v0.1.25: 乾坤一统——MOD 系统首版(1040 全绿,金钟罩不漂)

【P0 修复(0.1.24 遗留)】worldGen.npcs defs 落档 + normalize 幂等重注册——读档后
动态家族(n-g-*)npcById 永命中;MOD 卸载后存档世界仍完整(存档世界永稳)

【MOD 系统四层】
- M2 内容层:modSchema.ts(ModPack 全 JSON:manifest+data{events/npcs/worldgen/pills/forges};
  modParse 纯解析校验 id/name/version/事件模板合法性)
- M3 管理器:modToPlugin(MOD→CotycPlugin 一等子类——插件持久化/双闸/启停/回滚全复用)
- M1 传输层:main IPC mods:scan/read(userData/mods/*.json|*.cotymod)+ preload + env.d.ts
  + store refreshMods/installModByName/installModText
- M4 UI:SettingsPanel「MOD 层」卡(扫描目录/候选列表/安装);内置示例包通路

【世界/插件协同】
- WorldGenPools 聚合词库池(默认不变→基准世界不变;reset() 供隔离);MOD 于新档参与生成
- items.ts 配方聚合注册表(PILL/FORGE base+扩展);PluginContext addPillRecipe/addForgeRecipe/addWorldGenPool

【边界(明注)】灾因/世界数值表注入归平衡版;脚本型 MOD 不做;MOD 只影响新档世界(老档不变形)

【测试】1040 全绿(46 套件):worldGen 存档 1 例 + mod-system 5 例(解析/转换/模板/依赖/基准指纹);
金钟罩 0.1.24 基线未漂(世界生成默认池不变);build 通过
This commit is contained in:
2026-08-23 16:29:29 +08:00
parent ec25bf92fc
commit 5d9c333c76
18 changed files with 364 additions and 21 deletions
@@ -0,0 +1,30 @@
/**
* MOD 管理器:ModPack → CotycPlugin 构造(MOD=插件一等子类)。
* 全量复用 PluginManager 管线:持久化/启停/双闸/自动回滚。
*/
import { CotycPlugin } from '../kernel/plugin'
import { ModPack } from './modSchema'
export function modToPlugin(pack: ModPack): CotycPlugin {
return {
id: `mod-${pack.id}`,
name: `MOD·${pack.name}`,
version: pack.version,
author: pack.author ?? 'mod',
description: pack.description ?? '',
kind: 'content',
dependencies: (pack.depends ?? []).map((d) => `mod-${d}`),
conflicts: (pack.conflicts ?? []).map((c) => `mod-${c}`),
install(ctx) {
// 事件池(与核心事件同池聚合;findEvent 查池)
if (pack.data.events?.length) ctx.addEventPool(`mod-${pack.id}`, pack.data.events)
// 世界模板(worldgen 池候选——新档参与生成)
for (const def of pack.data.npcs ?? []) ctx.addNpcTemplate(def)
// 词库注入(styles/regions/fams/suffixes
if (pack.data.worldgen) ctx.addWorldGenPool(pack.data.worldgen)
// 配方补充
for (const r of pack.data.pills ?? []) ctx.addPillRecipe(r)
for (const r of pack.data.forges ?? []) ctx.addForgeRecipe(r)
}
}
}