⭐ StarCodes
StarCodes 是一款专为 Paper 和 Folia 服务器设计的轻量级兑换码插件,支持一次性代码、可配置的后台奖励以及游戏内管理 GUI。
如果发现任何 Bug,请在 Discord 上联系我:pupillaviolaalt
⭐ StarCodes
为现代 Minecraft 服务器提供简单、整洁且轻量的兑换码系统。
StarCodes 允许玩家通过简单的命令兑换自定义服务器代码,例如:
/code <code>
当玩家兑换代码时,StarCodes 会为该玩家执行配置好的控制台奖励命令。
本插件旨在帮助服务器管理员无需搭建数据库或复杂的外部服务,即可快速建立用于活动、促销、创作者推广、补偿奖励、首发奖励和社区抽奖的简易代码系统。
✨ StarCodes 能做什么?
StarCodes 为你的服务器添加了一个可配置的兑换码系统。
你可以将其用于:
- ? 首发奖励
- ? 活动代码
- ? TikTok、YouTube、Discord 或社区推广活动
- ? 创作者专属代码
- ?️ Bug 补偿奖励
- ⭐ 限时促销
- ? 箱子钥匙、货币、排名、权限或任何基于命令的奖励
✅ 为什么选择 StarCodes?
StarCodes 致力于保持 简单、易读和实用。
没有臃肿的系统。
不需要数据库。
没有不必要的设置。
无需远程服务。
只有代码、奖励、限制和一个干净的管理 GUI。
如果你希望快速为玩家提供一个可兑换的代码,例如:
- /code launch
- /code discord
- /code tiktok
- /code sorry
- /code creatorname
并通过现有插件的命令给予他们奖励,那么它非常有用。
✨ 功能特性
- ⭐ 简单的 /code <code> 命令
- ? 可配置的奖励命令
- ? 每位玩家仅限使用一次
- ? 可选的全局最大使用次数限制
- ✅ 启用或禁用代码
- ?️ 清晰的游戏内管理 GUI
- ? 可编辑的显示名称
- ? 奖励命令内部占位符
- ⚡ 轻量级本地文件存储
- ? MiniMessage 风格的可配置消息
- ? 支持重载
- ? 支持 Paper 和 Folia
- ?️ 不依赖 NMS
- ? 无需数据库
- ? 无遥测数据或隐藏远程上传
? 玩家命令
/code <code>
兑换已配置的代码。
?️ 管理员命令
/starcodes
打开管理 GUI。
/starcodes reload
重载插件配置文件和代码文件。
别名
? 权限
starcodes.admin
允许访问管理 GUI 和管理员命令。
玩家使用以下命令不需要任何权限:
/code <code>
? 奖励命令占位符
StarCodes 支持在奖励命令中使用内部占位符。
可用占位符
%player%
正在兑换代码的玩家名称。
示例
commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
- "lp user %player% permission set event.reward true"
这些命令将从控制台执行。
⚙️ 示例代码配置
示例 codes.yml:
codes:
welcome:
- display-name: "Welcome Code"
- enabled: true
- max-global-uses: -1
- commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
tiktok:
- display-name: "TikTok Reward"
- enabled: true
- max-global-uses: 500
- commands:
- "eco give %player% 10000"
- "crate key give %player% epic 1"
- "say %player% redeemed the TikTok code!"
? 配置选项
display-name
display-name: "Welcome Code"
在管理 GUI 中显示的易读名称。
enabled
enabled: true
控制该代码当前是否可被兑换。
设置为:
enabled: false
以临时禁用该代码。
max-global-uses
max-global-uses: <number>
控制该代码在全局范围内总共可以被兑换的次数。
使用:
max-global-uses: -1
表示全局使用次数无限制。
使用数字如:
max-global-uses: 100
将代码限制为最多 100 次总兑换。
?️ 管理 GUI
StarCodes 包含一个游戏内的管理 GUI,便于更轻松地管理代码。
使用以下命令打开:
/starcodes
从 GUI 中,你可以直接管理代码,而无需手动编辑每个值。
GUI 允许你:
- ➕ 创建代码
- ❌ 删除代码
- ✅ 启用或禁用代码
- ? 编辑显示名称
- ? 编辑全局最大使用次数
- ? 添加奖励命令
- ? 移除奖励命令
- ? 重载插件文件
? 安装方法
- 下载插件 jar 文件。
- 将 jar 文件放入服务器的 plugins 文件夹中。
- 重启服务器。
- 根据需要编辑生成的文件。
- 使用 /starcodes 通过管理 GUI 管理代码。
- 给玩家代码,让他们使用 /code <code> 进行兑换。
✅ 兼容性
StarCodes 专为现代服务器环境设计。
- ✅ Paper
- ✅ Folia
- ✅ Minecraft 1.21+
- ✅ 不依赖 NMS
- ✅ 无需数据库
- ✅ 基于控制台命令的奖励机制
? 隐私与数据
StarCodes 使用本地服务器文件来存储代码和兑换数据。
StarCodes 不会有意将玩家数据上传到任何远程服务器。
存储的数据仅限于代码兑换跟踪所需的内容,例如哪些玩家已经兑换了代码,以及某个代码在全局范围内已被使用了多少次。
❓ 常见问题
玩家可以重复兑换同一个代码吗?
不可以。每位玩家对每个代码只能兑换一次。
我可以限制总共多少名玩家可以兑换一个代码吗?
可以。
使用:
max-global-uses: 100
设置为:
max-global-uses: -1
以实现全局使用次数无限制。
奖励命令是以控制台身份执行的吗?
是的。所有奖励命令均从控制台执行。
StarCodes 需要数据库吗?
不需要。StarCodes 使用本地文件。
StarCodes 支持 Folia 吗?
支持。StarCodes 专为同时支持 Paper 和 Folia 而设计。
我可以使用其他插件的奖励吗?
可以。如果另一个插件有控制台命令,你可以将其用作 StarCodes 奖励命令。
示例
命令:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
- "lp user %player% permission set example.permission true"
? 作者
由 PupillaViola 制作。
⭐ StarCodes
StarCodes is a lightweight redeem-code plugin for Paper and Folia servers with one-time codes, configurable console rewards and an in-game admin GUI.
If you find any bug, contact me on Discord: pupillaviolaalt
⭐ StarCodes
Simple, clean and lightweight redeem codes for modern Minecraft servers.
StarCodes lets players redeem custom server codes with a simple command, for example:
/code <code>
When a player redeems a code, StarCodes executes the configured console reward commands for that player.
It is designed for server owners who want a fast and easy code system for events, promotions, creator campaigns, compensation rewards, launch rewards, and community giveaways without setting up a database or a complicated external service.
✨ What does StarCodes do?
StarCodes adds a configurable redeem-code system to your server.
You can use it for:
- ? Launch rewards
- ? Event codes
- ? TikTok, YouTube, Discord or community campaigns
- ? Creator codes
- ?️ Bug compensation rewards
- ⭐ Limited-time promotions
- ? Crate keys, money, ranks, permissions or any command-based reward
✅ Why use StarCodes?
StarCodes is made to be simple, readable and practical.
No bloated systems.
No required database.
No unnecessary setup.
No remote service.
Just codes, rewards, limits and a clean admin GUI.
It is useful if you want to quickly give your players a redeemable code like:
- /code launch
- /code discord
- /code tiktok
- /code sorry
- /code creatorname
and reward them with commands from your existing plugins.
✨ Features
- ⭐ Simple /code <code> command
- ? Configurable reward commands
- ? One-time use per player
- ? Optional global max uses per code
- ✅ Enable or disable codes
- ?️ Clean in-game admin GUI
- ? Editable display names
- ? Internal placeholders for reward commands
- ⚡ Lightweight local file storage
- ? MiniMessage-style configurable messages
- ? Reload support
- ? Paper and Folia support
- ?️ No NMS
- ? No database required
- ? No telemetry or hidden remote uploads
? Player Command
/code <code>
Redeems a configured code.
?️ Admin Commands
/starcodes
Opens the admin GUI.
/starcodes reload
Reloads the plugin configuration and code files.
Aliases
? Permissions
starcodes.admin
Allows access to the admin GUI and admin commands.
Players do not need any permission to use:
/code <code>
? Reward Command Placeholders
StarCodes supports internal placeholders inside reward commands.
Available placeholders
%player%
The name of the player redeeming the code.
Example
commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
- "lp user %player% permission set event.reward true"
These commands are executed from the console.
⚙️ Example Code Configuration
Example codes.yml:
codes:
welcome:
- display-name: "Welcome Code"
- enabled: true
- max-global-uses: -1
- commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
tiktok:
- display-name: "TikTok Reward"
- enabled: true
- max-global-uses: 500
- commands:
- "eco give %player% 10000"
- "crate key give %player% epic 1"
- "say %player% redeemed the TikTok code!"
? Configuration Options
display-name
display-name: "Welcome Code"
The readable name shown in the admin GUI.
enabled
enabled: true
Controls whether the code can currently be redeemed.
Set it to:
enabled: false
to temporarily disable the code.
max-global-uses
max-global-uses: <number>
Controls how many total times the code can be redeemed globally.
Use:
max-global-uses: -1
for unlimited global uses.
Use a number like:
max-global-uses: 100
to limit the code to 100 total redemptions.
?️ Admin GUI
StarCodes includes an in-game admin GUI for easier code management.
Open it with:
/starcodes
From the GUI you can manage your codes without manually editing every value.
The GUI allows you to:
- ➕ Create codes
- ❌ Delete codes
- ✅ Enable or disable codes
- ? Edit display names
- ? Edit global max uses
- ? Add reward commands
- ? Remove reward commands
- ? Reload plugin files
? Installation
- Download the plugin jar.
- Put the jar inside your server plugins folder.
- Restart the server.
- Edit the generated files if needed.
- Use /starcodes to manage codes from the admin GUI.
- Give players codes to redeem with /code <code>.
✅ Compatibility
StarCodes is designed for modern server environments.
- ✅ Paper
- ✅ Folia
- ✅ Minecraft 1.21+
- ✅ No NMS
- ✅ No required database
- ✅ Console-command based rewards
? Privacy and Data
StarCodes uses local server files to store code and redemption data.
StarCodes does not intentionally upload player data to any remote server.
Stored data is limited to what is needed for code redemption tracking, such as which players have already redeemed a code and how many times a code has been used globally.
❓ FAQ
Can a player redeem the same code twice?
No. Each player can redeem each code only once.
Can I limit how many total players can redeem a code?
Yes.
Use:
max-global-uses: 100
Set it to:
max-global-uses: -1
for unlimited global uses.
Are reward commands executed as console?
Yes. All reward commands are executed from console.
Does StarCodes need a database?
No. StarCodes uses local files.
Does StarCodes support Folia?
Yes. StarCodes is designed to support both Paper and Folia.
Can I use rewards from other plugins?
Yes. If another plugin has a console command, you can use it as a StarCodes reward command.
Examples
commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
- "lp user %player% permission set example.permission true"
? Author
Made by PupillaViola.
评论 0
登录后参与评分
还没有评论,来抢沙发吧