橡果与遗迹 Wiki
理念、系统与数据

数据数据库与数值表说明

最后编辑 2026-10-21 11:09 · 第 1 版 · 新增页面 · 修订记录(1)

本目录是物品与数值的唯一数据源。其他地方的配置,包括 CE、CloudItems、AcornCore 和 CloudUI 显示的概率,都以这里为准,并且应当从这里导出生成。不要分别手写多份,以免对不上。

  • 维护人:总策划。研发和 sol 只读;发现问题写进任务回报。
  • 格式:CSV(UTF-8 带 BOM,Excel 可直接打开)。字段内不使用英文逗号,多个值用「;」分隔。
  • 状态列取值:已确认(用户明确拍板)、策划决定(总策划定的,用户可以推翻)、草案、示例、占位。**头脑风暴里用户举的例子一律标示例,不能写成已确认。**只有已确认的行可以进正式服。示例和占位的行用来演示结构,群系逐个设计时再替换。

表与关系

稀有度.csv ─────────────┐
                        ↓ 稀有度
来源.csv ──关联晶球──→ 晶球.csv ──各池 ID──→ 掉落池.csv ──物品 ID──→ 物品库.csv
                        │                          ↑                    ↑
                   层权重方案 ──→ 数值参数.csv ──────┘                    │
                                                                         │
                     手办.csv ──物品 ID──────────────────────────────────┤
                     外观.csv ──物品 ID──────────────────────────────────┘
                     源抽取.csv ──源物品 ID、抽取池 ID──→ 掉落池.csv
文件 内容
物品库.csv 所有物品的总表。任何一件物品都要先在这里登记 ID,其他表才能引用它
稀有度.csv 稀有度分级。颜色加边框形状两重区分,不只靠颜色
来源.csv 产出来源:群系、活动、地区、副本
晶球.csv 每种晶球:来自哪里、开启费用、引用哪些池、采用哪套层权重
掉落池.csv 池里有哪些物品、权重、数量、条件
手办.csv 手办收集的附加属性:系列、展示方式(上交锁定)、颜色变体
外观.csv 时装、武器皮肤的附加属性
源抽取.csv 各种"源"的抽取规则:抽取池、保底、概率公示
数值参数.csv 全局参数:费用、层权重、上限、规划假设

试算过程见 数值/晶球试算.md,系统设计见 策划/系统/S01_晶球手办与源抽取.md。

ID 规则(遵守 D002、T003)

  • 格式为 命名空间:路径,全部小写英文、数字、下划线和斜杠。自研内容的命名空间是 acorn:,原版物品是 minecraft:。
  • ID 一旦上线就不改、不复用。物品下架时把状态改为已下架,不删除这一行。
  • 名称键规则:acorn.item.<路径里的斜杠换成下划线>.name。显示名放进语言文件,这里的"简体名称"一列只方便阅读。
  • 新增专有名词时,要同步登记到 策划/术语表.md。

联动规则

发生什么 必须同步做什么
新增一个来源(群系、活动、地区、副本) 在 来源.csv 加一行 → 设计它的晶球 → 新建它的独有池和独有手办池
新增一种生物(群系逐个设计时) 同时登记它的手办(手办直接复用生物模型,见 S01 第四节)
新增一种"源" 在 源抽取.csv 加一行;在 外观.csv 登记它的外观奖池
修改任何权重 重新计算 数值/晶球试算.md 中受影响的结果;更新游戏内的概率公示
某个物品的稀有度达到稀有(R3)或以上,或者属于神奇橡果、源、外观 发放必须经过奖励账本(D003 第七节)
修改交易范围 检查是否会形成"付费货币 → 随机结果"的链条(S01 第六节)