🌀 Overworld Ability Engine

For RPG Maker MZ

Field abilities • Map targeting • Environmental state control

Turn your maps into interactive spaces with a focused overworld ability framework.

The Overworld Ability System adds a radial skill wheel to the map, allowing players to cast field abilities directly onto tiles, events, regions, and coordinates — with visual targeting, range limits, timers, and persistent state handling.

Designed for developers who want structured overworld interaction without rewriting core map logic.

🎮 What It Does

🔹 Map-Based Ability Casting

• Radial ability selection wheel

• Cursor targeting with preview

• Range limiting

• Directional push / pull handling

• Manual coordinate targeting support

Players cast abilities directly on the map — no battle scene required.

🔹 Implemented Abilities

Included out of the box:

• Push

• Pull

• Freeze

• Growth

• Levitate

• Teleport (to saved anchor)

• Reveal

Each ability integrates with event tags, regions, and timers.

🔹 Targeting System

Abilities can target:

• Events

• Tiles

• Region IDs

• Explicit coordinates

Supports both radial wheel targeting and manual targeting logic.

🔹 Visual & UX Feedback

• Targeting overlay

• Range highlights

• Particle burst effects

• Toast notifications

• Teleport anchor sprite

• Ability icons

Clear visual communication for players.

🔹 Timed Environmental States

Supports temporary states with automatic restoration:

• Frozen

• Levitated

• Grown

• Revealed

Durations are configurable. States revert automatically when timers expire.

🔹 Persistence & Save Support

The system persists via $gameSystem:

• Ability unlock states

• Cooldowns

• Teleport anchor

• Active timers

Everything restores correctly on save/load.

🔹 Plugin Commands & Script API

Built-in commands:

• Unlock / lock abilities

• Set cooldowns

• Set / clear teleport anchor

• Force-use an ability

Script access:

FF.Abilities.*

Allows custom logic and integration into larger systems.

🔹 Event & Region Tag Support

Add tags in:

Event Notes:

• pushable

• pullable

• freezeable

• growable

• levitateable

• hiddenPath

• frozenAppearance: X

• levitateAppearance: X

Tileset / Region Notes:

• Region-based freeze/growth hooks

• Region ID interaction logic

No need for complex event condition trees.

🧩 What It Is Designed For

• Golden Sun–style field skills

• Puzzle-light dungeon interaction

• Exploration gating mechanics

• Environmental storytelling

• Soft Metroidvania progression

• Region-based map interactions

⚠ Important Limitations

This plugin is intentionally focused and does not attempt to be a full environmental simulation engine.

It does not:

• Consume MP/TP automatically

• Handle built-in resource cost systems

• Include cast-time mechanics

• Provide advanced elemental conduction systems

• Include a generic chain-reaction puzzle engine

• Modify the tilemap permanently at runtime

Environmental changes are handled through:

• Timers

• Self-switches

• Switch hooks

• Appearance swaps

It augments map behavior rather than overwriting core map logic.

🛠 Developer Philosophy

This system is built to:

• Reduce event spaghetti

• Provide structured overworld interactions

• Stay compatible with most MZ projects

• Avoid heavy overwriting of engine internals

It gives you a clean ability framework — while leaving puzzle complexity in your control.

💡 Ideal For Developers Who:

• Prefer structured systems over massive all-in-one plugins

• Want controlled environmental interaction

• Need persistence + targeting without custom scripting

• Plan to build puzzles using switches and event logic