Config

This page covers every config file the Mermaids mod generates, updated for Mermaids Update Version 4.0.0. Every file lives under mods/Siren_Mermaids/ and each one carries its own ConfigVersion, which increases automatically whenever that file’s layout changes – your existing settings are migrated for you, and new options are appended with their defaults. You never need to edit ConfigVersion by hand.

New in 4.0.0: a Lamia Config for the new Lamia creature, "Enable-Lamia-Transformation" in the Default Config, and a Store Config for the Octopus, Manta and Seahorse tails sold at the store.

The long Description-* and *-Information strings in each file are written by the mod and reset to the current text whenever it loads, so editing them has no lasting effect. They are listed below as “a long string” for completeness.

In-Game Server Configuration Menu

Everything on this page can be edited from inside the game, without opening a file or restarting the server.

Open the Mythical Creatures menu with /mc and pick Server Settings. The card only appears for players holding the mermaids.admin.config permission.

• Changes are pending until you press Save. The menu shows a running count of unsaved changes, and a Revert button discards them.
• Settings are grouped into sections: Mermaid, Drying Out, Appearance, Siren Song, Creatures, Werewolf, Silver Weakness, Werewolf Howl, Vampire, Lamia, Sunlight and Blood, Blood Drain, Zones, Hunger Mods and Store Tails.
• Compatibility sections for Cultivation, Endless Leveling and Orbis Origins only appear when that mod is actually installed.
• Each row’s caption shows the exact config key it edits, and saving writes straight to the same JSON files documented below, so the two ways of configuring the mod never disagree.

The files remain fully supported – edit them directly if you prefer, then run /mermaids admin reload. A file with a typo in it is skipped with a warning rather than reset, so a mistake never wipes your settings.

Default Config

This is the default config values and descriptions for the Default Config, config version 1, found in the path mods/Siren_Mermaids/Config.json. This file controls settings that are shared across every Mythical Creature.

Mermaids Config

This is the default config values and descriptions for the Mermaids Config, config version 22, found in the path mods/Siren_Mermaids/MermaidsConfig.json. This file only controls Mermaid-specific settings.

Older installs will have this data inside Config.json instead – the mod automatically copies it over to MermaidsConfig.json the first time you launch Update Version 3 or newer.

Siren Song

/mermaids song (permission mermaids.song) is a transformed mermaid’s active ability: one burst that holds hostile creatures where they stand, gives every player nearby a regeneration buff, and draws sea life that is in the water in toward the singer – never through walls. Its cooldown survives a relog or a toggle. With the Cultivation mod installed, Merfolk perform it as a cultivation technique instead, and the command steps aside.

Drying Out

Off by default – turning it on changes how a mermaid server plays, so it is opt-in.

With "Enable-Drying-Out" set to true, a mermaid standing on land slowly dries out. A meter appears above the hotbar and drains like the vanilla breath bar; once it empties, the player takes Drying-Out-Damage every Drying-Out-Damage-Interval-Seconds under the mod’s own Mermaids_DryingOut damage cause. This can kill. Any contact with water refills the meter, and the HUD disappears once the player is safe again. Dying refills it too, and toggling the transformation off and on does not.

Rebalanced in 3.2.0. The damage default dropped from 10 every 1 second to 4 every 3 seconds. The old rate could kill a full-health player in about ten seconds, which was often faster than the trip to the nearest lake – drying out is meant to push a mermaid back toward water, not execute them.

Your existing values decide what happens on update. If your Drying-Out-Damage and Drying-Out-Damage-Interval-Seconds are still sitting at the old defaults of 10 and 1, they are retuned to 4 and 3 for you. If you changed either one, your number is kept exactly as it is – a server that deliberately tuned this keeps its balance.

What does not dry you out:

• Rain. Standing in a downpour counts as being wet and keeps the meter full. This applies even when "Rain-Can-Cause-Transformations" is false – rain not transforming you on this server does not mean rain fails to wet you.
• Creative mode. Creative players are exempt entirely; the meter and HUD switch off. Switching to creative resets the meter rather than pausing it, so coming back to survival starts you from full instead of resuming a stale drain that could kill instantly.

A few things worth knowing before enabling it:

• Drying-Out-Only-While-Transformed is false for a reason. Mermaids revert to their human model moments after leaving water, so setting this to true means the meter almost never gets the chance to drain – unless you also run "Always-A-Mermaid-Even-On-Land". Leave it false unless you know you want the narrower behavior.
• Keep Drying-Out-Seconds-To-Empty above ~17 seconds. That is roughly how long vanilla drowning takes to empty, and drying out is meant to be the slower, more forgiving of the two.
• Set Drying-Out-Damage to 0 if you want the meter purely as flavor. The bar and HUD still work, they just never hurt anyone.

Werewolf Config

See the Werewolf page for more info. This is the default config values and descriptions for the Werewolf Config, config version 4, found in the path mods/Siren_Mermaids/WerewolfConfig.json.

Silver Weakness

Off by default, and the item list starts empty, so nothing happens until an admin both turns it on and lists which items count as silver. Once set up, damage from an attacker holding one of those items is multiplied by Silver-Damage-Multiplier. It matches the Mermaid’s drying out and the Vampire’s sunlight: a weakness each creature can be given, never one forced on a server by an update.

Werewolf Howl

/mc werewolf howl (permission mermaids.werewolf.howl) is a transformed werewolf’s active ability: one cry that gives every werewolf nearby – the howler included – a timed regeneration buff, and slows anything hostile to the howler for a few seconds. Its cooldown survives a relog or a toggle.

Vampire Config

See the Vampire page for more info. This is the default config values and descriptions for the Vampire Config, config version 3, found in the path mods/Siren_Mermaids/VampireConfig.json.

Sunlight and Blood

Off by default – it is a survival mechanic, and a server should only see it if it deliberately turns it on. With it on, a transformed Vampire standing in enough daylight takes Sunlight-Damage every Sunlight-Damage-Interval-Seconds, but never below Sunlight-Minimum-Health: the sun drives them indoors rather than killing them. Their Blood meter drains on its own over Blood-Seconds-To-Empty and refills from the damage they deal to living things. While a Vampire has Blood it slowly regenerates health; once starved, the sun burns harder.

Blood Drain

/mc vampire drain (permission mermaids.vampire.drain) opens a timed window on a cooldown: while it is open, a share of every point of melee damage the Vampire deals comes back as health. It works whether or not Sunlight and Blood is on, and its cooldown survives a relog or a toggle.

Lamia Config

New in 4.0.0, see the Lamia page for more info. This is the default config values and descriptions for the Lamia Config, config version 1, found in the path mods/Siren_Mermaids/LamiaConfig.json.

A deliberately thin file: a Lamia has exactly one mode – chosen in the menu, on land and in water – so there is no Transformation-Mode here. Turning the creature off for the whole server is "Enable-Lamia-Transformation" in the Default Config.

Store Config

New in 4.0.0. This is the default config values and descriptions for the Store Config, config version 1, found in the path mods/Siren_Mermaids/StoreConfig.json.

It controls the Octopus, Manta and Seahorse tails – cosmetic tails a player buys once, bound to their Hytale account, and usable on any server running Mermaids 4.0.0. The server learns who owns one by reading a public list of buyers’ player ids, one file per tail. Each check is a plain download; nothing about your server is sent. The last lists are kept in Data/StoreCache.json, so purchases still apply if the store cannot be reached.

Mermaid Zones and Whitelist Config

This is the default config values and descriptions for the Mermaid Zones and Whitelist Config, config version 1, found in the path mods/Siren_Mermaids/WhitelistZonesConfig.json.

Mermaids Orbis Origins Config

This is the default config values and descriptions for the Mermaids Orbis Origins config, config version 1, found in the path mods/Siren_Mermaids/Compatibility/OrbisOrigins.json.

Mermaids Endless Leveling Config

This is the default config values and descriptions for the Mermaids Endless Leveling config, config version 5, found in the path mods/Siren_Mermaids/Compatibility/EndlessLeveling.json.

Endless Leveling Race Files

Without Mermaids Premium installed, the mod registers its own nine-race Mermaid line into Endless Leveling, and writes each race’s definition to its own file under mods/Siren_Mermaids/Compatibility/EndlessLevelingRaces/ (mermaid.json, mermaid_princess.json, mermaid_crown_princess.json, mermaid_tidebreaker.json, mermaid_abyssal.json, mermaid_tideweaver.json, mermaid_moonbinder.json, mermaid_queen.json and mermaid_empress.json). Each holds that race’s display name, description, base attributes, passives and ascension requirements, and can be tuned like any Endless Leveling race file.

Each file carries a Race-Version. When the mod ships a new version of the races, every field is reset to the new defaults – and the file you had is first copied into a .old folder beside it, so your edits can be carried over by hand.

With Premium installed, Premium’s own race lines are used instead and these files are not.

Mermaids Cultivation Config

See the Cultivation Addon page for more info. This is the default config values and descriptions for the Mermaids Cultivation config, config version 2, found in the path mods/Siren_Mermaids/Compatibility/Cultivation.json.

Requires the Cultivation mod, version 0.9.1 or newer. Without it this file is still generated, but nothing in it does anything.

Cultivation Merfolk Race Config

See the Cultivation Addon page for more info. This is the default config values and descriptions for the Merfolk race the Mermaids mod registers into Cultivation, config version 1, found in the path mods/Siren_Mermaids/Compatibility/CultivationRaces/merfolk.json.

These are the same stat knobs Cultivation’s own Race/*.json files use, so a Merfolk cultivator can be balanced against the mod’s built-in races directly.