UDMR

插件

· 作者 Lolka12321

高级报告系统,支持 Discord 集成

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

最新 1.0 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

? ReportSystem

适用于 Minecraft 服务器的先进举报系统,集成 Discord 功能与管理员工具

✨ 特性

? 举报系统

  • 交互式举报创建 - Minecraft 聊天中的分步表单
  • 精美 GUI - 支持分页和状态跟踪查看您的举报
  • 多语言支持 - 包含英文和俄文本地化
  • 春季配色方案 - 令人愉悦的渐变效果以提升用户体验
  • 自动验证 - 检查玩家是否存在并防止自我举报

? Discord 集成

  • 实时通知 - 举报即时发送至 Discord 频道
  • 交互按钮 - 直接从 Discord 批准、拒绝、检查和评论
  • 惩罚系统 - 用于封禁/静音/踢出/警告的模态表单,可设置持续时间
  • 玩家检查功能 - 冻结玩家并将其呼叫至语音频道
  • 自动命令 - 自动执行惩罚

⚙️ 管理员工具

  • 举报管理 - 审核、评论并更新举报状态
  • 玩家冻结 - 在验证期间冻结违规者
  • 语音频道集成 - 通过 Discord 呼叫玩家进行检查
  • 统计信息 - 跟踪已批准、已拒绝和待处理的举报数量
  • 热重载 - 无需重启服务器即可更新配置

? 安装

要求

  • Minecraft Server 1.21+
  • Paper/Spigot
  • Java 17+
  • Discord Bot(可选,但推荐)

设置步骤

  1. 下载 Releases 中的最新版本

  2. 安装 插件:

    cp ReportSystem-1.0.0.jar /path/to/server/plugins/
    
  3. 启动 服务器以生成配置文件

  4. 配置 Discord Bot:

    • 在 Discord Developer Portal 创建机器人
    • 启用以下意图:
      • MESSAGE CONTENT
      • GUILD MESSAGES
      • GUILD VOICE STATES
    • 复制机器人令牌
  5. 编辑 plugins/ReportSystem/config.yml:

    language: "en-EN"  # 或 "ru-RU"
    
    discord:
      use-bot: true
      bot-token: "YOUR_BOT_TOKEN_HERE"
      channel-id: "YOUR_CHANNEL_ID_HERE"
    
    reports:
      max-active-reports: 5
      form-timeout: 300
      history-limit: 18
    
  6. 重启 服务器

? 命令

玩家命令

命令 别名 描述 权限
/report /rep 创建新举报 reportsystem.report
/reports - 查看您的举报 reportsystem.reports
/report help - 显示帮助 reportsystem.report

管理员命令

命令 描述 权限
/report reload 重新加载配置 reportsystem.admin.reload
/unfreeze <player> 解冻玩家 reportsystem.admin

? 权限

# 完全访问权限
reportsystem.*

# 玩家权限
reportsystem.report         # 创建举报
reportsystem.reports        # 查看自己的举报

# 管理员权限
reportsystem.admin          # 访问所有管理员命令
reportsystem.admin.reload   # 重新加载配置
reportsystem.admin.stats    # 查看统计信息

? 使用示例

创建举报

  1. 在聊天中输入 /report
  2. 输入违规者的昵称
  3. 输入举报原因
  4. 添加其他详细信息或输入 'skip'
  5. 点击 [YES] 按钮确认

Discord 审核

批准并施加惩罚

  1. 点击 Approve 按钮
  2. 填写模态表单:
    • 惩罚类型:ban、mute、kick 或 warn
    • 持续时间:30m、7d、1y 或 permanent
    • 原因:其他详细信息
  3. 玩家将被自动惩罚

呼叫检查

  1. 加入 Discord 中的语音频道
  2. 点击 Check 按钮
  3. 玩家在游戏中被冻结
  4. 玩家收到带有语音频道名称的通知
  5. 进行检查
  6. 使用 /unfreeze <player> 解冻

? 本地化

支持的语言

  • ?? English (en-EN)
  • ?? Russian (ru-RU)

自定义语言

  1. 将 locales/en-EN.yml 复制到 locales/your-lang.yml
  2. 翻译所有字符串
  3. 在 config.yml 中设置 language: "your-lang"

渐变色

插件使用美丽的春季主题渐变:

# 樱花粉 → 桃色
prefix: "<gradient:#FFB7C5:#FFDAB9>[Report]</gradient>"

# 薄荷绿 → 鲜绿色
report-success: "<gradient:#98FB98:#7FFF00>Report submitted!</gradient>"

? API 使用

Maven

<repository>
    <id>jitpack</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.yourusername</groupId>
    <artifactId>ReportSystem</artifactId>
    <version>1.0.0</version>
</dependency>

示例代码

// 获取插件实例
ReportSystem plugin = ReportSystem.getInstance();

// 以编程方式创建举报
Report report = new Report(
    "REP-" + System.currentTimeMillis(),
    player.getUniqueId(),
    player.getName(),
    "Griefer123",
    UUID.fromString("..."),
    "Griefing",
    "Destroyed spawn area"
);

// 保存举报
plugin.getDataManager().saveReport(report);

// 发送到 Discord
plugin.getDiscordBot().sendReport(report);

? 统计信息

查看全服举报统计信息:

=== Report Statistics ===
Total reports: 156
Approved: 89
Rejected: 45
Pending: 22

?️ 配置

config.yml

language: "en-EN"

discord:
  use-bot: true
  bot-token: "YOUR_TOKEN"
  channel-id: "YOUR_CHANNEL_ID"

报告设置: max-active-reports: 5 # 每个玩家的最大待处理报告数 form-timeout: 300 # 表单超时时间(秒)(0 = 无超时) history-limit: 18 # GUI 中每页显示的报告数

本地化文件

  • locales/en-EN.yml - 英文翻译
  • locales/ru-RU.yml - 俄文翻译

? 春季配色方案

该插件采用美丽的春季主题配色方案:

  • ? 樱花粉 - 标题和前缀
  • ? 桃色 - 警告和超时提示
  • ? 薰衣草紫 - 问题和信息
  • ? 薄荷绿 - 成功消息
  • ✅ 鲜绿色 - 批准操作

? 故障排除

Discord 机器人无法工作

  1. 检查 config.yml 中的机器人令牌
  2. 验证机器人已启用所需的事件意图(Intents)
  3. 确保频道 ID 正确无误
  4. 检查机器人在该频道中是否具有权限

玩家无法创建报告

  1. 检查权限:reportsystem.report
  2. 验证玩家是否已达到最大报告数量限制
  3. 检查报告系统是否可用(Discord 是否已连接)

语音检查功能无法工作

  1. 确保已启用 GUILD_VOICE_STATES 事件意图
  2. 管理员必须处于语音频道中
  3. 玩家必须在线
  4. 检查机器人的权限设置

? 更新日志

版本 1.0.0

  • 首次发布
  • 报告创建系统
  • 带按钮的 Discord 集成
  • 处罚模态框系统
  • 玩家冻结与检查功能
  • 多语言支持
  • 春季配色方案
  • 支持分页的 GUI 界面

? 贡献指南

欢迎贡献!请随时提交拉取请求(Pull Request)。

  1. Fork 本仓库
  2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开一个拉取请求

? 许可证

本项目基于 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

? 致谢

  • 作者: Lolka12321
  • Discord 集成: JDA Library
  • 颜色系统: Adventure API
  • 灵感来源: 社区反馈与建议

⭐ 表达支持

如果这个项目对您有帮助,请点亮一颗 ⭐️!


为 Minecraft 社区 ❤️ 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源