更好的奖励

更好的奖励

创建和管理促销代码,以物品奖励玩家。非常适合活动、赠送和新手奖励。包含防滥用保护和实时统计。

经济

BetterRewards 模组

一个完整的 Minecraft 服务器促销码系统。服务器管理员可以创建自定义促销码,用物品奖励玩家,并可完全控制数量、使用次数限制和过期日期。


概述

BetterRewards 添加了一个直观的游戏内界面,用于兑换促销码。

非常适合:

  • 🎁 新手奖励 面向新玩家
  • 🎉 活动奖励 面向季节性活动和特殊场合
  • 🏆 成就奖励 面向赠送活动和比赛
  • 👥 社区福利 面向 Discord 成员、支持者等

主要功能

  • ✅ 简单的 GUI — 玩家使用 /promo 并输入促销码

  • ✅ 灵活的奖励 — 添加多个物品并自定义数量

  • ✅ 管理员控制 — 使用命令在游戏内创建和删除促销码

  • ✅ 使用次数限制 — 设置最大兑换次数或过期日期

  • ✅ 防滥用 — 每位玩家每个促销码只能领取一次

  • ✅ 统计信息 — 跟踪总兑换次数和唯一玩家数

  • ✅ 离线模式支持 — 专为离线模式服务器设计

  • ✅ 在线模式支持 — 在在线模式服务器上正常工作

  • ✅ 自动保存 — 兑换数据自动持久化

  • ✅ 多个 Minecraft 版本 — 查看可用文件以了解支持的版本

安装

服务器管理员

  1. 下载适用于你的 Minecraft 版本的 .jar 文件。
  2. 将其放入服务器的 mods/ 文件夹中。
  3. 启动服务器。
  4. 配置文件将自动生成。
  5. 可选:编辑 server_config/promocodemod-server.toml 以添加默认促销码。
  6. 修改配置后重启服务器。

请确保下载与你的 Minecraft 和模组加载器版本相匹配的 BetterRewards 构建版本。

玩家

BetterRewards 主要面向服务器设计。

根据服务器配置和 Minecraft/模组加载器版本的不同,客户端也可能需要安装该模组。请始终遵循服务器管理员提供的安装说明。


快速开始

创建你的第一个促销码

/promocode create WELCOME minecraft:diamond 5

玩家随后可以使用 /promo,输入 WELCOME,并获得 5 个钻石。

多个物品

/promocode create STARTER minecraft:diamond 3 minecraft:iron_sword 1 minecraft:bread 10 0 0

奖励:

  • 3 个钻石
  • 1 把铁剑
  • 10 个面包
  • 总使用次数不限
  • 无过期时间

限时活动促销码

/promocode createraw HALLOWEEN:minecraft:pumpkin,20;minecraft:orange_dye,10|50|0

该促销码:

  • 给予 20 个南瓜
  • 给予 10 个橙色染料
  • 允许总共兑换 50 次
  • 永不过期

删除促销码

/promocode delete WELCOME

命令参考

玩家命令

命令 用途
/promo 打开促销码兑换 GUI
/promocode help 显示可用命令

管理员命令

管理员命令需要 OP 等级 2+。

创建促销码

/promocode create <CODE> <item> <count> [maxUses] [expiryEpoch]

多个奖励:

/promocode create <CODE> <item1> <count1> <item2> <count2> [item3] [count3] [maxUses] [expiryEpoch]

原始格式:

/promocode createraw <CODE:item1,count1;item2,count2|maxUses|expiryEpoch>

删除促销码

/promocode delete <CODE>

帮助

/promocode help

参数

参数 值 描述
CODE 字母、数字、_、- 示例:WELCOME、SUMMER2026、EVENT_01
item Minecraft 物品 ID 格式:namespace:name
count 1–64 物品数量
maxUses 0–999 0 表示不限次数
expiryEpoch Unix 时间戳 0 表示促销码永不过期

物品 ID 示例

minecraft:diamond
minecraft:emerald
minecraft:golden_apple
minecraft:enchanted_golden_apple
minecraft:netherite_sword
minecraft:diamond_pickaxe
minecraft:diamond_axe
minecraft:iron_sword
minecraft:bread
minecraft:coal
minecraft:iron_ingot
minecraft:oak_log
minecraft:obsidian

根据你运行的 Minecraft 版本,可能还支持其他物品。


过期日期

过期日期使用 Unix 时间戳(秒)。

示例:

日期 Epoch
2025 年 1 月 1 日 1735689600
2025 年 7 月 1 日 1751328000
2026 年 1 月 1 日 1767225600

使用:

0

表示促销码永不过期。

你可以使用 Unix 时间戳转换器为其他日期生成时间戳。


配置

服务器配置位于:

server_config/promocodemod-server.toml

示例:

[[promocodes]]
codes = [
    "EARLY_EASTER:minecraft:diamond,5;minecraft:golden_apple,3|100|0",
    "FREESTART:minecraft:iron_sword,1;minecraft:bread,10|200|0",
    "DIAMONDS4ALL:minecraft:diamond,64|10|0"
]

格式

CODE:item1,count1;item2,count2|maxUses|expiryEpoch

更改配置后重启服务器。


工作原理

  1. 玩家使用 /promo 打开 GUI。
  2. 玩家输入促销码。
  3. 玩家点击 CONFIRM 或按 Enter。
  4. BetterRewards 验证促销码。
  5. 如果有效,将配置的奖励添加到玩家背包中。

如果背包已满,溢出的物品会掉落在玩家脚下。

无效兑换会显示相应的错误,例如:

  • 促销码无效
  • 促销码已兑换
  • 促销码已过期
  • 已达到最大使用次数

统计信息

BetterRewards 会跟踪促销码的使用情况。

GUI 可以显示如下信息:

已兑换

25 / 100

表示可用的 100 次兑换中已使用 25 次。

玩家

10

表示有 10 位唯一玩家兑换了奖励。


防滥用保护

每位玩家每个促销码 只能兑换一次。

兑换信息在服务器重启后仍然保留。

这有助于防止玩家重复领取相同的奖励。

离线模式服务器

BetterRewards 支持离线模式服务器。

但是,离线模式服务器无法提供与经过身份验证的在线模式服务器相同的身份保证。服务器管理员应监控可疑活动,并在必要时禁用或删除有问题的促销码。


数据存储

兑换数据自动保存到:

world_folder/promocodes_data.json

该文件包含以下信息:

  • 玩家已兑换的促销码
  • 每个促销码的总兑换次数
  • 通过命令创建的自定义促销码

不建议手动编辑。

如果你需要手动修改该文件,请先创建备份。


示例

欢迎奖励

/promocode create WELCOME minecraft:diamond 5 minecraft:iron_sword 1 minecraft:bread 20 0 0

奖励:

  • 5 个钻石
  • 1 把铁剑
  • 20 个面包
  • 不限使用次数
  • 无过期时间

限时周年活动

/promocode create ANNIVERSARY minecraft:golden_apple 3 100 1767225600

奖励 3 个金苹果,总共最多兑换 100 次。

复杂奖励

/promocode createraw STARTER:minecraft:diamond,10;minecraft:emerald,5;minecraft:enchanted_golden_apple,2|50|0

奖励:

  • 10 个钻石
  • 5 个绿宝石
  • 2 个附魔金苹果
  • 最多兑换 50 次
  • 无过期时间

季节性赠送

/promocode create XMAS minecraft:red_concrete 20 minecraft:green_concrete 20 minecraft:gold_block 5 0 0

故障排查

"Invalid item"(物品无效)

检查精确的 Minecraft 物品 ID。

示例:

minecraft:acacia_log

而不是:

acacia log

物品的可用性也可能取决于你的 Minecraft 版本。

"Code already exists"(促销码已存在)

先删除现有的促销码:

/promocode delete OLDCODE

然后重新创建。

玩家无法兑换有效的促销码

检查是否:

  • 该玩家已经兑换过该促销码
  • 促销码已过期
  • 已达到最大兑换次数

物品未出现

检查玩家的背包。

如果背包已满,溢出的奖励会掉落在玩家脚下。

编辑配置后服务器报错

检查:

promocodemod-server.toml

是否存在语法错误,并验证所有配置的物品 ID 对于所使用的 Minecraft 版本是否有效。


兼容性

  • Minecraft: 支持多个版本
  • 模组加载器: 查看各个下载/文件以了解兼容性
  • 服务器: 支持
  • 客户端: 取决于所选版本/构建
  • 离线模式: 支持
  • 在线模式: 支持

请始终下载与你的确切 Minecraft 版本和模组加载器 相匹配的文件。


已知限制

  • 通过标准 create 命令最多只能设置 3 个奖励物品
  • 使用 createraw 进行更复杂的奖励配置
  • 每个奖励条目的物品数量限制为 1–64
  • 管理员促销码通过命令或配置文件创建
  • 促销码不区分大小写,并在内部以大写形式存储

许可证

不允许未经署名进行再分发。