DrakeModsLibs — ⚠️ 迁移至Hexium

【重要】 DrakeMods 正在迁移至 Hexium。

这是我们在Thunderstore上发布的最后几次更新之一。此后将不再在此发布新的DrakeMods，现有模组在Thunderstore上也只会获得有限的支持。

获取最新更新、最新版本和未来的模组，请关注我们 六角: 👉 Hexium上的DrakeMods

这些Thunderstore列表将在此之后弃用。

[!TIP]

🎨 DrakesReskinIt 终于要来了，就在 Hexium 上！

基于DrakeModsLibs打造的下一个模组：为任意物品赋予新的物品栏图标、新的装备模型和自定义颜色，并支持可保存的预设。它接入了LockSmith和DrakesRenameIt已在使用的同一个Shift+右键标签菜单。👉 德雷克外观修改已应用于赫克西姆

共享库，用于 德雷克模组 英灵神殿模组。它拥有显示Harmony补丁、物品自定义数据辅助工具、标签门禁、菜单绑定注册表，以及 服务器配置同步 这样功能模组体积更小，游戏更新时也能保持兼容。

德雷克模组库 单独发布，以便其他DrakeMods（从 德雷克重命名器) 可以依赖一个通用包。更注重自定义的模组以后可能会使用它；这里有 目前暂无发布完整套装版的计划 ——优先级和重新设计先行。 皮肤 如果有时间的话，这件事我们仍然想进一步调查。

英灵神殿 1.0

此版本面向 英灵神殿 1.0 API变更（主要是物品架视觉更新及相关显示路径）。安装匹配的 德雷克模组库 使用你的功能模组进行构建，以便标签和悬停文本在1.0更新后仍可正常工作。

需要用于

• 锁匠 （共享锁定|重命名标签页、木质界面、配置同步）
• 龙族改名 （以及任何未来共享显示/配置同步的DrakeMods）

锻造助手（DrakeModsLibs.Forge）

锻造纹理 （图片嵌入在你的DLL中，防扁平化处理） 锻造精灵 （平面剪切图）和 锻造外观 （材料、图标、吸附点、组件、火焰颜色……）：由Drakes Asset Forge的纯C#导出所生成的API代码调用。使用者为 德雷克改名器 （纸） 锻造外观.模型 （来自你的 DLL 的 .glb 模型，例如 Forge 的 look.mesh.file）以及 锻造外观.碰撞箱：由……使用 龙之物品商店 （展示柜）。

服务器配置同步（DrakeConfigSync）

只有DrakeModsLibs 引用和ILRepack嵌入 服务器同步消费者模组不得添加 ServerSync Thunderstore 依赖项或 ILRepack 步骤。

启动时，通过API创建同步：

var sync = CustomizeLibsAPI.CreateConfigSync(modId, displayName, version); var entry = sync.BindSynced(config, section, configurationManagerCategory, key, defaultValue, description); sync.AddLockingConfigEntry(lockEntry); sync.FinalizeBinding(log, expectedSyncedEntryCount, () => lockEntry.Value);

使用 仅客户端绑定 用于客户端单独设置（从不与ServerSync同步注册）。 真相来源 / 真实来源已变更 像底层ServerSync实例一样运行。

软兼容（CompatHost）

可选的外部模组（WardIsLove、ProtectiveWards、Arcane Ward、DevCommands……）是 永不 硬依赖。DrakeModsLibs 为每个插件提供脚手架：

• 德雷克模组库.兼容.兼容模块 / 兼容性优先级
• 兼容主机 / CompatHosts.GetOrCreate(ownerGuid, log) — 每个 Drake 插件 GUID 仅限一个主机

领域规则（结界通行、纸张拿取、物品架名称）保持不变 锁匠 / 重新命名内置的桥接是一种便利——并非承诺追踪每个上游 ward 的变更。请在这些仓库上报告问题；欢迎提交拉取请求和你自己的 SoftDependency 模块。LockSmith 还提供了 锁匠兼容接口 用于第三方网桥。

特工指南： .cursor/skills/drakemods-compat-host/SKILL.md。WardIsLove交给RenameIt： 文档/交接-wardislove-重命名它.md.

自定义数据API（其他模组）

读取并输出 物品掉落.物品数据.自定义数据 通过 自定义库接口:

• 获取自定义数据值(item, key) — 显示值（标签 → 真空值，文本 → 存储字符串）
• 获取自定义原始数据(item, key) — 原始字典值
• 转储物品自定义数据(item, options) — 所有按键，一个模组，一个按键，JSON 或整洁文本
• 导出全部龙族自定义数据(item) / 导出物品自定义数据给模组(item, modId)
• 注册模组自定义数据字段(modId, fields) — 在启动时注册你的模组按键

内置模组 ID： 德雷克重命名, 德雷克模组库, 龙之任务物品, 德雷克物品商店.

订阅 自定义事件.道具名称变更时 用于重命名日志记录；请使用 重命名 与 获取自定义数据值.

标签门（RenameIt集成）

其他模组与 仅库；重命名调用 可执行 / 重命名背包是否被抑制 而且你的标签永远不需要新版本。

// 软标记（管理员/VIP TagBypass 仍可能允许） CustomizeLibsAPI.BlockRename(item); // 硬标记（LockSmith 式安全保护——无管理员绕过） CustomizeLibsAPI.HardBlockRename(item); // 或 CustomizeLibsAPI.MarkImmutable(item); // 延迟处理：由所属模组负责（并非永不，也非硬性永不） CustomizeLibsAPI.RegisterDeferredEditAuthority( "LockSmith", CustomizeOperation.RenameName | CustomizeOperation.RenameDescription, (item, player, op) => /* 你的策略 */ true); CustomizeLibsAPI.DeferEditsTo( item, "LockSmith", CustomizeOperation.RenameName, suppressRenameInventoryUi: true); // 重新标记拥有物品栏菜单 // 启动时注册整个预制体族（无需逐个掉落物标记） CustomizeLibsAPI.RegisterItemExclusion( "masterkey", CustomizeOperation.RenameName, suppressRenameInventoryUi: true, hardLock: true); CustomizeLibsAPI.RegisterItemDeferral( "CryptKey", "LockSmith", CustomizeOperation.RenameName, suppressRenameInventoryUi: true); // 启动时注册自定义标签规则（RenameIt 会自动识别） CustomizeLibsAPI.RegisterTagBlockRule( "Drake_MyMod_LockBound", CustomizeOperation.RenameName, suppressRenameInventoryUi: true, hardLock: true);

软方块仍然遵守RenameIt的管理员/VIP权限 标签绕过 对于 可执行硬锁定、延迟授权，以及库存界面会抑制这些操作 不 自动应用绕过。直接 设置自定义名称 仍然适用于拥有模组的重命名界面。

堆叠合并策略

注册一条消费者策略，使用 注册堆叠合并策略. 然后库拥有库存合并：

• 分离堆叠已启用 / 分离堆叠硬锁 — 全局指纹合并
• 获取堆叠力量(物品) ——单项覆盖该 无视 那些全局变量（无TagBypass）

public DrakeStackForce GetStackForce(ItemDrop.ItemData? item) { // None = 跟随 SeparateStacks；ByIdentity = 始终按指纹；Never = 从不自动合并 return DrakeStackForce.None; }

当两件物品不一致时， 绝不 战胜 按身份 结束 无.

共享木材界面 + 标签宿主

想要改名的铬元素住在这个 德雷克模组库.用户界面:

• 德雷克伍德行动菜单, 德雷克确认面板 （默认尺寸300×178）， 德雷克文本提示面板
• 德雷克面板选项 (宽度, 最小高度, 最大高度, 按钮宽度, 按钮高度, 行间距）— 可选构造函数参数，用于 德雷克伍德行动菜单 和 确认面板面板大小根据内容在最小值和最大值之间调整；超出最大值的内容可滚动。若使用预设大小则省略此项。
• 德雷克界面输入 / 德雷克按钮音效
• 德雷克滑块带标签的浮点滑块（标签／轨道／数值文本），由布局驱动； 创建(父级, 位置, 标签, 最小值, 最大值, 初始值, 变更时, 格式, 宽度)用于ReskinIt的亮度增强。
• 德雷克数值步进器 − / 场地 / + 与 设置范围 / 可交互
• 德雷克标签宿主 —制作|升级风格 右上 标签页；仅 已注册 已安装的模组会有一个标签页。重命名基础优先级较低；功能模组占用默认优先级（例如按键锁定）。延迟/抑制会完全隐藏重命名。

跨模组旋钮：BepInEx 配置节 集成 (德雷克整合配置)—共享库存开启修饰键， 标签页优先级覆盖 (id=优先级;…）， 强制默认标签页ID, 禁用默认领取特性模组仅保留游戏玩法相关配置。

打开物品栏并显示提示（库）： 打开物品栏按键 + 右键点击打开 德雷克选项卡宿主 任何时候 可用 标签页已存在该项目（已考虑权限） 可用). 黄色互动台词：

• 1个可用标签页 → 该模组已本地化 获取提示短语 （例如 LockSmith“配置锁具工具”，RenameIt“编辑”）
• 2+ 可用 → 库已本地化 自定义 不要把这些短语放进 Libs —— 从每个功能模组注册 getter。仅当可用数量 ≥ 2 时才会显示标签栏。

重命名交接： 注册标签页 重命名 用你的本地化提示； 可用 必须尊重压制 和 标签绕过（管理员在开锁匠钥匙上可能获得usable=2）。一旦Libs消耗usable ≥ 1，便移除竞争的“for options”提示/打开一次。

物品外观（换皮工具）

• 最大色调增强 / 增益：模型和图标着色可能带有亮度增强（通道值高于1，最高可达4倍），保存为 RRGGBB*2.50用于ReskinIt的亮度滑块。紧身胸甲/腿甲（直接绘制在身体上）也会被染色。

安装

1. 安装 BepInEx 和 约顿巨人 （见Thunderstore依赖项）。
2. 安装 德雷克模组库.
3. 安装依赖它的功能模组（例如 龙骑重命名）。

队伍： 德雷克模组 · 联系方式：Drakethos（Discord / 邮箱见 RenameIt 页面）。

发布（GitHub Actions）

推标签 v{Version} 匹配 <版本> 在 模组.包.道具 奔跑 .github/workflows/release.yml:

1. 构建Thunderstore压缩包，并创建附带该压缩包的GitHub Release
2. 将该压缩包发布到 雷电站 (德雷克模组-德雷克模组库)
3. 将同一个压缩包发布到 海希姆 (瓦哈拉姆.赫克西姆.游戏雷神商店成功后)

需要仓库密钥：