Punish System

插件

· 作者 melut

一个带有 Discord 集成的 Minecraft 插件,用于封禁、静音和警告玩家。所有处罚记录都会自动记录到指定的 Discord 频道中。

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

最新 2.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

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

  1. Download DiscordPunishBot-2.0.0.jar
  2. Place in your plugins folder
  3. Start server (config files will be generated)
  4. Stop server and configure

3. Discord Bot Setup

  1. Go to Discord Developer Portal
  2. Create new application → Bot tab → Create bot
  3. Copy bot token
  4. OAuth2 → URL Generator:
    • Scopes: bot, applications.commands
    • Permissions: Send Messages, Use Slash Commands, Read Message History, Manage Messages
  5. 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 小时)"

? 故障排除

常见问题

机器人未响应斜杠命令:

  1. 检查配置文件中的机器人令牌
  2. 验证机器人是否具有 applications.commands 作用域
  3. 检查 Discord 中的角色权限
  4. 在游戏中使用 /dpunish test discord

数据库错误:

  1. 检查配置文件中的数据库类型
  2. 对于 MySQL:验证连接详情
  3. 对于 SQLite:检查文件权限
  4. 在游戏中使用 /dpunish test database

交互按钮无法工作:

  1. 验证管理员角色 ID 是否正确
  2. 检查 Discord 频道中机器人的权限
  3. 确保机器人可以管理消息
  4. 检查服务器日志以获取详细错误信息

报告/申诉未显示:

  1. 检查配置文件中的频道 ID
  2. 验证机器人是否有访问频道的权限
  3. 检查用户权限
  4. 使用 /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. 插件安装

  1. 下载 DiscordPunishBot-2.0.0.jar 文件
  2. 将其放入 plugins 文件夹中
  3. 启动服务器(将生成配置文件)
  4. 停止服务器并进行配置

3. Discord 机器人设置

  1. 访问 Discord Developer Portal
  2. 创建新应用 → 进入 Bot 选项卡 → 点击创建 Bot
  3. 复制 Bot Token
  4. OAuth2 → URL Generator:
    • 作用域:bot, applications.commands
    • 权限:Send Messages, Use Slash Commands, Read Message History, Manage Messages
  5. 使用生成的链接将机器人添加到你的服务器

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*

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源