
代码声明
一个用于Minecraft 1.21.1的服务端Fabric模组,允许玩家兑换代码以获取奖励。 无需客户端模组。无需数据库。
查看大图概述
CodeClaim 让服务器管理员可以创建可兑换的代码,通过任意服务器命令奖励玩家——给予物品、宝可梦、广播标题等。每位玩家每个代码只能兑换一次,每个代码可以设置全局使用次数上限。所有数据都存储在简单的 JSON 文件中,无需外部数据库设置。
特性
- 任何玩家都可以使用
/claim,无需管理员权限 - 每位玩家每个代码只能兑换一次,通过 UUID 强制执行
- 通过
max_uses设置每个代码的全局使用次数上限 - 设置
max_uses: -1表示无限兑换 - 使用
%player%作为占位符执行任意服务器命令作为奖励 - 所有数据自动保存到本地 JSON 文件
- 无需重启服务器即可热重载配置和数据
- 仅服务端——玩家无需安装任何内容
要求
- Minecraft 1.21.1
- Fabric Loader 0.15.0 或更高版本
- Fabric API 0.102.0+1.21.1
- Java 21
安装
- 从 Releases 页面下载
codeclaim-1.0.0.jar - 下载所有必需的依赖项:Fabric Language Kotlin、Fabric API
- 将文件放入服务器的
mods/文件夹中,与 Fabric API 放在一起 - 启动服务器——配置文件将自动生成于
config/codeclaim.json - 编辑配置以定义你的代码和奖励
- 使用
/claimadmin reload应用更改,无需重启
命令
| 命令 | 权限 | 描述 |
|---|---|---|
/claim <code> |
所有玩家 | 兑换代码并领取奖励 |
/claimadmin reload |
OP 等级 2 | 从磁盘重载配置和玩家数据 |
/claimadmin info <code> |
OP 等级 2 | 查看代码的使用统计信息 |
配置
配置文件位置:config/codeclaim.json
{
"messages": {
"invalid_code": "&cCode '&4{code}&c' does not exist!",
"already_claimed": "&cYou have already redeemed '&4{code}&c'!",
"max_uses": "&cCode '&4{code}&c' has reached its usage limit!",
"success": "&aSuccessfully redeemed code '&2{code}&a'!",
"reloaded": "&aCodeClaim config reloaded!"
},
"codes": {
"WELCOME2024": {
"max_uses": -1,
"commands": [
"give %player% minecraft:bread 16"
]
},
"SHINY_EVENT": {
"max_uses": 100,
"commands": [
"givepokemonother %player% moltres form=galarian",
"title @a title {\"text\":\"A player claimed SHINY_EVENT!\",\"color\":\"gold\"}"
]
},
"GRAND_PRIZE": {
"max_uses": 1,
"commands": [
"give %player% minecraft:netherite_ingot 3",
"say %player% claimed the Grand Prize!"
]
}
}
}
字段参考
| 字段 | 描述 |
|---|---|
max_uses |
所有玩家的最大总兑换次数。-1 表示无限。 |
commands |
代码成功兑换时执行的服务器命令列表。 |
%player% |
运行时替换为兑换玩家用户名的占位符。 |
{code} |
在消息字符串中替换为所输入代码的占位符。 |
&a, &c |
所有消息字段均支持的标准 Minecraft 颜色代码。 |
数据存储
玩家兑换历史记录自动保存到:
data/codeclaim_data.json
此文件记录了哪些玩家兑换了哪些代码,以及每个代码的总使用次数。请定期备份此文件,以便在服务器迁移时保留兑换历史记录。
从源码构建
要求:JDK 21、Gradle 8.8 或更高版本
git clone https://github.com/YOUR_USERNAME/codeclaim
cd codeclaim
# Linux / macOS
./gradlew build
# Windows
gradlew.bat build
编译后的 jar 将输出到 build/libs/codeclaim-1.0.0.jar。
兼容性
| 模组 | 状态 |
|---|---|
| Cobblemon | 兼容——使用 givepokemonother %player% |
| LuckPerms | 兼容 |
| 任何服务端命令模组 | 兼容 |
许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE。
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。