Installs, configures and runs a 7 Days to Die server.
7 Days to Die is a PC zombie survial game made by "The Fun Pimps" and is available through Steam.
- To install a copy of the 7 Days to Die server client via chef, it requires
credentials of a Steam account with SteamGuard (otherwise user input is
required to install the server with
steamcmd) disabled and a licensed copy of 7 Days to Die purchased for that account. - Ubuntu 12.04 (this might work on other
apt-getbased distros, but this is currently the only supported version at the moment)
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['steam_username'] | String | Steam username with a `7 Days to Die` license (required) | nil |
| ['sdtd']['steam_password'] | String | Password for the above username (required) | nil |
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['instance_dir'] | String | The base directory for your instances | "#{node["steamcmd"]["apps_dir"]}/294420/instances" |
| ['sdtd']['instance_name'] | String | Folder name for the instance. | "7dtd_instance_01" |
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['backups_dir'] | String | The base directory for your backups. Each instance will have a subfolder in here. | "#{node['steamcmd']['home']}/backups" |
| ['sdtd']['compress_backups'] | Boolean | Whether or not to compress the backups created | true |
Settings that determine the difficulty and other settings of the server, as well as alternative admin settings and controls.
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['serverconfig']['ServerPort'] | String | Port you want the server to listen on | "26900" |
| ['sdtd']['serverconfig']['ServerIsPublic'] | String | Whether or not to register this server with the master server. | "false" |
| ['sdtd']['serverconfig']['ServerName'] | String | Name of the server | "My Game Host" |
| ['sdtd']['serverconfig']['ServerPassword'] | String | Password for the server | "" |
| ['sdtd']['serverconfig']['ServerMaxPlayerCount'] | String | Maximum Concurrent Players | "8" |
| ['sdtd']['serverconfig']['ServerDescription'] | String | Description for the server | "A 7DTD server" |
| ['sdtd']['serverconfig']['ServerWebsiteURL'] | String | Website URL for the server | "" |
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['serverconfig']['GameWorld'] | String | Options: Navezgane, MP Wasteland Horde, MP Wasteland Skirmish, MP Wasteland War, Random Gen | "Random Gen" |
| ['sdtd']['serverconfig']['GameName'] | String | Name of the game. Controls the server SEED. | "My Game" |
| ['sdtd']['serverconfig']['GameDifficulty'] | String | 0 - 4, 0=easiest, 4=hardest | "2" |
| ['sdtd']['serverconfig']['GameMode'] | String | GameModeSurvivalMP, GameModeSurvivalSP (MP has land protection) | "GameModeSurvivalMP" |
| ['sdtd']['serverconfig']['ZombiesRun'] | String | 0 = default day/night walk/run, 1 = never run, 2 = always run | "0" |
| ['sdtd']['serverconfig']['BuildCreate'] | String | cheat mode on/off | "false" |
| ['sdtd']['serverconfig']['DayNightLength'] | String | Time in minutes | "40" |
| ['sdtd']['serverconfig']['FriendlyFire'] | String | Can friendly players damage each other (PvP) | "false" |
| ['sdtd']['serverconfig']['PersistentPlayerProfiles'] | String | If disabled a player can join with any selected profile. If true they will join with the last profile they joined with | "true" |
| ['sdtd']['serverconfig']['DropOnDeath'] | String | 0 = everything, 1 = toolbelt only, 2 = backpack only, 3 = delete all | "0" |
| ['sdtd']['serverconfig']['DropOnQuit'] | String | 0 = nothing, 1 = everything, 2 = toolbelt only, 3 = backpack only | "0" |
| ['sdtd']['serverconfig']['CraftTimer'] | String | 0 = None (instant), 1 = Normal, 2 = Fast (double speed) | "1" |
| ['sdtd']['serverconfig']['LootTime'] | String | 0 = None (instant), 1 = Normal, 2 = Fast (double speed) | "1" |
| ['sdtd']['serverconfig']['EnemySenseMemory'] | String | Time, in seconds, that a zombie will pursue something that has been sensed. | "60" |
| ['sdtd']['serverconfig']['EnemySpawnMode'] | String | 0 = Disabled 0%, 1 = Very Low 50%, 2 = Low 75%, 3 = Medium 100%, 4 = High 125%, 5 = Very High 150% | "3" |
| ['sdtd']['serverconfig']['EnemyDifficulty'] | String | 0 = Normal, 1 = Feral | "0" |
| ['sdtd']['serverconfig']['NightPercentage'] | String | Percentage in whole numbers. | "35" |
| ['sdtd']['serverconfig']['BlockDurabilityModifier'] | String | Percentage in whole numbers. | "100" |
| ['sdtd']['serverconfig']['LootAbundance'] | String | Percentage in whole numbers. | "100" |
| ['sdtd']['serverconfig']['LootRespawnDays'] | String | Days in whole numbers. | "7" |
| ['sdtd']['serverconfig']['LandClaimSize'] | String | Size in blocks that is protected by a keystone | "7" |
| ['sdtd']['serverconfig']['LandClaimDeadZone'] | String | Keystones must be this many blocks apart (unless you are friends with the other player) | "30" |
| ['sdtd']['serverconfig']['LandClaimExpiryTime'] | String | The number of days a player can be offline before their claims expire and are no longer protected | "3" |
| ['sdtd']['serverconfig']['LandClaimDecayMode'] | String | Controls how offline players land claims decay. All claims have full protection for the first 24hrs. 0=Linear, 1=Exponential, 2=Full protection until claim is expired. | "0" |
| ['sdtd']['serverconfig']['LandClaimOnlineDurabilityModifier'] | String | How much protected claim area block hardness is increased when a player is online. 0 means infinite (no damage will ever be taken). Default is 32x | "4" |
| ['sdtd']['serverconfig']['LandClaimOfflineDurabilityModifier'] | String | How much protected claim area block hardness is increased when a player is offline. 0 means infinite (no damage will ever be taken). Default is 32x | "4" |
| ['sdtd']['serverconfig']['AirDropFrequency'] | String | How often airdrop occur in game-hours, 0 == never | "72" |
| ['sdtd']['serverconfig']['MaxSpawnedZombies'] | String | Making this number too large (more than about 80) may cause servers to run at poor framerates which will effect lag and play quality for clients. | "60" |
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['serverconfig']['ControlPanelEnabled'] | String | Enable/Diable the control panel | "false" |
| ['sdtd']['serverconfig']['ControlPanelPort'] | String | Port of the control panel webpage | "8080" |
| ['sdtd']['serverconfig']['ControlPanelPassword'] | String | Password to gain entry to the control panel | "CHANGEME" |
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['serverconfig']['TelnetEnabled'] | String | Enable/Diable the telnet | "true" |
| ['sdtd']['serverconfig']['TelnetPort'] | String | Port of the telnet server | "8081" |
| ['sdtd']['serverconfig']['TelnetPassword'] | String | Password to gain entry to the telnet interface | "CHANGEME" |
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['serverconfig']['DisableNAT'] | String | Set this to true if your router doesn't support NAT | "true" |
| ['sdtd']['serverconfig']['AdminFileName'] | String | Server Admin file name | "admins.xml" |
| ['sdtd']['serverconfig']['EACEnabled'] | String | Enables/Disables EasyAntiCheat | "true" |
| ['sdtd']['serverconfig']['SaveGameFolder'] | String | Use this to override the default save game path | nil |
This sets up the admin configuration for the default instance. Admins, moderators and commands all have permission levels associated with them. The commands available to the admins and moderators are determined by the permissions assigned to each of the commands.
A whitelist can also be set up that only allows those that are a part of the list.
| Key | Type | Description | Default |
|---|---|---|---|
| ['sdtd']['serveradmin']['admins'] | Hash | A hash of Steam IDs and Permission levels as keys and values of the hash respectively to be admins of the server. | nil |
| ['sdtd']['serveradmin']['moderators'] | Hash | A hash of Steam IDs and Permission levels as keys and values of the hash respectively to be moderators of the server. | nil |
| ['sdtd']['serveradmin']['permissions'] | Hash | A hash of commands and Permission levels as keys and values of the hash respectively for permission levels for each command. | nil |
| ['sdtd']['serveradmin']['whitelist'] | Hash | A hash of Steam IDs and Permission levels as keys and values of the hash respectively of servers to be allowed to the server. If there are any items in the whitelist, the whitelist only mode is enabled. | nil |
| ['sdtd']['serveradmin']['blacklist'] | Hash | A hash of Steam IDs and Unban date as keys and values of the hash respectively for blacklist of steam users and when the ban is lifted. | nil |
7dtd-server::default: Installs the server, creates an instance, and runs the server7dtd-server::install: Installs the server7dtd-server::create: Creates/configures an instance7dtd-server::backup: Setups up backups for the server instance (TODO)7dtd-server::start: Starts the server (TODO)7dtd-server::stop: Stops the server (TODO)
Include 7dtd-server in your node's run_list:
{
"run_list": [
"recipe[7dtd-server::default]"
]
}Add include the following attributes:
override['sdtd']['steam_username'] = "YOUR_STEAM_USERNAME"
override['sdtd']['steam_password'] = "YOUR_STEAM_PASSWORD"After having run the install and instance recipes (or default, which does
both), add backup to the run list:
{
"run_list": [
"recipe[7dtd-server::backup]"
]
}- Add rsync script from vagrant
- Convert definitions to LWRPs
- Refactor code
Author:: Nicholas LaMuro