兑换+

兑换+

兑换专属代码，赢取游戏内奖励！管理员可通过简洁的用户界面创建和管理代码，并即时记录至Discord，让您的社区随时掌握最新动态。

实用

兑换+预览查看大图

<Redeem+>

支持服务器 – https://discord.gg/DRxwt8Qg2W

Redeem+ 让服务器管理者能够通过可兑换代码运行抽奖、新手奖励、活动与推广活动。玩家通过游戏内界面输入代码，管理员则通过管理界面管理代码、限制、奖励、控制台命令和 Discord 日志记录。

每个代码都支持可配置的使用次数限制、每位玩家一次兑换、物品奖励、可选的控制台命令（以服务器身份执行），以及每次兑换的自动 Discord Webhook 日志。所有数据持久化保存为 JSON 文件，使 Redeem+ 在重启和更新后安全可靠。

功能

核心

  • 代码兑换系统 – 玩家通过简洁的游戏内界面兑换代码
  • 管理员代码管理 – 通过管理界面创建、编辑和删除代码
  • 使用次数限制 – 将代码设置为单次使用、限制次数使用或无限次使用
  • 每位玩家一次 – 每位玩家只能兑换每个代码一次
  • 物品奖励 – 给予任意 Hytale 物品，并配置数量
  • 控制台命令 – 兑换时可选执行的控制台命令
  • 持久化存储 – 代码、使用次数和玩家追踪数据保存为 JSON
  • Discord 日志记录 – 可选的 Webhook 日志记录已兑换的代码

玩家

  • 简单的兑换界面 – 输入代码并立即领取奖励
  • 清晰的反馈 – 针对所有兑换结果的成功与错误消息

管理员

  • 管理界面 – 无需编辑文件即可管理代码
  • 更新安全 – 编辑代码会保留已有的兑换次数
  • 基于权限的访问 – 管理功能受权限节点保护

命令

/redeem 打开兑换界面 权限：无

/redeem admin 打开管理员代码管理器界面 权限：redeem.admin

权限

redeem.admin 访问管理员界面及创建、编辑或删除兑换代码所需权限。

玩家用法

  1. 运行 /redeem
  2. 输入兑换代码（不区分大小写）
  3. 点击 REDEEM
  4. 奖励将添加到你的背包
  5. 如果代码无效或不可用，将显示错误消息

管理员用法 – 代码管理

运行 /redeem admin

创建或更新一个代码

代码 玩家必须输入的精确字符串（存储为大写）

最大兑换次数 代码总共可被兑换的次数 输入 0 表示无限次

奖励 分号分隔格式 物品ID:数量; 物品ID2:数量

示例 Ingredient_Bar_Adamantite:1; Ingredient_Bar_Mithril:2 Ingredient_Bar_Adamantite:1; Ingredient_Bar_Mithril:2; Ingredient_Bar_Cobalt:3

如果代码已存在，它将被更新，同时保留现有的兑换次数和玩家数据。

控制台命令（可选）

管理员可以定义在代码被兑换时执行的控制台命令。

  • 命令以分号分隔
  • 命令以控制台身份执行（管理员权限）

占位符 @p 或 @s – 玩家名称 <uuid> – 玩家 UUID

示例 money give @p 1000; say @p redeemed a code! say @p redeemed a code FOR THE FIRST TIME!

现有代码列表

管理员界面显示

  • 代码名称
  • 当前使用次数
  • 最大使用次数
  • 兑换该代码的独立玩家数量

示例 WELCOME — 3/10 次使用 (3 位玩家)

错误消息

玩家

  • 无效或未知的代码
  • 你已经兑换过此代码
  • 此代码已达到兑换次数限制
  • 请输入一个代码
  • 代码已兑换，但背包已满

管理员

  • 你没有使用管理员兑换的权限
  • 输入一个代码
  • 最大兑换次数必须是一个数字（0 = 无限）
  • 至少添加一个奖励或控制台命令

数据存储

代码存储在 /Hyronix_RedeemPlus/codes.json

配置存储在 /Hyronix_RedeemPlus/config.json

当代码被修改或兑换时，文件会自动创建和更新。

Discord Webhook 日志记录

Redeem+ 可以将兑换日志发送到 Discord。

在你的 /Hyronix_RedeemPlus/config.json 文件中配置 Webhook URL。

示例 { "discordWebhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL" }

记录的信息

  • 玩家名称
  • 已兑换的代码
  • 获得的奖励

如果 Webhook URL 为空或无效，兑换功能仍会正常运行。

指南

  • 使用清晰、易于记忆的代码
  • 避免使用空格（代码会统一转换为大写）
  • 使用有效的 Hytale 物品 ID 作为奖励
  • 设置合理的兑换次数限制
  • 每位玩家只能兑换每个代码一次
  • 更新代码不会重置已有的使用数据

分发说明： 未经明确标注 Hyronix Studios 版权及模组名称，不得将本模组分发或捆绑于第三方设置中。否则，禁止分发。