[V2.6][非直连]把物品、配方、收集、升级和属性成长做成一套可配置的图鉴系统

这是一个什么 Mod？

图鉴卡牌 是一个为《七日杀》制作的客户端图鉴系统。玩家可以在游戏内打开图鉴窗口，查看不同分类下的卡牌，
           使用指定材料解锁卡牌，并继续投入材料升级卡牌等级。卡牌升级后会为角色提供对应的

被动属性加成。

它不是单纯的展示界面，而是一套可以长期养成的收集系统：探索、制作、搜集材料、解锁图鉴、升级图鉴，最终把这些进度转化为角色成长。

目前包含哪些内容？

玩家怎么使用？

1. 进入游戏后，点击 HUD 上的 图鉴 按钮。

2. 在左侧选择分类，也可以直接在搜索框输入关键词。

3. 点击卡牌查看介绍、获得方式、当前属性、下级属性和材料消耗。

4. 材料足够时，点击按钮进行解锁或升级。

5. 图鉴等级会保存到角色数据中，下次进入仍然保留。

服主 / 作者可配置内容

图鉴内容主要写在：            Mods/ZZ_CodexCards/Config/CodexCardsConfig.xml

• 可调整卡牌名称、图标、分类、排序。

• 可调整介绍文本和获得方式文本。

• 可调整解锁材料和升级材料。

• 可调整每一级提供的属性奖励。

• 可继续新增自己的卡牌，不限制只使用生成内容。

配置示意

<card id="medicalFirstAidKit" group="medical" name="急救包" icon="medicalFirstAidKit" maxLevel="5" sort="500">
    <description>常用的高级医疗物资，适合加入医疗类图鉴成长。</description>

    <obtain>
        <line>可通过制作、搜刮或商人获得。</line>
    </obtain>

    <unlock>
        <cost item="medicalFirstAidKit" display="急救包" count="1" />
    </unlock>

    <levels>
        <level value="1">
            <cost item="medicalFirstAidBandage" display="急救绷带" count="3" />
            <reward stat="HealthMax" operation="base_add" value="1" text="最大生命值 +1" />
        </level>
    </levels>
</card>

上面只是示意，实际配置可以按自己的服务器节奏调整材料数量和奖励强度。

安装方式

1. 将 ZZ_CodexCards 文件夹放入游戏的 Mods 目录。

2. 启动游戏。

3. 进入世界后，在 HUD 上点击“图鉴”按钮打开窗口。

4. 如果修改过 XML 配置，建议重启游戏后再测试。

兼容性说明

• 这是带 UI 的图鉴系统，主要面向客户端使用。

• 专用服务器进程检测到该 DLL 时会自动禁用功能，避免服务端加载 UI 逻辑。

• 如果服务器需要玩家使用图鉴功能，玩家客户端需要安装此 Mod。

• 窗口 XML 已做 HUD 入口兼容处理，但如果你的 UI 大改过，按钮位置可能需要手动调整。

注意事项

• 不要把奖励数值调得过高，否则很容易破坏服务器成长节奏。

• 删除或修改卡牌 ID 可能影响玩家已有图鉴进度，正式服修改前请先备份。

• 如果搜索不到目标，请先切到“全部”分类再搜；搜索默认只筛选当前分类。

• 如果自定义图标不显示，请检查物品图标名是否能被游戏图标图集识别。