Skip to content

整合包构建

pack 侧当前要补的不是更多模组,而是把脚本、数据包和导出检查补成正式内容。

当前实例快照

当前实例情况:

项目 已确认事实
版本与加载器 当前实例是 1.20.1 Forge
KubeJS 根目录 存在 kubejslocal/kubejs 两个根,但当前主要内容在 kubejs
当前脚本计数 startup_scripts = 2server_scripts = 0client_scripts = 1
当前数据资源计数 kubejs/data 当前没有已索引资源,assets 有基础示例文件
事件栈 mods/ 中已存在 EventJS-1.20.1-1.4.0.jar,但当前索引里还没有 NativeEventsServerEventsStartupEvents 的实际项目用法
TaCZ 与扩展 已安装 tacztacz-tweakstacz_turretstaczaddontaczammoquerytaczjs

当前 pack 侧最明显的缺口不是“再挑一批模组”,而是把 server_scriptsdata 侧真正补成项目内容。现在的目录结构已经具备入口,但正式遗址逻辑还没有落进去。

pack 侧边界

pack 侧只接管以下内容:

负责什么 不负责什么
模组栈 选择依赖、确定可用系统 不写遗址运行态规则
配置层 调整基础行为、手感和默认策略 不持有遗址正式记录
脚本与数据包 组织标签、战利品、进度胶水和服务器事件入口 不取代正式 runtime 服务
导出与 QA 验证实例可启动、可重载、可试玩 不替代设计验收

KubeJS 与数据包边界

当前实例自带的 kubejs/README.txt 已经把几个目录的职责写清楚了,第一切片也应按这个边界落地:

目录 运行时边界 当前状态
kubejs/startup_scripts 只在启动时加载,适合启动期注册 已有 2 个脚本,但还不是正式遗址逻辑
kubejs/server_scripts 跟随服务端资源重载,适合服务器事件、战利品、标签和配方改动 当前为空
kubejs/data 作为 datapack 目录,适合 loot_tablestagsfunctions 等服务器资源 当前为空
kubejs/client_scripts 跟随客户端资源重载,适合 tooltip 和客户端提示 当前只有示例级内容

这条边界决定了第一切片应该怎么落:

  1. 需要长期进世界资源包的内容,先放进 kubejs/data
  2. 需要跟随 /reload 快速迭代的服务器胶水,放进 kubejs/server_scripts
  3. 客户端提示和视觉辅助只能建立在服务端数据已经写入的前提上,不能反过来当主逻辑。

TaCZ 现状与制作规则

当前枪械方案已经定了,不需要再把“是否使用 TaCZ”当成待定问题。

路径或模组 已确认事实 结论
mods/tacz-1.20.1-1.1.7-hotfix2.jar TaCZ 已经装好 第一切片直接基于它工作
mods/tacz-tweaks-2.13.1-all.jarmods/tacz_turrets-1.1.2-all.jarmods/taczaddon-1.20.1-1.1.7.jarmods/taczammoquery-1.20.1-1.0.0.jarmods/taczjs-forge-1.4.0+mc1.20.1.jar 当前实例已经叠了多层 TaCZ 扩展 当前枪械内容已经够多,第一切片更该收范围,而不是继续加层
tacz/tacz-pre.toml DefaultPackDebug = false 直接改默认包不应作为正式做法
tacz/tacz_default_gun/gunpack.meta.json 当前默认枪包 namespacetacz 项目自己的枪包不应继续复用这个命名空间

对应规则如下:

  1. 第一切片继续沿用 TaCZ 这一套枪械系统,不拆成多套独立枪械系统。
  2. 如果要正式制作,优先复制出项目自己的 gunpack,而不是直接长期修改 tacz_default_gun
  3. DefaultPackDebug = false 的前提下,直接改默认包只能视为临时试验,不应当成正式做法。

第一切片的 pack 缺口

按当前实例状态,第一切片还缺以下 pack 侧内容:

缺口 当前状态 第一批落点
宿主与分类标签 kubejs/data 为空 kubejs/data/lost_civilization/tags/...
战利品与进度资源 还没有正式遗址资源 loot_tablesadvancements、必要的 functions
服务端胶水 kubejs/server_scripts 为空 激活提交、掉落修正、进度推进、服务器事件桥接
本地 smoke test 还没有稳定检查清单 启动、/reload、进入实例、完成一次回收

这意味着第一条 pack 路线应当很短:

  1. 先固定 TaCZ 的制作方式和命名空间策略。
  2. 再把最小 data 资源补齐。
  3. 再把最小 server_scripts 胶水补齐。
  4. 最后再考虑客户端提示、更多武器内容和更重的表现层。

最后更新时间: