# Server Config

<p class="callout success">Information targets the latest **supported** release. For legacy (older) versions and bug fixes, read the changelogs.</p>







#### **Introduction**

<p class="callout info"> **Multiplayer:** Configuration files on servers override any "client-side" (player) or pack settings while you play on that server.</p>

Server configuration files tweak settings that apply to **ALL** worlds created for the current mod pack.

<table border="1" id="bkmrk-multimc-right-click-" style="border-collapse: collapse; width: 100%; border-width: 1px; border-style: hidden;"><colgroup><col style="width: 18.9882%;"></col><col style="width: 81.131%;"></col></colgroup><tbody><tr><td style="border-style: hidden;">**MULTIMC**  
</td><td style="border-style: hidden;">Right click pack icon → `Config Folder` → `swem-server.toml`</td></tr><tr><td style="border-style: hidden;">**CURSEFORGE**</td><td style="border-style: hidden;">Right click pack icon → `Open Folder` → `config` → `swem-server.toml`</td></tr><tr><td style="border-style: hidden;">**FORGE (WINDOWS)**</td><td style="border-style: hidden;">Open file explorer → `[user]/AppData/Roaming/.minecraft/config/swem-server.toml`</td></tr><tr><td style="border-style: hidden;">**FORGE (MAC)**</td><td style="border-style: hidden;">Open finder → `~/Library/Application Support/minecraft/config/swem-server.toml`</td></tr></tbody></table>

<p class="callout danger">Prior to **`1.21.1`** server config files are located under `saves` → `worldname` → `serverconfig` → `swem-server.toml`  
</p>

---

#### **World Override `1.21+`**

It is possible to set custom configuration for specific worlds (override default file).   
Paste a **copy** of the `swem-server` file into `saves` → `worldname` → `serverconfig`. **Edit. Save. Relaunch.**

---

#### **Important**

Configuration files have a specific format, and allow you to change **limited** values. Inputting invalid information or adjusting the file format can invalidate configuration file loading, world loading or result in game crashes.

It is important to read the file carefully and only change supported values.

- `#` is a comment to provide information on the feature and valid range or options
- `Range` means values must be within a set limit `Example:` 0-100
- `Default` is the setting used when the file is first generated and may be noted for reference

<p class="callout info">If you suspect your config file is corrupted or invalid, delete it and reload the game to regenerate the file.</p>

---

#### **Default Configuration**

This is the default configuration file, containing **12** adjustable settings.

<details id="bkmrk-default---1.21.1-1.1"><summary>Default - 1.21.1-1.1.1</summary>

```
#|| How much to heal the player wearing Netherite+ Riding Boots as a percentage of damage dealt.
# Default: 0.05
# Range: 0.01 ~ 1.0
lifesteal = 0.05

# || =========== [Horse Care] =========== ||
[horse_care]
	# || Specify how many minutes the Health Booster lasts for?
	# || We recommend '600' ~(30mc days) for singleplayer, and '10,000' ~(504mc days / 7irl days) for multiplayer.
	# Default: 600
	# Range: > 1
	healthBoosterTime = 600

# || =========== [Horse Experience Levels] =========== ||
[horse_experience_levels]
	# || Amount of XP required to max a horse's Speed stat.
	# || We recommend '13500' for singleplayer, and '100000' for multiplayer.
	# Default: 13500
	# Range: > 1
	maxSpeedXP = 13500
	# || Amount of XP required to max a horse's Jump stat.
	# || We recommend '13500' for singleplayer, and '100000' for multiplayer.
	# Default: 13500
	# Range: > 1
	maxJumpXP = 13500
	# || Amount of XP required to max a horse's Health  stat.
	# || We recommend '13500' for singleplayer, and '100000' for multiplayer.
	# Default: 13500
	# Range: > 1
	maxHealthXP = 13500
	# || Amount of XP required to max a horse's Affinity stat.
	# || We recommend '17000' for singleplayer, and '50000' for multiplayer.
	# Default: 17000
	# Range: > 1
	maxAffinityXP = 17000

# || =========== [Server Admin] =========== ||
[server_admin]
	# || Enable Coat Cycling (via lapis lazuli and redstone)?
	# || Do not enable if the server is multiplayer and has an economy.
	allowCoatCycling = true
	# || Can Secret Coats be obtained via Secret Items? (Default = True = Yes)
	# || Do not enable if the server is multiplayer and has an economy.
	allowSecretCoats = true
	# || Should the perks provided by the Amethyst Armor (excluding Amethyst Riding Boots) be disabled?
	disableAmethystPerks = false
	# || Should the rider be teleported with the horse if the horse should fall into the void whilst the horse is wearing Amethyst Tier Armor.
	voidTP = true
	# || Enable SWEM's built-in permission node system for controlling player use of commands.
	# || This is recommended for servers ONLY.
	enableKeyPermission = false
	# || What horses should spawn? Vanilla horses only, SWEM horses only, or Both?
	#Allowed Values: VANILLA_ONLY, SWEM_ONLY, BOTH
	horseSpawn = "BOTH"
	# || Should winged horse fly without requirement of Amethyst Horse Armor?
	wingedHorseFly = true

```

</details>---

#### **Adjustable Values**

##### Lifesteal

```
lifesteal = 0.05
```

<p class="callout info">*This accepts **decimal** numbers from `0.01-1.0`. Default is `0.05` - 5% damage is healed by Netherite+ [riding boots](https://wiki.swequestrian.com/books/star-worm-equestrian-lite/page/amethyst-riding-boots). `1.0` = 100%*</p>

##### Health Booster

```
	healthBoosterTime = 600
```

<p class="callout info">*This accepts **whole** numbers over `1`. Default is `600` - [health boosters](https://wiki.swequestrian.com/books/star-worm-equestrian-lite/page/health-booster) lasts 600 mins (approx. 30MC days) **while loaded**.*</p>

##### Skill Experience

```
	maxSpeedXP = 13500
```

```
	maxJumpXP = 13500
```

```
	maxHealthXP = 13500
```

```
	maxAffinityXP = 17000
```

<p class="callout info">*This accepts **whole** numbers (integers) over `1`. Default is `13500` experience for max. [skill](https://wiki.swequestrian.com/books/star-worm-equestrian-lite/page/skills) level, or `17000` for affinity.*</p>

<p class="callout warning">**Multiplayer:** Values are aimed at Singleplayer and it is common for **Equestrian** servers to set `50-100,000+`</p>

##### Coat Cycling

```
	allowCoatCycling = true
```

<p class="callout info">*This accepts `true` or `false`. Default is `true` and permits coat cycling (change) **owned** horses using lapis and redstone.*</p>

##### Secret Coats

```
	allowSecretCoats = true
```

<p class="callout info">*This accepts `true` or `false`. Default is `true` and allows players to obtain special coats in survival.*</p>

##### Void TP

```
	voidTP = true
```

<p class="callout info">*This accepts `true` or `false`. Default is `true` - teleport horse/rider to spawn if falling into the void with Amethyst horse armor.*</p>

##### Key Permissions (Multiplayer)

```
	enableKeyPermission = false
```

<p class="callout info">*This accepts `true` or `false`. Default is `false` - commands are not restricted to players with "key" permissions.* <span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> **TBC** </span></p>

##### Spawning

```
	horseSpawn = "BOTH"
```

<p class="callout info">*This accepts `BOTH` or `VANILLA_ONLY` or `SWEM_ONLY`. Default is `BOTH` - lite **and** vanilla horses naturally [spawn](https://wiki.swequestrian.com/books/star-worm-equestrian-lite/page/horse-overview#bkmrk-natural-spawns).*</p>

##### Winged Flight

```
	wingedHorseFly = true
```

<p class="callout info">*This accepts `true` or `false`. Default is `true` - default <span style="text-decoration: underline;">and</span> custom pegasus (set in JSON file) can fly without armor.*</p>

---

#### **Additional**

Configuration file updates are uncommon and *usually* harmless, but you may need to regenerate files or reapply custom settings.

<p class="callout warning">**Multiplayer:** Check or reset configuration files each time you update mods to ensure important settings are unaffected!</p>

---

#### **Known Issues**

You can report any mod issues to our bugs forum on **[Discord](https://discord.com/channels/715626418893095012/1123695058496000240)** - please check for duplicate reports first!

---

#### **Changelog**

<details id="bkmrk-view-changes-this-is"><summary>View Changes</summary>

<p class="callout info">This is not a complete list of changes or features. It is a log of wiki-related version information and may be outdated.</p>

<table border="1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 11.7429%;"></col><col style="width: 10.8801%;"></col><col style="width: 77.377%;"></col></colgroup><tbody><tr><td class="align-center" style="background-color: rgb(52, 5, 93);"><span style="color: rgb(255, 255, 255);">**MC Version**</span></td><td class="align-center" style="background-color: rgb(52, 5, 93);"><span style="color: rgb(255, 255, 255);">**Release**</span></td><td class="align-center" style="background-color: rgb(52, 5, 93);"><span style="color: rgb(255, 255, 255);">**Notes**</span></td></tr><tr><td class="align-center">`1.20.1`</td><td class="align-center">`1.1.1`</td><td>Page established - Information prior to `1.1.1` is not specifically included but is likely the same.</td></tr></tbody></table>

</details>