項目M.A.S

 

鸣谢 Fancy Toasts，配方解锁动画基于原版 Fancy Toast 制作。

 

Project M.A.S — 物质分析系统

引导你的玩家，而不告诉他们该去哪里。

Project M.A.S 允许整合包作者将合成配方锁定在世界本身之后。无需编写写着“去下界”的任务文本，也无需放置 NPC 来解释进度——只需将配方锁定在下界方块之后。玩家会自然地探索、找到方块、扫描它，然后解锁配方。没有手把手引导，没有冗长的文本说明，只有探索。

---

整合包作者使用它的原因：

• 自然的进度推进 — 玩家通过与世界互动来发现该做什么，而不是阅读说明。
• 与任何模组兼容 — 可将任何模组的配方锁定在任何方块之后。无论是 Create、Mekanism、Botania 还是原版，都没问题。
• 零 UI 摩擦 — 没有自定义 GUI、NPC 对话或需要维护的任务书条目。扫描仪物品和发光效果就是全部交互界面。
• JEI 集成 — 锁定的配方会自动从 JEI 中隐藏。玩家只能看到已解锁的内容。
• 每个玩家独立 — 每位玩家独立推进进度。世界数据会在不同会话之间持久化保存。
• 完全数据驱动 — 在单个 JSON 配置文件中定义所有内容，无需修改代码。

---

对玩家来说，它的运作方式如下：

1. 他们找到一个发光的方块（你配置了哪个方块解锁哪个配方）。
2. 他们使用扫描仪右键点击该方块。
3. 扫描进度条会在他们的 HUD 上填充。
4. 扫描完成时，配方解锁并弹出通知。
5. 他们现在可以合成该物品了。

就是这样。方块上的发光效果是他们需要的唯一提示。

---

 

槽位	展示内容
手持扫描仪时，需要被扫描的方块的样子
扫描中
新配方已解锁

可选第4项：一个展示完整流程的短 GIF（约5秒）— 玩家接近发光方块，进行扫描，弹出通知。

---

给整合包作者的示例配置：

将铁镐的配方锁定在铁矿石之后 — 玩家必须先开采铁矿石，然后才能合成开采铁矿石所需的工具：

{
  "item": "minecraft:iron_pickaxe",
  "unlock_block": "minecraft:iron_ore"
}

 

Mekanism 示例：

{
  "item": "mekanism:digital_miner",
  "unlock_block": "mekanism:osmium_ore",
  "scan_time": 15.0,
  "glow_color": "0x00FF88"
}

 

让玩家在合成任何下界合金剑之前先去探索海洋：

{
  "item": "minecraft:netherite_sword",
  "unlock_block": "minecraft:sponge",
  "scan_time": 20.0,
  "glow_color": "0xFF5500"
}

---

服务器指令（测试整合包需要 op 权限）：

指令	作用
/m.a.s lockrecipe <player> <recipe>	为特定玩家重新锁定配方。适用于整合包重置或测试进度流程。
/m.a.s unlockrecipe <player> <recipe>	为特定玩家解锁配方。可绕过扫描以用于测试或管理员操作。

---

可选集成：

• Create + Flywheel — 添加一个链接器物品，让玩家可以将自己链接到 Create 的机器。机器会使用链接玩家的配方解锁状态。
• 研究团队 — 玩家可以组建团队并共享已解锁的配方。一人扫描，全队受益。
• Sable — 可选依赖，扫描仪无法透过子层级进行扫描。

---

依赖项：

依赖项	必需？
NeoForge	是
Veil	是
Sable	可选
Create + Flywheel	可选
JEI	可选