Kadajah's Water Map

Dynamic Liquids, Realistic Physics & Weather Integration.

Kadajah’s Water Map transforms the static, lifeless water tiles of RPG Maker MZ into beautiful, fluid, and interactive liquid surfaces. Utilizing PixiJS filters and noise textures, this plugin renders realistic water distortions, customizable waves, and particle-based weather interactions.

This is not just an animated tile overlay. This is a complete liquid engine that allows you to define different types of water, from calm swimming pools to turbulent swamps, using simple Region IDs. It includes a physics-based "Wet Floor" system for puddles and a global rain engine that physically interacts with your water layers.

Version 5.1 Update: Includes fixes for the "Falsy Zero" padding bug and optimized Object Pooling for maximum performance.

Features: The Water Engine

1. Deep Water Layers (Customizable Liquids)

Create distinct bodies of water by configuring "Water Presets" and painting them onto the map with Region IDs.

• Visual Customization: Control color, opacity, texture opacity, and noise scale. You can import your own noise images to change the "flow" pattern.
• Smart Geometry: The plugin automatically connects adjacent water tiles.
• Dynamic Edges:
  • Padding: Shrink the water texture away from the tile grid edges to create depth or a "filled container" look.
  • Sine-Wave Distortion: Configure wave height and length independently for Top, Bottom, Left, and Right edges.
  • Foam: Add colored outlines to simulate foam at the water's edge.
• Motion: Set X/Y speed for flow direction and "Turbulence" power for the internal displacement distortion.

2. Wet Floor System (Shallow Water)

Define regions where the ground is wet but not deep (like rain-slicked streets or dungeon sewers).

• Interactive Footsteps: When players or events walk on these regions, the system generates splash particles and ground ripples.
• Physics Settings: Customize gravity, splash count, particle size, and ripple scale to differentiate between a light dampness and a deep puddle.

3. Integrated Global Rain

A dynamic weather system that communicates directly with your water layers.

• Map Tags: Activate rain simply by adding tags to your Map Notes:
  • <wrain>: Standard Rain.
  • <wrain: 0.5>: Light Drizzle.
  • <wrain: 5.0>: Heavy Storm.
• Physical Interaction: Unlike standard weather overlays, this rain creates ripples when raindrops hit your defined Deep Water layers. You can configure the splash intensity, spread, and batch size per water type (e.g., rain creates huge ripples in a swamp, but tiny ones in a pool).

4. Event Buoyancy & Interaction

Make your map entities react to the liquid.

• Floating Physics: Add the <wfloat> tag to any Event's Note box. The event will automatically bob up and down with sine-wave motion and rotate slightly to simulate buoyancy.
• Wake Ripples: Moving events in water automatically generate wake ripples based on the water preset's frequency and speed settings.

Performance & Configuration

Kadajah's Water Map Crystal is built for efficiency.

• Object Pooling: The system recycles ripple and splash sprites rather than creating/destroying them, ensuring that even heavy storms or sprinting characters do not cause Garbage Collection lag spikes.
• Hybrid Filtering: Displacement filters are applied intelligently to the water body and dynamic edges, while keeping static geometry sharp.

How to Use

Setting up Water:

1. Open the Plugin Parameters and edit "Water Presets".
2. Define a style (e.g., "Lava", "River") and assign it a Region ID (e.g., 1).
3. Paint Region 1 on your map.

Setting up Wet Floors:

1. Add Region IDs to the "Wet Floor Regions" list (e.g., 10).
2. Paint Region 10 over normal ground tiles.
3. Walk on them to see the splash effects.

Map & Event Note Tags:

• <wrain: X> : Put in Map Notes to start rain with intensity X.
• <wfloat> : Put in Event Notes to make the event float and ripple in water.

Terms of Use

• Commercial and non-commercial projects allowed.
• You are NOT permitted to resell or redistribute this plugin (JS), either on its own or as part of a bundle.
• You ARE permitted to edit the plugin's code for your own project's use. However, you are NOT permitted to redistribute the edited version of the plugin.