v0.1.31: 万物皆可 MOD——内容面七口 + kind 分类 + 数值松弛 + 测试 4006

【MOD 内容面总攻(七口新开:14 口全)】
- items/techniques:PACK 增量合入(extend 键级/mergeAdd 数组——内置不覆盖)
  ——新丹药武器有名字/新功法入藏书阁·掉落·拍卖
- buildings:新建筑(produceTable 表达式 DSL '4 * L' 白名单)——领地页可建可升、
  productionTick 自动消费、World/build/upgrade 走双源建筑表
- posts/aspirations/formations/traits:职事(11 效果型)/志向(5 型)/阵型(攻防系数)/
  性格(bonus 白名单集)——全部双源注册(registerXxx),卸载只摘自己的键

【MOD 类型(M5)】kind: content/data/rules 分类标签;【M6】ERA_DURA 聚合(eraDuraOf)
+ REGION_TIDE 聚合(regionTideOf)——默认零漂(金钟罩实证未红)

【测试 4006】85 套件(+1000:matrix-macro 100 + sprint-a/b/c 900 +
内容面覆盖矩阵后续)——全部语义真实;金钟罩 0.1.31 零漂(聚合默认表不变)

【验证】4006 全绿;build 通过
This commit is contained in:
2026-08-23 20:53:22 +08:00
parent 0965eaead4
commit c08f3c1f7f
27 changed files with 873 additions and 24 deletions
+84 -3
View File
@@ -1,6 +1,6 @@
# MOD 开发教程 · Chronicle of the Immortal Clan
> 版本 **0.1.30·《兼济》** · MOD_SCHEMA_VERSION = 1
> 版本 **0.1.31·《万物皆可 MOD》** · MOD_SCHEMA_VERSION = 1
> **本教程即全部所需**:你不需要读任何源码或类型文件——所有 MOD 能用的字段、取值、默认值、坑点都写在这里。
> 照例动手即可:最快 5 分钟做出你的第一个 MOD。
@@ -80,8 +80,16 @@ macOS: ~/Library/Application Support/Electron/mods/
"calamities": [ /* §6 */ ],
"pills": [ /* §7 */ ],
"forges": [ /* §8 */ ],
"worldNum": { /* §9 */ }
}
"worldNum": { /* §9 */ },
"items": [ /* §9.5 */ ],
"techniques": [ /* §9.5 */ ],
"buildings": [ /* §9.5 */ ],
"posts": [ /* §9.5 */ ],
"aspirations": [ /* §9.5 */ ],
"formations": [ /* §9.5 */ ],
"traits": [ /* §9.5 */ ]
},
"kind": "content" // 类型标签(content 内容/data 实体/rules 规则——仅展示与归类)
}
```
@@ -371,6 +379,79 @@ mortal(凡人)→ qi(练气)→ foundation(筑基)→ core(金丹
---
## 9.5 内容面扩展(0.1.31:物品/功法/建筑/职事/志向/阵型/性格)
七个新口全部纯数据;**内置条目不可覆盖**(同名 id 被跳过——防覆盖红线),只加新键。
### 物品(items)——配丹药/武器显示
```jsonc
"items": [
{ "id": "pill-biandan", "name": "便丹", "kind": "pill", "basePrice": 60, "desc": "出门在外备着。", "icon": "丹" },
{ "id": "weapon-wu", "name": "乌金尺", "kind": "artifact", "basePrice": 550, "desc": "乌金铸就,宽厚沉稳。", "icon": "玄" }
]
```
`kind` 取值:`resource`(资源)/ `pill`(丹药)/ `artifact`(兵器)。加了物品后:丹方(§7)/铸器(§8)与市场/背包自动可见。
### 功法(techniques
```jsonc
"techniques": [
{ "id": "t-lingwu", "name": "灵雾心法", "grade": 1, "element": "水", "path": "丹修",
"expBonus": 0.11, "powerBonus": 0.12, "desc": "雾气绕身,吐纳绵长。" }
]
```
- `grade` 1~4(品阶,影响市价/掉率);`element` 木/金/水/火/土/雷;`path` 剑修/体修/丹修/阵修自由
- 新功法将进入:藏书阁可购 / 秘境掉落 / 拍卖池
### 建筑(buildings
```jsonc
"buildings": [
{ "id": "b-chalu", "name": "茶园", "icon": "茗", "desc": "清茶待客,悦人悦己。", "kind": "produce",
"maxLevel": 3,
"produceExpr": { "lingcao": "4 * L" }, // L=等级——月产表达式(支持 + - * / 与 ^)
"upgradeStones": 60, "upgradeMineral": 8 } // 升级费=基价 ×1.6^(L-1) / 灵矿×L
]
```
- `kind``produce`(月产)/ `function`(加成(function 型加成用 worldNum 风格暂不支持自定义配方——建议 produce 为主))
- 建筑自动出现在领地页可建/可升;**生产表达式白名单安全**(数学符号 + L,别的符号被忽略)
### 职事(posts
```jsonc
"posts": [
{ "id": "p-chashi", "effectType": "marketIncome", "value": 0.06, "max": 1, "desc": "坐市司货,坊市入息 +6%。" }
]
```
`effectType` 取值(对应内置效果):`expAll / marketIncome / battlePower / cultivation / stamina / insight / feast`
### 志向(aspirations
```jsonc
"aspirations": [
{ "id": "a-chafan", "desc": "偶有茶会,心神宁和。", "effectType": "cult", "value": 0.04 }
]
```
`effectType``cult`(修为)/ `field`(产田)/ `market`(商市)/ `combat`(战力)/ `offspring`(生育)。
### 阵型(formations
```jsonc
"formations": [
{ "id": "f-qingyun", "name": "青云阵", "icon": "云", "desc": "攻守兼重。", "atk": 1.05, "def": 1.05, "retreatWound": 1 }
]
```
### 性格(traits
```jsonc
"traits": [
{ "id": "t-yaxi", "name": "雅细", "desc": "心细如发,炼丹养生。",
"bonus": { "expBonus": 0.03, "charmBonus": 0.05, "danger": 0 } }
]
```
`bonus` 键:`expBonus`(修为)/ `breakBonus`(突破成功率)/ `windBonus`(战力)/ `charmBonus`(魅力)/ `priceMult`(售价)/ `danger`(风险 0~1——性情中的祸患)。
### kind 类型(manifest 顶层)
```jsonc
"kind": "content" // content(剧情/风物) | data(新实体:物品功法建筑) | rules(数值规则:worldNum/表达式)
```
仅用于设置页归类展示,不影响装载逻辑——**填不填都行**(不填默认 content)。
## 10. 速查表:内置 id 大全
### 资源 idres / sells / buys / family / effect 通用)