DiscordPunishBot v2.0.0
?? Türkçe README için aşağı kaydırın | ?? English README
?? English README
A professional punishment, appeal, and report management system plugin for Minecraft servers with advanced Discord integration.
✨ Key Features
? Advanced Discord Integration
- Interactive Button System: Approve/reject appeals and reports directly from Discord
- Rich Embed Messages: Beautiful, detailed embed messages with status colors
- Slash Commands: Full Discord slash command support for all punishment types
- Role-Based Permissions: Assign specific Discord roles for different operations
- Real-Time Notifications: Instant Discord notifications for new appeals/reports
- Multi-Channel Support: Separate channels for logs, appeals, and reports
⚖️ Complete Appeal System
- Appeal Commands:
/appeal, /appeal list, /appeal status <id>
- Interactive Discord Buttons: Approve, reject, or investigate appeals from Discord
- Appeal Status Tracking: Pending, Under Review, Approved, Rejected
- Automatic Notifications: Players get notified of appeal decisions
- Cooldown System: 24-hour cooldown between appeals
- Admin Response System: Admins can add responses to appeal decisions
? Advanced Report System
- Report Commands:
/report <player> <reason>, /report anonymous <player> <reason>
- Interactive Moderation: Approve, reject, or investigate reports from Discord
- Priority Levels: Low, Medium, High, Urgent, Critical with color coding
- Anonymous Reports: Complete privacy protection for reporters
- Status Tracking: Pending, Under Review, Investigating, Resolved, Dismissed, Duplicate
- Cooldown Management: 5-minute cooldown between reports
? Configurable Reward System
- Console Command Rewards: Execute any console command as reward
- Flexible Configuration: Different rewards for correct reports/appeals
- Automatic Distribution: Rewards given automatically upon approval
- Custom Messages: Configurable reward notification messages
?️ Database & Performance
- Dual Database Support: SQLite (default) and MySQL
- Transaction Management: Proper commit/rollback for data integrity
- Connection Pool: Optimized database connection management
- Async Operations: Non-blocking database operations for better performance
- Error Recovery: Automatic error handling and recovery mechanisms
? Installation
1. Requirements
- Java 17+
- Spigot/Paper 1.20+
- Essentials Plugin
- Discord Bot with permissions
2. Plugin Setup
- Download
DiscordPunishBot-2.0.0.jar
- Place in your
plugins folder
- Start server (config files will be generated)
- Stop server and configure
3. Discord Bot Setup
- Go to Discord Developer Portal
- Create new application → Bot tab → Create bot
- Copy bot token
- OAuth2 → URL Generator:
- Scopes:
bot, applications.commands
- Permissions:
Send Messages, Use Slash Commands, Read Message History, Manage Messages
- Add bot to your server using generated URL
4. Configuration
Edit config.yml:
# Discord Configuration
discord:
token: "YOUR_BOT_TOKEN_HERE"
guild-id: "YOUR_GUILD_ID_HERE"
# Channel Configuration
log-channel-id: "LOG_CHANNEL_ID" # General punishment logs
appeal-channel-id: "APPEAL_CHANNEL_ID" # Appeal notifications
report-channel-id: "REPORT_CHANNEL_ID" # Public report notifications
report-log-channel-id: "REPORT_LOG_ID" # Admin report management
# Admin Role Configuration
report-admin-role-id: "REPORT_ADMIN_ROLE" # Role for report management
appeal-admin-role-id: "APPEAL_ADMIN_ROLE" # Role for appeal management
# Punishment Roles
roles:
mute: "MUTE_ROLE_ID"
ban: "BAN_ROLE_ID"
kick: "KICK_ROLE_ID"
tempban: "TEMPBAN_ROLE_ID"
jail: "JAIL_ROLE_ID"
warn: "WARN_ROLE_ID"
other: "OTHER_ROLE_ID"
# Reward System Configuration
reward-system:
enabled: true
# Commands to execute when a report is approved
report-correct-commands:
- "eco give %player% 100"
- "tellraw %player% {\"text\":\"Thanks for the correct report! +100 coins\",\"color\":\"green\"}"
# Commands to execute when an appeal is approved
appeal-approved-commands:
- "eco give %player% 50"
- "tellraw %player% {\"text\":\"Your appeal was approved! +50 coins\",\"color\":\"green\"}"
# Custom messages
report-approved-message: "§a§l[REPORT] §7Your report was correct! You received a reward."
appeal-approved-message: "§a§l[APPEAL] §7Your appeal was approved! You received a reward."
? Commands
Discord Slash Commands
/mute <player> [reason] - Mute a player
/ban <player> [reason] - Ban a player
/kick <player> [reason] - Kick a player
/tempban <player> [reason] - Temporary ban
/jail <player> [reason] - Jail a player
/warn <player> [reason] - Warn a player
/diger <player> [reason] - Other punishments
/ceza <player> - View punishment history
Minecraft Commands
General Commands
/ceza <player> - View player's punishment history
/dpunish reload - Reload configuration
/dpunish info - Plugin information
/dpunish test <database/discord> - Test connections
/dpunish stats - Server statistics
Appeal Commands
/appeal - Show available punishments to appeal
/appeal <punishment_id> <reason> - Create new appeal
/appeal list - List your appeals
/appeal status <appeal_id> - Check appeal status
Report Commands
/report <player> <reason> [description] - Create report
/report anonymous <player> <reason> [description] - Anonymous report
/report list - List your reports
/report status <report_id> - Check report status
? Discord Interactive Features
报告管理按钮
创建报告后,管理员会在报告日志频道中看到以下按钮:
- ✅ 批准并手动处罚 - 批准报告,给予奖励,需进行手动处罚
- ❌ 拒绝 - 将该报告视为无效而拒绝
- ? 调查 - 标记为正在调查中(保持按钮可用)
申诉管理按钮
创建申诉后,管理员会在申诉频道中看到以下按钮:
- ✅ 批准申诉 - 批准申诉,移除处罚,给予奖励
- ❌ 拒绝申诉 - 将该申诉视为无效而拒绝
- ? 调查 - 标记为正在调查中(保持按钮可用)
交互功能
- 实时更新: 状态更改时嵌入消息会自动更新
- 管理员追踪: 显示处理请求的管理员
- 状态颜色: 待处理、已批准、已拒绝、调查中对应不同的颜色
- 按钮状态: 操作完成后按钮禁用,或在调查期间保持可用
- 错误处理: 优雅地处理删除的消息或无效操作
? 权限
# 通用权限
discordpunish.* # 所有权限
discordpunish.admin # 管理员权限
discordpunish.reload # 重载配置
discordpunish.test # 测试连接
# 处罚权限
discordpunish.ceza # 查看处罚历史
# 申诉权限
discordpunish.appeal.* # 所有申诉权限
discordpunish.appeal.create # 创建申诉
discordpunish.appeal.list # 列出自己的申诉
discordpunish.appeal.viewall # 查看所有申诉(管理员)
# 报告权限
discordpunish.report.* # 所有报告权限
discordpunish.report.create # 创建报告
discordpunish.report.list # 列出自己的报告
discordpunish.report.viewall # 查看所有报告(管理员)
discordpunish.report.notify # 接收报告通知
?️ 高级配置
数据库设置
database:
type: "sqlite" # 或 "mysql"
# MySQL 配置(如果使用 MySQL)
host: "localhost"
port: 3306
database: "punishments"
username: "your_username"
password: "your_password"
语言设置
language: "tr" # "tr" 表示土耳其语,"en" 表示英语
自定义处罚
punishments:
mute:
spam:
command: "essentials:mute %player% 30m Spam"
display: "刷屏 (30 分钟)"
toxic:
command: "essentials:mute %player% 2h Toxic behavior"
display: "有毒行为 (2 小时)"
? 故障排除
常见问题
机器人未响应斜杠命令:
- 检查配置文件中的机器人令牌
- 验证机器人是否具有
applications.commands 作用域
- 检查 Discord 中的角色权限
- 在游戏中使用
/dpunish test discord
数据库错误:
- 检查配置文件中的数据库类型
- 对于 MySQL:验证连接详情
- 对于 SQLite:检查文件权限
- 在游戏中使用
/dpunish test database
交互按钮无法工作:
- 验证管理员角色 ID 是否正确
- 检查 Discord 频道中机器人的权限
- 确保机器人可以管理消息
- 检查服务器日志以获取详细错误信息
报告/申诉未显示:
- 检查配置文件中的频道 ID
- 验证机器人是否有访问频道的权限
- 检查用户权限
- 使用
/dpunish test discord 验证设置
? 功能详解
状态系统
- 报告: 待处理 → 审核中 → 调查中 → 已解决/已驳回/重复
- 申诉: 待处理 → 审核中 → 已批准/已拒绝
- 颜色编码: 每种状态在 Discord 嵌入消息中具有独特的颜色
- 通知: 状态更改时自动通知玩家
奖励系统
- 可配置命令: 执行任何控制台命令作为奖励
- 多重奖励: 不同操作对应不同奖励
- 玩家通知: 发放奖励时的自定义消息
- 灵活占位符: 在命令和消息中使用
%player%
数据库设计
- 处罚表: 核心处罚数据
- 申诉表: 通过外键链接到处罚
- 报告表: 独立的报告系统
- 索引: 优化性能
- 事务: ACID 合规以确保数据完整性
? 支持
?? 土耳其语 README
Minecraft 服务器的 Discord 集成高级处罚、申诉和投诉管理系统。
✨ 基本功能
? 高级 Discord 集成
- 交互式按钮系统: 直接在 Discord 上批准/拒绝申诉和投诉
- 丰富的嵌入消息: 带有状态颜色的美观且详细的嵌入消息
- 斜杠命令: 支持所有处罚类型的 Discord 斜杠命令
- 基于角色的权限: 针对不同操作的特殊 Discord 角色
- 实时通知: 新申诉/投诉的即时 Discord 通知
- 多频道支持: 日志、申诉和投诉使用独立频道
⚖️ 完整申诉系统
- 申诉命令:
/appeal, /appeal list, /appeal status <id>
- 交互式 Discord 按钮: 在 Discord 上批准、拒绝或调查申诉
- 申诉状态追踪: 待处理、审核中、已批准、已拒绝
- 自动通知: 玩家会收到申诉决定的通知
- 冷却系统: 申诉间隔 24 小时等待期
- 管理员回复系统: 管理员可以为申诉决定添加回复
? 高级举报系统
-
举报命令: /report <玩家> <原因>, /report anonymous <玩家> <原因>
-
交互式审核: 在 Discord 上批准、拒绝或审查举报
-
优先级等级: 低、中、高、紧急、严重 - 带颜色编码
-
匿名举报: 为举报者提供完全隐私保护
-
状态追踪:待处理、审核中、调查中、已解决、已拒绝、重新提交
-
冷却时间管理:投诉之间需等待 5 分钟
? 可配置的奖励系统
- 控制台命令奖励:将任何控制台命令作为奖励执行
- 灵活配置:针对不同的举报/投诉提供不同的奖励
- 自动发放:审核通过后自动发放奖励
- 自定义消息:可配置的奖励通知消息
?️ 数据库与性能
- 双数据库支持: SQLite(默认)和 MySQL
- 事务管理: 确保数据完整性的适当提交/回滚机制
- 连接池: 优化的数据库连接管理
- 异步操作: 非阻塞处理,提升性能
- 错误恢复: 自动错误管理与恢复机制
? 安装
1. 环境要求
- Java 17+
- Spigot/Paper 1.20+
- Essentials 插件
- 拥有权限的 Discord 机器人
2. 插件安装
- 下载
DiscordPunishBot-2.0.0.jar 文件
- 将其放入
plugins 文件夹中
- 启动服务器(将生成配置文件)
- 停止服务器并进行配置
3. Discord 机器人设置
- 访问 Discord Developer Portal
- 创建新应用 → 进入 Bot 选项卡 → 点击创建 Bot
- 复制 Bot Token
- OAuth2 → URL Generator:
- 作用域:
bot, applications.commands
- 权限:
Send Messages, Use Slash Commands, Read Message History, Manage Messages
- 使用生成的链接将机器人添加到你的服务器
4. 配置
编辑 config.yml 文件:
# Discord 配置
discord:
token: "BOT_TOKEN_BURAYA"
guild-id: "SUNUCU_ID_BURAYA"
# 频道配置
log-channel-id: "LOG_KANAL_ID" # 通用处罚日志
appeal-channel-id: "ITIRAZ_KANAL_ID" # 申诉通知
report-channel-id: "SIKAYET_KANAL_ID" # 通用举报通知
report-log-channel-id: "SIKAYET_LOG_ID" # 管理员举报管理
# 管理员角色配置
report-admin-role-id: "SIKAYET_ADMIN_ROL" # 举报管理角色
appeal-admin-role-id: "ITIRAZ_ADMIN_ROL" # 申诉管理角色
# 处罚角色
roles:
mute: "MUTE_ROL_ID"
ban: "BAN_ROL_ID"
kick: "KICK_ROL_ID"
tempban: "TEMPBAN_ROL_ID"
jail: "JAIL_ROL_ID"
warn: "WARN_ROL_ID"
other: "OTHER_ROL_ID"
奖励系统配置
reward-system:
enabled: true
举报审核通过时执行的命令
report-correct-commands:
- "eco give %player% 100"
- "tellraw %player% {"text":"感谢您的正确举报!+100 金币","color":"green"}"
申诉审核通过时执行的命令
appeal-approved-commands:
- "eco give %player% 50"
- "tellraw %player% {"text":"您的申诉已获批准!+50 金币","color":"green"}"
自定义消息
report-approved-message: "§a§l[举报] §7举报属实!您已获得奖励。"
appeal-approved-message: "§a§l[申诉] §7申诉已获批准!您已获得奖励。"
## ? 命令
### Discord Slash 命令
- `/mute <玩家> [原因]` - 静音玩家
- `/ban <玩家> [原因]` - 封禁玩家
- `/kick <玩家> [原因]` - 踢出玩家
- `/tempban <玩家> [原因]` - 临时封禁
- `/jail <玩家> [原因]` - 关押玩家
- `/warn <玩家> [原因]` - 警告玩家
- `/diger <玩家> [原因]` - 其他处罚
- `/ceza <玩家>` - 查看处罚记录
### Minecraft 命令
#### 通用命令
- `/ceza <玩家>` - 查看玩家的处罚记录
- `/dpunish reload` - 重新加载配置
- `/dpunish info` - 插件信息
- `/dpunish test <数据库/Discord>` - 测试连接
- `/dpunish stats` - 服务器统计
#### 申诉命令
- `/appeal` - 显示可申诉的处罚
- `/appeal <ceza_id> <sebep>` - 创建新的申诉
- `/appeal list` - 列出你的申诉
- `/appeal status <itiraz_id>` - 查看申诉状态
#### 举报命令
- `/report <oyuncu> <sebep> [açıklama]` - 创建举报
- `/report anonymous <oyuncu> <sebep> [açıklama]` - 匿名举报
- `/report list` - 列出你的举报
- `/report status <sikayet_id>` - 查看举报状态
## ? Discord 交互功能
### 举报管理按钮
当举报创建后,管理员会在举报日志频道中看到以下按钮:
- **✅ 批准 & 手动处罚** - 批准举报,发放奖励,需要执行手动处罚
- **❌ 拒绝** - 将举报标记为无效并拒绝
- **? 转入调查** - 标记为待调查(保持按钮激活状态)
### 申诉管理按钮
当申诉创建后,管理员会在申诉频道中看到以下按钮:
- **✅ 批准申诉** - 批准申诉,撤销处罚,发放奖励
- **❌ 拒绝申诉** - 将申诉标记为无效并拒绝
- **? 转入调查** - 标记为待调查(保持按钮激活状态)
### 交互特性
- **实时更新**:当状态发生变化时,嵌入消息会自动更新。
- **管理员追踪**:显示哪位管理员执行了操作。
- **状态颜色**:为等待中、已批准、已拒绝、审核中等不同状态提供不同的颜色标识。
- **按钮状态**:操作完成后按钮会被禁用,或在审核过程中保持可用。
- **错误处理**:优雅地处理删除的消息或无效的操作。
## ? 权限
```yaml
# 通用权限
discordpunish.* # 所有权限
discordpunish.admin # 管理员权限
discordpunish.reload # 重载配置
discordpunish.test # 连接测试
# 惩罚权限
discordpunish.ceza # 查看惩罚记录
申诉权限
discordpunish.appeal.* # 所有申诉权限
discordpunish.appeal.create # 创建申诉
discordpunish.appeal.list # 列出自己的申诉
discordpunish.appeal.viewall # 查看所有申诉(管理员)
举报权限
discordpunish.report.* # 所有举报权限
discordpunish.report.create # 创建举报
discordpunish.report.list # 列出自己的举报
discordpunish.report.viewall # 查看所有举报(管理员)
discordpunish.report.notify # 接收举报通知
## ? 支持
- **GitHub Issues**: [报告错误或提出功能请求](https://github.com/amhunter1/punishsystem/issues)
- **Discord 支持**: [加入我们的 Discord](https://discord.com/users/871721944268038175)
- **电子邮件**: gfwilliamtr@gmail.com
---
**DiscordPunishBot v2.0.0** - 为您的 Minecraft 服务器提供专业级的处罚、申诉和举报管理系统。
*由 Melut 开发 - 2025*
DiscordPunishBot v2.0.0
?? Türkçe README için aşağı kaydırın | ?? English README
?? English README
A professional punishment, appeal, and report management system plugin for Minecraft servers with advanced Discord integration.
✨ Key Features
? Advanced Discord Integration
- Interactive Button System: Approve/reject appeals and reports directly from Discord
- Rich Embed Messages: Beautiful, detailed embed messages with status colors
- Slash Commands: Full Discord slash command support for all punishment types
- Role-Based Permissions: Assign specific Discord roles for different operations
- Real-Time Notifications: Instant Discord notifications for new appeals/reports
- Multi-Channel Support: Separate channels for logs, appeals, and reports
⚖️ Complete Appeal System
- Appeal Commands:
/appeal, /appeal list, /appeal status <id>
- Interactive Discord Buttons: Approve, reject, or investigate appeals from Discord
- Appeal Status Tracking: Pending, Under Review, Approved, Rejected
- Automatic Notifications: Players get notified of appeal decisions
- Cooldown System: 24-hour cooldown between appeals
- Admin Response System: Admins can add responses to appeal decisions
? Advanced Report System
- Report Commands:
/report <player> <reason>, /report anonymous <player> <reason>
- Interactive Moderation: Approve, reject, or investigate reports from Discord
- Priority Levels: Low, Medium, High, Urgent, Critical with color coding
- Anonymous Reports: Complete privacy protection for reporters
- Status Tracking: Pending, Under Review, Investigating, Resolved, Dismissed, Duplicate
- Cooldown Management: 5-minute cooldown between reports
? Configurable Reward System
- Console Command Rewards: Execute any console command as reward
- Flexible Configuration: Different rewards for correct reports/appeals
- Automatic Distribution: Rewards given automatically upon approval
- Custom Messages: Configurable reward notification messages
?️ Database & Performance
- Dual Database Support: SQLite (default) and MySQL
- Transaction Management: Proper commit/rollback for data integrity
- Connection Pool: Optimized database connection management
- Async Operations: Non-blocking database operations for better performance
- Error Recovery: Automatic error handling and recovery mechanisms
? Installation
1. Requirements
- Java 17+
- Spigot/Paper 1.20+
- Essentials Plugin
- Discord Bot with permissions
2. Plugin Setup
- Download
DiscordPunishBot-2.0.0.jar
- Place in your
plugins folder
- Start server (config files will be generated)
- Stop server and configure
3. Discord Bot Setup
- Go to Discord Developer Portal
- Create new application → Bot tab → Create bot
- Copy bot token
- OAuth2 → URL Generator:
- Scopes:
bot, applications.commands
- Permissions:
Send Messages, Use Slash Commands, Read Message History, Manage Messages
- Add bot to your server using generated URL
4. Configuration
Edit config.yml:
# Discord Configuration
discord:
token: "YOUR_BOT_TOKEN_HERE"
guild-id: "YOUR_GUILD_ID_HERE"
# Channel Configuration
log-channel-id: "LOG_CHANNEL_ID" # General punishment logs
appeal-channel-id: "APPEAL_CHANNEL_ID" # Appeal notifications
report-channel-id: "REPORT_CHANNEL_ID" # Public report notifications
report-log-channel-id: "REPORT_LOG_ID" # Admin report management
# Admin Role Configuration
report-admin-role-id: "REPORT_ADMIN_ROLE" # Role for report management
appeal-admin-role-id: "APPEAL_ADMIN_ROLE" # Role for appeal management
# Punishment Roles
roles:
mute: "MUTE_ROLE_ID"
ban: "BAN_ROLE_ID"
kick: "KICK_ROLE_ID"
tempban: "TEMPBAN_ROLE_ID"
jail: "JAIL_ROLE_ID"
warn: "WARN_ROLE_ID"
other: "OTHER_ROLE_ID"
# Reward System Configuration
reward-system:
enabled: true
# Commands to execute when a report is approved
report-correct-commands:
- "eco give %player% 100"
- "tellraw %player% {\"text\":\"Thanks for the correct report! +100 coins\",\"color\":\"green\"}"
# Commands to execute when an appeal is approved
appeal-approved-commands:
- "eco give %player% 50"
- "tellraw %player% {\"text\":\"Your appeal was approved! +50 coins\",\"color\":\"green\"}"
# Custom messages
report-approved-message: "§a§l[REPORT] §7Your report was correct! You received a reward."
appeal-approved-message: "§a§l[APPEAL] §7Your appeal was approved! You received a reward."
? Commands
Discord Slash Commands
/mute <player> [reason] - Mute a player
/ban <player> [reason] - Ban a player
/kick <player> [reason] - Kick a player
/tempban <player> [reason] - Temporary ban
/jail <player> [reason] - Jail a player
/warn <player> [reason] - Warn a player
/diger <player> [reason] - Other punishments
/ceza <player> - View punishment history
Minecraft Commands
General Commands
/ceza <player> - View player's punishment history
/dpunish reload - Reload configuration
/dpunish info - Plugin information
/dpunish test <database/discord> - Test connections
/dpunish stats - Server statistics
Appeal Commands
/appeal - Show available punishments to appeal
/appeal <punishment_id> <reason> - Create new appeal
/appeal list - List your appeals
/appeal status <appeal_id> - Check appeal status
Report Commands
/report <player> <reason> [description] - Create report
/report anonymous <player> <reason> [description] - Anonymous report
/report list - List your reports
/report status <report_id> - Check report status
? Discord Interactive Features
Report Management Buttons
When a report is created, admins see these buttons in the report log channel:
- ✅ Approve & Manual Punishment - Approve report, give rewards, requires manual punishment
- ❌ Reject - Reject the report as invalid
- ? Investigate - Mark as under investigation (keeps buttons active)
Appeal Management Buttons
When an appeal is created, admins see these buttons in the appeal channel:
- ✅ Approve Appeal - Approve appeal, remove punishment, give rewards
- ❌ Reject Appeal - Reject the appeal as invalid
- ? Investigate - Mark as under investigation (keeps buttons active)
Interactive Features
- Real-time Updates: Embed messages update automatically when status changes
- Admin Tracking: Shows which admin processed the request
- Status Colors: Different colors for pending, approved, rejected, investigating
- Button States: Buttons are disabled after action or remain active during investigation
- Error Handling: Graceful handling of deleted messages or invalid operations
? Permissions
# General Permissions
discordpunish.* # All permissions
discordpunish.admin # Admin permissions
discordpunish.reload # Reload config
discordpunish.test # Test connections
# Punishment Permissions
discordpunish.ceza # View punishment history
# Appeal Permissions
discordpunish.appeal.* # All appeal permissions
discordpunish.appeal.create # Create appeals
discordpunish.appeal.list # List own appeals
discordpunish.appeal.viewall # View all appeals (admin)
# Report Permissions
discordpunish.report.* # All report permissions
discordpunish.report.create # Create reports
discordpunish.report.list # List own reports
discordpunish.report.viewall # View all reports (admin)
discordpunish.report.notify # Receive report notifications
?️ Advanced Configuration
Database Settings
database:
type: "sqlite" # or "mysql"
# MySQL Configuration (if using MySQL)
host: "localhost"
port: 3306
database: "punishments"
username: "your_username"
password: "your_password"
Language Settings
language: "tr" # "tr" for Turkish, "en" for English
Customizing Punishments
punishments:
mute:
spam:
command: "essentials:mute %player% 30m Spam"
display: "Spam (30 minutes)"
toxic:
command: "essentials:mute %player% 2h Toxic behavior"
display: "Toxic Behavior (2 hours)"
? Troubleshooting
Common Issues
Bot not responding to slash commands:
- Check bot token in config
- Verify bot has
applications.commands scope
- Check role permissions in Discord
- Use
/dpunish test discord in-game
Database errors:
- Check database type in config
- For MySQL: verify connection details
- For SQLite: check file permissions
- Use
/dpunish test database in-game
Interactive buttons not working:
- Verify admin role IDs are correct
- Check bot permissions in Discord channels
- Ensure bot can manage messages
- Check server logs for detailed errors
Reports/Appeals not showing:
- Check channel IDs in config
- Verify bot has access to channels
- Check user permissions
- Use
/dpunish test discord to verify setup
? Features in Detail
Status System
- Reports: Pending → Under Review → Investigating → Resolved/Dismissed/Duplicate
- Appeals: Pending → Under Review → Approved/Rejected
- Color Coding: Each status has distinct colors in Discord embeds
- Notifications: Automatic player notifications for status changes
Reward System
- Configurable Commands: Execute any console command as reward
- Multiple Rewards: Different rewards for different actions
- Player Notifications: Custom messages when rewards are given
- Flexible Placeholders: Use
%player% in commands and messages
Database Design
- Punishments Table: Core punishment data
- Appeals Table: Linked to punishments with foreign keys
- Reports Table: Independent reporting system
- Indexes: Optimized for performance
- Transactions: ACID compliance for data integrity
? Support
?? Türkçe README
Minecraft sunucuları için Discord entegrasyonu ile gelişmiş ceza, itiraz ve şikayet yönetim sistemi.
✨ Temel Özellikler
? Gelişmiş Discord Entegrasyonu
- İnteraktif Buton Sistemi: İtiraz ve şikayetleri Discord'dan direkt onayla/reddet
- Zengin Embed Mesajları: Durum renkli güzel ve detaylı embed mesajları
- Slash Komutları: Tüm ceza türleri için Discord slash komut desteği
- Rol Bazlı İzinler: Farklı işlemler için özel Discord rolleri
- Gerçek Zamanlı Bildirimler: Yeni itiraz/şikayet için anında Discord bildirimleri
- Multi-Kanal Desteği: Log, itiraz ve şikayet için ayrı kanallar
⚖️ Komple İtiraz Sistemi
- İtiraz Komutları:
/appeal, /appeal list, /appeal status <id>
- İnteraktif Discord Butonları: Discord'dan itirazları onayla, reddet veya incele
- İtiraz Durum Takibi: Beklemede, İnceleniyor, Onaylandı, Reddedildi
- Otomatik Bildirimler: Oyuncular itiraz kararlarından haberdar edilir
- Cooldown Sistemi: İtirazlar arası 24 saat bekleme
- Admin Yanıt Sistemi: Adminler itiraz kararlarına yanıt ekleyebilir
? Gelişmiş Şikayet Sistemi
- Şikayet Komutları:
/report <oyuncu> <sebep>, /report anonymous <oyuncu> <sebep>
- İnteraktif Moderasyon: Discord'dan şikayetleri onayla, reddet veya incele
- Öncelik Seviyeleri: Düşük, Orta, Yüksek, Acil, Kritik - renk kodlamalı
- Anonim Şikayetler: Şikayetçi için tam gizlilik koruması
- Durum Takibi: Beklemede, İnceleniyor, Araştırılıyor, Çözüldü, Reddedildi, Tekrar
- Cooldown Yönetimi: Şikayetler arası 5 dakika bekleme
? Yapılandırılabilir Ödül Sistemi
- Konsol Komut Ödülleri: Ödül olarak herhangi bir konsol komutu çalıştır
- Esnek Yapılandırma: Doğru şikayet/itiraz için farklı ödüller
- Otomatik Dağıtım: Onay sonrası ödüller otomatik verilir
- Özel Mesajlar: Yapılandırılabilir ödül bildirim mesajları
?️ Veritabanı & Performans
- Çift Veritabanı Desteği: SQLite (varsayılan) ve MySQL
- Transaction Yönetimi: Veri bütünlüğü için uygun commit/rollback
- Bağlantı Havuzu: Optimize edilmiş veritabanı bağlantı yönetimi
- Async İşlemler: Daha iyi performans için engelleyici olmayan işlemler
- Hata Kurtarma: Otomatik hata yönetimi ve kurtarma mekanizmaları
? Kurulum
1. Gereksinimler
- Java 17+
- Spigot/Paper 1.20+
- Essentials Plugin
- İzinli Discord Bot
2. Plugin Kurulumu
DiscordPunishBot-2.0.0.jar dosyasını indirin
plugins klasörüne yerleştirin
- Sunucuyu başlatın (config dosyaları oluşacak)
- Sunucuyu durdurun ve yapılandırın
3. Discord Bot Kurulumu
- Discord Developer Portal'a gidin
- Yeni uygulama oluşturun → Bot sekmesi → Bot oluştur
- Bot token'ı kopyalayın
- OAuth2 → URL Generator:
- Scope'lar:
bot, applications.commands
- İzinler:
Send Messages, Use Slash Commands, Read Message History, Manage Messages
- Oluşan URL ile botu sunucunuza ekleyin
4. Yapılandırma
config.yml düzenleyin:
# Discord Yapılandırması
discord:
token: "BOT_TOKEN_BURAYA"
guild-id: "SUNUCU_ID_BURAYA"
# Kanal Yapılandırması
log-channel-id: "LOG_KANAL_ID" # Genel ceza logları
appeal-channel-id: "ITIRAZ_KANAL_ID" # İtiraz bildirimleri
report-channel-id: "SIKAYET_KANAL_ID" # Genel şikayet bildirimleri
report-log-channel-id: "SIKAYET_LOG_ID" # Admin şikayet yönetimi
# Admin Rol Yapılandırması
report-admin-role-id: "SIKAYET_ADMIN_ROL" # Şikayet yönetimi rolü
appeal-admin-role-id: "ITIRAZ_ADMIN_ROL" # İtiraz yönetimi rolü
# Ceza Rolleri
roles:
mute: "MUTE_ROL_ID"
ban: "BAN_ROL_ID"
kick: "KICK_ROL_ID"
tempban: "TEMPBAN_ROL_ID"
jail: "JAIL_ROL_ID"
warn: "WARN_ROL_ID"
other: "OTHER_ROL_ID"
# Ödül Sistemi Yapılandırması
reward-system:
enabled: true
# Şikayet onaylandığında çalışacak komutlar
report-correct-commands:
- "eco give %player% 100"
- "tellraw %player% {\"text\":\"Doğru şikayet için teşekkürler! +100 coin\",\"color\":\"green\"}"
# İtiraz onaylandığında çalışacak komutlar
appeal-approved-commands:
- "eco give %player% 50"
- "tellraw %player% {\"text\":\"İtirazın onaylandı! +50 coin\",\"color\":\"green\"}"
# Özel mesajlar
report-approved-message: "§a§l[ŞİKAYET] §7Şikayetin doğruydu! Ödül aldın."
appeal-approved-message: "§a§l[İTİRAZ] §7İtirazın onaylandı! Ödül aldın."
? Komutlar
Discord Slash Komutları
/mute <oyuncu> [sebep] - Oyuncuyu sustur
/ban <oyuncu> [sebep] - Oyuncuyu yasakla
/kick <oyuncu> [sebep] - Oyuncuyu at
/tempban <oyuncu> [sebep] - Geçici yasakla
/jail <oyuncu> [sebep] - Oyuncuyu hapsset
/warn <oyuncu> [sebep] - Oyuncuyu uyar
/diger <oyuncu> [sebep] - Diğer cezalar
/ceza <oyuncu> - Ceza geçmişini görüntüle
Minecraft Komutları
Genel Komutlar
/ceza <oyuncu> - Oyuncunun ceza geçmişini görüntüle
/dpunish reload - Yapılandırmayı yeniden yükle
/dpunish info - Plugin bilgileri
/dpunish test <database/discord> - Bağlantıları test et
/dpunish stats - Sunucu istatistikleri
İtiraz Komutları
/appeal - İtiraz edilebilir cezaları göster
/appeal <ceza_id> <sebep> - Yeni itiraz oluştur
/appeal list - İtirazlarını listele
/appeal status <itiraz_id> - İtiraz durumunu kontrol et
Şikayet Komutları
/report <oyuncu> <sebep> [açıklama] - Şikayet oluştur
/report anonymous <oyuncu> <sebep> [açıklama] - Anonim şikayet
/report list - Şikayetlerini listele
/report status <sikayet_id> - Şikayet durumunu kontrol et
? Discord İnteraktif Özellikler
Şikayet Yönetim Butonları
Şikayet oluşturulduğunda adminler şikayet log kanalında bu butonları görür:
- ✅ Onayla & Manuel Ceza - Şikayeti onayla, ödül ver, manuel ceza gerekli
- ❌ Reddet - Şikayeti geçersiz olarak reddet
- ? İncelemeye Al - İnceleme olarak işaretle (butonları aktif tutar)
İtiraz Yönetim Butonları
İtiraz oluşturulduğunda adminler itiraz kanalında bu butonları görür:
- ✅ İtirazı Onayla - İtirazı onayla, cezayı kaldır, ödül ver
- ❌ İtirazı Reddet - İtirazı geçersiz olarak reddet
- ? İncelemeye Al - İnceleme olarak işaretle (butonları aktif tutar)
İnteraktif Özellikler
- Gerçek Zamanlı Güncellemeler: Durum değiştiğinde embed mesajları otomatik güncellenir
- Admin Takibi: Hangi adminin işlemi yaptığını gösterir
- Durum Renkleri: Beklemede, onaylandı, reddedildi, inceleniyor için farklı renkler
- Buton Durumları: İşlem sonrası butonlar deaktive olur veya inceleme sırasında aktif kalır
- Hata Yönetimi: Silinmiş mesajlar veya geçersiz işlemler için zarif hata yönetimi
? İzinler
# Genel İzinler
discordpunish.* # Tüm izinler
discordpunish.admin # Admin izinleri
discordpunish.reload # Config yenileme
discordpunish.test # Bağlantı testleri
# Ceza İzinleri
discordpunish.ceza # Ceza geçmişi görüntüleme
# İtiraz İzinleri
discordpunish.appeal.* # Tüm itiraz izinleri
discordpunish.appeal.create # İtiraz oluşturma
discordpunish.appeal.list # Kendi itirazlarını listeleme
discordpunish.appeal.viewall # Tüm itirazları görme (admin)
# Şikayet İzinleri
discordpunish.report.* # Tüm şikayet izinleri
discordpunish.report.create # Şikayet oluşturma
discordpunish.report.list # Kendi şikayetlerini listeleme
discordpunish.report.viewall # Tüm şikayetleri görme (admin)
discordpunish.report.notify # Şikayet bildirimleri alma
? Destek
DiscordPunishBot v2.0.0 - Minecraft sunucunuz için profesyonel ceza, itiraz ve şikayet yönetim sistemi.
Developed by Melut - 2025
评论 0
登录后参与评分
还没有评论,来抢沙发吧