BungeeReport

--- # 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`) ```yaml # 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 ```text **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） ```yaml # 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以上