官方种子 Mod

种子 Mod 随 Mods 站点一起部署，元数据登记在 registry.json，代码位于 mods/<id>/。它们是学习写 Mod 的最好范本。

id	名称	说明	标签
hello-world	Hello World	最简单的 Mod 示例	示例
auto-highlight	自动高亮敌人	进入战斗时自动高亮所有敌人	战斗 / 高亮 / 自动化
user-info	用户信息查询	通过聊天命令查询任意用户信息	工具 / 查询 / 社交
battle-log	战斗日志	记录战斗中的所有消息，支持导出	记录 / 统计 / 导出
player-list	玩家列表	显示当前战斗中的所有玩家	UI / 战斗 / 信息

hello-world

最小实现，只用生命周期钩子（完整代码见示例页）。

{
  "id": "hello-world",
  "name": "Hello World",
  "version": "1.0.0",
  "author": "findor-team",
  "description": "最简单的 Mod 示例",
  "main": "index.js",
  "permissions": []
}

auto-highlight

展示 事件 + 命令 + 存储 的组合用法。

{
  "id": "auto-highlight",
  "name": "自动高亮敌人",
  "version": "1.0.0",
  "author": "findor-team",
  "description": "进入战斗时自动高亮所有敌人",
  "main": "index.js",
  "tags": ["战斗", "高亮", "自动化"],
  "permissions": ["features", "models", "events", "commands", "storage"],
  "dependencies": []
}

要点：

• onLoad 里用 ctx.storage.get('settings', {}) 恢复设置
• onEnable 里 ctx.events.on('game:enterBattle' / 'game:leaveBattle') 并保存取消函数
• ctx.commands.register('toggle', …) 与 ('delay', …)，分别是 args: 0 与 args: 1
• onDisable 里逐个调用保存的取消函数

user-info / battle-log / player-list

这三个 Mod 更偏向"读状态 + 出结果"：

• user-info：注册聊天命令，查到用户后把信息 send(...) 到聊天
• battle-log：监听战斗消息，累积到内存/存储，并提供导出（界面上有"清除历史消息"入口）
• player-list：读取当前战斗玩家列表并渲染成列表

它们的 manifest 结构与上面一致，可按 registry.json 里的 tags 在浏览页搜索查看。

如何基于种子 Mod 改造

1. 复制 mods/hello-world/ 为 mods/<你的id>/
2. 改 manifest.json 的 id（必须全局唯一）、name、author、description
3. 写 index.js
4. 在根 registry.json 的 mods 数组里加一条
5. 部署站点 → 浏览页出现你的 Mod

下一步：发布与安装 · manifest.json