Server Config

TheInformation SWEMtargets serverthe configlatest addssupported world-specificrelease. configurableFor 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 forwhile featuresyou likeplay needs,on tack,that skills etc. It can be opened and edited with a simple text editing program like Notepad.server.

Server configuration files tweak settings that apply to SingleplayerALL 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+

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

Important

[serverConfiguration root]/[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 name]/serverconfig/loading or result in game crashes.

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

If theyou suspect your config file is notcorrupted inor invalid, delete it and reload the folder,game thento try runningregenerate the world again to generate it.
If its still not there, copy/paste the full default config (below) into a .txt file, edit the config values as you wish, name it 'swem-server.toml', and put the .txt file into the folder. The server should read it upon next start-up.file.

ConfigsDefault ExplainedConfiguration

General
Config: Short for configuration, which means to change something to your preference. 
Default: Means the one thatThis is preset. If at any time you need to reset, the default configconfiguration isfile, alwayscontaining okay12 toadjustable returnsettings. to.
Lines: Configs are read by the computer in lines, like programming code. The lines staying the way they are is very important.
#: Means everything in that line of the config will not be read by the computer. Changes made here will effect nothing.

Remember

Horse Care

# || =========== [Horse Care] =========== ||
[horse_care]
	# || Do horses need to eat? (Default = True = Yes)
	needFood = true

This says: Turn on or off the need to eat. Must be True or False. Default is True.
Need for food effects horse ability. If the horse isn't fed often enough, it will not be able to gait up when riding and will lose health.
Turning this off means the horse will no longer be limited by need for food.

	# || Do horses need to drink? (Default = True = Yes)
	needWater = true

This says: Turn on or off the need to drink. Must be True or False. Default is True.
Need for water effects horse ability. If the horse isn't fed often enough, it will not be able to gait up when riding and will lose health.
Turning this off means the horse will no longer be limited by need for water.

	# || Enable Poop ticking on swem horses? (Default = True = Yes)
	poopTick = true

This says: Turns on or off the need to poop. Must be True or False. Default is True.
This effects nothing but horse care. If you don't want the habit of cleaning stalls, turn this to False.

	# || Specify range (radius) that the horses search for food/water. The larger the  radius, the more lag it can cause per horse.
	# || We recommend "15" (30b diameter) for servers.
	#Range:# Default: 15
	# Range: 5 ~ 40
	intakeSearchRadius = 15

This says: How far horses will search for food and water. Must be between 5 and 40 (blocks). Default is 15.
This effects how easily horses find accessible food, and choose the best food (further) over available food (nearer). Having a greater search radius is ideal for pasture horses that may not have water sources nearby, however an increased radius can cause lag.

Servers or players who experience significant lag should keep this value at default or lower to maximize their performance.

	# || Specify in seconds the interval between each poop cycle.
	# || We recommend '1800' (30min) for singleplayer, and '2700' (45min) for multiplayer.
	#Range:# Default: 1800
	# Range: > 1
	poopInterval = 1800

This says: How often your horses will poop. It must be more than 1. Default is 1800 (30min).
This is in ticks. 20 ticks = 1 second. The higher the number, the less they poop. This time will only pass while the horse is loaded.

	# || Enable Pee ticking on swem horses? (Default = True = Yes)
	peeTick = true

This says: Turns on or off the need to pee. Must be True or False. Default is True.
This effects nothing but horse care. If you don't want the habit of cleaning stalls, turn this to False.

	# || Specify in seconds the interval between each pee cycle.
	# || We recommend '1500' (25min) for singleplayer, and '2700' (45min) for multiplayer.
	#Range:# Default: 1500
	# Range: > 1
	peeInterval = 1500

This says: How often your horses will pee. It must be more than 1. Default is 930.
This is in ticks. 20 ticks = 1 second. The higher the number, the less they pee. This time will only pass while the horse is loaded.

Servers that aim to limit overbreeding or have reproductive 'cycles' should set an extended cooldown period.

	# || Specify how many seconds it takes for the foal to growp up?
	# || We recommend '1800' (30min) for singleplayer, and '28800' (8hr) for multiplayer.
	#Range:# Default: 1800
	# Range: > 1
	foalAgeInSeconds = 1800

This says: How many seconds it takes for a foal to grow up. It must be more than 1. Default is 1800.
1800seconds = 30minutes - this time will only pass while the foal is loaded.

Servers that want an extended period of foal care and growth time should extend this according to their needs.

	# || 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.
	#Range:# Default: 600
	# Range: > 1
	healthBoosterTime = 600

# || =========== [Horse Breeding] =========== || [horse_breeding] # || Enable Breeding Tokens? This says:limits Howbreeding manyof minuteshorses ato healthTokens, boosterprevents lasts.feed Itfrom mustescalating befoal moregrowth thantime, 1.and Defaultlimits use of canatazarite potions. # || Enable if the server is 600.
600multiplayer minutesand has an economy. tokensBreeding = 10false hours RL or ~30MC days - this time will only pass while the horse is loaded.

Servers that offer boosters as a veterinary treatment service should increase this value to reflect the ideal duration for the price charged, factoring in that horses loaded very frequently (ie in neighbourhoods) will lose this booster quicker.

Horse Breeding

#
	# || Do horses stay in love mode forever? (Default = False = No)
	# || If false, horses will only be in love mode for the amount of seconds specified in stallionLoveTime and mareLoveTime.
	permanentLoveMode = false

This says: This turns on or off love mode being permanent love mode (seeking a partner).
Must be True or False. Default is True.

#
	# || Specify how many seconds the stallion stays in love mode (Only has an effect if permanentLoveMode is false).
	# || We recommend '1800' (30min) for singleplayer, and '28800' (8hr) for multiplayer.
	#Range:# Default: 1800
	# Range: > 1
	stallionLoveTimeInSeconds = 1800

This says: How many seconds a stallion will remain in love mode (seeking a partner). It must be more than 1. Default is 1800.
1800seconds = 30minutes - this time will only pass while the horse is loaded. Overriden if permanent love mode is enabled.

#
	# || Specify how many seconds the mare stays in love mode (Only has an effect if permanentLoveMode is false).
	# || We recommend '1800' (30min) for singleplayer, and '28800' (8hr) for multiplayer.
	#Range:# Default: 1800
	# Range: > 1
	mareLoveTimeInSeconds = 1800

This says: How many seconds a mare will remain in love mode (seeking a partner). It must be more than 1. Default is 1800.
1800seconds = 30minutes - this time will only pass while the horse is loaded. Overriden if permanent love mode is enabled.

#
	# || Specify how many seconds it takes for the mare to give birth
	# || Set to 1 to disable gestation period, and making the birth instant.
	# || We recommend '1800' (30min) for singleplayer, and '28800' (8hr) for multiplayer.
	#Range:# Default: 1800
	# Range: > 1
	mareGestationTimeInSeconds = 1800

This says: How many seconds a mare's gestation (pregnancy) lasts. It must be more than 1. Default is 1800.
900seconds = 15minutes - this time will only pass while the horse is loaded.

#
	# || Specify how many seconds it takes for the stallion to be able to breed again.
	# || We recommend '900' (15min) for singleplayer, and '14400' (4hr) for multiplayer.
	#Range:# Default: 900
	# Range: > 1
	stallionBreedingCooldownInSeconds = 900

This says: How many seconds it takes before a stallion is fertile after breeding. It must be more than 1. Default is 1800.
1800seconds = 30minutes - this time will only pass while the horse is loaded.

#
	# || Specify how many seconds it takes for the mare to be able to breed again.
	# || We recommend '1800' (30min) for singleplayer, and '28800' (8hr) for multiplayer.
	#Range:# Default: 1800
	# Range: > 1
	mareBreedingCooldownInSeconds = 1800

This says: How many seconds it takes before a mare is fertile after birthing. It must be more than 1. Default is 1800.
1800seconds = 30minutes - this time will only pass while the horse is loaded.

#
	# || Specify how many times a stallion can breed before it is exhausted.infertile.
	# || Disable thisinfertility option by setting it to '0'.
	#Range:# Default: 0
	# Range: > 0
	maxStallionCovers = 0

This says: How many covers a stallion can have before it becomes 'infertile' (capped). It must be more than 0-1+. Default is 0.
0 = no limit.

#
	# || Specify how many times a mare can breed before it is exhausted.infertile.
	# || Disable thisinfertility option by setting it to '0'.
	#Range:# Default: 0
	# Range: > 0
	maxMareCovers = 0

This says: How many births a mare can have before it becomes 'infertile' (capped). It must be more than 0-1+. Default is 0.
0 = no limit.

	# || Can the owner geld their own horses? (Default = True = Yes)
	# || If false, only op's and people with the permission node (swem.horse.geld) can geld horses.
	ownerCanGeld = true

This says: If the owner can geld their horse via command or potion.
Must be True or False. Default is True.

	# || Specify the chance of a mare giving birth to twins (Default = 1,000 = 0.1%)
	# || If the value is higher than 1,000 the odds go down, if the value is lower than 1,000 the odds go up.
	#Range:# || We recommend '1000' (1/1000 chance) for singleplayer, and '15000' (1/15000 chance) for multiplayer.
	# Default: 1000
	# Range: > 1
	twinBirthChance = 1000

This# says:# The|| rarityShould infertile horses be able to be made fertile again (by giving a male/female/random potion)? refertile_horses = true # # || If enabled, a Stallion will look for a fertile Mare to breed without need of aitems. twinnatural_breed_chance foal= birth, 1 infalse # births resulting in twins. It must be more 1. Default is 1000.
1000|| =========== 1 in 1000 births result in twins. The percentage is so low as viable twin births are incredibly rare and risky.

[Tack Dependencies

=========== ||
[tack_dependencies]
	# || Is the Bridle slot required before equipping a Blanket? (Default = True = Yes)
	needBridle = true

This says: This turns on or off the need for the Bridle to equip a Saddle Blanket.
Must be True or False. Default is True.
This feature is only for life-like accuracy. Disabling it does not effect gameplay.

	# || Is the Blanket slot required before equipping a Saddle? (Default = True = Yes)
	needBlanket = true

This says: This turns on or off the need for the Saddle Blanket to be placed first before putting the Saddle on.
Must be True or False. Default is True.
This feature is only for life-like accuracy. Disabling it does not effect gameplay.

	# || Is the Saddle slot required before equipping the Girth Strap,  Breast Collar, and/or Saddlebag? (Default = True = Yes)
	needSaddle = true

This says: This turns on or off the need for the Saddle to be placed first before putting the Girth Strap, Breastcollar or Saddlebag on.
Must be True or False. Default is True.
This feature is only for life-like accuracy. Disabling it does not effect gameplay.

	# || The Rider and Saddle should fall off if there is no Girth Strap equipped. (Default = True = Yes)
	needGirthStrap = true

This says: This turns on or off the need for the Girth Strap to keep the Saddle on.
Must be True or False. Default is True.
This feature is only for life-like accuracy. Disabling it does not effect gameplay.

	# || Are all Tack slots required before equipping Horse Armor? (Default = True = Yes)
	needAll = true

This says: This turns on or off the need for Horse Armor to require a full (Adventure) Tack Set - all 6 pieces.
Must be True or False. Default is True.
This feature is only for life-like accuracy. Disabling it does not effect gameplay.

	# || The Bridle is needed to steer the horse. (If disabled, you would still need a saddle). (Default = True = Yes)
	needBridleToSteer = true

This# says:|| This=========== turns on or off the need for the Bridle to steer the horse.
Must be True or False. Default is True.
Disabling this does effect gameplay. If this is False, you will only need a Saddle to command the horse while riding.

[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.
	#Range:# 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.
	#Range:# 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.
	#Range:# 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.
	#Range:# Default: 17000
	# Range: > 1
	maxAffinityXP = 17000

This# says:|| How=========== much experience points are required to fully level a skill. Must be greater than 1. Default is 13500 for Speed, Jump and Health, or 17000 for Affinity.
Decrease these values if you would like to spend less time training horses, or increase one/specific/all to spend longer.

For multiplayer servers it is highly recommended to increase skills accordingly if the server values commitment to training a horse and/or aims to encourage server competitions being higher prestige the higher a horse's level is. 

Currently the health skill can only be maxed with XP potions - this feature will be implemented in future.

[Server AdminAdmin] Settings

Settings|| specifically aimed at Multiplayer servers to help manage or promote survival economies, horse acquisition and population.

[server_admin]
	# || Enable Coat Cycling (via lapis lazuli and redstone)?
	# || Do not enable if the server is multiplayer and has an economy.
	allowCoatCycling = true

This says: Turns on or off the ability to Lapis/Redstone flip through coats. Must be True or False. Default is True.
When disabled, new coats can only be acquired via converting vanilla ponies (if permitted), breeding horses selectively or summon commands.

Servers that aim to encourage an economy for horse breeding and sales should disable (set to false) coat cycling.

	# || 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

This says: Turns on or off the ability to make secret coats using their special items. Must be True or False. Default is True.
When disabled, secret coats can only be acquired with summon commands and normal conversion items will not work.

Servers that intend to restrict all secret coats or for special rewards should disable (set to false) secret coat converting.

	# || Enable Breeding Tokens? This limits breeding of horses and ponies to Tokens while preventing feed from escalating foal growth time.
	# || Enable if the server is multiplayer and has an economy.
	tokensBreeding = false

This says: Turns on or off the ability to breed and create SWEM horses normally. Must be True or False. Default is false.
When enabled, SWEM horses can only be bred with breeding tokens or spawned by summon commands. Cantazarite potions will NOT work on vanilla ponies.

Servers that aim for all horses to come via sales or rescue (without having to turn off mob spawning to prevent vanilla horses) or limit who can breed horses should enable (set to true) breeding tokens. See also: Recipe control config for breeding token crafting restrictions HERE.

	# || Enable the horse's food/water systems to be based off the 24 hour day?
	# || This is recommended for servers ONLY.
	serverTime = false

This# says:|| TurnsRequired on or off needs resetting on a 24hrs (RL) cycle depending on time. Must be True or False. Defaultonly is false.
When'serverTime' enabled,config needsis willenabled. reset# || The hour at 8AMwhich GMTmorning andhungy betime calculatedtriggers (Local to the server). # Default: 7 # Range: 0 ~ 23 morningHungyTime = 7 # || Required only is 'serverTime' config is enabled. # || The hour at 9PMwhich GMTevening eachhungy servertime daytriggers provided(Local to the horseserver). is# loaded.

Servers20 that# haveRange: food/water0 enabled~ and23 enforceeveningHungyTime care= standards should enable this to prevent horses missing many meals or drinks based on MC days while loaded by other players.

20
	# || Should xp cost for renaming items in an cantazarite anvil be removed?
	removeXpRenameCost = true

This says: Turns on or off cantazarite anvils allowing item renaming at no XP cost. Must be True or False. Default is true.
When enabled, it will be free (requiring no XP levels) to rename items in the cantazarite anvil, permitting players to do harmless functions like set nametags, name tack items, rename their enchanted tools or armor.

Full (Default) Config

	needFood = true

	needWater = true

	5 ~ 40

	We recommend '1800' (30min) for singleplayer, and '2700' (45min) for multiplayer.

	We recommend '1500' (25min) for singleplayer, and '2700' (45min) for multiplayer.

	foalAgeInSeconds = 1800

	healthBoosterTime = 600

	tokensBreeding = false

	permanentLoveMode = false

	stallionLoveTimeInSeconds = 1800

	mareLoveTimeInSeconds = 1800

	mareGestationTimeInSeconds = 1800

	stallionBreedingCooldownInSeconds = 900

	mareBreedingCooldownInSeconds = 1800

	maxStallionCovers = 0

	maxMareCovers = 0

	twinBirthChance = 1000

	refertile_horses = true

	(30min) for singleplayer, and '28800' (8hr) for multiplayer.

# || Is the Bridle slot required before equipping a Blanket? (Default = True = Yes)

# || Is the Blanket slot required before equipping a Saddle? (Default = True = Yes)

# || Is the Saddle slot required before equipping the Girth Strap,   Breast Collar, and/or Saddlebag? (Default = True = Yes)

	= True = Yes)

	needAll = true

	saddle). (Default = True = Yes)

	We recommend '13500' for singleplayer, and '100000' for multiplayer.

	|| Amount of XP required to max a horse's Jump stat.

	|| Amount of XP required to max a horse's Health  stat.

	|| Amount of XP required to max a horse's Affinity stat.

	enable if the server is multiplayer and has an economy.

	allowSecretCoats = true

	serverTime = false

	morningHungyTime = 7

eveningHungyTime = 20

	removeXpRenameCost = true

    disableAmethystPerks = false

	voidTP = true

If you notice changes you don't like but don't know how to undo the changes you made to the Config, shut down the game and replace the config with this default one and the config will be reset. If using an older release, delete the config file and relaunch to regenerate it.

Troubleshooting

Changelog

# || List of coats ids that should not be obtainable

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 - please check for duplicate reports first! 

Changelog