Moon Pool Mermaids

Ever wanted to find a hidden pool on a tropical island, wait for the full moon, and wake up a mermaid? Now you can with Moon Pool Mermaids, a free fan mod inspired by H2O: Just Add Water and Mako: Island of Secrets. Somewhere out at sea lies the Moon Pool, a secret grotto with a pool open to the sky. Stand in its water on a full-moon night and the moon gives you a locket that answers to you alone. Carry it, and ten seconds after water touches you -- the sea, a pool, even the rain -- you have a tail. You stay a mermaid until you are completely dry again.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Features:

One secret, one locket, one tail: everything you need to live the show in Hytale.

• The Moon Pool: a hidden grotto that generates naturally on tropical islands, with a pool open to the sky, a hidden way in, glowing crystals, and an underwater tunnel a mermaid can swim straight in through.
• The full-moon ritual: stand in the Moon Pool's water while the full moon is high and the moonlight pours down the shaft and gives you a locket.
• Three lockets: a silver locket with a blue, clear, or red stone, chosen by the moon. Each one is bound to the player who received it, so nobody else can use yours.
• The ten-second countdown: any touch of water -- swimming, wading, or rain and snow under the open sky -- starts the countdown, with a shimmer and a sound, just like the show.
• Two tails to choose from: the bronze-orange Mermaid tail with its broad crescent fluke and matching scale top, or the blue Merman tail with a pointed fluke. Switch any time with /moonpool tail.
• Life as a mermaid: a swim boost in the water and you never run out of breath. A full set of swim and land animations.
• Beached on land: out of the water you stay a mermaid -- slower, with lower jumps -- until you dry off. Sunshine and heat (lava, fire, a burning campfire) dry you faster.
• Wear your locket: carry your own locket and you wear it at your throat, over your clothes, in your stone's color. It tucks away under chest armor.
• Lost your locket? Return to a Moon Pool at the next full moon for a new one with the same stone. Every older copy goes dark.
• Every timing is configurable: the countdown, drying off, the ritual window, how rare the Moon Pools are, and more.
• Works on its own. Plays nicely next to Mermaids and Mythical Creatures.
• Free, now and always. No paid content.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

How It Works:

🏝️ The Moon Pool

Moon Pools hide on the shallow shelves of tropical islands, about one tropical island in four, and never more than one per island. A typical world has around seven within 20 km of spawn, the nearest usually 3 to 9 km out -- so pack for a sea voyage. From the outside it just looks like a rocky island. Find the way in, and you'll come out beside a pool of water under an opening to the night sky, lit by glowing crystals. Mermaids can skip the climb and swim straight in through the underwater tunnel.

🌕 The Full Moon

The moon in Hytale runs through its phases over five in-game days, so a full moon comes every fifth night. The ritual only works while the full moon is high, from 9 PM to 3 AM in-game (about twelve real minutes). Stand in the pool's water, and after a few seconds of moonlight a locket appears in your inventory. Players without a locket are told in chat when a full moon is coming. One claim per player per full moon.

🧜 The Transformation

Carry your own locket anywhere in your inventory, and the moment water touches you the countdown starts. Ten seconds later you have your tail -- even if you've already stepped back onto land, as long as you're still wet. In the water you get a swim boost and never run out of breath. On land you're beached, moving slower until you're completely dry again: about thirty seconds in shade or at night, quicker in the sun or next to a fire. Chest and leg armor are hidden while you have a tail, so your scale top and locket show (purely visual: the armor still protects you).

🐚 Mermaid or Merman

Pick your tail freely and change it whenever you like with /moonpool tail mermaid or /moonpool tail merman. The Mermaid tail is bronze-orange with a broad crescent fluke and a matching scale top. The Merman tail is blue deepening to navy with a pointed fluke and no scale top. It keeps your own underwear top unless you say otherwise with /moonpool tail top off.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Commands, Config, and Permissions:

Commands:

• /moonpool info -- what the mod is, your tail, your merman top, and whether your locket shows in human form.
• /moonpool tail, /moonpool tail mermaid, /moonpool tail merman -- list the tails, or choose yours. Applies at your next transformation.
• /moonpool tail top, /moonpool tail top on, /moonpool tail top off -- keep or take off your underwear top with the merman tail. Applies at once, even mid-swim.
• /moonpool locket give blue|clear|red|random <player> (admin) -- give a player a locket bound to them.
• /moonpool locket inspect <player> (admin) -- show a player's locket bond: lockets given, their stone, their last claim.
• /moonpool locket reset <player> (admin) -- make every copy of a player's locket go dark. They can claim a new one at the next full moon.
• /moonpool moon status (admin) -- the moon phase, the game time, and when the next ritual night is.
• /moonpool pool list, /moonpool pool nearest (admin) -- the Moon Pools discovered in this world, or the one nearest you. A pool is recorded the first time its area loads.

Permissions:

• moonpool, moonpool.info, moonpool.tail -- the player commands. Every player has these by default.
• moonpool.admin.locket -- moonpool.admin.locket.give, moonpool.admin.locket.inspect, moonpool.admin.locket.reset.
• moonpool.admin.moon -- moonpool.admin.moon.status.
• moonpool.admin.pool -- moonpool.admin.pool.list, moonpool.admin.pool.nearest.
• Admin nodes are never given to players by default.

Config:

Moon Pool Mermaids keeps its settings in four files in the mod's data folder. Every setting carries its own description in the file.

• Config.json -- debug logging.
• Transform.json -- the transformation: on or off, the countdown (10 seconds), drying off (30 seconds), how much sun and heat speed it up, which weathers count as wet, swim and beached speeds, hiding chest armor, whether creative-mode players transform, showing the countdown, and the locket in human form.
• Locket.json -- the ritual: on or off, which moon phase counts as full, the ritual window (9 PM to 3 AM), how long the moonlight takes, reclaiming lost lockets, full-moon announcements, and the shortest real time between two claims (60 minutes).
• Pool.json -- generation: on or off, how rare Moon Pools are (a bigger CellSizeBlocks is rarer), which biomes they appear in, and the sea-floor depth range. Changes only affect terrain generated afterwards.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

HOW TO INSTALL:

Client:

Upload the MoonPoolMermaids.jar file into your %appdata%\Hytale\UserData\Mods\ Folder

Server:

Upload the MoonPoolMermaids.jar file into your servers mods\ folder

Make sure you delete any previous version of Moon Pool Mermaids otherwise your world may not start.

Moon Pools only generate in new terrain. On an existing world, sail past the edge of what you've already explored to find one -- or start a new world.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

MOD COMPATIBILITY:

Moon Pool Mermaids needs no other mod. It can run next to my Mermaids and Mythical Creatures mod: when both are installed, any player Mermaids can transform is left to Mermaids, and the locket does nothing for them.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

VERSION COMPATIBILITY:

v1.0.0-latest : Designed for Hytale Update 7 (Server 0.7.2 and later 0.7.x).

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Known Limitations:

• Moon Pools only appear in terrain generated after the mod is installed.
• The vanilla /locate prefab command also lists spots where a Moon Pool was considered but never built. /moonpool pool nearest only shows real ones.
• With Mermaids and Mythical Creatures installed, Mermaids takes priority for any player it can transform.
• English only for now.
• Found a bug? Please report it so it can get fixed.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Credits and Disclaimer:

Moon Pool Mermaids is a free fan work: never sold, never paywalled. H2O: Just Add Water and Mako: Island of Secrets belong to Jonathan M. Shiff Productions and their other rights holders, who do not endorse or sponsor this project. Every model, texture, and line of text in the mod is original.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Support the Creator:

You can support me by using my creator code SIREN at checkout.

Want more mythical creatures? Check out my Mermaids and Mythical Creatures mod.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===