### ![Mermaids-Banner](https://media.forgecdn.net/attachments/description/1430860/description_ddc80697-2f7f-4ad4-b9da-df3bfa931a25.png) ### Ever wanted to be a Mermaid? Now you can with Mermaids, this mod allows the player to transform into a Mermaid when entering the water! Which will give the player increased movement speed, water breathing, night vision, and more while swimming underwater throughout the seas, oceans, and rivers. This is Curseforge v2.4.3 description. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Features: After entering the water for a couple seconds, you'll turn into a mermaid. Once you enter the land, your legs will regenerate (Can be modified). * Grow a Mermaid Tail and keep your cosmetics. * Breathe underwater with increased swim speed. * Custom Mermaid NPCs that spawn in the ocean. * Mod fully customizable with permissions and config. * Configurable transformation option -- Example: Transform only by potions and/or enable for all. * Custom model, cosmetics, and animations, WIP. * Compatibility support with 9+ mods. Including a custom Mermaids mod API. * Compatibility with Endless Leveling as an addon that adds the mermaid race with variations. * Compatibility with Orbis Origins as an extension that adds the mermaid species. * Works in Multiplayer and Singleplayer. * and More! ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Roadmap: * Particles when you transform into a Mermaid. * More Mermaid related sea life and/or underwater things. * More Mermaid cosmetic armor. * More Mermaid cosmetics. * Mermaid on land animations. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Commands, Config, and Permissions: ### Commands Extra Info:

/mermaids ui
- Will open a UI where you can select mermaid tail model and color.
- May require permission: mermaids.ui
/mermaids info
- Get information on the Mermaids mod installed on the server.
/mermaids toggle true|false
- You can enable or disable Mermaid transformations.
- Requires permission: mermaids.toggle
/mermaids air
- Allows a player as a Mermaid to share air with nearby players.
/mermaids permpotionremove
- Will remove the permanent potion transformation from the player.
/mermaids bug
- /mermaids bug log
  - Get an information log about possible bug issues that could occur with the Mermaids mod.
- /mermaids bug compfix
  - Command to make sure the player has all of the Mermaids mod components.
- /mermaids bug report [Strings]
  - Command to report any bugs directly to the Mermaids developers Discord server.
/mermaids debug
- Requires permission: mermaids.debug
- /mermaids debug givemermaidring
  - Give the player a testing item called the Mermaid Ring.
  - Requires permission: mermaids.debug.mermaidring
/mermaids admin
- Requires permission: mermaids.admin
- /mermaids admin transformmode {New Mode Integer}
  - Update the transformation mode with 0 to allow transforming when entering water and 1 to only allow transformation from drinking a potion..
  - Requires permission: mermaids.admin.mode
- /mermaids admin mermaidonland true|false
  - Toggle mermaid on land for all players.
  - Requires permission: mermaids.admin.mermaidonland
- /mermaids admin landspeeddebuff true|false
  - Toggle if the player will have a speed debuff as a mermaid on land.
  - Requires permission: mermaids.admin.mermaidonland
- /mermaids admin itemspeed true|false
  - Toggles to allow some items to increase the swim movement speed.
  - Requires permission: mermaids.admin.itemspeed
- /mermaids admin blockstransformation true|false
  - Toggle to allow some blocks to transform players into a mermaid.
  - Requires permission: mermaids.admin.blocktransform
- /mermaids admin blockstransformation true|false
  - Toggle to allow some blocks to transform players into a mermaid.
  - Requires permission: mermaids.admin.blocktransform
- /mermaids admin raintransformation true|false
  - Toggle to allow rain to transform players into a mermaid.
  - Requires permission: mermaids.admin.raintransform
- /mermaids admin mermaidglow true|false
  - Toggle to have the mermaid model glow.
  - Requires permission: mermaids.admin.mermaidglow
- /mermaids admin mermaidglowradius {New Radius Integer}
  - Set the radius of the mermaid glow.
  - Requires permission: mermaids.admin.mermaidglow
- /mermaids admin orbisorigins
  - Requires permission: mermaids.admin.orbisorigins
  - /mermaids admin orbisorigins mermaidscontent [true/false]
    - Toggle to allow regular Mermaids content. If false, you can only transform into a Mermaid as a mermaid species.
    - Requires permission: mermaids.admin.orbisorigins.mermaidscontent
  - /mermaids admin orbisorigins onlyinwater[true/false]
    - As a mermaid species, you will only have a Mermaid tail while in water.
    - Requires permission: mermaids.admin.orbisorigins.onlyinwater
- /mermaids admin endlessleveling
  - Requires permission: mermaids.admin.endlessleveling
  - /mermaids admin endlesslevelingmermaidscontent [true/false]
    - Toggle to allow regular Mermaids content. If false, you can only transform into a Mermaid as a mermaid race.
    - Requires permission: mermaids.admin.endlessleveling.mermaidscontent
  - /mermaids admin endlesslevelingonlyinwater[true/false]
    - As a mermaid race, you will only have a Mermaid tail while in water.
    - Requires permission: mermaids.admin.endlessleveling.onlyinwater

### Permissions Extra Info:

mermaids.transform
- Allows the player to mermaid transform when this option is enabled in config.
mermaids.ui
- Run /mermaids ui command.
mermaids.toggle
- Run /mermaids toggle (boolean) command.
mermaids.debug
- Access to the /mermaids debug commands.
mermaids.debug.mermaidv2
- Access to use /mermaids debug mermaidv2 true|false, which allows the user to try out the Mermaid Tail Model v2.
mermaids.admin
- Access to the /mermaids admin commands.
mermaids.admin.mode
- Access to use /mermaids admin transformmode {New Mode Integer}, which updates the transformation mode.
mermaids.admin.mermaidonland
- Access to use /mermaids admin mermaidonland true|false, which toggles mermaid on land for all players.
- Access to use /mermaids admin landspeeddebuff true|false, which toggles if the player will have a speed debuff as a mermaid.
mermaids.admin.itemspeed
- Access to use /mermaids admin itemspeed [true/false], which toggles to allow some items to give increased swim speed.
mermaids.admin.blocktransform
- Access to use /mermaids admin blocktransformation true|false, which toggles to allow some blocks to transform players into a mermaid.
mermaids.admin.raintransform
- Access to use /mermaids admin raintransformation true|false, which toggles to allow rain to transform players into a mermaid.
mermaids.admin.mermaidglow
- Access to use /mermaids admin mermaidglow true|false, which toggles the mermaid model glow.
- Access to use /mermaids admin mermaidglowraduis {int}, that sets the radius of the mermaid glow.
mermaids.admin.orbisorigins
- Access to the /mermaids admin orbisorigins command line.
mermaids.admin.orbisorigins.mermaidscontent
- Access to the /mermaids admin orbisorigins mermaidscontent [true/false], which toggles to allow regular Mermaids content.
mermaids.admin.orbisorigins.onlyinwater
- Access to the /mermaids admin orbisorigins onlyinwater [true/false], which as a mermaid species, you will only have a Mermaid tail while in water.
mermaids.admin.endlessleveling
- Access to the /mermaids admin endlessleveling command line.
mermaids.admin.endlessleveling.mermaidscontent
- Access to the /mermaids admin endlessleveling mermaidscontent [true/false], which toggles to allow regular Mermaids content.
mermaids.admin.endlessleveling.onlyinwater
- Access to the /mermaids admin endlessleveling onlyinwater [true/false], which as a mermaid race, you will only have a Mermaid tail while in waterr.

### Config Extra Info:

This is the default config values and descriptions for config version 14:

If you want to view the compatibility configs, check out my official config wiki.

"Config-Information"
- Default Value: "Confused about what one of these statement do? Check out the Mermaids page on the Curseforge website and scroll down to Config Extra Info."
"ConfigVersion"
- Default Value: 14
- Description: Config Version when you first load the plugin.
"PluginName"
- Default Value: "Mermaids"
- Description: Plugin name.
"Version"
- Default Value: "2.4.3"
- Description: Plugin Verison when you first load the plugin.
"Website"
- Default Value: “https://mermaids.dev/mermaids/”
- Description: Official website for the Mermaids mod.
"Download-Site"
- Default Value: "https://www.curseforge.com/hytale/mods/mermaids"
- Description: A link to the plugin's download page and informatiton.
"Enable-Generic-Console-Logs"
- Default Value: false
- Description: Send console logs for majority of mermaid actions: transforming and modifying settings.
"Transformation-Mode"
- Default Value: 0
- Description: TransformationMode = 0 : Transform when entering water, TransformationMode = 1 : Requires user to drink Mermaid Potion to Transform.
"Description-Transformation-Mode"
- Default Value: A long string that tells you about the description for Transformation-Mode.
- Description: A description of the Transformation-Mode config option.
"Always-A-Mermaid-Even-On-Land"
- Default Value: false
- If you have permissions to be a Mermaid, than you'll always be transformed into a Mermaid even on land.
"Mermaid-On-Land-Speed-Debuff"
- Default Value: true
- If the player is transformed as a Mermaid, they will have a speed debuff while on land.
"Require-Transformation-Permission"
- Default Value: false
- Description: Requires the player to have the permission -- mermaids.transform -- to transform into a Mermaid.
"Require-Mermaids-UI-Permission"
- Default Value: false
- Description: Requires the player to have the permission -- mermaids.ui -- to run the command /mermaids ui.
“Items-Can-Increase-Swim-Speed”
- Default Value: true
- Description: Some items like fishbone harpoon and some modded related items will give you increased swim speed as a mermaid.
"Blocks-Can-Cause-Transformations"
- Default Value: true
- Description: Some blocks like mud and a cauldron will cause you to transform into a mermaid.
"Rain-Can-Cause-Transformations"
- Default Value: false
- Description: Walking into the rain will cause you to transform.
"Mermaid-Have-A-Glow/Light"
- Default Value: true
- Description: The mermaid model will light of a glow allowing the player to see better underwater.
"Mermaid-Glow/Light-Radius"
- Default Value: 33
- Description: The radius of the mermaid glow.
"EasyHunger-By:Haasapenas-Compatibility"
- Default Value: true
- Description: Compatibility with the EasyHunger Mod.
"AquaThirst&Hunger-By:Jume-Compatibility"
- Default Value: true
- Description: Compatibility with the Aqua Thirst & Hunger Mod.
"DivingTale-By:xnrdev-Compatibility"
- Default Value: true
- Description: Compatibility with the [xnrdev] DivingTale Mod.
"MoreNPC-By:BlueEyesWhiteMen-Compatibility"
- Default Value: true
- Description: Compatibility with the MoreNPC Mod.
"KeybladesReimagined-By:TaHie-Compatibility"
- Default Value: true
- Description: Compatibility with the Keyblades Reimagined Mod.
"New-Version-Message"
- Default Value: true
- Description: When Mermaids mod version is outdated, send a message to OPed players when they join.
"DebugMode"
- Default Value: false
- Run the plugin in debug mode to get alerts about most actions of the plugin.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## HOW TO INSTALL: ### Client: Upload the Mermaids.jar file into your %appdata%\Hytale\UserData\Mods\ Folder ### Server: Upload the Mermaids.jar file into your servers mods\ folder Make sure you delete any previous version of Mermaids otherwise your world may not start. Mermaids-Mermaid_showoff

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## MOD COMPATIBILITY: A list of all compatible mods with my Mermaids mod can be found here. How to enable the Endless Leveling Compatibility Addon information can be found here. How to enable the Orbis Origins Compatibility expansion can be found here. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## VERSION COMPATIBILITY: v2.0.0-latest : Designed: 2026.03.26-89796e57b - Active support for continued versions until specified. v1.3.6-v1.4.3 : Designed: 2026.02.17-255364b8e v1.3.0-v1.3.5 : Designed: 2026.01.27-734d39026 v1.0.0-v1.2.7 : Designed: 2026.01.13-dcad8778f - Supported Until: 2026.01.24-6e2d4fc36 ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Known Bugs: * Weird HUE/color on the Mermaid tail when transformed. * You keep your tail for a small amount of time once you go on land. * Animations are weird when you hit a block or when you're above water. ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== ## Support the Creator of Mermaids: You can support me by using my creator code SIREN at checkout. Support Mermaids by using creator code SIREN image.

Support Mermaids by using creator code SIREN image.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--=== [ Modifold Mermaids Mod with History

](https://api.modifold.com/analytics/mermaids/embed?theme=dark) ===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Mermaids for Server Owners

Mermaids for Server Owners