How to Configure Magic

A magic type is an optional, naturally regenerating resource like Mana that other plugins (e.g. EcoItems, EcoEnchants) can spend. Each type defines its own regen rate and limit. This page takes you from an empty file to a working magic type, then breaks down every part of the config.

Quick start

  1. Open the /plugins/EcoSkills/magic_types/ folder.

  2. Copy _example.yml and rename the copy to your magic type's ID, e.g. mana.yml. The file name is the ID.

  3. Set the name, regen-rate, and limit.

  4. Set join-on-full to decide how players start.

  5. Run /ecoskills reload.

  6. Rejoin and watch %ecoskills_mana% regenerate towards %ecoskills_mana_limit%, e.g. in the action bar.

Naming and IDs

The file name without .yml is the magic type's ID. That ID is what you use in commands, placeholders, and prices. For item textures and icons, see the Item Lookup System.

The structure of a magic type

PartWhat it controls
InfoThe name shown to players
RegenerationHow fast the resource regenerates and its cap
Join behaviorWhether players join full or empty
# === Info: name ===
name: "&#40ffe6🌊 Mana" # Display name shown to players

# === Regeneration: rate and cap ===
regen-rate: "0.02 * %ecoskills_mana_limit%" # Amount regenerated per second; supports expressions
limit: "100 + %ecoskills_wisdom%" # Maximum a player can hold; supports expressions

# === Join behavior ===
join-on-full: true # true: players join with a full resource; false: empty

Info

The display name players see for the resource.

name: "&#40ffe6🌊 Mana" # Display name shown to players

Regeneration

How fast the resource refills and the most a player can hold. Both accept expressions, so you can scale the cap off other stats.

regen-rate: "0.02 * %ecoskills_mana_limit%" # Amount regenerated per second
limit: "100 + %ecoskills_wisdom%" # Maximum a player can hold

Join behavior

Whether players come online with the resource full or empty.

join-on-full: true # true: join full; false: join empty

Internal placeholders

PlaceholderValue
%ecoskills_<id>%The player's current amount of this magic
%ecoskills_<id>_limit%The player's maximum for this magic

Where to go next

  • Default magic types: the shipped configs are on GitHub.

  • Spend magic: wire costs into abilities with the Prices system.

  • Make an effect: build the abilities that consume magic in How to make an Effect.