Troubleshooting

Cannot Connect to Daemon

Symptom: GUI stuck on loading screen, or CLI connection error.

Solutions:

  1. Verify saba-core.exe is running
  2. Check if IPC port (default 57474) is used by another program
  3. Ensure firewall isn't blocking local connections
  4. Verify .ipc_token file exists in %APPDATA%/saba-chan/

Server Won't Start

Symptom: Start button has no effect.

Solutions:

  1. Check that executable_path points to a valid server executable
  2. Verify working_dir is a valid directory
  3. Check console output for error messages
  4. Run port conflict check (:instance validate <id> or GUI diagnostics)

Module Not Loading

Symptom: Game not showing in module list.

Solutions:

  1. Verify module directory path (SABA_MODULES_PATH env var)
  2. Ensure both module.toml and lifecycle.py exist in the module directory
  3. Run :module refresh
  4. Check that Python 3.x is available

Discord Bot Not Responding

Solutions:

  1. Verify bot token is correctly configured
  2. Check bot status (:bot status)
  3. Ensure bot is invited to the Discord server
  4. Verify bot has message read/write permissions
  5. Check that the prefix is correct

Update Failed

Solutions:

  1. Check internet connection
  2. Verify GitHub API accessibility
  3. Check current status: :update status
  4. Retry manually: :update check → :update download → :update apply

FAQ

Does Saba-chan crashing kill my game servers?

No. Game servers run as independent processes. If the daemon crashes, servers keep running. Restarting Saba-chan will auto-detect running servers.

Can I run multiple servers for the same game?

Yes. Create multiple instances with the same module. Each instance has independent settings (ports, directories, etc.).

How do I add a new game?

Develop a module or install a community module. See the Module Development Guide. No core recompilation needed.

Can I use GUI and CLI at the same time?

Yes. Both connect to the same daemon and are independently registered.

Can I manage servers remotely?

Yes. Use the Discord bot for remote control. Behind NAT? Cloud mode (relay server) works without port forwarding.

Can I run game servers in Docker?

Yes. Enable the Docker extension, then toggle docker_enabled in instance settings. CPU/memory limits are configurable.