Server settings

From AAGRINDER wiki
Revision as of 13:56, 8 September 2022 by Maze (talk | contribs) (remove wiki formatting for link)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

The AAGRINDER server has a number of settings, which can be found in the file config.json. This file is created when the server is first started, and it is filled with default values. If the file already exists when the server is started, its contents are read and interpreted. In case any settings are missing, default values are added to the file automatically.

The following table lists all the settings, their default values and their explanations.

Setting name Default value Explanation
level_name "world" The name of the directory where the world will be saved.
level_seed Random value (0 - 65535) The seed, which will be used for terrain generation.
generate_structures true Whether or not structures should be generated.
spawn_monsters true Whether or not monsters should spawn on this server.
load_distance 1 The distance (in chunks) in which chunks are loaded around the player.
enable_unloading true Whether chunks should be unloaded server-side when not needed.
unload_distance 2 The distance (in chunks), beyond which chunks are unloaded on client & server.
gamemode 0 The default gamemode on this server.
allow_home true Whether the /home command is allowed.
server_port 8080 The port on which the server should run.
restrict_to_localhost false Whether only localhost should be allowed to connect to this server.
allow_registration true Whether registration should be publicly available.
enable_autosave true Whether the world should be saved periodically and upon receiving SIGINT.
autosave_minutes 120 The interval for automatic saving.
max_players 42 The number of players that are allowed to play at the same time.
matrix_room_id "" the ID of the (optionally) bridged Matrix room.
matrix_homeserver_url "" Your Matrix homeserver URL.
matrix_bot_enabled false Whether the Matrix bridge bot should be enabled.
matrix_bot_access_token "" The access token for your Matrix bot account.
matrix_appservice_enabled false Whether the Matrix appservice bridge should be enabled.
matrix_appservice_id "aagrinder" The desired ID for the Matrix appservice.
matrix_appservice_url "http://localhost:8433" The URL on which this appservice will be accessible from your Matrix server.
matrix_appservice_domain "example.org" The domain for the Matrix server.
matrix_appservice_bindaddress "localhost" The host on which this appservice will be accessible from your Matrix server.
matrix_appservice_port 8433 The port on which this appservice will be accessible from your Matrix server.
authorization true Whether admin.txt should be checked.
allow_sudo false Whether the /sudo command should be allowed for the users specified in the file sudo.txt.
enable_server_log true Whether a log of logins, messages and commands should be kept.
debug_server false Whether additional debug features should be enabled (increases network load)
enable_debug_log false Whether a log of all events should be kept (huge ram usage!)
enable_autologin false Whether the login screen should be skipped.
autologin_name "user" The name to log in as if autologin is enabled.
multithread 4 The number of threads to use for terrain generation.
welcome_message "" A message that will be displayed after login.