用途:MSW-Git/MSWPackages 是 MSW 官方一方预构建功能包仓库。当用户要求实现常见游戏功能时,先查此目录;若有匹配包,建议集成而非从零编写。
主要能力:提供功能到包的映射表,覆盖提示/通知、排行榜(基础与高级)、背包、商店、世界商店、邮件、任务成就、对话、按键绑定、游戏事件、玩家数据、图鉴、命令、虚拟滚动列表、掉落表、全局配置、GM 公告、资源、UI 组件等。技能本身是薄索引,各包详情按需从 GitHub 拉取,保持目录最新。
使用方式:先做范围判断(系统级还是仅 UI),必要时向用户提一个简短问题;匹配后先取 README:https://raw.githubusercontent.com/MSW-Git/MSWPackages/main/<package-name>/README.md,再按需取文件树与原始文件。集成前须经用户确认,默认不自动安装。集成时映射文件到项目布局,检查 UUID 冲突与精灵 RUID 依赖,解析跨包依赖,按标准 MSW 流程 stop → refresh_workspace → play 应用,并接入 _<PackageName>Logic 单例 API。
适用场景:需要快速复用官方预构建游戏功能、避免重复造轮子时。
限制:.modpackage 是 Maker 编辑器元数据,非自动安装脚本,实际集成靠手动复制文件;Sample/ 仅为示例,不应直接复制;UI 文件须经 msw-ui-system 处理,不可手改原始 .ui JSON;包不能替代对 mlua 的理解;不应批量推测性安装;仓库不可达时回退到从零构建并告知用户。