整合包构建
pack 侧当前要补的不是更多模组,而是把脚本、数据包和导出检查补成正式内容。
当前实例快照
当前实例情况:
| 项目 | 已确认事实 |
|---|---|
| 版本与加载器 | 当前实例是 1.20.1 Forge |
| KubeJS 根目录 | 存在 kubejs 与 local/kubejs 两个根,但当前主要内容在 kubejs |
| 当前脚本计数 | startup_scripts = 2,server_scripts = 0,client_scripts = 1 |
| 当前数据资源计数 | kubejs/data 当前没有已索引资源,assets 有基础示例文件 |
| 事件栈 | mods/ 中已存在 EventJS-1.20.1-1.4.0.jar,但当前索引里还没有 NativeEvents、ServerEvents、StartupEvents 的实际项目用法 |
| TaCZ 与扩展 | 已安装 tacz、tacz-tweaks、tacz_turrets、taczaddon、taczammoquery、taczjs |
当前 pack 侧最明显的缺口不是“再挑一批模组”,而是把 server_scripts 和 data 侧真正补成项目内容。现在的目录结构已经具备入口,但正式遗址逻辑还没有落进去。
pack 侧边界
pack 侧只接管以下内容:
| 层 | 负责什么 | 不负责什么 |
|---|---|---|
| 模组栈 | 选择依赖、确定可用系统 | 不写遗址运行态规则 |
| 配置层 | 调整基础行为、手感和默认策略 | 不持有遗址正式记录 |
| 脚本与数据包 | 组织标签、战利品、进度胶水和服务器事件入口 | 不取代正式 runtime 服务 |
| 导出与 QA | 验证实例可启动、可重载、可试玩 | 不替代设计验收 |
KubeJS 与数据包边界
当前实例自带的 kubejs/README.txt 已经把几个目录的职责写清楚了,第一切片也应按这个边界落地:
| 目录 | 运行时边界 | 当前状态 |
|---|---|---|
kubejs/startup_scripts | 只在启动时加载,适合启动期注册 | 已有 2 个脚本,但还不是正式遗址逻辑 |
kubejs/server_scripts | 跟随服务端资源重载,适合服务器事件、战利品、标签和配方改动 | 当前为空 |
kubejs/data | 作为 datapack 目录,适合 loot_tables、tags、functions 等服务器资源 | 当前为空 |
kubejs/client_scripts | 跟随客户端资源重载,适合 tooltip 和客户端提示 | 当前只有示例级内容 |
这条边界决定了第一切片应该怎么落:
- 需要长期进世界资源包的内容,先放进
kubejs/data。 - 需要跟随
/reload快速迭代的服务器胶水,放进kubejs/server_scripts。 - 客户端提示和视觉辅助只能建立在服务端数据已经写入的前提上,不能反过来当主逻辑。
TaCZ 现状与制作规则
当前枪械方案已经定了,不需要再把“是否使用 TaCZ”当成待定问题。
| 路径或模组 | 已确认事实 | 结论 |
|---|---|---|
mods/tacz-1.20.1-1.1.7-hotfix2.jar | TaCZ 已经装好 | 第一切片直接基于它工作 |
mods/tacz-tweaks-2.13.1-all.jar、mods/tacz_turrets-1.1.2-all.jar、mods/taczaddon-1.20.1-1.1.7.jar、mods/taczammoquery-1.20.1-1.0.0.jar、mods/taczjs-forge-1.4.0+mc1.20.1.jar | 当前实例已经叠了多层 TaCZ 扩展 | 当前枪械内容已经够多,第一切片更该收范围,而不是继续加层 |
tacz/tacz-pre.toml | DefaultPackDebug = false | 直接改默认包不应作为正式做法 |
tacz/tacz_default_gun/gunpack.meta.json | 当前默认枪包 namespace 是 tacz | 项目自己的枪包不应继续复用这个命名空间 |
对应规则如下:
- 第一切片继续沿用 TaCZ 这一套枪械系统,不拆成多套独立枪械系统。
- 如果要正式制作,优先复制出项目自己的 gunpack,而不是直接长期修改
tacz_default_gun。 - 在
DefaultPackDebug = false的前提下,直接改默认包只能视为临时试验,不应当成正式做法。
第一切片的 pack 缺口
按当前实例状态,第一切片还缺以下 pack 侧内容:
| 缺口 | 当前状态 | 第一批落点 |
|---|---|---|
| 宿主与分类标签 | kubejs/data 为空 | kubejs/data/lost_civilization/tags/... |
| 战利品与进度资源 | 还没有正式遗址资源 | loot_tables、advancements、必要的 functions |
| 服务端胶水 | kubejs/server_scripts 为空 | 激活提交、掉落修正、进度推进、服务器事件桥接 |
| 本地 smoke test | 还没有稳定检查清单 | 启动、/reload、进入实例、完成一次回收 |
这意味着第一条 pack 路线应当很短:
- 先固定 TaCZ 的制作方式和命名空间策略。
- 再把最小
data资源补齐。 - 再把最小
server_scripts胶水补齐。 - 最后再考虑客户端提示、更多武器内容和更重的表现层。