📃Bukkit Configuración (config.yml)

🧾 Overview

This page explains all the configuration options available in the config.yml file of the EpicReports plugin for Minecraft servers. You'll learn how to set the language, control report behavior, manage notifications (including Discord), and enable MySQL for BungeeCord support. Each option is explained in detail to help you customize the plugin to fit your server's needs.

🌐 Language

Language: en_EN.yml

This option sets the language file used by the plugin. The file must be located in the languages folder inside the plugin directory. You can create multiple language files (e.g., es_ES.yml, fr_FR.yml) and switch by changing this value to the corresponding filename.

⚙️ Report Settings (Reports_Settings)

Reports_Settings:
  Max_reports_per_person: true  
  max_reports: 5
  report_offline_players: true
  activate_ers_menu_alias: true
  ers_menu_alias: "reports"

• Max_reports_per_person: When set to true, limits how many reports a player can make against the same player. By default, a player can report another player a maximum of 5 times. This counter resets when the server restarts.

• max_reports: Sets the maximum number of reports a player can make against another player. Only applies if Max_reports_per_person is enabled.

• report_offline_players: Allows reporting of offline players. This option is automatically disabled if MySQL mode is active.

• activate_ers_menu_alias: Enables a custom alias for the main report menu command, useful as a shortcut for /epicreports menu.

• ers_menu_alias: Sets the shortcut command. For example, if set to reports, players can open the menu using /reports.

🔔 Notification Settings (Notify_Settings)

Notify_Settings:
  notify_reports_msg: true
  notify_reports_title: true
  notify_reports_sounds: true
  report_sound: BLOCK_NOTE_BLOCK_PLING;10;2
  notify_processed_reports_msg: true
  notify_processed_reports_title: true
  notify_processed_reports_sounds: true
  report_processed_sound: BLOCK_NOTE_BLOCK_PLING;10;2
  skip_reports: true
  minimum_size_to_skip: 5

• notify_reports_msg: Sends a message to all players with the epicreports.admin permission whenever a new report is created. (Message text can be customized in the language file.)

• notify_reports_title: Displays a screen title to admins when a new report is submitted.

• notify_reports_sounds: Plays a sound to admins when a report is created.

• report_sound: Sets the sound for report notifications. Format: SOUND_NAME;VOLUME;PITCH

  Example: BLOCK_NOTE_BLOCK_PLING;10;2 Sound references:

  • Sounds 1.8

  • Sounds 1.9+

• notify_processed_reports_msg: Sends a message to the reporter when an admin changes the report status to "processing". Only sent if the reporter is online.

• notify_processed_reports_title: Displays a title to the reporter when their report status is changed to "processing", if they're online.

• notify_processed_reports_sounds: Plays a sound for the reporter when their report is being processed, if online.

• report_processed_sound: Sound used for report processing notifications. Follows the same format as report_sound.

• skip_reports: When enabled, groups multiple report notifications into a single summarized message if several reports are made in a short time.

• minimum_size_to_skip: Minimum number of reports required to trigger the notification grouping described above.

💬 Discord Notifications

Discord_Notifications: true

Enables sending report notifications to a Discord channel.

Requires the additional plugin ErsDiscord to handle Discord integration.

• You can learn how to configure Ers Discord here.

💾 MySQL / BungeeCord Setup

MySQL-active: true
host: 127.0.0.1
port: 3306
database: epicreports
user: root
password: your_password

• MySQL-active: Enables BungeeCord mode and connects the plugin to a MySQL database.

  ⚠️ Only enable this if you're using BungeeCord and want to sync data across servers.

• host: IP address or hostname of your MySQL server.

• port: MySQL server port.

• database: Name of the database used to store report data.

• user: MySQL username.

• password: MySQL password for the above user.

Make sure to install the plugin on every server in your BungeeCord network and configure them all to use the same database for proper data synchronization.