DocumentationBot: Version 1

2026-10-01T04:13:05Z

Version 1

New page

{{ANEURISMNav}}

Start with the server log and the message shown to the joining player. For the Linux service in the [[ANEURISM IV/Dedicated servers|installation guide]], read recent output with:

<syntaxhighlight lang="bash">
journalctl --user -u aniv.service -n 200 --no-pager
</syntaxhighlight>

== The dedicated server exits during startup ==

Check that <code>ANIV_COMMUNITY_OWNER_STEAM_ID</code> is your 17-digit personal SteamID64 and that <code>ANIV_DATA_ROOT</code> is an absolute writable directory. An existing database must use its original owner.

Set <code>ANIV_MAP</code> to <code>aneurismiv</code> or <code>misery</code>. The error <code>Configured server map does not exist in this build</code> means the selected map isn't in the installed build. Reusing an old <code>nightmare</code> setting can cause this error.

Validate the Steam installation if <code>steam_appid.txt</code> is missing or doesn't contain <code>2773280</code>. Keep the bundled Steam libraries with the executable.

If the service reaches its start limit after repeated failures, fix the error first, then run:

<syntaxhighlight lang="bash">
systemctl --user reset-failed aniv.service
systemctl --user start aniv.service
</syntaxhighlight>

== The server isn't listed ==

For in-game hosting, choose '''Anyone''' before starting. Friends and Invite only sessions aren't publicly listed.

A dedicated server must finish Steam login, relay allocation, and map loading before it can accept players. Allocation can take up to three minutes. If the log reports <code>steam_fake_ip_timeout</code>, check outbound Steam access and try again after the connection recovers.

Another process must not own local UDP ports <code>27015</code> or <code>27016</code>. Stop the conflicting process or use a separate network namespace or virtual machine. Opening public firewall ports won't fix a local port conflict.

Refresh '''Community''' after startup. If a password change reports that the Steam listing was withdrawn, restart hosting after correcting the reported metadata problem.

== Version mismatch ==

The game version is a name such as <code>20-preview1</code>. The host and joining player must use the same version name, including capitalization.

Update both installations and check Steam's beta selection. The setup guide uses <code>preview</code>. Older builds can have additional compatibility checks, so keep both sides current on the same branch when diagnosing a mismatch.

== A player cannot join ==

Check the rejection message, then the password, local ban, whitelist, and available slots. An empty whitelist allows ordinary admission; a nonempty whitelist restricts staff as well as other players. Read the [[ANEURISM IV/Server administration#Whitelist|whitelist limitation]] before enabling it. If it has locked out every administrator, stop the server and restore a backup from before it was enabled.

Joining also requires Steam authentication and a Nexus account-policy check. If either service is unavailable, retry when it recovers. Community servers don't need a Nexus server credential, and there is no setting that bypasses the player policy check.

A local unban doesn't remove a Nexus ban. A Nexus unban doesn't remove an independent local ban.

== Staff commands are denied ==

Use the Steam account assigned to the saved world's owner or staff role. Only the owner can assign ranks. A moderator can't manage server configuration, and staff can't act on themselves or on someone of equal or higher authority.

Changing <code>ANIV_COMMUNITY_OWNER_STEAM_ID</code> on an existing world won't replace its owner. Use the account recorded for that world.

== Settings didn't change ==

Check the file path, key spelling, capitalization, and double quotes. General settings belong in <code>aniv.cfg</code>; gameplay values belong in <code>customserverrules.cfg</code>. Check the log for a parse error.

Restart for changes to startup settings, the message of the day, or fate overrides. Removing a gameplay setting from a file requires a restart to restore its default. See [[ANEURISM IV/Server configuration#Apply changes|Apply changes]] for the limits of <code>reloadservercfg</code>.

If the wrong name appears, check for an old <code>systemServerName</code> value as well as <code>ANIV_SERVER_NAME</code>.

== Voice chat isn't working ==

Choose and test the microphone in Steam's voice settings. Check the game's receive volume, radio volume, push-to-talk bindings, and mute settings. The game must have focus to capture voice input.

Proximity voice depends on distance. Radio voice requires an eligible faction and matching radio channel. Test with another nearby player before troubleshooting a radio-only problem. A server mute prevents that player from transmitting.

Voice travels with the game connection. You don't need to open a separate voice port or install a voice server.

== Find the player log ==

{| class="wikitable"
! Platform !! Log location
|-
| Windows || <code>%USERPROFILE%\AppData\LocalLow\Vellocet\ANEURISM IV\Player.log</code>
|-
| Linux || <code>~/.config/unity3d/Vellocet/ANEURISM IV/Player.log</code>
|-
| macOS || <code>~/Library/Logs/Vellocet/ANEURISM IV/Player.log</code>
|}

These are the game's [https://docs.unity3d.com/2022.3/Documentation/Manual/LogFiles.html Unity player log locations]. The dedicated-server examples use <code>-logFile -</code>, which sends the log to the terminal or system journal instead. When asking for help, include the game version, operating system, map, and relevant error messages. Remove passwords and Steam login tokens from anything you share.

[[Category:ANEURISM IV]]

ANEURISM IV/Troubleshooting - Revision history

DocumentationBot: Version 1