Config Introduction

Config Introduction

Yet-Another-Thirst consolidates all configuration files into a single folder within your Minecraft instance directory:

📂 config/yet_another_thirst/

The mod splits configuration between client-only visual adjustments and server-authoritative gameplay settings.

---

Configuration Files

1. client.toml

Contains client-side visual adjustments. Modifying it does not affect server gameplay and can be tweaked in multiplayer.

[hud]

Configuration Key	Type	Default	Range	Description
hudXOffset	Integer	0	-512 to 512	Horizontal pixel offset for the thirst droplets HUD bar (positive = right).
hudYOffset	Integer	0	-512 to 512	Vertical pixel offset for the thirst droplets HUD bar (positive = down).

---

2. common.toml

Controls all core gameplay mechanics. In multiplayer, these options must be configured on the server side.

[general]

Configuration Key	Type	Default	Range / Format	Description
extraHydrationConvertsToQuenched	Boolean	true	true/false	Convert overflow hydration into quenched bonus.
thirstDepletesInPeaceful	Boolean	false	true/false	Allow thirst to deplete in Peaceful difficulty.
drinkRainWater	Boolean	true	true/false	Allow players to drink rain water by looking up while it rains.
depletesWhenNausea	Boolean	true	true/false	Deplete thirst faster while the player has the Nausea effect.
sprintPrevention	Boolean	true	true/false	Prevent sprinting when thirst is at or below the sprint threshold.
sprintThreshold	Integer	6	0 to 20	Thirst value at or below which sprinting is blocked (6 = 3 droplets).
dehydrationHaltsHealthRegen	Boolean	true	true/false	Prevent natural health regeneration while the thirst bar is not full.
suspendThirstEffects	List of Strings	["tombstone:ghostly_shape"]	'effect_id' or 'id op amp'	Effects that completely suspend all thirst mechanics (thirst frozen, immune to damage, sprinting not blocked).
pauseDepletionEffects	List of Strings	["farmersdelight:nourishment", ...]	'effect_id' or 'id op amp'	Effects that pause thirst depletion from movement/exhaustion.
regenThirstEffects	List of Strings	["farmersdelight:nourishment", ...]	'effect_id' or 'id op amp'	Effects that periodically restore thirst level.
regenThirstInterval	Integer	40	1 to 72000	Interval in ticks between thirst regeneration ticks when a regen effect is active.
regenThirstAmount	Integer	1	1 to 20	Amount of thirst restored per regeneration tick.

[effects]

Configuration Key	Type	Default	Range / Format	Description
hydrationEffectThirstPerTick	Integer	1	0 to 20	Base thirst restored by the Hydration effect each tick per effect level.
hydrationEffectQuenchedPerTick	Integer	1	0 to 20	Base quenched restored by the Hydration effect each tick per effect level.
thirstyEffectExhaustionPerTick	Double	0.005	0.0 to 4.0	Base thirst exhaustion added by the Thirsty effect each tick per effect level.

[compatibility]

Configuration Key	Type	Default	Options / Range	Description
appleSkinThirstTooltip	Boolean	true	true/false	Add YAT thirst and quenched values to item tooltips when AppleSkin is loaded.
appleSkinThirstHudPreview	Boolean	true	true/false	Preview held item thirst restoration on the thirst HUD when AppleSkin is loaded.
toughAsNailsMode	Enum	"AUTO_DISABLE_YAT"	OFF, AUTO_DISABLE_YAT, ITEMS_ONLY, FORCE_YAT	Tough As Nails handling mode (AUTO_DISABLE_YAT stops YAT when TAN is loaded).
coldSweatDehydrationModifier	Boolean	true	true/false	Use Cold Sweat body temperature to increase dehydration when hot.
coldSweatReplacesEnvironmentModifiers	Boolean	true	true/false	Replace YAT biome/Nether temperature modifiers with Cold Sweat body temperature.
coldSweatHotBodyTemperature	Double	50.0	-150.0 to 150.0	Cold Sweat body temperature where extra dehydration starts.
coldSweatBurningBodyTemperature	Double	100.0	-150.0 to 150.0	Cold Sweat body temperature where extra dehydration reaches the configured maximum.
coldSweatMaxDehydrationModifier	Double	1.75	1.0 to 10.0	Maximum dehydration multiplier applied at or above burning body temperature.
supernaturalVampireSuspendsThirst	Boolean	true	true/false	Suspend YAT thirst and hide HUD for Supernatural vampires.
vampirismVampireSuspendsThirst	Boolean	true	true/false	Suspend YAT thirst and hide HUD for Vampirism vampires.

[dehydration]

Configuration Key	Type	Default	Range	Description
dehydrationDamage	Double	1.0	0.0 to 100.0	Amount of damage dealt when dehydrated.
damageIntervalTicks	Integer	40	1 to 72000	Interval in ticks between dehydration damage ticks.
dehydrationDamageEasyLimit	Double	10.0	0.0 to 20.0	Minimum health remaining on Easy difficulty when taking dehydration damage.
dehydrationDamageNormalLimit	Double	0.0	0.0 to 20.0	Minimum health remaining on Normal difficulty when taking dehydration damage.
dehydrationDamageHardLimit	Double	0.0	0.0 to 20.0	Minimum health remaining on Hard difficulty when taking dehydration damage.

[depletion]

Configuration Key	Type	Default	Range	Description
thirstDepletionModifier	Double	1.2	0.0 to 10.0	Thirst depletion speed relative to hunger (1.0 = same speed).
netherThirstDepletionModifier	Double	3.0	1.0 to 10.0	Thirst depletion speed multiplier in ultra-warm dimensions (Nether).
fireResistanceDehydrationModifier	Double	0.0	0.0 to 1.0	Depletion speed multiplier when Fire Resistance is active (0.0 = no depletion).
biomeDehydrationModifier	Boolean	true	true/false	Use biome temperature and humidity to adjust thirst depletion outside ultra-warm dimensions.
fireProtectionDehydrationModifier	Boolean	true	true/false	Reduce thirst depletion based on armor Fire Protection enchantment levels.
environmentModifierHarshness	Double	0.5	0.0 to 1.0	How strongly cool or humid biomes reduce dehydration when biome modifiers are enabled.

[purity]

Configuration Key	Type	Default	Range	Description
defaultPurity	Integer	2	0 to 3	Default purity for water items lacking a tag (0=dirty, 1=slightly dirty, 2=acceptable, 3=purified).
quenchWhenDebuffed	Boolean	true	true/false	Grant hydration even if the player received a purity-related debuff.
dirtyNauseaChance	Double	1.0	0.0 to 1.0	Chance of getting Nausea+Hunger after drinking dirty water.
dirtyPoisonChance	Double	0.3	0.0 to 1.0	Chance of getting Poison after drinking dirty water.
slightlyDirtyNauseaChance	Double	0.5	0.0 to 1.0	Chance of Nausea+Hunger from slightly dirty water.
slightlyDirtyPoisonChance	Double	0.1	0.0 to 1.0	Chance of Poison from slightly dirty water.
acceptableNauseaChance	Double	0.05	0.0 to 1.0	Chance of Nausea+Hunger from acceptable water.
acceptablePoisonChance	Double	0.0	0.0 to 1.0	Chance of Poison from acceptable water.
purifiedNauseaChance	Double	0.0	0.0 to 1.0	Chance of Nausea+Hunger from purified water.
purifiedPoisonChance	Double	0.0	0.0 to 1.0	Chance of Poison from purified water.

[world]

Configuration Key	Type	Default	Range	Description
mountainsY	Integer	100	-64 to 320	Y-level above which water gains +1 purity (mountain spring water).
cavesY	Integer	48	-64 to 320	Y-level below which water gains +1 purity (cave spring water).
runningWaterPurificationAmount	Integer	1	0 to 3	Purity levels added to non-source running water.

[items]

Configuration Key	Type	Default	Format	Description
waterBottleStackSize	Integer	64	1 to 64	Maximum stack size for water bottles.
drinks	List of Lists	(Default vanilla/mod drinks)	[["id", thirst, quench]]	Items that restore thirst when drunk.
foods	List of Lists	(Default vanilla/mod foods)	[["id", thirst, quench]]	Items that restore thirst when eaten.
itemsBlacklist	List of Strings	["yet_another_thirst:example_item_1", ...]	["item_id", "#tag"]	Items excluded from thirst restoration.

[handDrinking]

Configuration Key	Type	Default	Range	Description
canDrinkByHand	Boolean	false	true/false	Allow players to drink by shift-right-clicking water with an empty hand.
handDrinkingThirst	Integer	3	0 to 20	Thirst restored when drinking by hand.
handDrinkingQuenched	Integer	2	0 to 20	Quenched bonus restored when drinking by hand.
drinkBothHandsNeeded	Boolean	false	true/false	Require both hands to be empty to drink by hand.