🖧 ATLYSS Dedicated Server Plugin

Now updated for the latest ATLYSS version.

This BepInEx plugin adds headless dedicated server support to the game ATLYSS, enabling you to run the game in a terminal as a dedicated server — no graphics or UI needed.

⚠️ This is for hosting servers only. It will disable itself when the game is being launched normally.

✅ Mod Compatibility

• Fully compatible with other BepInEx mods that modify or enhance hosting behavior.
  This includes:
  • Chat formatting mods (e.g., colored messages)
  • Uncapped party size or connection limit mods
  • Custom stat or balance changes
  • Lobby tweak plugins

As long as the mod loads under BepInEx and applies during host/server initialization, it will work seamlessly with this dedicated server plugin.

🔍 Known Bugs

• Console input does not echo back while typing.
  When using the BepInEx console, typed characters may not appear on screen. However, input is still being received and processed correctly — pressing Enter will submit the full command.

• No feedback for partially typed commands.
  Since input isn't echoed, it's easy to lose track of what you've typed. To mitigate this, commands should be typed carefully and can be confirmed once submitted.

✅ Requirements

• BepInEx 5.x
• ATLYSS game
• Must launch the game with the following arguments:

-batchmode -nographics -server

🛠️ Launch Syntax

ATLYSS.exe -batchmode -nographics -server [options...]

You must include -batchmode -nographics before your own custom arguments.

🔧 Available Arguments

⚠️ Only one of -public, -private, or -friends can be used.
⚠️ Only one of -pve, -pvp, or -social can be used.
⚠️ If -hostsave is not specified, the server will default to using save slot 0.
You must have a valid character in the selected slot.

📦 Example Usages

Start a public PvE server with 16 players:

ATLYSS.exe -batchmode -nographics -server -name "MyServer" -motd "Welcome!" -maxplayers 16 -public -pve

Start a private PvP server with a password:

ATLYSS.exe -batchmode -nographics -server -name "Private Warzone" -password "hunter2" -maxplayers 10 -private -pvp

Start a friends-only social server:

ATLYSS.exe -batchmode -nographics -server -name "CozyHub" -motd "Grab tea and chill." -friends -social

🧠 Behavior Notes

• The host is teleported to the fishing area 30 seconds after spawning.
• Server shuts down 5 seconds after host stop (clean shutdown).
• In-game chat is mirrored to the terminal (color tags handled).
• Console input works for typing commands directly.
• Audio is disabled via AudioListener.volume = 0.
• Server config and startup logs are shown in the console.

🧪 Troubleshooting

• ❌ Server disappearing when trying to join? Make sure you have a character saved in slot 0, or specify a -hostsave slot when starting.
• ❌ Nothing happens? Make sure you're running with -batchmode -nographics -server
• ❌ Can't see the terminal? Run the game via cmd.exe or a .bat script
• ❌ Server name reset? Must be under 20 characters

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.1.0] - 2025-Dec-23

Added

• Added a configuration file under BepInEx/config/FleesDedicatedServer.cfg as an additional option to specify dedicated server settings
• Added an option to schedule a server restart after a specified amount of time
  • The automatic restart can be configured to go through only when the server player count drops below a certain percentage of the maximum player count
  • The time interval is specified in the [XXd][XXh][XXm][XXs] format, such as 4h for 4 hours, 1d6h30m for 1 day, 6 hours and 30 minutes, etc.
  • The minimum time interval is 30 minutes
• Added /restart to the server console - this will restart the server after 20 seconds have elapsed
• Added /cancelrt - this command and /cancelsd will cancel a pending server shutdown or restart
• The mod will now generate start_dedicated_server.cmd on Windows and start_dedicated_server.sh on Linux with Proton
  • These scripts can be used to launch a dedicated server directly instead of having to specify launch options through Steam
  • You will need to first launch the game normally using this mod for those scripts to appear or be updated
• The mod will now generate steam_appid.txt to allow to boot the game without going through the Steam Client

Changed

• In-game audio is now muted while running with -batchmode -nographics
• The host player is now hidden from view instead of being teleported in an off-screen area

[0.0.7] - 2025-Nov-26

Version bump without significant changes

[0.0.6] - 2025-Apr-09

Fixed

• Updated mod code to work with the new update of ATLYSS.
• Cleaned up console output.

[0.0.5] - 2025-Apr-09

Fixed

• Removed deprecated dependency from mod (thanks for the heads up Marioalexsan).

[0.0.4] - 2025-Apr-09

Fixed

• Updated mod code to work with the new update of ATLYSS.

[0.0.3] - 2025-Apr-09

** Undocumented update **

[0.0.2] - 2025-Apr-09

Added

• -hostsave argument to specify which save slot the server host character uses (range: 0–6).
  • If not provided or out of range, defaults to save slot 0.
  • Warning logged if an invalid slot is given.

Changed

• You must have a valid character in the selected save slot to start the server.

[0.0.1] - 2025-Apr-09

Initial mod release