ElementalArms
The complete RPG gear suite: elemental weapons, item abilities, tiers with random rolls, gems, sets and a full equipment menu — all with a visual in-game editor.
A full RPG item system
Installation
Get ElementalArms running in a minute — it needs no other plugin.
config.yml, paste your key into the license field and restart. You will find it in My panel at infinity3113. Without it the plugin disables itself and says so in the console. The licence covers one server: if it is used on two at once, it shuts down.- Buy and download ElementalArms.jar, then drop it into your server's plugins/ folder.
- Restart the server (Java 21 required for 1.21+).
- (Optional) Install MythicMobs, PlaceholderAPI or MMOCore — they hook in automatically.
- Edit anything from
/ea editoror the config files, then run/ea reload.
Items & tiers
Every item is defined in YAML or from the editor, with stats, a rarity, a tier and dynamic lore.
| Concept | What it does |
|---|---|
| Types | Sword, axe, bow, crossbow, spear, shield, armor, wand, ring, amulet, talisman, gem, consumable. |
| Stats | Damage, attack speed, crit chance/damage, max health, armor, defense, toughness, knockback resist, movement speed. |
| Tiers | Common → Mythic. Each tier rolls stats in a range, so items of the same kind vary. tier: RANDOM picks one by weight. |
| Soulbound | Binds an item to the player who picks it up; others can't use it and it can't be dropped. |
| Requirements | Gate an item behind a level, permission or class (uses MMOCore level/class if present). |
| Durability | Optional custom durability that warns and breaks on its own. |
/ea editor — pick a category, an item, and click each property.Elemental damage
Weapons deal elemental damage on top of physical. Mobs can be weak (more damage) or resistant (less) to each element.
| Element | Element | Element |
|---|---|---|
| 🔥 Fire | ❄ Ice | 💧 Water |
| 🪨 Earth | 🌪 Wind | ⚡ Lightning |
| ☠ Poison | ✨ Light | 🌑 Dark |
| 🕊 Holy | 🌿 Nature | 🔮 Arcane |
Weakness and resistance show live as ▲ / ▼ on the floating damage number. Set them per mob, or per MythicMobs mob with the native mechanic.
Health bars
A floating bar above each mob with its health and, most useful of all, its elemental weaknesses and resistances. Players can see at a glance which weapon to use.
When it shows
| Mode | What it does |
|---|---|
on-hit | Appears when you hit and hides by itself. The default and the lightest. |
always | Always visible on nearby mobs. |
Six styles
solid ▉▉▉▉▉▉▉▉▉▉ # el más legible (por defecto)
hearts ❤❤❤❤❤❤❤❤❤❤
framed [▮▮▮▮▮▮▯▯▯▯]
thin ━━━━━━━━━━
pips ■■■■■■□□□□
numbers # sin barra, solo "❤ 14/20"What you can tune
| Setting | What for |
|---|---|
show-elements | Shows ▲ weak and ▼ resists next to the bar. |
color-by-health | Green → yellow → red as health drops. |
max-bars | Cap of bars at once (60 by default). The anti-lag brake. |
only-hostile | Hostile mobs only: no cows or villagers. |
view-distance | From how many blocks it is visible (32 by default). |
max-bars and view-distance, or switch to on-hit. You can also turn them off entirely with health-bars.enabled: false.Item abilities
Bind any of the 19 built-in abilities to an item, with a trigger, cooldown, chance and its own parameters. Configure it all from the editor.
| Trigger | When it fires |
|---|---|
RIGHT_CLICK / LEFT_CLICK | On right/left click — aims where you look. |
ON_HIT | When you hit an entity with the item. |
WHEN_DAMAGED | When something damages you. |
ON_KILL | When you kill an entity. |
Abilities: fireball, lightning, aoe_damage, explosion, heal, lifesteal, shield, speed, strength, regeneration, resistance, poison, wither, blind, freeze, ignite, knockback, pull, leap, teleport. Plus mythic:YourSkill to run a MythicMobs skill.
Mana
ElementalArms has its own mana, and only uses it when no RPG plugin already provides one (MMOCore). The maximum comes from your gear's max-mana stat and refills at mana-regen per second.
max-mana, they simply have no mana and abilities with a cost are free for them, as before. Nothing needs configuring to keep things as they were.Equipment & accessories
Open /ea inventory for a full equipment menu: armor, two hands, shield and elytra, plus dedicated accessory slots.
| Slot | Accepts |
|---|---|
| 2 Rings | RING |
| Amulet | AMULET |
| Pendant | NECKLACE |
| Talisman | TALISMAN |
/ea stats opens a character sheet grouped by offense / defense / mobility, with all elemental damage folded into a single icon so it never clutters — no matter how many elements you carry.
Stats
The 89 stats an item can carry. You set them in its YAML file under stats:, and those marked % are written as whole numbers: 25 means 25%.
stats:
damage: 8.0
crit-chance: 25 # 25%
ability-damage: 25 # +25% de daño de habilidad
max-mana: 100lang/<language>.yml, under stat-name. This file only decides which stats exist.Attack
| Key | What it does |
|---|---|
damage | The weapon's attack damage. |
attack-speed | Attacks per second. |
crit-chance | Chance of a critical hit. % |
crit-damage | How much a critical adds. % |
ability-damage | Damage from abilities. % |
elemental-power | Boosts elemental damage. % |
armor-penetration | Ignores part of the target's armor. % |
execute | Bonus damage to low-health targets. % |
lifesteal | Heals you when you hit. % |
attack-knockback | How far your hit pushes. |
sweeping-damage | Damage of the sweeping attack. |
Defense
| Key | What it does |
|---|---|
max-health | Extra hearts. |
defense | Reduces incoming damage. |
armor | Armor, the vanilla one. |
armor-toughness | Makes armor hold better against big hits. |
knockback-resistance | You get pushed less when hit. |
dodge-chance | Chance to dodge a hit entirely. % |
thorns | Returns part of the damage to the attacker. % |
max-absorption | Absorption shield, spent before your health. |
explosion-resistance | Better against explosions. |
burning-time | How long you stay on fire. |
health-regen | Health you recover over time. |
Elemental resistances
One for each of the 12 elements.
| Key | What it does |
|---|---|
resist-fire | Resistance to the Fire element. % |
resist-water | Resistance to the Water element. % |
resist-earth | Resistance to the Earth element. % |
resist-wind | Resistance to the Wind element. % |
resist-light | Resistance to the Light element. % |
resist-dark | Resistance to the Dark element. % |
resist-poison | Resistance to the Poison element. % |
resist-holy | Resistance to the Holy element. % |
resist-lightning | Resistance to the Lightning element. % |
resist-ice | Resistance to the Ice element. % |
resist-nature | Resistance to the Nature element. % |
resist-arcane | Resistance to the Arcane element. % |
Abilities and mana
| Key | What it does |
|---|---|
cooldown-reduction | Shortens the wait between abilities. % |
ability-range | Range of your abilities. % |
max-mana | Maximum mana. Without this stat the player has no mana and abilities are free. |
mana-regen | Mana recovered per second. |
Movement
| Key | What it does |
|---|---|
movement-speed | Walking and running speed. |
jump-strength | How high you jump. |
safe-fall | Blocks you can fall without getting hurt. |
fall-damage | Multiplies fall damage (lower it to take less). |
step-height | Height you climb without jumping. |
gravity | How hard gravity pulls you. |
sneak-speed | Speed while sneaking. |
movement-efficiency | Water, snow and cobwebs slow you less. |
flying-speed | Flying speed (creative or elytra). |
scale | The player's size. |
Utility
| Key | What it does |
|---|---|
mining-speed | Mining speed. |
block-break-speed | Speed breaking blocks in general. |
submerged-mining | Mining underwater without the penalty. |
swim-speed | Swimming speed. |
oxygen | You last longer underwater. |
entity-reach | You can hit from further away. |
block-reach | You place and break blocks from further away. |
xp-boost | More experience. % |
loot-luck | Better loot. % |
Combat balance — new in 1.1
These five exist to counter what previously had no answer.
| Key | What it does |
|---|---|
accuracy | Cancels the target's dodge. The antidote to dodge-chance: without it, stacking dodge made you untouchable. % |
crit-resistance | Reduces the chance of being crit. % |
block-chance | Chance to block while your shield is up. Capped at 80%. % |
counter-damage | When you block, returns this % of the damage to the attacker. % |
damage-cap | Cap on the damage a single hit can do to you. Your insurance against broken items. |
Conditional hits — new in 1.1
| Key | What it does |
|---|---|
backstab | Bonus damage when hitting from behind. % |
first-strike | Bonus damage on your first hit against each target. Resets after 30 s. % |
combo-damage | Grows with each chained hit, up to 10. Lost after 4 s without hitting. % |
double-strike | Chance to repeat the hit at half damage. Melee only. % |
Damage by context — new in 1.1
The PvP / PvE pair is the most useful: it lets you balance the arena without unbalancing the open world.
| Key | What it does |
|---|---|
damage-vs-players | Damage against players only (PvP). % |
damage-vs-mobs | Damage against mobs only (PvE). % |
ranged-damage | Damage with bow and crossbow. % |
melee-damage | Melee damage. % |
berserk | More damage the less health you have. Nothing at full health. % |
damage-vs-undead | Bonus damage to zombies, skeletons, phantoms and the wither. % |
Defense by context — new in 1.1
| Key | What it does |
|---|---|
ranged-resistance | Less damage from projectiles. % |
melee-resistance | Less melee damage. % |
magic-resistance | Less damage from abilities. Capped at 80%. % |
Abilities and mana — new in 1.1
| Key | What it does |
|---|---|
spell-vamp | Heals you from ability damage. The mage's lifesteal. % |
mana-steal | Mana you recover per hit. |
mana-cost-reduction | Abilities cost less mana. Capped at 90%. % |
ability-crit-chance | Your abilities can crit too. Uses your crit-damage, or +50% if you have none. % |
aoe-radius | Widens the area of all your abilities. Hard cap of 24 blocks. % |
Survival — new in 1.1
| Key | What it does |
|---|---|
tenacity | Negative effects last less on you. Capped at 80%. % |
second-wind | Chance to survive a lethal hit on half a heart. Has its own cooldown. % |
keep-item-chance | Chance to keep each item on death. % |
hunger-saving | Chance not to spend hunger. % |
Durability — new in 1.1
| Key | What it does |
|---|---|
durability-saving | Chance not to spend durability. % |
repair-rate | Durability points repaired by themselves every 5 seconds. |
World — new in 1.1
| Key | What it does |
|---|---|
magnet-range | Pulls dropped items towards you. In blocks, capped at 12. |
smelt-touch | Chance that what you mine comes out already smelted (iron, gold, copper, sand…). % |
taming-luck | Chance to get the item back when taming. % |
Upgrade · Reforge · Gems
The progression loop, all with one natural gesture — grab the stone or gem and click the item.
| Action | What it does |
|---|---|
| Upgrade (+N) | An upgrade stone raises all stats a % per level, up to a max. Optional success chance. |
| Reforge | A reforge stone re-rolls the item's stats within its tier — it can come out better or worse. |
| Gems / sockets | Items can have sockets; drag a gem in to add its stats. Slots shown as ◆ / ◇. |
| Sets | Cumulative bonuses for wearing 2 / 3 / 4 pieces of the same set. |
/ea station), or drop them from mobs and blocks with drop tables.Commands
Base: /elementalarms · aliases /ea, /earms
| Command | What it does |
|---|---|
/ea inventory | Open your equipment menu |
/ea stats | Your character sheet |
/ea editor | The visual item / ability editor |
/ea station <id> | Open a station without going to its block (needs permission) |
/ea give <player> <item> [n] | Give a custom item |
/ea list · /ea reload | List items · reload config |
/ea help | The command list |
/ea station place <id> · /ea station remove | Place or remove a station on the block you are looking at |
/ea fix [player] | Clean up stuck attributes on a player |
/ea debug | Show in chat what happens on each click |
Permissions
| Permission | Grants | Default |
|---|---|---|
elementalarms.admin | Editor, give, reload and admin tools | op |
elementalarms.station.command | Open stations with /ea station <id>, without their block | op |
Players use the menus (/ea inventory, /ea stats) and open stations by right-clicking their block, without any permission. elementalarms.admin already includes elementalarms.station.command.
Placeholders
With PlaceholderAPI installed:
| Placeholder | Returns |
|---|---|
%elementalarms_stat_damage% | Total of any stat (damage, defense…) |
%elementalarms_set% | Active set name |
%elementalarms_tier% | Tier of the item in hand |
%elementalarms_upgrade% | Upgrade level of the item in hand |
%elementalarms_durability% | Custom durability of the item in hand |
Configuration
Everything is configurable. The main files, all reloadable with /ea reload:
| File | What it holds |
|---|---|
config.yml | Damage indicators, recipes, upgrade/reforge/gems, requirements, drops, stations, accessories. |
items/ | Your custom items, one file per category. |
items/configurations/ | Tiers, sets, rarities, elements, stats, lore formats, drop tables. |
stations.yml | Crafting stations and their recipes. |
/ea editor writes all of these files for you.config.yml in detail
Every section of plugins/ElementalArms/config.yml. Keys stay in English (that's how the plugin reads them); the comments follow your language.
Damage indicators
damage-indicators:
enabled: true # floating damage numbers
show-all: true # true = also fists, mobs, fall…Crafting & item revision
vanilla-crafting:
replace-recipes: true # crafting vanilla gives its EA version
item-revision:
keep-data: # what to keep when rebuilding after a new version
enchantments: true # keep enchantments
display-name: true # keep the name
lore: false # keep the lore
kept-lore-prefix: '&7' # prefix for kept loreAbilities
abilities:
enabled: true # abilities system
cancel-vanilla-use: true # right-click cancels the vanilla use
messages:
cooldown: '&cThat ability is ready in &e{seconds}s&c.'
no-mana: '&cYou do not have enough mana (&b{mana}&c).'Native abilities and how to use them.
abilities: # inside items/*.yml
- ability: fireball
trigger: RIGHT_CLICK
cooldown: 5 # cooldown seconds
damage: 8 # damage
speed: 1.5 # projectile speed
- ability: lifesteal
trigger: ON_HIT
chance: 30 # % chance
percent: 25 # % of damage stolenEquipment sets
sets:
enabled: true # bonuses for wearing a full set
notify: true # chat notice when it togglesUse requirements
requirements:
enabled: true # requirements to use an item
level-source: VANILLA # VANILLA (exp level) or NONE
messages:
level: '&cYou need level &e{level}&c to use this.'
permission: '&cYou lack permission to use this item.'
class: '&cOnly the &e{class}&c class can use this.'Soulbound
soulbound:
enabled: true # binds the item to a player
bind-mode: PICKUP # PICKUP (on pickup) or USE (on use/equip)
prevent-drop: true # prevents dropping it
prevent-use-by-others: true # others cannot use it
messages:
bound: '&8🔒 &7This item is now bound to your soul.'
not-owner: '&cThis item is bound to another player.'
cannot-drop: '&cYou cannot drop a soulbound item.'Upgrade (+N)
upgrade:
enabled: true # +1, +2… upgrades with stones
stat-increase-per-level: 0.08 # +8% stats per level, stacking
max-level: 10 # max level (an item can override it)
stone-item: PIEDRAMEJORA # EA item consumed as the stone
success-chance: 100.0 # 100 = always; on fail, stone is lostIdentification
identify:
enabled: true # unidentified items hide their stats
scroll-item: PERGAMINOIDENT # EA item consumed to identifyReforge
reforge:
enabled: true # rerolls the tier's stats
stone-item: PIEDRAREFORJA # EA item consumed to reforge
keep-upgrade-level: true # keeps the +N when reforgingGems / sockets
gems:
enabled: true # gems in item sockets
destroy-on-remove: true # true = removing a gem destroys itCustom durability
custom-durability:
enabled: true # custom per-item durability
warn-below-percent: 15 # warn when below this %
on-zero: BREAK # BREAK (destroyed) or UNUSABLE (no stats)Feature toggles
drops:
enabled: true # loot tables (drops.yml)
stations:
enabled: true # crafting stations (stations.yml)
accessories:
enabled: true # equipment menu /ea inventory
texture-pack:
enabled: false # true only if players use the EA ResourcePackVersion history
Every release and what changed in it.
- 🐛ElementalArms 1.1.5 never got as far as starting up: it died during enable and the server disabled the whole plugin, so no command worked. It starts properly now.
- 🐛The cause was the order in which the internal stat data was prepared. Rewritten so that order can no longer break startup.
- 🔧New pre-release check: all 61 plugin classes are loaded the way the server would load them, so a startup failure cannot leave the workshop again.
- 🔧Straight update: nothing changes in the config or the items. Swap the .jar and you are done - your items, sets and abilities stay as they were.
- 🐛Gem sockets did nothing when you took the item out of the editor. "Get the item!" handed you a template that never read max-sockets, so you received an item with zero sockets and inserting a gem answe
- 🐛Items your players already own could never gain sockets or durability. Rebuilding an item preserves its data, so adding max-sockets to the YML and bumping revision-id changed nothing. They now adopt w
- 🐛The smithing table handed out a stripped item: upgrading to netherite produced no sockets, no durability and no tier roll.
- 🐛Bows fired with template stats. The arrow only carried the bow's ID, so damage was recalculated from scratch: a +10 bow full of gems hit for exactly the same as a fresh one.
- 🐛The format: block in lore-formats.yml was never read. The file documents it as the lore's running order, but the order was hard-coded, so reordering that list changed nothing in game. It works now, an
- 🐛The explosion ability had its two options backwards: the editor offered radius, which no code read, and hid break-blocks, which does work.
- 🐛Nine texts were hard-coded in Spanish on an English plugin. Four were seen by ordinary players: the durability line on every item, Dos Manos on two-handed weapons, the set-equipped message, and the la
- 🔧break-blocks is now offered in the ability editor, with its own icon and help. It defaults to 0, so an explosion does not wreck the terrain unless you say so.
- ✨21 more texts became translatable, including the combat indicators (✦ Block!, ✦ x2, ✦ Second Wind!, ✷ CRIT!). They worked before, but there was no way to translate them or recolour them.
- 🐛The editor did nothing when you typed a value in chat. The text arrived off the server thread, so the save was dropped without even an error in console.
- 🐛Logging out with an editor question still open left that question stored, and it was then applied to the first thing you typed on your next login.
- 🐛Abilities did not fire on hits from arrows, tridents or thrown potions: the plugin looked at the projectile instead of whoever threw it, so the hit did not count as yours.
- 🐛Items stuck to the cursor or appeared duplicated when upgrading gear. The client was out of sync with the server; the inventory is now refreshed after every change.
- 🐛Coloured names showed raw in the editor (&eLight Damage instead of Light Damage in yellow).
- 🐛Crit Resistance did nothing. It was in stats.yml, translated and with its own icon, but no code ever read it: you could put it on an item and it was decoration. It now cuts the extra damage from a cri
- 🐛Stats in the editor looked like the same option over and over. Only 57 of the 89 had an icon and the other 32 all fell back to the same blank paper. Several also clashed with a button's material (Defe
- 🐛The submenu buttons (abilities, lore, hand style, amplifiers, damage and resistances) were drawn on every page of the editor, so they looked like they repeated page after page. They are now only on th
- 🔧From the second page on, the six slots the buttons used go back to the list, so a page holds 36 stats instead of 30.
- 🔧Item properties come out in a fixed order, and stats that are already set come before the empty ones.
- ✨Every stat now carries a short description of what it does, with the plugin's real caps: dodge says "max 80%", ability area says "hard cap 24 blocks", passive repair says "every 5s". The 28 that are n
- ✨The 12 elemental resistances have their own submenu, the same way elemental damage already worked. They used to sit loose among the 89 stats, so every element appeared twice in the list and finding th
- 🐛Items could look stuck to the cursor, or vanish from a slot, in the equipment menu. The server had it right the whole time — what went wrong is that the menu cancels each click and moves the pieces it
- ✨✨ New — Dropped items now glow with the colour of their tier
- 🐛🐛 Fix — Elemental damage numbers always showed up white instead of their element's colour
- 🐛Elemental damage indicators always showed up white. The element colour was looked up after it had already been converted, so every element fell back to white - only Wind looked right, by coincidence.
- ✨Floating health bars above mobs, showing their elemental weakness at a glance.
- ✨32 new stats (89 in total): ability crit, magic resistance, spell vamp, area radius, reduced mana cost, accuracy, item magnet and more.
- ✨Search by ID in the item editor: type part of an ID and it looks through every category at once. Built for servers with hundreds of items.
- ✨/ea help with the full command list, showing each player only the commands they can actually use.
- 🔧Items in the editor are now sorted by tier and name. The order used to be random and changed on every server start.
- 🔧Tab completion for /ea only suggests the commands you have permission for.
- 🐛Any player could open stations with /ea station <id> from anywhere, skipping the block entirely. It now requires elementalarms.station.command (op by default).
- 🐛The item editor showed a raw "Abilities" field that did nothing.
- 🐛Removed the texts in the skill amplifier menu that mentioned a plugin that does not exist yet.
No notes for this version.
Discussion
Comment and share your experience on each plugin version.
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
No comments on this version yet — be the first!
Player reviews
What server owners think of this plugin.
Has pretty much all you need for your semi- or full rpg server.
buen plugin!