GiftcodeX

插件

· 作者 ihqqq_

高级赠送码系统,支持 GUI 编辑器和数据库

0 本站下载 0 关注 更新于 5 个月前

最新 1.5 · 26.1.2 · Folia / Paper

一键开服(送7天)
minecraft_title

GiftcodeX

适用于 Minecraft 服务器的先进礼包码管理插件 —— 支持 GUI 编辑器、PlaceholderAPI 兼容、MySQL/H2 数据库以及 Folia。

2026-04-05_13 55 53 2026-04-05_13 57 01

目录


需求

需求项 版本
Java 21+
Paper / Folia 1.21+
PlaceholderAPI 2.11+ (可选)
ViaVersion 最新版 (可选)

注意: 不支持 Spigot。你必须使用 Paper 或 Folia。

ViaVersion: 可选安装 ViaVersion 以支持旧版客户端(低于 1.21.6)的玩家加入服务器。插件会自动检测旧版客户端,并将输入方式从对话框切换为聊天栏模式。


安装

  1. 从 Releases 下载最新的 GiftcodeX-x.x.jar。
  2. 将 .jar 文件放入服务器的 plugins/ 文件夹中。
  3. 启动或重启服务器。
  4. 配置文件将在 plugins/GiftcodeX/ 目录下自动生成。
  5. (可选) 编辑 config.yml 和 messages.yml,然后运行 /gcx reload。

命令

所有管理员命令均需 giftcodex.admin 权限。玩家使用 /redeem 领取礼包码。

管理员 — /giftcodex (别名: /gcx, /gc)

命令 描述
/gcx help 显示命令帮助
/gcx create <code> [-g] 创建礼包码。添加 -g 可立即打开 GUI 编辑器
/gcx delete <code> 永久删除一个礼包码并清除所有玩家的使用记录
/gcx enable <code> 启用已禁用的礼包码
/gcx disable <code> 禁用一个礼包码而不将其删除
/gcx gui 列出所有礼包码(对玩家打开 GUI,对控制台显示文本列表)
/gcx edit <code> 打开某个礼包码的 GUI 设置编辑器
/gcx items <code> 打开某个礼包码的物品奖励编辑器
/gcx assign <code> <player> 直接将礼包码奖励发放给指定玩家
/gcx setperm <code> <perm|none> 设置或清除使用该礼包码所需的权限
/gcx info <code> 打印有关该礼包码的详细信息
/gcx random <prefix> [amount] [-c <template>] 批量生成随机礼包码。使用 -c <template> 可从现有礼包码复制设置
/gcx reload 无需重启即可重新加载 config.yml、messages.yml 和 codes.yml

玩家

命令 描述
/redeem <code> 兑换礼包码

权限

权限 默认值 描述
giftcodex.admin OP 完全访问所有管理员命令
giftcodex.player Everyone 允许使用 /redeem
giftcodex.vip OP 示例:用于限制 VIP 专属礼包码的自定义权限

配置

config.yml

# 数据库类型:H2(内置,无需设置)或 MYSQL
database:
  type: H2
  mysql:
    host: localhost
    port: 3306
    database: giftcodex
    username: root
    password: ""

# 检查 GitHub 上的新版本(会在 OP 加入时通知)
check-update: true

# GUI 设置
gui:
  reward-color: "&a"   # 应用于奖励消息的颜色前缀

# 创建新礼包码时应用的默认值
defaults:
  expiry: "2099-12-31T23:59:59"   # 留空表示永不过期
  max-uses: 100                    # 全局使用次数限制
  player-max-uses: 1               # 每位玩家的使用限制(-1 = 无限制)
  max-uses-per-ip: 1               # 每个 IP 的限制(0 = 禁用)
  required-playtime: 0             # 所需游戏时长(分钟)(0 = 无要求)

messages.yml

所有消息均支持 & 颜色代码。infinity-symbol 字段控制无限/永不过期值的显示内容(默认为 ∞)。

prefix: "&8[&bGiftcodeX&8] "

# 用于显示无限或永不过期值的符号
infinity-symbol: "∞"

redeemed:            "&a礼包码兑换成功!"
invalid-code:        "&c该礼包码不存在。"
code-disabled:       "&c该礼包码当前已被禁用。"
code-expired:        "&c该礼包码已过期。"
max-uses-reached:    "&c该礼包码已达到全局使用上限。"
already-redeemed:    "&c你已达到该礼包码的最大使用次数。"
ip-limit-reached:    "&c你的 IP 地址使用该礼包码的次数过多。"
not-enough-playtime: "&c你需要至少 &e{required} &c的游戏时长才能使用此礼包码。&7(当前拥有: &e{current}&7)"
no-permission:       "&c你没有权限使用此礼包码。"

编辑 messages.yml 后请运行 /gcx reload —— 无需重启服务器。

codes.yml

礼包码由系统自动存储和管理。你也可以手动编辑此文件,然后运行 /gcx reload。

SUMMER24:
  commands:
    - "give %player% diamond 3"
    - "give %player% golden_apple 1"
  messages:
    - "&aYou received &e3 Diamonds &aand a &eGolden Apple&a!"
  max-uses: 1000               # 剩余的全局使用次数(设置为 999999999 即为无限)
  expiry: "2024-08-31T23:59:59"
  enabled: true
  player-max-uses: 1           # -1 = 每个玩家无限次
  max-uses-per-ip: 2           # 0 = 禁用
  required-playtime:           # 完整时长模型(从纯整数自动迁移)
    years: 0
    months: 0
    weeks: 0
    days: 0
    hours: 0
    minutes: 0
    seconds: 0
    milliseconds: 0
  permission: ""               # 留空表示无需权限
  items: []                    # 通过 /gcx items <code> 设置物品奖励

字段参考:

字段 描述
commands 兑换时执行的控制台命令。使用 %player% 作为玩家名称占位符
messages 发送给玩家的提示信息。支持 & 颜色代码
max-uses 剩余全局使用次数。设置为 999999999 即视为无限
expiry ISO-8601 格式的过期时间 (yyyy-MM-dd'T'HH:mm:ss)。留空表示永不过期
enabled true / false
player-max-uses 单个玩家的兑换上限。-1 = 无限
max-uses-per-ip 单个 IP 的兑换上限。0 = 禁用
required-playtime 包含以下字段的时长模型:years、months、weeks、days、hours、minutes、seconds、milliseconds。旧的纯整数值(分钟数)将在重载时自动迁移
permission 所需的权限节点。留空表示无要求
items ItemStack 序列化的物品奖励 — 通过 /gcx items <code> 管理

PlaceholderAPI

安装 PlaceholderAPI 即可在服务器任意位置使用以下占位符。

占位符 描述
%giftcodex_total_codes% 已注册礼包码的总数
%giftcodex_player_totalused% 该玩家已兑换的礼包码数量
%giftcodex_code_exists_<code>% true / false — 该礼包码是否存在
%giftcodex_code_enabled_<code>% true / false — 该礼包码是否启用
%giftcodex_code_expired_<code>% true / false — 该礼包码是否已过期
%giftcodex_code_maxuses_<code>% 剩余全局使用次数
%giftcodex_code_used_<code>% 该礼包码被兑换的总次数(所有玩家)
%giftcodex_code_expiry_<code>% 过期日期字符串,或配置的无限符号
%giftcodex_code_permission_<code>% 所需权限,或 None
%giftcodex_code_playtime_<code>% 以人类可读格式显示的所需游戏时长(例如 1d 2h 30m)
%giftcodex_code_playtime_minutes_<code>% 转换为总分钟数的所需游戏时长
%giftcodex_code_playtime_ms_<code>% 以毫秒为单位的所需游戏时长
%giftcodex_code_playeruses_<code>% 该玩家 兑换此礼包码的次数
%giftcodex_code_canuseip_<code>% true / false — 该玩家的 IP 是否仍在限制范围内
%giftcodex_code_playerlimit_<code>% 单个玩家的使用上限,若为无限则显示无限符号
%giftcodex_code_iplimit_<code>% 单个 IP 的使用上限,若已禁用则显示无限符号

ViaVersion 支持

当安装 ViaVersion 时,GiftcodeX 会自动检测每位管理员客户端的版本:

  • 1.21.6+ 客户端 使用原生的 Dialog 输入方式(带有标签字段的弹出式表单)。
  • 旧版客户端(低于 1.21.6) 将自动回退到 聊天输入 模式。

GUI 编辑器会在每个物品的 lore(描述)中显示提示,指明当前查看者处于哪种输入模式(dialog input 或 chat input)。无需进行任何配置。


作者

Name ihqqq
Facebook facebook.com/ihqqqq

支持

  • 问题与错误报告: GitHub Issues
  • Discord 服务器: discord.gg/YQtCC7BV

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源