决策记录
D001游戏版本与技术栈（v2）
- 状态：已确认：版本 1.21.10，路线为 CE 加云系列。策划建议：模块裁剪和分层方案（见第三、四节）。
- 日期：2026-10-21
- 依据：用户决定的「CE＋云系列＋1.21.10」，以及 GPT 调研的离线知识库
知识库/橡果与遗迹_CE与云系列_1.21.10_报告与本地知识库/。 - 取代：v1 中的「BetterModel 主方案」，作废。
- 影响范围：全部美术资产规格、全部插件开发、界面方案、副本与装备玩法、服务器部署、采购预算。
- 修订：2026-10-21，作者确认 CloudUI 支持 1.21.10，界面方案改为以 CloudUI 为主。
一、结论
| 项目 | 决定 |
|---|---|
| 发行平台 | 网易《我的世界》中国版 Java 网络服 |
| 游戏版本 | 1.21.10。开发期锁定；网易开放更高版本之前不升级 |
| 服务端 | Paper 1.21.10，Java 21，首发单服 |
| 客户端 | 纯原版客户端加服务器资源包，不要求玩家装 Mod，不支持基岩版 |
| 底层材质与资源包 | CraftEngine：负责方块、家具、物品外观、字体图片，并统一打包所有资源 |
| 业务插件 | 云系列，按模块分批启用（见第三节），不是一次装齐整套 |
| 定制玩法 | 自研插件（由 Claude 开发窗口负责），通过云系列和 CE 的接口接入 |
关于 AX：知识库里 GPT 最初比较的四条路线是 IA＋MEG、CE＋MEG、ArcArtX、云系列。AX 应该是指 ArcArtX，已在用户选定云系列时落选，这一项结案。
二、对版本的关键判断
CloudUI 可以在 1.21.10 上使用。 ✅ 用户已经和作者确认，CloudUI 正式支持 1.21.10（2026-10-21）。公开文档里写的"服务端需要 1.21.11 或 26.x"已经过时，以作者的答复为准。
界面方案因此调整为：
| 界面需求 | 方案 |
|---|---|
| 全屏系统界面：重铸站、强化站、商城、衣橱、背包、图鉴、地牢大厅 | CloudUI（主方案） |
| NPC 对话、简单确认、说明文字 | CloudUI 或 1.21.10 原生对话框（Dialog），按具体场景选择 |
| 血条、提示、状态 | CloudHealthBar，再配合 CE 字体做 HUD |
| 自研玩法的界面（肉鸽祝福选择、发现图鉴等） | 优先接入 CloudUI；接不上时退回 CE 字体容器 |
保留一条原则：界面只负责显示。 扣费、发放、存档等数据操作一律由业务插件完成，不放在界面层里。这样以后换界面方案也不会动到玩法逻辑。
CloudModel 在 1.21.10 上的限制：自由旋转和 mesh 网格需要 1.21.11 客户端，这一条是客户端门槛，和 CloudUI 无关，首发仍然不能用，配置里固定 free-rotation: false。这条直接约束美术规格，见第五节。
三、模块分层（总策划裁剪）
"整套云系列"指的是候选范围。首发只启用玩法确实需要的模块，理由有三条：
- 每多一个插件，就多一个授权依赖、多一层属性叠加、多一组键位冲突。
- 职业、PvP、拍卖、时装商城这些玩法本身还没有设计定案。先装插件，等于让插件来反向决定玩法。
- 要先跑通核心循环，再按需扩展。
第一层：首发核心（随首轮原型启用）
| 模块 | 在本项目中负责什么 | 前置依赖 | 标价 |
|---|---|---|---|
| CraftEngine | 方块、家具、物品外观、字体界面、资源包汇总与托管 | — | 社区版免费 |
| CloudModel 云模型 | 生物、Boss、NPC 的骨骼模型与动画 | PacketEvents | 68R |
| MythicMobs | 怪物 AI、阶段、技能 | — | 免费版先行 |
| CloudItems 云物品 | 装备属性、技能、词缀（即前缀重铸）、强化、宝石、工坊 | MythicLib | 38R |
| CloudDungeon 云副本 | 地牢实例、组队、门票、断线与当机恢复、通关结算 | FAWE | 98R |
| CloudHealthBar 云血条 | 怪物血条 | PacketEvents | 18R |
| CloudUI 云界面 | 全部系统界面（重铸、强化、地牢大厅、图鉴等） | 待核 | 价格待核 |
| 基础设施 | LuckPerms（权限）、PlaceholderAPI（变量）、FAWE、PacketEvents、MythicLib | — | 免费 |
首发付费合计约 222R 加 CloudUI（按抓取日标价；CloudUI 价格待核；不含 CE Premium 和模型素材）。
第二层：玩法定案后再启用
| 模块 | 触发条件 |
|---|---|
| CloudShop 云商城、Vault 加经济插件 | 经济系统设计定案（货币是否存在、NPC 交易范围） |
| StarMail 星月邮箱 | 需要离线补发奖励时。副本当机补偿、活动发奖都会用到，大概率第二批就要 |
| StarBag 星月行囊 | 背包容量确实成为痛点时 |
| CloudCosmetics 云时装、CloudAcces 云饰品、CloudTitle 云称号 | 外观收藏和商业化方案定案。首发一律只做展示，不加战斗属性 |
| CloudHologram 云全息 | 聚落和遗迹需要场景文字提示时 |
| CloudChat 云聊天 | 需要频道、展示物品时 |
第三层：暂不采用
| 模块 | 理由 |
|---|---|
| StarVocation 星月天职 | 职业和技能树还没决定。装了它，等于默认这是职业 RPG，和"装备改变行动方式"的方向冲突。另外它和 MMOCore 互斥 |
| CloudArena 云竞技 | PvP 未确认，和生活冒险定位关系弱 |
| StarAuction 星月市集 | 自由交易未确认；一旦上线必须同时解决刷取和囤积问题。⚠️ 头脑风暴 I09 提出了"神奇橡果市场"的需求，预计提前到第二层，并带上前置的星月邮箱。需要核实它能否限定用点券类货币交易 |
| StarCrate 星月造物 | 随机开箱。真要做，必须先对照网易概率公示和商业化规则 |
| CloudSync | 首发单服，用不上 |
⚠️ 2026-10-21 头脑风暴更新（I12）：首发是主城、冒险、生存三大世界加副本临时世界，因此需要补两样东西：
- 多世界管理：CloudWorlds（免费）提前到第一层，候选方案。注意它不能接管云副本的专用世界。
- 领地插件：生存世界要用，目前清单里没有，需要另外选型，比如 Residence、Lands、GriefPrevention。
冒险世界定期刷新，每次都要重新预生成地图，比如用 Chunky。这一步要排进维护流程。三个世界跑在同一个 Paper 实例上，负载比单世界高，以后需要拆分子服时再启用 CloudSync。
2026-10-21 补充（I14 到 I19），新增候选技术项，都是待核状态：
- 冒险世界同一种子每天重置，每月换一次种子（I21）：每月换种子时预生成一次"母版世界"并存档，每天定时用母版覆盖冒险世界，CPU 成本很低。需要定时重置插件或自研脚本，重置前把在线玩家送回主城。
- CustomCrops（农业）、CustomFishing（钓鱼）：都出自 CE 作者团队，原生联动 CE。要核实价格以及对 1.21.10 的支持。
- 防挂机验证：选插件还是自研待定。要求是只在疑似挂机时弹出。
- 世界 Boss 临时战场：自研，或者复用云副本 / CloudWorlds 的临时世界能力。
- 领地插件需要支持"野外禁止破坏，领地内允许破坏"。
四、自研层：云系列做不到的部分
云系列负责通用能力，本项目的特色玩法必须自研，并且关键数据要由我们自己掌握：
| 自研内容 | 原因 | 接入方式 |
|---|---|---|
| 肉鸽层 | 云副本是固定地图加波次脚本，没有随机房间和局内祝福 | 监听云副本事件（开始、怪物组、通关、失败、离开），或从副本脚本调用我们的插件 |
| 统一奖励账本 | 副本、邮件、宝箱、补偿各自发奖，容易重复发放 | 每次高价值发放都生成唯一结算号，由自研层统一记账 |
| 群系遭遇与发现记录 | 群系线索、稀有遭遇、个人发现图鉴没有现成插件 | 自研，生物用 MythicMobs 加 CloudModel |
| 遗迹机关 | 环境解谜需要定制逻辑 | 自研，配合 CE 方块和家具 |
| 大型技能 | 超出 MythicMobs 配置能力的技能 | 自研，通过 MythicLib 技能接口挂到 CloudItems 装备上 |
原则：云系列是闭源插件，有授权风险，不能让玩家的长期核心进度只存在闭源插件里。发现记录、奖励账本、肉鸽局外成长都放在自研层。
五、对其他部分的影响
| 对象 | 规格要求 |
|---|---|
| 美术（GPT） | 交付 .bbmodel。只用方块（cube），不用 mesh。静态元素旋转遵守原版限制：单轴旋转，角度只能是 -45、-22.5、0、22.5、45 度；动画里的骨骼旋转不受这个限制。具体贴图尺寸、骨骼数量上限、命名规则另出《美术资产规范》 |
| 开发（Claude 窗口） | Paper API 1.21.10，Java 21。装备一律用 CloudItems 生成，不另造物品系统。属性统一走 MythicLib。界面接入 CloudUI，界面层只负责显示，不处理数据。需要的云系列 JAR 作为编译期依赖 |
| 用户（简单部分） | CE 方块和家具、CloudItems 装备、MythicMobs 普通怪、云副本波次脚本，都按我提供的模板填写 |
| 策划（我） | 原版内容以 1.21.10 为上限来设计；界面按 CloudUI 能力来设计；属性来源只认装备一处 |
| 采购 | 首发约 222R 加 CloudUI，第二层按需追加 |
六、最大风险：授权与网易正式机
云系列每个插件都要联网验证授权并绑定机器。验证成功后，连不上授权服务器最多能离线运行 72 小时。网易要求游戏部署在网易发放的正式机上。两者叠加，产生三个问题：
网易正式机能否访问外网授权服务器✅ 用户已确认可以正常使用与授权（2026-10-21）。- 机器绑定与迁移：从测试机迁到网易正式机时，授权要先解绑再绑定。迁移流程要提前和作者确认。
- 授权失效时的表现：CloudModel 失效后怪物还在但模型不显示；CloudItems 失效后装备功能停用。这两种情况都要准备维护公告和应急停服流程。
剩下的第 2 问在采购前问作者。
七、首轮技术验证（批量制作前必须通过）
| 编号 | 验证内容 | 通过标准 |
|---|---|---|
| T0 | 网易正式机能访问授权服务器 | ✅ 已确认（2026-10-21，用户确认可正常使用与授权） |
| T1 | 网易客户端接收 CE 资源包 | 自动下载并加载，国内下载速度可接受 |
| T2 | CE 加 CloudModel 合并资源包 | 一件方块、一件家具、一只模型生物同时正常显示 |
| T3 | 装备闭环 | 用 CI 武器加 CE 外观，击杀模型小怪，掉落一件装备，在词缀站重抽一次；重启后结果保留；属性只计算一次 |
| T4 | 副本闭环 | 一张小地图的波次流程；成功、失败、死亡、掉线、停服五条路径都不吞物品、不重复发奖 |
| T5 | CloudUI 在 1.21.10 上运行 | 用作者提供的构建，在网易客户端上显示正确、交互可用，资源包能与 CE 合并 |
| T6 | 网易认证接入 | 接入后各插件能正常识别玩家 |
八、待办
- 用户问网易（授权访问已确认 ✅）：资源包有无大小或审核限制；1.21.10 是否已对网络服开放
- 用户问云系列作者：网易正式机部署、换机解绑、测试机和正式机是否需要两份授权（CloudUI 支持 1.21.10 已确认 ✅）
- 我：根据本决策出《美术资产规范》（给 GPT），以及《首轮原型开发需求》（给开发窗口）