用途:把用户的创意转成受支持、可编译的《杀戮尖塔2》Mod 代码,并在真实 STS2 宿主中验证选定行为。契约指导编写,Build 与宿主自测确认结果。
主要能力:支持 Card、Relic、Potion、Power、Keyword、Enchantment、Orb 内容;完整的单人 Act 与新的 Shared/Act 域 Ancient;战斗 Card Afflictions、可选好坏 Run Modifiers、Run/Combat Global Effects、独立 Rest Site 动作;自定义原生界面 Rewards 与 Custom Card Piles;Mod 自有 Runtime UI(顶栏、Toast、运行时热键、Capstone、Catalog、浮动窗口、搜索扩展、固定节点附着、shell-token);统一预览/执行公式的 Card 伤害/格挡/能量/星/威能计算;确定性高级 Card/Potion 目标选择;Monster 移动图与 Encounter 名单;普通 Events、有限原生展示、Quest Card 强制后续 Events;可玩 Character Foundation、静态展示、有限战斗提示、原生场景对话、次要资源与有序语义缓冲;独立/Card/Relic/Modifier Rest Site 选项、有限状态、可读性辅助与受支持静态美术;接地气的原版 Card/视觉/Ancient/可用性覆盖;以及仅宿主派发到的自定义表面上的 cataloged model-hook。
使用方式:按阶段惰性读取 ./ 下文件,依次为 route.md、interview.md、design.md、semantic-contract.md、spec.md、scaffold.md、quirks.md、author.md、build.md、verify.md、repair.md。需要具体 API、配方或报错答案时,只窄查询 ../sts2api。可玩 Character 内容前先读 ../sts2api/design/character-foundation.md。主要命令:python ../modmaker/scripts/capability_preflight.py --spec SPEC.md;scaffold.py --project-dir <外层目录> --mod-name <ModName> --author <Author>;build.py --project-dir <外层目录> --mod-name <ModName>;launch.py;grep_log.py --mod-name <ModName>;launch.py --self-test --mod-name <ModName>。外层项目目录名必须与 Mod 名不同。
限制:不得读取或反编译本地源码,不得交付 Harmony、反射、Publicizer 或 IL。报告前需 Build、Tier 1、Tier 2 与相关有头 UI/输入验证。不得编辑已安装技能载荷。非玩家可见的进展、跑后 Badge、Settings、Telemetry、多人、更新检查等暂缓。已知不支持:无公开宿主的任意行为场景/材质、全局房间替换、任意事务/过渡/RNG 改写、替代能量、保留已打出 Card 区域、无依据的禁用/权重表面、多人集成与一键创意工坊发布。具体功能清单与限制见随附表面与 sts2api 参考;缺失事实暂未提供。