Bukkit Configuration
This page is about the Bukkit/Sponge config.yml file and the various settings it provides.
For Bungee see Bungee Configuration
Page version: 4.7.2
| Setting | Default | Description |
|---|---|---|
| ServerName | 'Plan' | Name of the server, placed on the Analysis page and used to access the analysis page on Bungee WebServer |
| Setting | Default | Description |
|---|---|---|
| Logging.Locale | default | 2 letter Locale code, selects the locale used (Found inside the jar) |
| Logging.Create_new_locale_file_on_next_enable | false | Writes a new locale.txt file to plugin folder on plugin enable and sets this back to false. |
| Logging.Debug | false | Logger debug mode, takes one or multiple options 'true'/'both'/'all','false','console','file','memory'. Example: "file, console" |
| Logging.Dev | false | Enables development error logging as well as other debug messages |
| Logging.Delete_logs_after_days | 7 | Number of days after which log files are removed |
| Update_notifications.Check_for_updates | true | Should update notification be displayed on the website |
| Update_notifications.Notify_about_DEV_releases | false | Should update notifications include DEV releases |
| Configuration.Allow_bungeecord_to_manage_settings | true | Should server config file on Bungeecord apply changes to this server's config. |
| Setting | Default | Description |
|---|---|---|
| Type | SQLite | 'MySQL', 'H2' or 'SQLite' |
| MySQL.Host | localhost | |
| MySQL.Port | 3306 | |
| MySQL.User | root | User for editing the database |
| MySQL.Password | minecraft | Password of MySQL.User |
| MySQL.Database | Plan | Name of the Database to use |
| MySQL.Launch_options | ?rewriteBatchedStatements=true&useSSL=false | Launch options to use |
| Setting | Default | Description |
|---|---|---|
| Port | 8804 | Port of the Webserver |
| Alternative_IP | false | Should an alternate address be used for the WebServer links |
| Alternative_IP.Address | your.domain.here:%port% | Address to use as link in inspect and analyze commands if setting above is enabled. %port% will be replaced with the Port automatically. If you have port-forwarded an alternate address to the webserver port, %port% is not required. |
| Internal_IP | 0.0.0.0 | Internal InetAddress to start the WebServer on. 0.0.0.0 manages the Internal IP automatically. No need to change unless running in Docker. |
| Security.SSL_certificate | [[View the tutorial on setting up a SSL Certificate | |
| Disable_Webserver | false | Disables the WebServer. This is for External WebServer Use |
| External_Webserver_address | https://www.example.address | Address to give to users when WebServer is offline. |
| Setting | Default | Description |
|---|---|---|
| Commands.Log_unknown | false | Log commands that are not registered, e.g. /bremobmreb |
| Commands.Log_aliases_as_main_command | true | Combines command aliases to the main command, e.g. /i to /give |
| Geolocations | true | Enable Geolocation gathering |
Unit supports values MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS
| Setting | Default (Unit) | Description |
|---|---|---|
| Use_server_timezone | true | Attempt to use Server TimeZone everywhere. Depends on JVM Time, which is determined when server is started. False will use UTC |
| Delays.Ping_server_enable_delay | 300 (SECONDS) | Delay from server start before Ping is started to be gathered. |
| Delays.Ping_player_join_delay | 30 (SECONDS) | Delay from player login before Ping is started to be gathered. |
| Delays.Wait_for_DB_Transactions_on_disable | 20 (SECONDS) | Maximum time to wait until unfinished transactions are executed when database closes. |
| Thresholds.AFK_threshold | 3 (MINUTES) | Idle time before Plan considers a player afk |
| Thresholds.Activity_index.Login_threshold | 2 | Sessions/Week required to be considered Active by Activity Index |
| Thresholds.Activity_index.Playtime_threshold | 30 (MINUTES) | Playtime/Week to be considered Active by Activity Index |
| Thresholds.Remove_inactive_player_data_after | 180 (DAYS) | How many days player has to not log in to be removed from the database |
| Periodic_tasks.Analysis_refresh_every | 60 (MINUTES) | How often server analysis is run |
| Periodic_tasks.Check_DB_for_server_config_files_every | 1 (MINUTES) | How often database is checked for new config files |
| Periodic_tasks.Clean_caches_every | 10 (MINUTES) | How often data caches are cleaned |
| Periodic_tasks.Clean_Database_every | 1 (HOURS) | How often database is cleaned of old data |
| Setting | Default | Description |
|---|---|---|
| Theme | default | See Themes for more details about this setting |
| Sessions.Replace_accordion_with_table | false | Replaces Session Accordion with a Table |
| Sessions.Show_most_played_world_in_title | true | Adds most used world, eg "world (94.65%)" to the Session Accordion headers (Similar to session table) |
| Sessions.Show_on_page | 50 | How many sessions are visible on a page |
| Sessions.Order_world_pies_by_percentage | false | By Default WorldPie is ordered alphabetically, colors are still determined alphabetically. |
| Players_table.Show_on_server_page | 2500 | How many players are visible on /server page Players tab |
| Players_table.Show_on_players_page | 25000 | How many players are visible on /players page |
| Open_player_links_in_new_tab | false | Feature switch for old behavior of player links |
| Show_player_IPs | true | Should IPs be displayed on /player pages at all? (Normally shown partially censored) |
| Graphs.Show_gaps_in_data | false | Displays data gaps in line graphs (Might increase page load time) |
| Graphs.TPS | 18 & 10 | Thresholds for TPS graph colors |
| Graphs.Disk_space | 500 & 100 | Thresholds for Disk graph colors |
| Command_colors |
&2, &7, &f
|
Color codes to use for command messages |
| Setting | Default | Description |
|---|---|---|
| Decimal_points | '#.##' | How many decimal points should be displayed |
| Time_amount | Time amounts are formatted by replacing the placeholders of these settings. More below. | |
| Dates | Dates are formatted with SimpleDateFormat patterns | |
| Dates.Show_recent_day_names | true | The day in dates is replaced by 'Today', 'Yesterday', 'Friday' for the few most recent days. |
Default:
| Time | Formatted |
|---|---|
| 400 days, 12 hours, 30 minutes and 20 seconds | 1 year, 1 month, 5d 12h 30m 20s |
| 400 days | 1 year, 1 month, 5d |
| 12 hours 20 sec. | 12h 20s |
| 0 sec. | 0s |
Extra Zeros
TimeAmount:
Year: '1 year, '
Years: '%years% years, '
Month: '1 month, '
Months: '%months% months, '
Day: '1d '
Days: '%days%d '
Hours: '%zero%%hours%:'
Minutes: '%hours%%zero%%minutes%:'
Seconds: '%minutes%%zero%%seconds%'
Zero: '00:00:00'
| Time | Formatted |
|---|---|
| 400 days, 12 hours, 30 minutes and 20 seconds | 1 year, 1 month, 5d 12:30:20 |
| 400 days | 1 year, 1 month, 5d |
| 12 hours 20 sec. | 12:00:20 |
| 30 minutes | 00:30:00 |
| 20 sec. | 00:00:20 |
| 0 sec. | 00:00:00 |
List of Worlds and the aliases used in graph generation. You can lump worlds together by setting their alias as the same value.
See External WebServer Use for more information
| Setting | Default |
|---|---|
| HTML_Export_path | Analysis Results |
| JSON_Export_path | Raw JSON |
Parts.<any>
|
false |
| Export_player_on_login_and_logout | Exports Player's html and json on login/logout based on Parts settings |
If you have third party plugins installed, their analysis settings will be displayed here.
For example if Vault is taking too long it can be disabled.
/plan status timings and the /debug-page can help figuring out what is taking all the time.