StarCodes

插件

· 作者 PupillaViola

这是一个插件,允许你创建星码(Starcode)。玩家只能兑换一次(可配置)的星码会执行一个命令,并且完全可定制,还可以使用图形用户界面(GUI)。

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

最新 1.0.0 · 1.21.10 · Folia

一键开服(送7天)

⭐ 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

重载插件配置文件和代码文件。

别名

  • /codeadmin
  • /scodes

? 权限

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 允许你:

  • ➕ 创建代码
  • ❌ 删除代码
  • ✅ 启用或禁用代码
  • ? 编辑显示名称
  • ? 编辑全局最大使用次数
  • ? 添加奖励命令
  • ? 移除奖励命令
  • ? 重载插件文件

? 安装方法

  1. 下载插件 jar 文件。
  2. 将 jar 文件放入服务器的 plugins 文件夹中。
  3. 重启服务器。
  4. 根据需要编辑生成的文件。
  5. 使用 /starcodes 通过管理 GUI 管理代码。
  6. 给玩家代码,让他们使用 /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 制作。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源