Config · mermaids.dev

Up to date for v1.0.0, from the mod’s own config files.

Four files are written into the mod’s data folder (mods/Siren_MoonPoolMermaids/) on first boot, each holding every setting at its default. Every setting also carries its own -Description line in the file. Times are real seconds unless a setting says game hours.

File	Controls
Config.json	Debug logging.
Transform.json	The water transformation, drying off, and the locket in human form.
Locket.json	The lockets and the full-moon ritual.
Pool.json	Where and how often Moon Pools generate.

Config.json

Setting	Default	What it does
`Debug`	`false`	Logs extra detail about transformations, lockets and the ritual to the server log.

Transform.json

Setting	Default	What it does
`Enabled`	`true`	Master switch. Turning it off changes every mermaid back on the next check and starts no new countdown.
`CountdownSeconds`	`10.0`	Seconds from the first touch of water to the tail, as in the show. The countdown keeps going on land; you only need to still be wet when it ends. 0 to 60.
`DryOffSeconds`	`30.0`	Seconds out of water and rain, in shade or at night, until a mermaid is dry and has legs again. 1 to 600.
`SunDryBonus`	`1.0`	How much faster full sunlight dries a mermaid: the drying rate is 1 + this x the sun on them. 1.0 halves the time in full sun; 0 turns it off. 0 to 10.
`HeatDryBonus`	`2.0`	How much faster a mermaid dries within `HeatRadius` of lava, fire or a burning campfire (added to the drying rate). 0 turns it off. 0 to 10.
`HeatRadius`	`2`	How close, in blocks, the heat must be. 0 turns heat off. 0 to 4.
`WetWeatherIds`	16 rain and snow weathers	Weather ids that make a player wet when nothing is above them. Sand and ash storms are not listed. Unknown ids are logged once at startup and ignored. Read at startup.
`SampleIntervalSeconds`	`0.5`	How often each player is checked for water and rain. 0.2 to 2.
`SwimSpeedMultiplier`	`1.0`	Scales a mermaid’s swim boost (swim speed, sprint and the jump out of water). 0.25 to 4.
`BeachedSlowdown`	`true`	Whether a mermaid on land is slowed and jumps lower until they dry off.
`BeachedSpeedMultiplier`	`1.0`	Scales the beached movement (higher is less slow). 0.25 to 4.
`HideChestArmor`	`true`	Hide chest armor while a player has a tail, so the scale top and the locket show. Leg armor is always hidden. Purely visual: the armor still protects.
`CreativeTransforms`	`false`	Whether players in creative mode transform. Switching to creative while transformed changes a player back.
`ShowCountdown`	`true`	Show the countdown seconds on screen. The sounds and the shimmer play either way.
`ShowLocketInHumanForm`	`true`	Draw the worn locket over the clothes of human-form players who carry their own locket. `false` keeps everyone on the vanilla model. Independent of `Enabled`. Read at startup and on a plugin reload.
`HumanLocketHidesWithAnyArmor`	`false`	A fallback: `true` hides the human-form locket while any armor piece shows, not just chest armor.

Locket.json

Setting	Default	What it does
`RitualEnabled`	`true`	Whether a Moon Pool gives lockets at the full moon. Turning it off leaves existing lockets working; admins can still give them.
`FullMoonPhase`	`0`	Which moon phase counts as full, numbered from 0 (0 is the full moon in vanilla; `/time` shows the phase counted from 1).
`RitualWindowStartHour`	`21.0`	The game hour the full moon is high enough to reach the pool.
`RitualWindowEndHour`	`3.0`	The game hour the window closes. It may wrap past midnight: 21 to 3 is about twelve real minutes at vanilla speed.
`RitualCheckIntervalSeconds`	`1.0`	How often the mod checks who is standing in a Moon Pool. 0.25 to 10. Read at startup.
`SequenceSeconds`	`4.0`	How long the moonlight shines on a player in the pool before the locket appears. Leaving the water cancels it. 1 to 30.
`ReclaimEnabled`	`true`	Whether a player who lost their locket may come back at a later full moon for a new one with the same stone. The new locket makes every older copy go dark.
`AnnounceFullMoon`	`true`	Tell players without a locket in chat when a full moon is coming tonight, and when it is high.
`MinRealMinutesBetweenClaims`	`60`	The shortest real time between two claims by the same player, across every world (each world keeps its own moon). 0 turns the limit off.
`HintCooldownSeconds`	`60`	The shortest time between two hints the pool gives one player.

Pool.json

Changes apply after a server restart, and only to terrain generated after it. Existing chunks never change, and turning generation off never removes a pool that exists.

Setting	Default	What it does
`Generation.Enabled`	`true`	Whether Moon Pools generate in new terrain.
`Generation.CellSizeBlocks`	`96`	The world is split into square cells this wide, with at most one candidate per cell. Bigger is rarer: at 96 a typical world has about 7 Moon Pools within 20 km of spawn, at 192 about a quarter as many. 96 to 6000.
`Generation.CellChance`	`1.0`	The chance (0 to 1) that a cell gets a candidate at all.
`Generation.Biomes`	`Zones.Oceans.Custom.Island_Tropical`	World-gen biome files a Moon Pool may generate in, as dotted paths with `*` wildcards. Only biomes that already place prefabs can be used.
`Generation.SeabedMinY`	`105`	The lowest sea floor a Moon Pool’s island may stand on.
`Generation.SeabedMaxY`	`109`	The highest. Sea level is 114, so the default puts the island in 5 to 9 blocks of water.

A candidate becomes a Moon Pool only where it lands in one of the Biomes, in sea water whose floor is between SeabedMinY and SeabedMaxY, and at least 256 blocks from any other Moon Pool.