兑换

兑换 是一个可配置的奖励兑换系统，由 专为英灵神殿专用服务器打造.

功能

• 服务器权威系统 — 兑换数据及验证均在服务器端处理。
• 基于代码的奖励系统 — 玩家可以使用唯一代码兑换物品包。

用途

1. 模组首次启动时，会自动创建 兑换数据 内部文件夹 BepInEx/配置，该系统存储系统使用的所有配置和数据文件。
2. 管理员在以下位置定义物品包 packages.yml，它们作为所有可用奖励的参考依据。
3. 新代码被手动添加到 code.insert.yml当此文件保存时，系统会验证条目并自动将有效代码移至 code.active.yml.
4. 管理员随后必须通过任意方式向玩家提供有效代码，例如活动奖励、购买奖励、手动发放或私信。
5. 中的有效代码 code.active.yml 可由玩家使用聊天命令兑换 /兑换 <CODE>.
6. 当兑换码成功兑换后，服务器会将配置的物品直接发送到玩家的背包中。
7. 所使用的代码随后将从 代码.激活.yml 并记录于 已领取的兑换码，确保所有兑换的完整历史记录和可追溯性。

文件示例

示例包（包)

礼包：
- 标识：新手礼包
  物品：
  - 预制体：金币，数量：500
  - 预制体：木材，数量：100
  - 预制体：石头，数量：100
- 标识：VIP礼包
  物品：
  - 预制体：金币，数量：5000
  - 预制体：青铜，数量：20
  - 预制体：铁剑，数量：1，品质：3

示例代码（code.insert.yml 或 code.active.yml)

兑换码：
- 兑换码：ABCD-1234-START 礼包：starter
- 兑换码：ABCD-2345-START 礼包：starter
- 兑换码：ABCD-3456-START 礼包：starter
- 兑换码：VIP-ONLY-9999 礼包：vip_bundle
- 兑换码：VIP-ONLY-8888 礼包：vip_bundle
- 兑换码：VIP-ONLY-7777 礼包：vip_bundle

指令

安装（手动）

1. 放置 Redeem.dll 归档到 BepInEx\plugins\ 文件夹。
2. 首次启动时，模组会自动创建配置文件夹 仅在服务器上.