? ReportSystem
适用于 Minecraft 服务器的先进举报系统,集成 Discord 功能与管理员工具
✨ 特性
? 举报系统
- 交互式举报创建 - Minecraft 聊天中的分步表单
- 精美 GUI - 支持分页和状态跟踪查看您的举报
- 多语言支持 - 包含英文和俄文本地化
- 春季配色方案 - 令人愉悦的渐变效果以提升用户体验
- 自动验证 - 检查玩家是否存在并防止自我举报
? Discord 集成
- 实时通知 - 举报即时发送至 Discord 频道
- 交互按钮 - 直接从 Discord 批准、拒绝、检查和评论
- 惩罚系统 - 用于封禁/静音/踢出/警告的模态表单,可设置持续时间
- 玩家检查功能 - 冻结玩家并将其呼叫至语音频道
- 自动命令 - 自动执行惩罚
⚙️ 管理员工具
- 举报管理 - 审核、评论并更新举报状态
- 玩家冻结 - 在验证期间冻结违规者
- 语音频道集成 - 通过 Discord 呼叫玩家进行检查
- 统计信息 - 跟踪已批准、已拒绝和待处理的举报数量
- 热重载 - 无需重启服务器即可更新配置
? 安装
要求
- Minecraft Server 1.21+
- Paper/Spigot
- Java 17+
- Discord Bot(可选,但推荐)
设置步骤
-
下载 Releases 中的最新版本
-
安装 插件:
cp ReportSystem-1.0.0.jar /path/to/server/plugins/
-
启动 服务器以生成配置文件
-
配置 Discord Bot:
- 在 Discord Developer Portal 创建机器人
- 启用以下意图:
MESSAGE CONTENT
GUILD MESSAGES
GUILD VOICE STATES
- 复制机器人令牌
-
编辑 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
-
重启 服务器
? 命令
玩家命令
| 命令 |
别名 |
描述 |
权限 |
/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 # 查看统计信息
? 使用示例
创建举报
- 在聊天中输入
/report
- 输入违规者的昵称
- 输入举报原因
- 添加其他详细信息或输入 'skip'
- 点击
[YES] 按钮确认
Discord 审核
批准并施加惩罚
- 点击
Approve 按钮
- 填写模态表单:
- 惩罚类型:
ban、mute、kick 或 warn
- 持续时间:
30m、7d、1y 或 permanent
- 原因:其他详细信息
- 玩家将被自动惩罚
呼叫检查
- 加入 Discord 中的语音频道
- 点击
Check 按钮
- 玩家在游戏中被冻结
- 玩家收到带有语音频道名称的通知
- 进行检查
- 使用
/unfreeze <player> 解冻
? 本地化
支持的语言
- ?? English (
en-EN)
- ?? Russian (
ru-RU)
自定义语言
- 将
locales/en-EN.yml 复制到 locales/your-lang.yml
- 翻译所有字符串
- 在
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 机器人无法工作
- 检查
config.yml 中的机器人令牌
- 验证机器人已启用所需的事件意图(Intents)
- 确保频道 ID 正确无误
- 检查机器人在该频道中是否具有权限
玩家无法创建报告
- 检查权限:
reportsystem.report
- 验证玩家是否已达到最大报告数量限制
- 检查报告系统是否可用(Discord 是否已连接)
语音检查功能无法工作
- 确保已启用
GUILD_VOICE_STATES 事件意图
- 管理员必须处于语音频道中
- 玩家必须在线
- 检查机器人的权限设置
? 更新日志
版本 1.0.0
- 首次发布
- 报告创建系统
- 带按钮的 Discord 集成
- 处罚模态框系统
- 玩家冻结与检查功能
- 多语言支持
- 春季配色方案
- 支持分页的 GUI 界面
? 贡献指南
欢迎贡献!请随时提交拉取请求(Pull Request)。
- Fork 本仓库
- 创建您的功能分支 (
git checkout -b feature/AmazingFeature)
- 提交您的更改 (
git commit -m 'Add some AmazingFeature')
- 推送到分支 (
git push origin feature/AmazingFeature)
- 打开一个拉取请求
? 许可证
本项目基于 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
? 致谢
- 作者: Lolka12321
- Discord 集成: JDA Library
- 颜色系统: Adventure API
- 灵感来源: 社区反馈与建议
⭐ 表达支持
如果这个项目对您有帮助,请点亮一颗 ⭐️!
为 Minecraft 社区 ❤️ 制作
? ReportSystem
Advanced report system for Minecraft servers with Discord integration and admin moderation tools
✨ Features
? Report System
- Interactive Report Creation - Step-by-step form in Minecraft chat
- Beautiful GUI - View your reports with pagination and status tracking
- Multi-language Support - English and Russian localizations included
- Spring Color Palette - Pleasant gradients for better UX
- Automatic Validation - Checks player existence and prevents self-reports
? Discord Integration
- Real-time Notifications - Reports sent instantly to Discord channel
- Interactive Buttons - Approve, Reject, Check, and Comment directly from Discord
- Punishment System - Modal form for ban/mute/kick/warn with duration
- Player Check Feature - Freeze players and call them to voice channel
- Automatic Commands - Execute punishments automatically
⚙️ Admin Tools
- Report Management - Review, comment, and update report status
- Player Freeze - Freeze violators during verification
- Voice Channel Integration - Call players for checks via Discord
- Statistics - Track approved, rejected, and pending reports
- Hot Reload - Update configuration without server restart
? Installation
Requirements
- Minecraft Server 1.21+
- Paper/Spigot
- Java 17+
- Discord Bot (optional, but recommended)
Setup Steps
-
Download the latest release from Releases
-
Install the plugin:
cp ReportSystem-1.0.0.jar /path/to/server/plugins/
-
Start your server to generate configuration files
-
Configure Discord Bot:
- Create a bot at Discord Developer Portal
- Enable the following intents:
MESSAGE CONTENT
GUILD MESSAGES
GUILD VOICE STATES
- Copy the bot token
-
Edit plugins/ReportSystem/config.yml:
language: "en-EN" # or "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
-
Restart the server
? Commands
Player Commands
| Command |
Aliases |
Description |
Permission |
/report |
/rep |
Create a new report |
reportsystem.report |
/reports |
- |
View your reports |
reportsystem.reports |
/report help |
- |
Show help |
reportsystem.report |
Admin Commands
| Command |
Description |
Permission |
/report reload |
Reload configuration |
reportsystem.admin.reload |
/unfreeze <player> |
Unfreeze a player |
reportsystem.admin |
? Permissions
# Full access
reportsystem.*
# Player permissions
reportsystem.report # Create reports
reportsystem.reports # View own reports
# Admin permissions
reportsystem.admin # Access to all admin commands
reportsystem.admin.reload # Reload configuration
reportsystem.admin.stats # View statistics
? Usage Examples
Creating a Report
- Type
/report in chat
- Enter violator's nickname
- Enter reason for report
- Add additional details or type 'skip'
- Confirm by clicking
[YES] button
Discord Moderation
Approve with Punishment
- Click
Approve button
- Fill the modal form:
- Punishment Type:
ban, mute, kick, or warn
- Duration:
30m, 7d, 1y, or permanent
- Reason: Additional details
- Player is automatically punished
Call for Check
- Join a voice channel in Discord
- Click
Check button
- Player is frozen in-game
- Player receives notification with voice channel name
- Conduct verification
- Use
/unfreeze <player> to unfreeze
? Localization
Supported Languages
- ?? English (
en-EN)
- ?? Russian (
ru-RU)
Custom Languages
- Copy
locales/en-EN.yml to locales/your-lang.yml
- Translate all strings
- Set
language: "your-lang" in config.yml
Gradient Colors
The plugin uses beautiful spring-themed gradients:
# Cherry Blossom → Peach
prefix: "<gradient:#FFB7C5:#FFDAB9>[Report]</gradient>"
# Mint → Fresh Green
report-success: "<gradient:#98FB98:#7FFF00>Report submitted!</gradient>"
? API Usage
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>
Example Code
// Get the plugin instance
ReportSystem plugin = ReportSystem.getInstance();
// Create a report programmatically
Report report = new Report(
"REP-" + System.currentTimeMillis(),
player.getUniqueId(),
player.getName(),
"Griefer123",
UUID.fromString("..."),
"Griefing",
"Destroyed spawn area"
);
// Save the report
plugin.getDataManager().saveReport(report);
// Send to Discord
plugin.getDiscordBot().sendReport(report);
? Statistics
View server-wide report statistics:
=== Report Statistics ===
Total reports: 156
Approved: 89
Rejected: 45
Pending: 22
?️ Configuration
config.yml
language: "en-EN"
discord:
use-bot: true
bot-token: "YOUR_TOKEN"
channel-id: "YOUR_CHANNEL_ID"
reports:
max-active-reports: 5 # Maximum pending reports per player
form-timeout: 300 # Form timeout in seconds (0 = no timeout)
history-limit: 18 # Reports per page in GUI
Localization Files
locales/en-EN.yml - English translations
locales/ru-RU.yml - Russian translations
? Spring Color Palette
The plugin features a beautiful spring-themed color scheme:
- ? Cherry Blossom Pink - Headers and prefixes
- ? Peach - Warnings and timeouts
- ? Lavender - Questions and info
- ? Mint Green - Success messages
- ✅ Fresh Green - Approvals
? Troubleshooting
Discord Bot Not Working
- Check bot token in
config.yml
- Verify bot has required intents enabled
- Ensure channel ID is correct
- Check bot has permissions in the channel
Player Can't Create Reports
- Check permission:
reportsystem.report
- Verify they haven't reached max reports limit
- Check if report system is available (Discord connected)
Voice Check Not Working
- Ensure
GUILD_VOICE_STATES intent is enabled
- Admin must be in a voice channel
- Player must be online
- Check bot permissions
? Changelog
Version 1.0.0
- Initial release
- Report creation system
- Discord integration with buttons
- Punishment modal system
- Player freeze and check feature
- Multi-language support
- Spring color palette
- GUI with pagination
? Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature)
- Commit your changes (
git commit -m 'Add some AmazingFeature')
- Push to the branch (
git push origin feature/AmazingFeature)
- Open a Pull Request
? License
This project is licensed under the MIT License - see the LICENSE file for details.
? Credits
- Author: Lolka12321
- Discord Integration: JDA Library
- Color System: Adventure API
- Inspired by: Community feedback and suggestions
⭐ Show Your Support
Give a ⭐️ if this project helped you!
Made with ? for the Minecraft community
评论 0
登录后参与评分
还没有评论,来抢沙发吧