Menu
  Log out
 

Soulmask Server Configuration Guide

Soulmask Guide • Updated Jan 9, 2026

Soulmask: Complete Server Configuration Guide

Comprehensive guide to configuring and optimizing your Soulmask dedicated server for the best multiplayer survival experience.

System Requirements

Minimum Requirements:

  • CPU: Intel Core i5-8400 or AMD Ryzen 5 2600
  • RAM: 12GB DDR4
  • Storage: 25GB available space
  • Network: 15 Mbps upload for 20 players
  • OS: Windows 10/11 or Ubuntu 20.04+

Recommended Requirements:

  • CPU: Intel Core i7-9700K or AMD Ryzen 7 3700X
  • RAM: 16GB DDR4
  • Storage: 50GB SSD storage
  • Network: 50 Mbps upload for 50+ players
  • OS: Windows 11 or Ubuntu 22.04 LTS

Installation Process

Step 1: SteamCMD Installation

# Ubuntu/Debian sudo apt update sudo apt install steamcmd # Create user for server sudo useradd -m -s /bin/bash soulmask sudo usermod -aG sudo soulmask # Switch to server user sudo -u soulmask -i

Step 2: Download Server Files

# Create installation directory mkdir /home/soulmask/server cd /home/soulmask/server # Download Soulmask server (app ID: 2978680) steamcmd +login anonymous +app_update 2978680 validate +quit # Create necessary directories mkdir saves logs mods

Step 3: Basic Configuration

Create the main configuration file ServerConfig.ini:

[ServerSettings] ServerName = "My Soulmask Server" ServerPassword = "" ServerDescription = "Welcome to our Soulmask adventure!" MaxPlayers = 40 Port = 7777 QueryPort = 27015 [Gameplay] Difficulty = Normal DayNightCycle = 24 ResourceRespawnTime = 300 StructureDecay = true PvP = false FriendlyFire = false [Performance] AutoSaveInterval = 600 MaxStructures = 5000 MaxDroppedItems = 1000 NetworkUpdateRate = 30 [World] WorldSize = Large Seed = 12345 BiomeDistribution = Balanced WeatherSystem = true SeasonalChanges = true

Advanced Configuration Options

Network Settings

  • Port: Game server port (default: 7777)
  • QueryPort: Server browser port (default: 27015)
  • MaxPlayers: Maximum concurrent players (1-100)
  • ReservedSlots: Slots reserved for admins
  • BandwidthLimit: Maximum bandwidth per player

Gameplay Balance

  • Difficulty: Easy, Normal, Hard, Custom
  • XPMultiplier: Experience gain multiplier (0.5-5.0)
  • GatherMultiplier: Resource gathering multiplier
  • TamingMultiplier: Taming success rate modifier
  • DropMultiplier: Item drop rate modifier

World Generation

  • WorldSize: Small, Medium, Large, XL
  • Seed: Random seed for world generation
  • LandmassSize: Percentage of land vs water
  • MountainHeight: Mountain elevation modifier
  • RiverCount: Number of rivers in world

Performance Optimization

  • ViewDistance: Maximum render distance (500-5000)
  • LODDistance: Level of detail distance
  • MaxNPCs: Maximum NPCs per region
  • CorpseDecayTime: Time before bodies disappear
  • StructureComplexity: Maximum building complexity

Starting the Server

Linux Launch Script

#!/bin/bash # start_soulmask.sh # Configuration SERVER_DIR="/home/soulmask/server" STEAM_DIR="$HOME/Steam" APP_ID="2978680" # Navigate to server directory cd "$SERVER_DIR" # Update server if needed "$STEAM_DIR/steamcmd.sh" +login anonymous +app_update $APP_ID +quit # Start server ./SoulmaskServer.sh ServerConfig=ServerConfig.ini # Keep script running while true; do sleep 30 if ! pgrep -f "SoulmaskServer" > /dev/null; then echo "Server crashed, restarting..." ./SoulmaskServer.sh ServerConfig=ServerConfig.ini fi done

Windows Batch File

@echo off :start cls echo Starting Soulmask Server... REM Update server "C:\Program Files (x86)\Steam\steamcmd.exe" +login anonymous +app_update 2978680 +quit REM Start server SoulmaskServer.exe ServerConfig=ServerConfig.ini REM Restart if crashed echo Server crashed or stopped. Restarting in 30 seconds... timeout /t 30 /nobreak > nul goto start

Administration and Moderation

Admin Setup

Add administrators to your server:

[Admins] AdminList = "steamid1,steamid2,steamid3" AdminLevel = "full" AdminChatColor = "#FF0000"

Essential Commands

/admin login [password]

Authenticate as server administrator.

/save

Force immediate world save.

/kick [player] [reason]

Remove player from server.

/ban [player] [duration] [reason]

Ban player for specified duration.

/teleport [x] [y] [z]

Teleport to coordinates.

/spawn [entity] [count]

Spawn entities or resources.

Performance Tuning

Network Optimization

[Network] NetworkUpdateRate = 60 MaxBandwidthPerClient = 50000 CompressionLevel = 6 TimeoutDuration = 30

Memory Management

[Performance] MaxMemoryUsage = 8192 GarbageCollectionInterval = 300 TextureStreaming = true AssetPreloading = false

Database Optimization

[Database] AutoVacuum = true BackupInterval = 3600 CompressionLevel = 9 MaxDatabaseSize = 2048

Security Configuration

Access Control

[Security] WhitelistEnabled = true WhitelistFile = "whitelist.txt" BlacklistEnabled = true BlacklistFile = "blacklist.txt" IPWhitelist = "" BanThreshold = 5 BanDuration = 3600

RCON Setup

[RCON] Enabled = true Port = 27016 Password = "your_secure_rcon_password" AllowedIPs = "127.0.0.1,your_admin_ip" LogLevel = 1

Mod Support

Enabling Mods

[Mods] Enabled = true ModDirectory = "mods" RequiredMods = "" OptionalMods = "mod1,mod2" WorkshopMods = "workshopid1,workshopid2" ModValidation = true

Popular Mod Categories

  • Quality of Life: Inventory management, UI improvements
  • Building: Enhanced building systems, new structures
  • Creatures: New creatures, enhanced AI
  • Content: New items, weapons, armor
  • Administration: Admin tools, server management

Backup and Recovery

Automated Backup Script

#!/bin/bash # backup_soulmask.sh BACKUP_DIR="/home/backups/soulmask" SERVER_DIR="/home/soulmask/server" DATE=$(date +%Y%m%d_%H%M%S) MAX_BACKUPS=7 mkdir -p "$BACKUP_DIR" # Create backup tar -czf "$BACKUP_DIR/soulmask_backup_$DATE.tar.gz" \ -C "$SERVER_DIR" saves/ config/ # Clean old backups ls -t "$BACKUP_DIR"/soulmask_backup_*.tar.gz | tail -n +$((MAX_BACKUPS + 1)) | xargs -r rm echo "Backup completed: soulmask_backup_$DATE.tar.gz"

Restore Procedure

#!/bin/bash # restore_soulmask.sh if [ -z "$1" ]; then echo "Usage: $0 " exit 1 fi BACKUP_FILE="$1" SERVER_DIR="/home/soulmask/server" # Stop server systemctl stop soulmask # Restore backup tar -xzf "$BACKUP_FILE" -C "$SERVER_DIR" # Fix permissions chown -R soulmask:soulmask "$SERVER_DIR" # Start server systemctl start soulmask echo "Restore completed from $BACKUP_FILE"

Troubleshooting

Common Issues

  • Server Not Appearing in Browser: Check firewall ports 7777/UDP and 27015/UDP
  • High Latency: Increase NetworkUpdateRate, check server resources
  • Crashes on Startup: Verify configuration file syntax, check logs
  • Player Disconnections: Monitor bandwidth limits, check network stability

Log Analysis

Key log locations:

  • logs/server.log - Main server log
  • logs/network.log - Network activity
  • logs/errors.log - Error messages and exceptions
  • logs/performance.log - Performance metrics

Conclusion

With proper configuration and optimization, your Soulmask server will provide an excellent multiplayer experience for your community. Regular maintenance and monitoring ensure stable operation.

Need Help? Join our Discord community for server admin support and share your configuration tips with other server owners.

← Back to Soulmask Guides
Top