Information targets the latest **supported** release. For legacy (older) versions and bug fixes, read the changelogs.
This page is a **WORK IN PROGRESS** and may contain inaccurate or placeholder information or links.
#### **Introduction****Multiplayer:** Configuration files on servers override any "client-side" (player) or pack settings while you play on that server.
Server configuration files tweak settings that apply to **ALL** worlds created for the current mod pack.Prior to **`1.21.1`** server config files are located under `saves` → `worldname` → `serverconfig` → `swem-server.toml`
--- #### **World Override `Neoforge 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 referenceIf you suspect your config file is corrupted or invalid, delete it and reload the game to regenerate the file.
--- #### **Default Configuration** This is the default configuration file, containing **12** adjustable settings.*This accepts **boolean** values of `true` or `false`. Default is `true` - horses reset hunger points (AM) and calculate meals (PM) daily.*
``` needWater = true ```*This accepts **boolean** values of `true` or `false`. Default is `true` - horses reset thirst (AM) and calculate drinks (PM) daily.*
Set the distance in blocks that horses will search for food and water sources, and prioritize choosing preferred types (ie bales over grass). ``` intakeSearchRadius = 15 ```*This accepts **whole** numbers from `5-40`. Default is `15` - Horses search 15B outwards (30B radius) for food and water sources.*
*If set too low, horses may struggle to find suitable sources to satisfy their needs. If set too high or with many horses, lag may occur.*
--- ##### Pee & Poop Set the duration between poop cycles. ``` poopInterval = 1800 ```*This accepts **whole** numbers over `1`. Default is `1800` - poop events (spawn poop entity) typically occur every 30 minutes **while loaded**.*
Set the duration between pee cycles. ``` peeInterval = 1500 ```*This accepts **whole** numbers over `1`. Default is `1800` - pee events (set block) typically occur every 25 minutes **while loaded**.*
--- ##### Foal Growth Set the duration for foals to grow up into adults. ` ONLY AFFECTS FOALS BORN AFTER THIS SETTING IS CHANGED! ` ``` foalAgeInSeconds = 1800 ```*This accepts **whole** numbers over `1`. Default is `1800` - foals fully grow up in 30 minutes, only increases **while loaded**.*
--- ##### Booster Shots Set the duration of effect for [booster](https://wiki.swequestrian.com/books/star-worm-equestrian/page/booster-shot) shots. ` ONLY AFFECTS HORSES BOOSTED AFTER THIS SETTING IS CHANGED! ` ``` healthBoosterTime = 600 ```*This accepts **whole** numbers over `1`. Default is `600` - booster effect expires after 600 minutes, only decreases **while loaded**.*
--- #### **Adjustable Values - Horse Breeding** ##### Breeding Tokens Enable or disable breeding tokens (uncraftable). Replaces [Rose Feed](https://wiki.swequestrian.com/books/star-worm-equestrian/page/rose-feed) as the breeding item. **Intended for Multiplayer servers.** ``` tokensBreeding = false ```*This accepts **boolean** values of `true` or `false`. Default is `false` - breed horses using the default [rose feed](https://wiki.swequestrian.com/books/star-worm-equestrian/page/rose-feed) (craftable).*
--- ##### Permanent Love Mode Enable or disable permanent love mode. If enabled Horses remain "In Love" and seek a partner until they successfully breed. ``` permanentLoveMode = false ```*This accepts **boolean** values of `true` or `false`. Default is `false` - horses remain "in love" for a short duration before it expires.*
--- ##### Love Mode Duration Set duration of "In Love" status for stallions. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! / IGNORED IF PERMANENT = TRUE` ``` stallionLoveTimeInSeconds = 1800 ```*This accepts **whole** numbers over `1`. Default is `1800` - stallions remain in love mode for 30 minutes, only decreases **while loaded**.*
Set duration of "In Love" status for mares. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! / IGNORED IF PERMANENT = TRUE` ``` mareLoveTimeInSeconds = 1800 ```*This accepts **whole** numbers over `1`. Default is `1800` - mares remain in love mode for 30 minutes, only decreases **while loaded**.*
--- ##### Gestation Duration Set duration of pregnancy (gestation) for mares. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! ` ``` mareGestationTimeInSeconds = 1800 ```*This accepts **whole** numbers over `1`. Default is `1800` - mares give birth after 30 minutes, only decreases **while loaded**.*
--- ##### Breeding Cooldown Set duration of breeding cooldown for stallions. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! ` ``` stallionBreedingCooldownInSeconds = 900 ```*This accepts **whole** numbers over `1`. Default is `900` - stallions cannot breed for 15 minutes, only decreases **while loaded**.*
Set duration of breeding cooldown for mares. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! ` ``` mareBreedingCooldownInSeconds = 1800 ```*This accepts **whole** numbers over `1`. Default is `1800` - mares cannot breed for 30 minutes, only decreases **while loaded**.*
--- ##### Breeding Limits Set limit on number of breedings for stallions. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! ` ``` maxStallionCovers = 0 ```*This accepts **whole** numbers over `0`. Default is `0` - stallions have no limits to how many times they can breed.*
Set limit on number of breedings for mares. ` ONLY AFFECTS HORSES BRED AFTER THIS SETTING IS CHANGED! ` ``` maxMareCovers = 0 ```*This accepts **whole** numbers over `0`. Default is `0` - mares have no limits to how many times they can breed.*
--- ##### Twins Chance Set chance (odds 1 in #) for mares to give birth to twin foals. ``` twinBirthChance = 1000 ```*This accepts **whole** numbers over `1`. Default is `1000` - 1 in 1000 births (0.1%) chance of producing twins.*
--- ##### Fertile Toggle Enable or disable permanent infertility status. ``` refertile_horses = true ```*This accepts **boolean** values of `true` or `false`. Default is `true` - horses can be given a male/female/random potion to reverse infertility.*
--- ##### Natural Breeding Enable or disable stallions being permanently "In Love" and able to breed with fertile mares nearby. ``` natural_breed_chance = false ```*This accepts **boolean** values of `true` or `false`. Default is `false` - horses will **always** require breeding items to reproduce.*
--- #### **Adjustable Values - Tack** ##### Tack Order Enable or disable limitations on what order tack must be equipped in. ``` # || Is the Bridle slot required before equipping a Blanket? (Default = True = Yes) needBridle = true ``` ``` # || Is the Blanket slot required before equipping a Saddle? (Default = True = Yes) needBlanket = true ``` ``` # || Is the Saddle slot required before equipping the Girth Strap, Breast Collar, and/or Saddlebag? (Default = True = Yes) needSaddle = true ```*This accepts **boolean** values of `true` or `false`. Default is `true` - tack must be equipped in a set order (bridle, blanket, saddle, girth).*
--- ##### Girth Strap Enable or disable automatic removal of the saddle and dismounting of the rider when a girth is not equipped. ``` needGirthStrap = true ```*This accepts **boolean** values of `true` or `false`. Default is `true` - girth must be equipped before mounting a horse.*
--- ##### Horse Armor Requirements Enable or disable requirements on a full set of Adventure Tack to equip Horse Armor. ``` needAll = true ```*This accepts **boolean** values of `true` or `false`. Default is `true` - full set (**inc. wraps + breast collar**) is required to equip armor.*
--- ##### Bridle Requirement Enable or disable requirements on a bridle to steer the horse. **If disabled, a saddle is still required!** ``` needBridleToSteer = true ```*This accepts **boolean** values of `true` or `false`. Default is `true` - horses cannot be "steered" without a bridle (halters do not count).*
--- #### **Adjustable Values - Experience Levels** ##### Skill Experience Set experience required to reach maximum level in each skill. ``` maxSpeedXP = 13500 ``` ``` maxJumpXP = 13500 ``` ``` maxHealthXP = 13500 ``` ``` maxAffinityXP = 17000 ```*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.*
**Multiplayer:** Values are aimed at Singleplayer and it is common for **Equestrian** servers to set `50-100,000+`
--- #### **Adjustable Values - Server Admin** ##### Coat Cycling Enable or disable changing horse coats in survival. ``` allowCoatCycling = true ```*This accepts `true` or `false`. Default is `true` and permits coat cycling (change) **owned** horses using lapis and redstone.*
--- ##### Secret Coats Enable or disable converting horses into a secret coat using the correct process or items. ``` allowSecretCoats = true ```*This accepts `true` or `false`. Default is `true` and allows players to obtain special coats in survival.*
--- ##### Server Time Enable or disable horse mealtimes using real life (24hr) time system. ` SUITABLE FOR SOME MULTIPLAYER / DO NOT USE IN SINGLEPLAYER ` ``` serverTime = false ```*This accepts `true` or `false`. Default is `false` and uses Minecraft day cycle to execute hunger and thirst routines at set game times.*
Set the real life time (local to the server) horses reset their hunger and thirst points. ` IGNORED IF SERVERTIME = FALSE ` ``` morningHungyTime = 7 ```*This accepts **whole** numbers over `0` and below `23`. Default is `7` - horses reset their needs at 7AM, **if they are in a loaded chunk.***
Set the real life time (local to the server) horses calculate their meals. ` IGNORED IF SERVERTIME = FALSE ` ``` eveningHungyTime = 20 ```*This accepts **whole** numbers over `0` and below `23`. Default is `20` - horses reset their needs at 8PM, **if they are in a loaded chunk.***
--- ##### Anvil Rename Cost Enable or disable free item (ie nametags) renaming in Cantazarite Anvils. ``` removeXpRenameCost = true ```*This accepts `true` or `false`. Default is `true` - cantazarite anvils can rename an item without XP cost or increments.*
--- ##### Amethyst Perks Enable or disable additional perks (excluding armor protection values) for Amethyst Player Armor. ``` disableAmethystPerks = false ```*This accepts `true` or `false`. Default is `false` - Amethyst armor retains all perks, specific to the item type or tier equipped.*
--- ##### Void TP Enable or disable teleporting the horse and rider if they fall into the void. ``` voidTP = true ```*This accepts `true` or `false`. Default is `true` - teleport horse/rider to spawn if falling into the void with Amethyst Horse Armor.*
--- ##### Blacklisted Coats Set restrictions on coats that can be obtained via breeding, natural spawning and spawn eggs. **TBC** ``` # || List of coats ids that should not be obtainable # || Example: ["swem:salamarty_arishant_cytris", "swem:mr_ed", "swem:joey_this_esme", "swem:delta_malli"] blacklistedCoatIds = [] ```*This accepts `swem:coatid` of default swem coats. Community pack coats can be individually restricted via their JSON files.*
--- ##### Key Permissions Enable or disable the built in permission node system. ` SUITABLE FOR SOME MULTIPLAYER / DO NOT USE IN SINGLEPLAYER ` ``` enableKeyPermission = false ```*This accepts `true` or `false`. Default is `false` - commands are not restricted to players with "key" permissions.*
--- ##### Spawning Enable or disable natural spawning of SW horses during world exploration. ``` horseSpawn = "BOTH" ```*This accepts `BOTH` or `VANILLA_ONLY` or `SWEM_ONLY`. Default is `BOTH` - lite **and** vanilla horses naturally spawn.*
--- ##### Obstacle Fireworks Enable or disable fireworks when colliding with jumps and barrel obstacles. ` CAN CAUSE REFUSALS / MINOR DAMAGE TO HORSES (JUMPS) ` ``` fireworkDisplay = false ```*This accepts `true` or `false`. Default is `false` - fireworks are not activated on contact with an obstacle.*
--- ##### Winged Flight Enable or disable ability for "natural winged horses" (ie Pegasus) to fly without Amethyst Horse Armor. ``` wingedHorseFly = true ```*This accepts `true` or `false`. Default is `true` - default and custom pegasus (set in JSON file) can fly **without** armor.*
--- ##### Lifesteal Set decimal value of the Lifesteal effect in Netherite+ riding boots. ` IGNORED IF DISABLEAMETHYSTPERKS = TRUE ` ``` lifesteal = 0.05 ```*This accepts **decimal** numbers from `0.01-1.0`. Default is `0.05` - 5% damage is healed by Netherite+ riding boots. `1.0` = 100%*
--- #### **Additional**Files change from `.toml` to `.toml.bak` if entries are invalid or a file was regenerated. Check regularly when updating or editing files!
Configuration file updates are uncommon and *usually* harmless, but you may need to regenerate files or reapply custom settings. --- #### **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**This is not a complete list of changes or features. It is a log of wiki-related version information and may be outdated.
| **MC Version** | **Release** | **Notes** |
1.21.1 | 1.6.12 | Page established - Information prior to 1.6.12 is not specifically included but is likely the same. |