Smoothbrain-ServerCharacters icon

ServerCharacters

Saves your character on the server, instead of your computer, to prevent you from messing with it.

Last updated a month ago
Total downloads 42548
Total rating 18 
Categories Mods Utility Server-side Client-side Tweaks Misc Tools
Dependency string Smoothbrain-ServerCharacters-1.3.2
Dependants 222 other mods depend on this mod

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.1901 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.1901

README

Server Characters

Saves your character on the server, instead of your computer, to prevent you from messing with it.

Has to be installed on all clients and the server, to have any effect.

If you want to copy profiles from the client to the server manually, just copy them to the character folder on the server and prefix them with the Steam ID and an underscore.

Features

Backups

Creates backups of all profiles on the server automatically. Backups are saved in the same folder as the character profiles. Number of backups to keep can be configured.

Emergency Backups

If a client suddenly loses connection to the server, it will automatically create an emergency backup, which it will upload to the server on the next connection, to restore it. This means that no progress will be lost, even if your internet breaks down or the server crashes for some reason.

These backups have a signature and messing with them will void this signature. The server will reject restoring emergency backups with an invalid signature.

AFK Kick Timer

You can configure a time after which players will be automatically disconnected from the server, if they are AFK (= didn't move) for this time.

Server Side Inventory

The inventory of all characters is saved on the server, to prevent players from duping items.

Single Character Mode

You can toggle the single character mode on in the servers configuration file. If it's on, each SteamID can only create one character on the server. Does not apply to server admins.

Console Commands

Server admins can use several console commands. The following commands are available right now.

ServerCharacters console commands - use 'ServerCharacters' followed by one of the following options.

  • resetskill [skillname] [playername] [steamid] - resets the skill for the specified player. Steam ID is optional and only required, if multiple players have the same name. If no name is provided, the skill is reset for every character on the server, online and offline.
  • raiseskill [skillname] [level] [playername] [steamid] - raises the skill for the specified player by the specified level. Steam ID is optional and only required, if multiple players have the same name. If no name is provided, the skill is raised for every character on the server, online and offline.
  • teleport [playername] [steamid] - teleports you to the specified player. Quote names with a space. Steam ID is optional and only required, if multiple players have the same name.
  • summon [playername] [steamid] - teleports the specified player to you. Quote names with a space. Steam ID is optional and only required, if multiple players have the same name.
  • giveitem [itemname] [quantity] [playername] [steamid] - adds the specified item to the specified players inventory in the specified quantity. Quote names with a space. Steam ID is optional and only required, if multiple players have the same name. Will fail, if their inventory is full.

Backup Only Mode

You can toggle the backup only mode on in the servers configuration file. If it's on, the server will not enforce the server's character profile anymore.

Hardcore Mode

You can toggle the hardcore mode on in the servers configuration file. If it's on, players will get kicked and their save file will be deleted from the server, if they die. They will still be able to keep the characters for singleplayer in this case.

Character Templates

On the server side, you can create a file named CharacterTemplate.yml in the same folder that has the DLL for this mod. You can add a custom spawn point, items and skills to this file. New characters will have these items and skills and will spawn at the configured position.

Example:

items:
  Wood: 50
  Stone: 30
  
skills:
  Bows: 15
  Run: 20

spawn:
  x: 100
  y: 50
  z: 150

Maintenance Mode

Server admins can enable the maintenance mode. Once enabled, a timer starts. When this timer elapses, all characters will be saved, the world will be saved and all non-admins will be disconnected and cannot login until the maintenance mode has been disabled.

You can also enable the maintenance mode from the command line of the server, by creating a file named 'maintenance' in the same folder that the DLL is in. To disable it, simply delete this file. This can be used to enable the maintenance mode from the same script that does the server restart, to prevent players from losing progress.

Discord Webhooks

In the configuration file on the server, you can set up notifications about maintenances for your Discord server. These values are not synced and won't be visible on the clients.

Linux Administration Webinterface

ServerCharacters has an API that can be used to connect a webinterface, to allow everyone to easily manage your Valheim server, even with no knowledge about Linux servers. Can also be used to do automated schedulded restarts of the Valheim server.

For a fully functional example webinterface, please see my GitHub repo.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-10-28 1.3.2 3730 Version 1.3.2 Install
2022-10-5 1.3.1 2778 Version 1.3.1 Install
2022-10-1 1.3.0 603 Version 1.3.0 Install
2022-8-23 1.2.9 4448 Version 1.2.9 Install
2022-8-6 1.2.8 2730 Version 1.2.8 Install
2022-8-2 1.2.7 954 Version 1.2.7 Install
2022-6-20 1.2.6 4680 Version 1.2.6 Install
2022-5-11 1.2.5 4047 Version 1.2.5 Install
2022-5-11 1.2.4 40 Version 1.2.4 Install
2022-4-18 1.2.3 2515 Version 1.2.3 Install
2022-4-16 1.2.2 391 Version 1.2.2 Install
2022-3-29 1.2.1 1930 Version 1.2.1 Install
2022-3-26 1.2.0 635 Version 1.2.0 Install
2022-2-14 1.1.5 3267 Version 1.1.5 Install
2022-2-2 1.1.4 1818 Version 1.1.4 Install
2022-1-5 1.1.3 2446 Version 1.1.3 Install
2021-11-30 1.1.2 1654 Version 1.1.2 Install
2021-11-20 1.1.1 712 Version 1.1.1 Install
2021-11-5 1.1.0 596 Version 1.1.0 Install
2021-7-11 1.0.0 2574 Version 1.0.0 Install