Skip to content

ServerThrall v2.1.3
Compare
Choose a tag to compare
@NullSoldier NullSoldier released this 20 May 00:47
· 82 commits to master since this release
v2.1.3
6203098

With this update, the documentation is being re-written as well to contain all the new information.

What's New
This is a very large release with a few major items described below.

  • Running multiple Conan Exiles servers on the same computer with ServerThrall now works as expected.
    #57
  • Servers should now close safely so that the game server has time to save all data. This should make you feel better about using the ServerRestart plugin. No data will be lost by your players. #55
  • In the past if your server name had spaces inside the ServerConfig plugin, it would not display properly and you would have to know to put quotes around the name. Now, ServerConfig will automatically quote your name so it just works. #52
  • version.txt has been removed. You can still see your current serverthrall version in serverthrall.log, or serverthrall.config #60
  • Unhandled crashes are now logged to serverthrall.log for easier debugging
  • QueryPort is now sent to ServerThrallApi using the ApiUploader plugin so that your ThrallBrowser page can display a join server button. #56
  • All plugins now have a new config item that can override their log verbosity. Add log_level = DEBUG to any plugin to change that plugin to be more verbose. The set of log levels are DEBUG, INFO, WARNING, ERROR, or CRITICAL.
  • Fixed a crash when ServerConfig would attempt to access conan configs that would be locked by the Conan Exiles server

3. Breaking Configuration Changes
Some configuration options have changed, please update your configuration below.

  • ServerRestarter.warning_minutes has been moved to RestartManager.warning_minutes
  • ServerRestarter.send_warning_message have been moved to RestartManager.warning_send_discord and RestartManager.warning_send_rcon
  • ServerRestarter.announce_in_game has been moved to RestartManager.restart_send_discord and RestartManager.restart_send_rcon

2. Added RCON integration
Alongside Discord, you can now have ServerThrall notify users of an impending update. This is done with the new RestartManager system that all plugins use to perform restarts. To enable this functionality, you can configure RestartManager plugin below.

[RestartManager]
enabled = true
warning_minutes = 5
warning_send_discord = True
warning_send_rcon = True
restart_send_discord = True
restart_send_rcon = True
Setting Description
warning_minutes dictates how long in minutes to give users after warning them of a server restart to restart the server.
warning_send_discord true if you want a warning to be sent to discord
restart_send_discord true if you want discord to be notified of a restart
warning_send_rcon true if you want a warning to be sent in game to your players
restart_send_rcon true if you want your in game players to be notified as they are being disconnected

3. RCON and Discord message customization

All plugins now support customizing messages sent to RCON or Discord, and each plugin provides special template items to help you customize your messages with contextual information.

Here are the new configuration options

DownRecovery

[DownRecovery]
discord_restart_message = @everyone Ah poop the server crashed! Bringing it back up!

ServerRestarter

[ServerRestarter]
rcon_warning_message = There are $timeleft $timeunit until the restart, get to a safe place!
rcon_restart_message = Goodbye world, next restart at $nextrestart
discord_warning_message = @everyone There are $timeleft $timeunit until the restart!
discord_restart_message = @everyone The server is restarting, next restart at $nextrestart

Warning Message Values

  • $timeleft How much time is left before the restart
  • $timeunit The unit for how much time is left before restart (ie: minute / minutes)
  • $newline Add a newline to your message

Restart Message Values

  • $newline Add a newline to your message
  • $nextrestart When the next restart will happen

ServerUpdater

[ServerUpdater]
rcon_warning_message = There are $timeleft $timeunit until the restart, get to a safe place!
rcon_restart_message = New update available from $current to $target on $branch. 
discord_warning_message = @everyone There are $timeleft $timeunit until the restart!
discord_restart_message = @everyone The server is restarting, next restart at $nextrestart

Warning Message Values

  • $timeleft How much time is left before the restart
  • $timeunit The unit for how much time is left before restart (ie: minute / minutes)
  • $newline Add a newline to your message
  • $current The current conan exiles version number
  • $target The version number we are about to update to
  • $branch The branch, either 'public' or 'testlive'ff we are on

Restart Message Values

  • $newline Add a newline to your message
  • $current The current conan exiles version number
  • $target The version number we are about to update to
  • $branch The branch, either 'public' or 'testlive'ff we are on
Assets 3
Loading