Configs, Commands & Files

• Client Config
• Common Config
• Server Config
• Recipe Config
• SWEM Commands
• Horse Data

Client Config

Information targets the latest supported release. For legacy (older) versions and bug fixes, read the changelogs.

Introduction

Client configs are set for the individual player and are not overriden by any server settings.

Client configuration files tweak small visual settings that apply to ALL worlds created for the current mod pack and any servers joined.

Important

Configuration files have a specific format, and allow you to change limited values. Inputting invalid information or adjusting the file format can result in issues such as invalid configuration loading or crashing.

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

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

If you suspect a config file is corrupted or invalid, delete it and reload Minecraft to regenerate a default file.

Default Configuration

This is the default configuration file, containing five adjustable settings.

# || =========== [Wings Transparency] =========== ||
[wings_tansparency]
	# || Set how visible the horse wings should be! 0 = off, 1 = 25%, 2 = 50%, 3 = 75%, 4 = 100%
	# Default: 4
	# Range: 0 ~ 4
	wingsTransparency = 4

# || =========== [Gait HUD] =========== ||
[hud]
	# || Should the gait HUD be enabled?
	gaitHudEnabled = true
	# || How much would you like to offset the current X position? (A negative value moves the text up and a positive value down.)				
	# Default: 0
	# Range: > -2147483648
	gaitHudX = 0
	# || How much would you like to offset the current Y position? (A negative value moves the text up and a positive value down.)				
	# Default: 0
	# Range: > -2147483648
	gaitHudY = 0
	# || What color should the gait HUD be?
	# Default: 16777215
	# Range: > -2147483648
	gaitHudColor = 16777215

# || =========== [Gender] =========== ||
[gender]
	# || Should gender icons be shown before horse names?
	# || Icons only show if the horse is tamed and has a custom name.
	showGenderIcons = true
	# || What colour the male icon should appear as.
	# || This is a hex value, format: #A1B2C3. (Default is #18C0ED)
	maleIconColor = "#18C0ED"
	# || What colour the female icon should appear as.
	# || This is a hex value, format: #A1B2C3. (Default is #FF4DAC)
	femaleIconColor = "#FF4DAC"
	# || What colour the icon should appear as, when the horse is infertile.
	# || This is a hex value, format: #A1B2C3. (Default is #444269)
	infertileIconColor = "#444269"

Adjustable Values - Wings

Set the transparency for wings on Amethyst Tier Horse Armor.

	# || Set how visible the horse wings should be! 0 = off, 1 = 25%, 2 = 50%, 3 = 75%, 4 = 100%
	# Default: 4
	# Range: 0 ~ 4
	wingsTransparency = 4

This accepts whole numbers from 0-4. Default is 4 where wings are fully opaque (100%).

Adjustable Values - Gait HUD

Enable or disable the gait HUD overlay which displays the currently active gait while riding a horse.

	# || Should the gait HUD be enabled?
	gaitHudEnabled = true

This accepts boolean values of true or false. Default is true (enabled). 

Set the horizontal position for the gait HUD overlay.

	# || How much would you like to offset the current X position? (A negative value moves the text up and a positive value down.)				
	#Range: > -2147483648
	gaitHudX = 0

This accepts whole numbers greater than -2147483648. Default is 0 to the right of the hotbar.

Set the vertical position for the gait HUD overlay.

# || How much would you like to offset the current Y position? (A negative value moves the text up and a positive value down.)				
	#Range: > -2147483648
	gaitHudY = 0

This accepts whole numbers greater than -2147483648. Default is 0 at the height of the hotbar.

Set the decimal value of the gait HUD overlay to change the text color.

# || What color should the gait HUD be?
	#Range: > -2147483648
	gaitHudColor = 16777215

This accepts whole numbers greater than -2147483648. Default is 16777215 (white).

Adjustable Values - Gait HUD

Enable or disable gender icons shown next to horse names.

# || Should gender icons be shown before horse names?
	# || Icons only show if the horse is tamed and has a custom name.
	showGenderIcons = true

This accepts boolean values of true or false. Default is true (enabled). 

Set the HEX value of the male gender icon.

# || What colour the male icon should appear as.
	# || This is a hex value, format: #A1B2C3. (Default is #18C0ED)
	maleIconColor = "#18C0ED"

This accepts HEX value combinations. Default is #18C0ED (blue).

Set the HEX value of the female gender icon.

# || What colour the female icon should appear as.
	# || This is a hex value, format: #A1B2C3. (Default is #FF4DAC)
	femaleIconColor = "#FF4DAC"

This accepts HEX value combinations. Default is #FF4DAC (pink).

Set the HEX value of the infertile (male or female) gender icon.

# || What colour the icon should appear as, when the horse is infertile.
	# || This is a hex value, format: #A1B2C3. (Default is #444269)
	infertileIconColor = "#444269"

This accepts HEX value combinations. Default is #444269 (muted purple).

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

Common Config

Information targets the latest supported release. For legacy (older) versions and bug fixes, read the changelogs.

Introduction

 Multiplayer: Configuration files on servers override any "client-side" (player) or pack settings while connected.

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

Important

Configuration files have a specific format, and allow you to change limited values. Inputting invalid information or adjusting the file format can result in issues such as invalid configuration loading or crashing.

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

If you suspect a config file is corrupted or invalid, delete it and reload Minecraft to regenerate a default file.

Default Configuration

This is the default configuration file, containing two adjustable settings.

#Common Configs
[common]

	# || =========== [Block o Water] =========== ||
	[common.block_o_water]
		# || Do the hose and the spigot require a Block O Water?
		needBlockOWater = true

#SWEM Ore Generation Settings
[oregen]

	# || =========== [Shining Amethyst] =========== ||
	[oregen.amethyst]
		# || What is the spawn chance (%) for Shining Amethyst?
		# Default: 25
		# Range: 0 ~ 100
		amethystSpawnChance = 25

Adjustable Values

Enable or disable the spigot requiring a block o' water.

# || Do the hose and the spigot require a Block O Water?
		needBlockOWater = true

This accepts boolean values of true or false. Default is true - spigots require a block o' water to function. 

Set the chance of amethyst clusters becoming shining amethyst when fully grown.

# || What is the spawn chance (%) for Shining Amethyst?
		# Default: 25
		# Range: 0 ~ 100
		amethystSpawnChance = 25

This accepts whole numbers from 0-100. Default is 25 (%).

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

Server Config

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 reference

If 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. 

# || =========== [Horse Care] =========== ||
[horse_care]
	# || Do horses need to eat? (Default = True = Yes)
	needFood = true
	# || Do horses need to drink? (Default = True = Yes)
	needWater = true
	# || Enable Poop ticking on swem horses? (Default = True = Yes)
	poopTick = true
	# || 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.
	# Default: 15
	# Range: 5 ~ 40
	intakeSearchRadius = 15
	# || Specify in seconds the interval between each poop cycle.
	# || We recommend '1800' (30min) for singleplayer, and '2700' (45min) for multiplayer.
	# Default: 1800
	# Range: > 1
	poopInterval = 1800
	# || Enable Pee ticking on swem horses? (Default = True = Yes)
	peeTick = true
	# || Specify in seconds the interval between each pee cycle.
	# || We recommend '1500' (25min) for singleplayer, and '2700' (45min) for multiplayer.
	# Default: 1500
	# Range: > 1
	peeInterval = 1500
	# || Specify how many seconds it takes for the foal to growp up?
	# || We recommend '1800' (30min) for singleplayer, and '28800' (8hr) for multiplayer.
	# Default: 1800
	# Range: > 1
	foalAgeInSeconds = 1800
	# || 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 Breeding] =========== ||
[horse_breeding]
	# || Enable Breeding Tokens? This limits breeding of horses to Tokens, prevents feed from escalating foal growth time, and limits use of canatazarite potions.
	# || Enable if the server is multiplayer and has an economy.
	tokensBreeding = false
	#
	# || 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
	#
	# || 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.
	# Default: 1800
	# Range: > 1
	stallionLoveTimeInSeconds = 1800
	#
	# || 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.
	# Default: 1800
	# Range: > 1
	mareLoveTimeInSeconds = 1800
	#
	# || 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.
	# Default: 1800
	# Range: > 1
	mareGestationTimeInSeconds = 1800
	#
	# || 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.
	# Default: 900
	# Range: > 1
	stallionBreedingCooldownInSeconds = 900
	#
	# || 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.
	# Default: 1800
	# Range: > 1
	mareBreedingCooldownInSeconds = 1800
	#
	# || Specify how many times a stallion can breed before it is infertile.
	# || Disable infertility option by setting it to '0'.
	# Default: 0
	# Range: > 0
	maxStallionCovers = 0
	#
	# || Specify how many times a mare can breed before it is infertile.
	# || Disable infertility option by setting it to '0'.
	# Default: 0
	# Range: > 0
	maxMareCovers = 0
	#
	# || 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.
	# || We recommend '1000' (1/1000 chance) for singleplayer, and '15000' (1/15000 chance) for multiplayer.
	# Default: 1000
	# Range: > 1
	twinBirthChance = 1000
	#
	# || Should 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 items.
	natural_breed_chance = false

# || =========== [Tack Dependencies] =========== ||
[tack_dependencies]
	# || 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
	# || The Rider and Saddle should fall off if there is no Girth Strap equipped. (Default = True = Yes)
	needGirthStrap = true
	# || Are all Tack slots required before equipping Horse Armor? (Default = True = Yes)
	needAll = true
	# || The Bridle is needed to steer the horse. (If disabled, you would still need a saddle). (Default = True = Yes)
	needBridleToSteer = true

# || =========== [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
	# || Enable the horse's food/water systems to be based off the 24 hour day?
	# || This is recommended for servers ONLY.
	serverTime = false
	# || Required only is 'serverTime' config is enabled.
	# || The hour at which morning hungy time triggers (Local to the server).
	# Default: 7
	# Range: 0 ~ 23
	morningHungyTime = 7
	# || Required only is 'serverTime' config is enabled.
	# || The hour at which evening hungy time triggers (Local to the server).
	# Default: 20
	# Range: 0 ~ 23
	eveningHungyTime = 20
	# || Should xp cost for renaming items in an cantazarite anvil be removed?
	removeXpRenameCost = 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
	# || 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 = []
	# || 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"
	# || Enables fireworks to be shot out of jumps and barrels when horses touch them.
	fireworkDisplay = false
	# || Should winged horse fly without requirement of Amethyst Horse Armor?
	wingedHorseFly = true
	#|| 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

Multiplayer Servers

Please note, default configuration is aimed at the average Singleplayer user. Configuration for Multiplayer use, especially with a strong Equestrian focus, or balance on rate of reproduction, training etc will require specific adjustments to suit your individual needs.

Read the full configuration file carefully to observe any recommendations on Multiplayer specific settings!

Adjustable Values - Horse Care

Food & Water

Enable or disable food and water system.

	needFood = true

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

Changelog

Recipe Config

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 connected.

Singleplayer: Recipe config is aimed at allowing MP servers to restrict access to certain items, and holds very little use in SP.

Recipe configuration files tweak settings affecting how items are obtained, which apply to ALL worlds created for the current mod pack.

Important

Configuration files have a specific format, and allow you to change limited values. Inputting invalid information or adjusting the file format can result in issues such as invalid configuration loading or crashing.

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

If you suspect a config file is corrupted or invalid, delete it and reload Minecraft to regenerate a default file.

Default Configuration

This is the default configuration file, containing two adjustable settings.

# || =========== [Obtaining] =========== ||
[obtaining]
	# || How is Amethyst Weapons and Armor (Player) obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 1
	# Range: 1 ~ 3
	obtainAmethystGear = 1
	# || How are Rosettes obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 1
	# Range: 1 ~ 3
	obtainRosettes = 1
	# || How are Two Tailed Ribbons obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 2
	# Range: 1 ~ 3
	obtainTwoTailedRibbons = 2
	# || How are Three Tailed Ribbons obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 2
	# Range: 1 ~ 3
	obtainThreeTailedRibbons = 2
	# || How are Champion and Reserve Champion Ribbons obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 2
	# Range: 1 ~ 3
	obtainChampionshipRibbons = 2
	# || How are Plaques obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 2
	# Range: 1 ~ 3
	obtainPlaques = 2
	# || How are Trophies obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 2
	# Range: 1 ~ 3
	obtainTrophies = 2
	# || How are Breeding Tokens obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 3
	# Range: 1 ~ 3
	obtainTokensBreeding = 3
	# || How are Boosters obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 1
	# Range: 1 ~ 3
	obtainBoosters = 1
	# || How are Infertility Potions obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 1
	# Range: 1 ~ 3
	obtainInfertilityPotions = 1
	# || How are Equestrian Shop Coins obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 1
	# Range: 1 ~ 3
	obtainCoins = 1
	# || How are XC Jump Eggs obtained? 1 = Survival Crafting, 2 = Creative Menu, 3 = /give
	# Default: 1
	# Range: 1 ~ 3
	obtainJumps = 1
	# || Should EQ Coins be exchangeable with SWEconM Thyms?
	sweconmExchange = false

Supported Values

Most settings accept a numerical value:

• 1 Obtained via crafting recipe in survival, creative menu or give commands (3/3).
• 2 Obtained via creative menu and give commands only, no crafting recipe (2/3).
• 3 Obtained via give commands only, no crafting recipe or creative menu option (1/3).

Adjustable Values

Set the method to obtain Amethyst equipment, including Player Armor and Weapons.

	obtainAmethystGear = 1

This accepts whole number values between 1-3. Default is 1 - items can be crafted in survival. 

Set the method to obtain Rosettes.

	obtainRosettes = 1

This accepts whole number values between 1-3. Default is 1 - items can be crafted in survival. 

Set the method to obtain Two Tailed Ribbons.

	obtainTwoTailedRibbons = 2

This accepts whole number values between 1-3. Default is 2 - items can be obtained via creative menu or commands. 

Set the method to obtain Three Tailed Ribbons.

	obtainThreeTailedRibbons = 2

This accepts whole number values between 1-3. Default is 2 - items can be obtained via creative menu or commands. 

Set the method to obtain Reserve and Champion Ribbons.

	obtainChampionshipRibbons = 2

This accepts whole number values between 1-3. Default is 2 - items can be obtained via creative menu or commands. 

Set the method to obtain Plaques.

	obtainPlaques = 2

This accepts whole number values between 1-3. Default is 2 - items can be obtained via creative menu or commands. 

Set the method to obtain Trophies.

	obtainTrophies = 2

This accepts whole numbers between 1-3. Default is 2 - items can be obtained via creative menu or commands.

Set the method to obtain Breeding Tokens. Only relevant if tokensBreeding = true in Server Config.

	obtainTokensBreeding = 3

This accepts whole number values between 1-3. Default is 3 - items can only be obtained via give commands.

Set the method to obtain Boosters.

	obtainBoosters = 1

This accepts whole number values between 1-3. Default is 1 - items can be crafted (brewing stand) in survival. 

Set the method to obtain Infertility Potions.

	obtainInfertilityPotions = 1

This accepts whole number values between 1-3. Default is 1 - items can be crafted (brewing stand) in survival. 

Set the method to obtain Equestrian Shop Coins.

	obtainCoins = 1

This accepts whole number values between 1-3. Default is 1 - items can be crafted in survival. 

Set the method to obtain throwable XC Jump Eggs.

	obtainJumps = 1

This accepts whole number values between 1-3. Default is 1 - items can be crafted in survival. 

Enable or disable converting Equestrian Shop Coins to Thyms (SWecon Mod).

This accepts boolean values of true or false. Default is false - coins cannot be exchanged for SWecon Thyms.

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

SWEM Commands

To use commands listed below, the following crtieria must be met:

• Commands (cheats) enabled
• User holds key(s) for specific commands.

Basic Commands

These are commands that are accessible to all players by default. 

CHANGE OWNERSHIP

Transfer ownership must be used while riding a horse to have an effect. Only the owner can run this command.

/swem horse transfer <playername>          Transfer a horse to another player (new owner).

ADD OR REMOVE TRUSTED PLAYERS
This command 'whitelists' player(s) to ride and interact with a horse that is set to Trusted only. 

Trusted player commands must be used while riding a horse to have an effect. Only the owner or OP can run this command.

LIST OWNED
This command is intended for servers that enforce a horse ownership limit.

TACK RENDERING
This command sets tack to invisible, or re-renders already invisible tack.
It is used to simulate 'bareback' riding or 'wild' horses (invisible rider). Server-side, so changes can be seen by all players.

Tack render commands must be used while riding a horse to have an effect.

RRP COMMANDS
These commands trigger a single or looped animation to support photos and videos for players and content creators. 
This occurs server-side, so triggered animations will be seen by all players unless it is a custom animation (pack required).

Looped animations (∞) play continuously until the command is repeated, all others will play one time then stop.
Single animations triggered during a looped animation will play once, then return to the original looped animation.
Animations are visual only and will not have any effects such as damage from bucking or biting. 

RRP commands must be used while riding a horse to have an effect.

RESOURCES

Breeding Commands (1.18.2-1.4.0+)

If configured on servers, these commands will only be usable by OPs or with relevant permissions (if enabled).

Breeding commands must be used while riding a horse to have an effect.

Summon & Modify Commands

If configured on servers, these commands will only be usable by  TBC .

Minecraft /summon command will only summon default (white) horses as of 1.20.1-1.5.0+, use /swem summon instead!

Filming Commands

These commands will only be usable to players with the Film key unless disabled in serverconfig (1.20+).

Wild mode and Max Gallop commands must be used while riding a horse to have an effect.

MULTIPLAYER Wild mode is not recommended for SMPs - it sets max affinity, provides free tack and adjusts gallop limit.

WILD MODE   THIS DOES NOT ACTUALLY MAKE HORSES "WILD"  
This command sets horses to a specific skill level and tack setup intended for quick filming-ready horses.

• Instantly tames a horse if it is currently untamed
• Instantly tacks a horse with gray western tack
• Set all tack items invisible
• Set Speed level to 1 (easier to keep up with camera)
• Set Jump level to 1
• Set Affinity level to 12 (max) to reduce refusals

  WILD MODE CANNOT BE REVERSED  

• Tack visibility is temporary - it will revert to visible on re-log or restart and can be toggled via commands.
• Skills changes are permanent unless retrained or adjusted via commands. Do not use on personal horses!
• This command has no effect on riders - it will not make them invisible!

Moderator Commands

These commands will only be usable to players with the Mod key unless disabled in serverconfig (1.20+).

Commands requiring a [playername] specified will need to be run while the intended player is online to work.

Admin Commands

These commands will only be usable to players with the Admin key unless disabled in serverconfig (1.20+).

Set level commands must be used while riding a horse to have an effect.

Assigning Keys

Keys do NOT stack - you need all the keys relevant to the desired keys (ie Admin does not inherit the commands of Mod).

As shown in the above sections, some SWEM commands are linked to a role 'key' to prevent misuse of some non-survival friendly commands on servers. Please read the below information carefully:

• Singleplayer (SP): All keys can be assigned via the /swem key assign command.
• Multiplayer (MP): Admin keys must be assigned via console access only.
• MP (Essentials): Admin keys must be assigned prior to opening the world to other players.
• Players with the admin key can assign film and mod keys to other users without requiring OP.

Other

Change Ownership
This vanilla command should no longer be needed in 1.18 with OP overrides to horse ownership (when set to none/trusted only) but it is noted in case of any issue with accessing a restricted horse.

/data modify entity @e[type=swem:swem_horse,sort=nearest,limit=1] Owner set value PLAYERSFULLUUIDHERE

1. Stand near the target horse - move away any other nearby SWEM horses (to not accidentally edit their data instead)
2. Find the UUID of a (OP) player, you can get it on a website like MCUUID, and edit the command
   
3. Run the command. You can change the horse to All, mount it and use the normal transfer command

Known Issues

If you find an issue, please report it to our bugs channel on Discord. We ask that you look to see if your issue was reported first!

• [-] Keys override OP access and cannot be circumvented to set custom role permissions via permission plugins.
  

Changelog

Horse Data

The Horse Data file (1.18.2+) adds information on horses within the world and allows players or servers to reference information that would otherwise be inaccessible outside of code or NBT explorers / editors. 

MultiMC: Instance > Minecraft Folder (Right Sidebar) > Saves > [World Name] > Serverconfig > swem > horsedata.json
CurseForge: Profile > ... (next to play) > Open Folder > Saves > [World Name] > Serverconfig > swem > horsedata.json
Forge (Windows): [user]/AppData/Roaming/.minecraft/saves/[world name]/serverconfig/swem/horsedata.json
Forge (Mac): ~/Library/Application Support/minecraft/saves/[world name]/serverconfig/swem/horsedata.json
Servers: World > Serverconfig > swem > horsedata.json

Horse Data Explained

Horse Data is only a reference source and cannot be changed to adjust entity data or remove entities in game!

Horse Data can be opened via a text editor (ie Notepad) and provides the following information:

Uses

The horse data has many potential uses - even as a reference only source:

• Find information on current horses in the world, search by specifics such as name / owner ID.
• Moderation: Investigate potential misuse of exploits or rule breaking involving SWEM horses.
• Management: Search by owner to ensure adherence to ownership limits. (See below)
• Management: Facilitate resolving issues (bugs etc) by being able to reinstate evidenced stats or data.
• Resurrection: Reference a deceased horse's last known stats to offer 'resurrection'. (See below)
• Relocation: Find the last known location of a horse to find missing entities or narrow search radius. (See below)

Horse Ownership

World Owners (SP) or Server staff with console access (MP) can of course search (Ctrl+F) for an owner's UUID in horse data and determine currently owned horses - alive or deceased - and information such as location and stats. This may provide useful for servers in moderation where imposed restrictions on number of owned horses exists and there is concern for misuse.

However, horse data and the horse owner data entry offers the most significant feature built into the game; searching by criteria for this specific information. With adequate permissions, the following commands can be run:

/swem horse owned list <player>   List the number of owned horses (and the names if nametagged) of a specific player.

/swem horse owned search <#>         List the names of players and # of horses owned that exceeds the limit of # owned.

Resurrection

Horses Data was implemented with the intention to enable in-game resurrection further into development.

Horse Data does not currently offer a way to resurrect horses in game, or alter the state of a horse via file editing. However, for servers that want to offer a low exploit-risk resurrection service (free or at cost) the horse data file contains most, if not all, the required information to create a new horse and reinstate the last-known skill levels, equipment and owner. 

Similarly, SP users can utilise the information in much the same way if they want to recreate a previous horse as accurately as possible.

Relocation

Horse Data does not save constantly, so coordinate locations may reflect the exact location of a horse on the move.

Horse Data does not currently offer a way to relocate horses in game, or alter the location of a horse horse via file editing. What it can do is provide a good starting location and dimension to conduct a manual search, or to narrow down search radius for searching via Minecraft commands. This information removes the necessity of using external NBT explorers, spending time searching when location commands fail (or cannot be used due to lack of a name / unknown exact name / many entities with the same name), leaving players hoping someone will find them in the future or even futile searching for a horse that may no longer be alive. 

Other

The Horse Data file should be safe to delete if it become corrupted or remove outdated information on deceased horses. It will regenerate with data of new and existing horses (provided they are loaded by a player). It will not reinstate the data of deceased horses prior to resetting the file. 

Known Issues

If you find an issue, please report it to our bugs channel on Discord. We ask that you look to see if your issue was reported first!

• [~] Saving data might occur too frequently, causing console spam and potentially lag on servers.
  

Changelog