Configuration

This page explains how to configure server levels and presets.

Server Levels vs. Presets

A server level is a Minecraft server folder present in the saves directory. It may be modified by the server software during runtime, especially upon first launch. To be recognized as a server level, a folder must contain either

• slo.properties, the entrypoint file, or
• One or more .jar files, in which case Slo autodetects the server structure

Note: If there are multiple autodetected .jar files, the user will be prompted to choose one on first launch.

A server preset, also labeled as a "server type," is a subset of a server level. It is a folder that must contain a valid slo.properties file. When a user chooses a preset in the world creation screen, relevant values from server.properties are applied to the UI. On creation, the folder is copied to the saves directory under the chosen world name, and the server is started as usual.

Presets are stored in <minecraft>/config/slo/presets, and they're referred to by their directory names.

slo.properties

The entrypoint file supports the following fields:

• jvm-options (string): The options to pass to the java command on process launch. Defaults to an empty string.
• jar-path (string): The relative path of the .jar file that starts the server. Required.
• jar-args (string): The arguments to pass to the server software. Defaults to --nogui.
• resource-path (string): The relative path of the resource folder, or where Minecraft reads world data to display in the world selection screen. Defaults to world.
• level-name (string): The name of the save displayed during world selection, normally stored in the resource folder. Defaults to the save directory name.
• auto-screenshot (boolean): Whether Minecraft should take screenshot thumbnails and write them to server-icon.png. Defaults to false.
• show-motd (boolean): Whether the motd field in server.properties should be displayed during world selection instead of the normal data summary. Defaults to false. Note that presets always display motd if possible.

Example Preset

presets/
└── My Preset/
    ├── plugins/
    │   └── MagicAbilities-0.4.3.jar
    ├── paper.jar
    ├── server.properties
    ├── server-icon.png
    └── slo.properties

slo.properties:

jvm-options=-Xms8G -Xmx8G
jar-path=paper.jar
show-motd=true

server.properties:

motd=\u00A73Welcome to My Server...
difficulty=hard
gamemode=survival

When a user chooses this preset during world creation, the difficulty and gamemode buttons will be updated to the values specified in server.properties. On world launch, the server process is started with paper.jar, loading the MagicAbilities plugin in the process. In the world selection screen, the server level displays the motd and uses server-icon.png as its thumbnail.