DocumentationBot: Version 1

2026-10-01T04:13:05Z

Version 1

New page

{{ANEURISMNav}}

Set the server name, map, password, and player limit in the hosting menu or dedicated-server environment. Put gameplay rules and the message of the day in the data directory.

== Data directory ==

Dedicated servers should set <code>ANIV_DATA_ROOT</code> to an absolute path. The [[ANEURISM IV/Dedicated servers|installation guide]] uses <code>~/aneurism/data</code>, with the full path written into <code>server.env</code>.

Without this override, the game uses its per-user data directory:

{| class="wikitable"
! Platform !! Default location
|-
| Windows || <code>%USERPROFILE%\AppData\LocalLow\Vellocet\ANEURISM IV</code>
|-
| Linux || <code>$XDG_CONFIG_HOME/unity3d/Vellocet/ANEURISM IV</code>, or <code>~/.config/unity3d/Vellocet/ANEURISM IV</code> when <code>XDG_CONFIG_HOME</code> is unset
|-
| macOS || <code>~/Library/Application Support/unity.Vellocet.ANEURISM IV</code>, or <code>~/Library/Application Support/Vellocet/ANEURISM IV</code> if that directory already exists
|}

These locations follow [https://docs.unity3d.com/2022.3/Documentation/ScriptReference/Application-persistentDataPath.html Unity's per-user data paths]. The [[ANEURISM IV/Troubleshooting#Find the player log|player log]] reports configuration paths. Check it if the expected directory is absent. Keep each saved world in its own directory and never let two running servers share one.

{| class="wikitable"
! File !! Contents
|-
| <code>aniv.db</code> || Saved world, players, owner, staff assignments, local bans, and whitelist.
|-
| <code>aniv.cfg</code> || General server settings.
|-
| <code>customserverrules.cfg</code> || Gameplay values such as rewards and event durations.
|-
| <code>customobjectvalues.cfg</code> || Overrides for individual fates.
|-
| <code>motd.txt</code> || Message shown to joining players.
|-
| <code>tasks.json</code> || Saved task progress.
|}

Create the optional text files when you need them. See [[ANEURISM IV/Backups and updates|Backups and updates]] before replacing a database or moving a world.

== Shared startup settings (next update) ==

Shared [[Dedicated server launch settings|startup option names and validation]] are prepared for the next ANEURISM IV update. The current preview still uses the environment settings below. After that game update, a dedicated server can put these defaults in <code>aniv.cfg</code>:

<syntaxhighlight lang="text">
hostname "My ANEURISM server"
map "aneurismiv"
maxplayers "32"
sv_password ""
</syntaxhighlight>

Use the map ID <code>aneurismiv</code> or <code>misery</code>. Keep this file readable only by the server account if it contains a password. The optional environment values below override these defaults; explicit <code>+hostname</code>, <code>+map</code>, <code>-maxplayers</code>, and <code>+sv_password</code> options override both. Do not set the same option twice. Restart to apply changes.

== Dedicated-server environment ==

These variables are read when hosting starts. Edit <code>server.env</code> and restart the server to apply changes.

{| class="wikitable"
! Variable !! Value
|-
| <code>ANIV_COMMUNITY_OWNER_STEAM_ID</code> || Required personal SteamID64 of the owner. Use the same account for every start of this saved world.
|-
| <code>ANIV_SERVER_NAME</code> || Public name, 1–64 characters. Avoid links, addresses, control characters, and surrounding spaces. Set it explicitly.
|-
| <code>ANIV_MAX_PLAYERS</code> || Whole number from 2 to 60. Defaults to 60; the setup example uses 32.
|-
| <code>ANIV_MAP</code> || Map ID. Use <code>aneurismiv</code> or <code>misery</code>, in lowercase. Set it explicitly.
|-
| <code>ANIV_ROTATION</code> || Public label, up to 64 characters. Defaults to <code>persistent-world</code>. This label doesn't schedule map changes.
|-
| <code>ANIV_SERVER_PASSWORD</code> || Optional password, up to 64 characters with no control characters. Empty means no password.
|-
| <code>ANIV_DATA_ROOT</code> || Absolute writable path for this world's data and configuration files.
|}

The dedicated server is publicly listed in '''Community'''. Use a password to restrict admission. Friends and Invite only visibility are available when [[ANEURISM IV/Hosting from the game|hosting from the game]]. Read the [[ANEURISM IV/Server administration#Whitelist|whitelist limitation]] before using that feature.

== General settings ==

In <code>aniv.cfg</code>, write one setting per line and put its value in double quotes. Names are case-sensitive. Lines beginning with <code>#</code> are comments. Use <code>1</code> and <code>0</code> for switches.

<syntaxhighlight lang="text">
# aniv.cfg
region "eu-central"
enableGlobalChat "1"
enableReports "0"
maintenanceTime "null"
wipeShutdown "0"
</syntaxhighlight>

{| class="wikitable"
! Setting !! Default !! Use
|-
| <code>region</code> || <code>unknown</code> || Region label used in server metadata. It doesn't move the server to another location.
|-
| <code>enableGlobalChat</code> || <code>0</code> || Enable global text chat for this server with <code>1</code>.
|-
| <code>enableReports</code> || <code>0</code> || Enable the community report option in the server window with <code>1</code>.
|-
| <code>lostDisabled</code> || <code>0</code> || Disable the Lost event with <code>1</code>.
|-
| <code>maintenanceTime</code> || <code>null</code> || Start the daily maintenance warning sequence at a UTC time such as <code>03:00:00</code>. See below.
|-
| <code>wipeShutdown</code> || <code>0</code> || Exit after a gameplay world wipe with <code>1</code>.
|-
| <code>serverName</code> || Generated when absent || Fallback name used during world initialization. The hosting menu or <code>ANIV_SERVER_NAME</code> supplies the current session name.
|-
| <code>systemServerName</code> || Session name || Alternate name used by server metadata. Usually leave it unset so the listing follows your chosen session name.
|}

Keep passwords in <code>server.env</code> or set them with the in-game <code>password</code> command. Startup <code>sv_password</code> in <code>aniv.cfg</code> is part of the next update described above. The game doesn't read an <code>ANIV_*</code> environment assignment from <code>aniv.cfg</code>.

=== Maintenance timing ===

<code>maintenanceTime</code> is the UTC time when warnings begin. The server waits 10 minutes, then 5 minutes, then 1 minute before disconnecting players and shutting down networking. A setting of <code>03:00:00</code> therefore begins maintenance shutdown around <code>03:16 UTC</code>.

This setting doesn't launch a replacement process. Leave it at <code>null</code> unless your hosting setup also handles the restart. The systemd service in the installation guide restarts a crashed process; it doesn't detect a process that remains alive after networking stops.

== Gameplay rules ==

Use <code>customserverrules.cfg</code> for gameplay settings. It uses the same quoted-value format:

<syntaxhighlight lang="text">
# customserverrules.cfg
eventWartimeDuration "900"
lootCycleInterval "600"
fateRespawnTime "10"
rewardBankerTransaction "Small"
</syntaxhighlight>

See [[ANEURISM IV/Gameplay settings]] for the setting names, shipped defaults, reward values, and fate overrides.

== Message of the day ==

Write your server rules or welcome message in <code>motd.txt</code>:

<syntaxhighlight lang="text">
Welcome to the server.
Please read the rules before joining a faction.
Ask a moderator if you need help.
</syntaxhighlight>

The server reads the file when hosting starts. Restart after editing it. If the file is empty or missing, joining players see the server name instead.

== Apply changes ==

Restart after changing startup settings, the map, the message of the day, or fate overrides. Use a separate data directory for a different map.

An owner or administrator can run <code>reloadservercfg</code> from the connected game console to reread <code>aniv.cfg</code>, <code>customserverrules.cfg</code>, and loot configuration. Settings already copied into a running system, such as chat/report switches and the maintenance timer, still need a restart. Removing a gameplay override doesn't reset its value in memory; restart to restore the shipped default.

<code>reloadlocalcfg</code> affects the computer running that console. It doesn't reload a remote dedicated server. <code>customobjectvalues.cfg</code> is applied when the map initializes and isn't part of <code>reloadservercfg</code>.

[[Category:ANEURISM IV]]

ANEURISM IV/Server configuration - Revision history

DocumentationBot: Version 1