BungeeReport

A Discord-integrated report and punishment plugin for BungeeCord.

Features

• Discord Integration: Sends player reports directly to Discord via Webhooks.
• Detailed Logging: Records report details, including the reporter and the target player.
• Automated Punishment: Automatically triggers BAN or Jail actions based on playtime, number of reports, and specific multipliers.
• Punishment Logs: Sends automated logs to a dedicated Webhook when a player is banned or jailed.
• Cooldown System: Prevents report spamming with a configurable cooldown timer.
• High Customizability: Fully configurable via config.yml.

Configuration Example (config.yml)

# Discord Webhook Settings
channel_webhook: ""
mention: "<@userid>, <@&roleid>\n"

# Jail Settings
jail_server: "jail" # The name of the jail server
jail_bypass_permission: "jail.bypass" # Permission to bypass jail restrictions

# Report System Settings
min_valid_reporters_count: 2 # Minimum number of reporters required
min_reporter_playtime_hours: 2 # Minimum playtime (in hours) required for a reporter to be counted
required_playtime_multiplier: 3 # Playtime multiplier for punishment logic
report_cooldown_minutes: 5 # Cooldown between reports (0 for no cooldown)

# Punishment Settings
punishment_type: "jail" # Options: jail = Send to jail server, ban = ProxyBan
ban_message: "&cYou have been banned due to reports.\n&7If you wish to appeal, please contact the administrator."

# Punishment Log Webhook
punishment_log_webhook: "" # If empty, uses channel_webhook by default

# Execution Commands
send_command:
  - "ban {player} Automated BAN based on reports"
  # You can add multiple lines of commands here

BAN/Jail Logic Specification

The plugin automatically executes a punishment if the following conditions are met:

1. min_valid_reporters_count: There must be at least a reporters who satisfy the minimum playtime requirement.
2. min_reporter_playtime_hours: Reporters with playtime less than b hours are recorded but not counted toward the automated punishment trigger.
3. required_playtime_multiplier: The total playtime of all valid reporters must be equal to or greater than:

Example

• Reporters: A1 (1h), A2 (5h), A3 (4h)
• Target: B (3h)
• Settings: a=2, b=2, c=3
• Result: A1 is ignored (<2\text{h}). A2 + A3 total 9 hours. Since Target B (3\text{h}) \times 3 = 9\text{h}, the punishment is triggered.

Report Cooldown

• You can limit report frequency using report_cooldown_minutes.
• Set to 0 for no limit. If set to 5, players can only submit one report every 5 minutes.

Punishment Logs (Webhook)

When a BAN or Jail occurs, the following details are sent via Webhook. If punishment_log_webhook is empty, it defaults to the channel_webhook URL.

Example Webhook Content

**Type**: BAN
**Target**: playerName
**Reason**: Cheating
**Executor**: staffName

Requirements

• Java 17 or higher

BungeeReport

BungeeCord用 Discord通報・処罰連携プラグイン

主な機能

• Discord Webhookへの通報送信
• 通報内容・通報者・対象プレイヤーの記録
• プレイ時間・通報人数・倍率による自動BAN/投獄判定
• BANまたはjail（監獄送り）時にWebhookで処罰ログ送信
• 通報コマンドのクールダウン（頻度制限）
• 設定ファイル（config.yml）で柔軟にカスタマイズ

設定例（config.yml）

# Discord Webhook設定
channel_webhook: ""
mention: "<@userid>, <@&roleid>\n"

# 監獄サーバー設定
jail_server: "jail" # 監獄サーバー名
jail_bypass_permission: "jail.bypass" # 監獄制限を無効化する権限

# 通報システム設定
min_valid_reporters_count: 2 # 最低通報人数
min_reporter_playtime_hours: 2 # 通報に必要な最低プレイ時間(時間)
required_playtime_multiplier: 3 # 必要プレイ時間倍率
report_cooldown_minutes: 5 # 通報のクールダウン(分)。0で無制限

# 処罰設定
punishment_type: "jail" # jail=投獄, ban=ProxyBan
ban_message: "&cあなたは通報によりBANされました。\n&7異議がある場合は管理者までご連絡ください。"

# 処罰ログWebhook送信設定
punishment_log_webhook: "" # 空ならchannel_webhookと同じWebhookを使う

# 実行コマンド
send_command:
  - "ban {player} 通報による自動BAN"
  # ここに複数行コマンドを追加可能

BAN/jail判定の仕様

• min_valid_reporters_count（最低通報人数）… プレイ時間b以上の通報者がa人以上必要
• min_reporter_playtime_hours（最低プレイ時間）… この時間未満の通報者はカウントしない（記録は残る）
• required_playtime_multiplier（必要プレイ時間倍率）… 有効通報者のプレイ時間合計が「対象プレイヤーのプレイ時間×倍率」以上で自動BAN/投獄

例

A1(1時間), A2(5時間), A3(4時間), B(3時間) a=2, b=2, c=3 のとき、

• A1は無効、A2+A3で合計9時間、B(3時間)×3=9時間でBAN

通報コマンドのクールダウン

• report_cooldown_minutesで通報の頻度を制限できます
• 0なら無制限、5なら5分ごとに1回のみ通報可能

BAN・jail時の処罰ログWebhook送信

• BANまたはjail時、Webhookに以下のような内容が送信されます
• punishment_log_webhookが空ならchannel_webhookと同じURLを使います

送信例

**種類**: BAN
**対象**: playerName
**理由**: チート行為
**実行者**: staffName

必要環境

• Java 17以上