本仓库是 ScriptsForMinecraftServer（SFMC）的纯元数据索引中心（Pure Registry Index Hub）。模块业务代码在各自独立仓维护，安装包通过 npm 分发；本仓库只维护发现、版本与兼容性元数据，以及索引构建工具。
采用 Homebrew-core 式的独立条目贡献与 Cargo Index 式的集中发现思路：modules/<id>.json 是唯一编辑来源，根目录 index.json 是供现行 CLI 获取的聚合产物。不同模块的 PR 可独立修改分片，合并后由 Actions 更新聚合文件。
在已安装 SFMC CLI 的环境中执行：
sfmc mod search
sfmc mod install afk
sfmc mod install <id>| ID / 清单 | 名称 | 分类 | 功能概览 | requires |
|---|---|---|---|---|
| activity-log | 行为日志 | system | 全服原生事件监听与审计日志摄入/多维检索插槽 | — |
| afk | 挂机检测 | utility | 纯内存位移挂机判定与原版 Tag 豁免 | — |
| area | 空间微内核 | system | 空间微内核与 AABB 区域特性调度引擎 | — |
| chat-sounds | 聊天关键字音效 | social | 聊天关键词全服原声音效与冷却防刷 | chat |
| chat | 聊天管道 | social | 独占原生聊天流管道，提供拦截器与广播/私聊服务 | economy |
| clean | 掉落物清理 | utility | 区域与全服掉落物预警、倒计时广播与物理回收箱清理 | area |
| coop | 合作社 | social | 合作社组织治理与公账划转托管 | economy, activity-log |
| data-backup | 数据灾备 | system | 世界种子/规则与全服计分板快照灾备（排除 sfmc_money） | — |
| economy | 经济系统 | economy | 计分板权威余额 + DB 流水留档 + 两阶段转账中枢 | — |
| fly-area | 区域飞行 | gameplay | 空间进出自动飞行能力赋权与剥离缓降 | area |
| gamemode-area | 区域游戏模式 | gameplay | 区域游戏模式切换与背包隔离置换 | area, inventory-switcher |
| inventory-switcher | 背包切换 | system | 通用背包多槽位快照持久化与原子置换服务 | — |
| land | 领地庄园 | gameplay | 现代地产租赁契约（只租不卖）+ 原版三维高亮线框 + 商业门票造血 | economy, activity-log |
| monitor | 运行时监控 | system | TPS 逐刻采样环与全服综合负载宏观时序监控 | — |
| online-time | 在线时长统计 | utility | 进服打点与心跳增量结转在线统计与多维排行榜 | — |
| peace-area | 和平区域 | gameplay | 区域怪物生成拦截与和平空间保护（友好生物豁免） | area |
| qa | 知识竞答 | gameplay | 知识竞答加权出题、聊天快捷作答与经济奖惩结算 | economy, chat |
| spawn-protect | 出生保护 | utility | 玩家进服与重生 60 ticks 高阶抗性保护 | — |
verify 验证分片和待生成的索引，允许 PR 中已发布的 index.json 暂时落后。--network 额外检查公共 npm 上包名与精确版本；每个请求超时 15 秒，最多并发 4 个，不下载或执行模块。
本仓库保留现有 AGPL-3.0-only 许可证；各模块的许可证以清单及模块自身许可证为准。
首次收录和展示信息仍编辑 modules/<id>.json 并通过 PR 审核。已收录模块的版本与 SDK 兼容范围由索引仓从公共 npm 的 latest 自动读取，模块仓和平台发布 CI 不再提交版本 PR。
Publish registry index 在 main 元数据变更时及每小时执行，也支持手动运行。同步后直接提交分片和聚合索引；无变化时不产生提交。可用 pnpm run sync:npm --dry-run 预览，或运行 pnpm run sync:npm 后再执行 pnpm run verify 和 pnpm run build。同步只修改 version、sdk，保留展示信息与已审核的模块依赖。
每次请求超时 15 秒，最多并发 4 个。网络错误、包名不符、无效 SDK 范围、已发布版本的降版、已弃用版本或预发布 latest 会使同步失败，校验完成前不写文件，CI 不发布失败结果。测试版本应发布到 beta 等独立 dist-tag。
若旧索引登记的版本高于 npm latest，仅当 npm 明确返回该旧版本不存在（404）时，自动纠正为实际发布版本；网络错误或权限错误不能触发纠正。