MPromoCodes

插件

· 作者 Majales

简单、强大且兼容 Folia 的 Minecraft 服务器促销码系统

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

最新 1.8 · 26.2 · Folia / Paper

一键开服(送7天)

MPromoCodes

适用于 Minecraft 服务器的简单、强大且兼容 Folia 的促销码系统

MPromoCodes 是一个轻量级但灵活的促销码插件,允许玩家通过一个简单的命令兑换奖励代码。 它支持完全可配置的奖励、条件、Discord Webhook 日志、独立的促销码文件以及多种存储类型,包括 YAML、SQLite 和 MySQL。

所有奖励均在 Bukkit、Spigot、Paper、Purpur 和 Folia 服务器上安全执行。


✨ 功能特性

  • 使用 /code 兑换促销码
  • 促销码存储在单独的 codes.yml 文件中
  • 完全可配置的奖励
  • 游戏内管理菜单
  • 支持 控制台 和 玩家 命令执行
  • 使用 message: 内置消息系统
  • 成功兑换后可选显示 标题 和 副标题 消息
  • 每位玩家 独立的代码使用记录
  • 一次性代码和多次使用代码
  • 全局使用限制
  • 每位玩家的使用限制
  • 代码冷却支持
  • 针对多种不同用例的 20+ 种条件
  • 支持 开始日期 和 过期日期 的代码
  • 基于权限 的代码访问控制
  • 可配置代码输入规则
  • 支持 不区分大小写 的代码
  • 可配置代码输入的 最小 和 最大 长度
  • 对失败兑换尝试的 防垃圾邮件保护
  • Discord Webhook 集成
  • 成功和失败的兑换 Webhook 日志
  • /codes webhook test 命令
  • 存储支持:
    • YAML
    • SQLite
    • MySQL
  • 自动将旧版 config.yml 中的代码迁移到 codes.yml
  • 自动将 YAML 已兑换数据迁移到 SQL 存储
  • 使用自定义 TaskManager 进行安全的异步执行
  • 兼容 Folia 的执行机制
  • 清晰且结构化的配置

? 示例代码配置

促销码现在存储在 codes.yml 中。

codes:
  WELCOME:
    enabled: true
    once-per-player: true
    global-use: 3
    per-player-use-limit: -1
    cooldown: ""
    permission-required: ""
    start-date: "25/12/2025 00:00"
    expiry-date: "31/12/2025 23:59"

    title:
      enabled: true
      main: "&aCode Redeemed!"
      sub: "&7You used: &fWELCOME"
      fade-in: 10
      stay: 40
      fade-out: 10

    commands:
      - "console: give %player% diamond 2"
      - "message: &aYou have successfully redeemed the &fWELCOME &acode!"

⚙️ 示例插件设置

通用插件设置存储在 config.yml 中。

settings:
  enabled: true
  server-name: "survival"
  debug: false
  case-insensitive-codes: true
  trim-code-input: true
  min-code-length: 2
  max-code-length: 32
  use-permission: "mpromocodes.use"

anti-spam:
  enabled: true
  failed-attempt-cooldown: "3s"
  max-failed-attempts: 5
  block-time: "1m"
  reset-on-success: true
  webhook-log-blocked-attempts: true

storage:
  type: "SQLITE"
  auto-migrate-yaml: true

  sqlite:
    file: "storage.db"

  mysql:
    host: "localhost"
    port: 3306
    database: "mpromocodes"
    username: "root"
    password: "password"
    use-ssl: false
    table-prefix: "mpromocodes_"

? Discord Webhook 集成

MPromoCodes 可以将详细日志直接发送到您的 Discord 员工频道。

Webhook 日志可以包含:

  • 成功的代码兑换
  • 失败的兑换尝试
  • 无效的代码
  • 已过期的代码
  • 已被使用的代码
  • 缺少权限
  • 达到全局限制
  • 未满足条件

您还可以在游戏中直接测试您的 Webhook:

/codes webhook test

Webhook 嵌入支持可配置的颜色、用户名、头像、页脚和提及保护。


? 存储系统

MPromoCodes 支持多种存储后端:

  • YAML — 简单的基于文件的存储
  • SQLite — 推荐用于大多数单服务器设置
  • MySQL — 推荐用于较大的设置和基于数据库的存储

启用时,现有的 redeemed.yml 数据可以自动迁移到 SQLite 或 MySQL。

storage:
  type: "SQLITE"
  auto-migrate-yaml: true

? 自动迁移

当从旧版本更新时,MPromoCodes 可以自动将现有促销码从 config.yml 移动到新 codes.yml 文件中。

更新后的首次启动时:

  • 来自 config.yml 的现有 codes: 被移动到 codes.yml
  • 旧配置文件备份为 config-old.yml
  • 生成一个新的 config.yml
  • 现有的已兑换数据可以迁移到 SQLite 或 MySQL

这既保留了旧设置的完整性,又允许插件使用新的更简洁的文件结构。


? 防垃圾邮件保护

MPromoCodes 包含针对失败兑换尝试的内置防垃圾邮件保护。

您可以配置:

  • 失败尝试冷却时间
  • 最大失败尝试次数
  • 临时封禁时间
  • 成功兑换后重置

这有助于保护您的服务器和 Discord Webhook 日志免受垃圾邮件困扰。


? 命令

  • /code <code> - 兑换促销码
  • /codes reload - 重新加载配置和代码文件
  • /codes stats - 显示您已兑换代码的信息
  • /codes menu - 打开管理菜单
  • /codes webhook test - 发送测试 Discord Webhook
  • /codes health - 监控服务器性能、插件加载情况等...

? 权限

  • mpromocodes.use - 允许玩家兑换代码
  • mpromocodes.admin - 允许管理命令
  • mpromocodes.admin.webhook - 允许测试 Discord Webhooks
  • mpromocodes.admin.health - 允许监控插件

兑换权限也可以在 config.yml 中更改:

settings:
  use-permission: "mpromocodes.use"

? 工作原理

促销码在 codes.yml 中定义。

每个代码可以:

  • 运行多个奖励
  • 执行控制台命令
  • 执行玩家命令
  • 发送内置插件消息
  • 受权限限制
  • 具有开始日期
  • 具有过期日期
  • 每位玩家只能使用一次
  • 可以多次使用
  • 具有全局使用限制
  • 具有每位玩家的使用限制
  • 具有冷却时间
  • 显示标题和副标题
  • 使用高级兑换条件

已兑换的代码数据使用所选的存储类型安全存储。

所有操作均通过安全的调度机制以兼容 Folia 的方式执行。


? 服务器兼容性

✅ Bukkit

✅ Spigot

✅ Paper

✅ Purpur

✅ Folia

✅ Java 17+


? 文件大小说明

此版本的插件 .jar 文件体积较大,因为 MPromoCodes 现已内置支持 SQLite 和 MySQL 数据库。

为了方便服务器管理员设置,所需的数据库驱动程序已直接包含在插件文件中。这意味着您无需单独下载或安装任何用于 SQLite 或 MySQL 支持的额外库。

文件体积增大是正常现象,这是由于捆绑了 SQL 数据库驱动程序所致,尤其是 SQLite 驱动程序,其中包含了针对多种操作系统的原生库。

简而言之:

  • 较大的文件体积属于正常情况
  • 无需进行额外的安装步骤
  • SQLite 和 MySQL 开箱即用
  • 仍支持 YAML 存储方式

? 为什么选择 MPromoCodes?

与简单的基于命令的促销码插件不同,MPromoCodes 具备以下优势:

  • 采用结构清晰的独立 codes.yml 系统
  • 支持 Discord Webhook 日志记录
  • 支持 YAML、SQLite 和 MySQL 存储方式
  • 可自动迁移旧版配置文件及已兑换的数据
  • 避免原版命令滥用问题
  • 采用兼容 Folia 的安全调度机制
  • 保持配置文件的可读性与可维护性
  • 非常适合用于活动、奖励、VIP 推广、抽奖以及服务器开服等场景

❤️ 结语

MPromoCodes 的设计兼顾了性能、清晰度以及对未来版本的兼容性。

如果您正在寻找一种具备现代存储方案、Discord 日志记录功能且完全适配 Folia 执行的简洁促销码解决方案——那么就是它了。


? 统计数据

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源