🖧 ATLYSS Dedicated Server Plugin

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