====== Minecraft ======

This page documents the Minecraft server infrastructure and configuration used by Scorpi.

===== Overview =====

The server runs on [[https://papermc.io/|Paper]], a high-performance fork of Spigot optimized for stability and performance. Paper includes additional configuration options and optimizations not available in vanilla or standard Spigot servers.

===== Server Software =====

^ Component ^ Version ^ Notes ^
| Server Software | Paper | Performance-optimized Spigot fork |
| Game Version | //varies// | Updated as needed |

===== Configuration =====

Paper uses several configuration files beyond the standard ''server.properties'':

  * ''paper-global.yml'' - Global server settings
  * ''paper-world-defaults.yml'' - Default world configuration
  * ''spigot.yml'' - Spigot-inherited settings
  * ''bukkit.yml'' - Bukkit-inherited settings

===== Plugins =====

This section documents plugins installed on the server and any required configuration.

==== AutoBackup ====

AutoBackup provides automated world backups on a scheduled basis.

=== Requirements ===

AutoBackup requires the server to remain active (not paused) to function. By default, Paper servers pause when no players are online, which prevents scheduled tasks from running.

=== Configuration ===

To ensure AutoBackup runs correctly, the server pause feature must be disabled.

**File:** ''paper-global.yml''

**Section:** ''misc''

<code yaml>
misc:
  pause-when-empty-seconds: -1
</code>

^ Setting ^ Value ^ Effect ^
| ''pause-when-empty-seconds'' | ''-1'' | Disables server pausing entirely |
| ''pause-when-empty-seconds'' | ''0'' | Default; pauses immediately when empty |
| ''pause-when-empty-seconds'' | ''n'' | Pauses after //n// seconds with no players |

<WRAP center round important 60%>
Setting this to ''-1'' means the server continues consuming resources even when empty. This is necessary for any plugin that needs to perform scheduled tasks (backups, maintenance, etc.) regardless of player activity.
</WRAP>

===== See Also =====

  * [[https://docs.papermc.io/|Paper Documentation]]
  * [[https://papermc.io/downloads|Paper Downloads]]