MagicItems & perks

Two independent modules for survival servers:

• magic-items – tools, weapons, armor and food in three tiers with abilities (3×3 mining, tree feller, harvesting, life steal, infinite food …), available via the /magicitem menu.
• perks – permanent advantages such as auto pickup, XP boost or flying, each unlockable by permission and toggled by players via /perks.

Enabling

• Module keys magic-items and perks, both without dependencies (both in the survival preset). See Modules & Presets.
• Buying from the menu additionally needs the economy module (see Coins & stock market). Without the coins module, only free items are possible.

MagicItems

Tiers

255 is the highest level Minecraft stores; the tiers differ in their abilities. Exceptions: the protection enchantments (Protection, Fire/Blast/Projectile Protection, Feather Falling) get 5 / 10 / 20 – Minecraft adds them up over all pieces and caps them at 20 points (80 %), in every version; more does nothing. Lure and Quick Charge stay at 5 (above that no fish bites / the crossbow no longer loads), Depth Strider at 3 and Swift Sneak at 5 (no further effect above). All magic weapons deal 200 % damage (after the tier bonus and lightning, arrows and the Legendary trident's lightning included). Existing items are brought to the current levels and enchantments on join or when held.

Enchantments that move the player – Riptide, Lunge (spear charge) and Wind Burst (mace) – have their own levels: 3 / 5 / 10 (Elite / Epic / Legendary). Older items with higher levels are adjusted on join or when held.

Kinds and from which version

Sweeping Edge exists from 1.11.1, Quick Charge/Piercing from 1.14 – on older versions only these enchantments are missing.

Tools

Toggle area mode (3×3, 5×5, tree feller, harvesting) with sneak + right-click. Every additionally mined block fires its own BlockBreakEvent – protection plugins and item tracking see it –, never takes chests along.

Weapons

Toggling Riptide: sneak + left-click with the trident (or /magicitem riptide). On: Riptide at the tier's level instead of Loyalty and Channeling – in water or rain like vanilla, on land every right-click boosts (the higher the level, the farther). Off: the trident is thrown again, sneak + right-click boosts as before. The item description shows the state.

| Bow, crossbow | shoot without arrows (nothing is consumed), fire arrows | explosion on impact: 200 % of the hit damage to everything around (no block damage) | + sneak while shooting: teleport to the impact |

Ammunition: /magicitem bullet picks what bow and crossbow fire – arrow, spectral arrow, snowball, egg, ender pearl, fireball, ghast fireball, wither skull, dragon fireball, shulker bullet, llama spit, trident or wind charge (depending on the version). The choice is per player for all magic bows; fireballs and skulls do not break blocks.

| Shield | reflects 15 % of melee damage | 30 % | 45 %, fully blocks explosions |

Armor

Elite made of diamond, Epic/Legendary of netherite (before 1.16 diamond). Legendary is unbreakable.

Armour (config.yml → magic.armor.<tier>): since armour + protection take off about 96 % at most in Minecraft and the Warden's sonic boom ignores both, Eternal enforces the damage itself:

Applies to hits, arrows, explosions, magic, fire, poison/wither and the Warden's sonic boom (not to falling, drowning, the void, /kill); what armour and protection already take off counts. After a config change, worn pieces take the new armour values on the next join or when held. Thorns 255 throws every attacker's hit back.

Hearts and speed are item attributes and only apply while the piece is worn. Item attributes only exist from 1.13.2 – below that, chestplate and leggings keep their normal values (the lore does not show the bonus there), all other abilities work.

Food & golden apples

Are not consumed when eaten: the bite is intercepted and the effect is applied directly.

Menu and commands

Free or paid

• Nothing is locked: every tier and every kind in the menu is open to everyone.
• For free gets an item whoever has the tier permission eternal.magic.use.<tier> and the kind permission eternal.magic.kind.<kind>. eternal.magic.free is always free.
• Otherwise you pay: price from magic.prices, booked as MAGIC_BUY. Price 0 = free for everyone.
• Abilities need no permission – whoever has the item uses it.

config.yml

magic:
  # Price in coins per tier (0 = free)
  prices:
    elite: 5000
    epic: 25000
    legendary: 100000
  # MagicItems only in your own inventory / ender chest;
  # chests, hoppers, frames and dropping only with eternal.magic.store
  own-inventory-only: true
  allow-drop: false
  # MagicItems and locked items are kept on death
  keep-on-death: true

magic:
  prices:
    elite:
      pickaxe: 5000
      bow: 400
      food: 500
      # … enter all remaining Elite kinds as well
    epic: 25000
    legendary: 100000

In the stock market and in the statistics, MagicItems run as their own material (e.g. MAGIC_LEGENDARY_PICKAXE) with a high base value, not as a normal diamond pickaxe.

Permissions

Custom items & Creator

Own items with texture, abilities and name effects from the dashboard: see Custom items & Creator.

Perks

/perks opens the perk menu, /perks <name> toggles a perk directly. The Perks button in the /settings menu opens it too. A perk can only be selected with its permission; the selection is stored per player in eternal_perks. Perks a version does not know yet do not appear in the menu there – the selection is still stored and applies again as soon as the player is on a newer server.

Auto pickup and auto smelt work with normal tools just as with MagicItems. If the player has turned on the overflow storage, auto-pickup drops that no longer fit into the inventory go there instead of onto the ground.

Effect perks run without particles and (from 1.14) without an icon in the HUD. Potions you drink are not overwritten: if a stronger effect is active, it stays; when turning a perk off, Eternal only removes its own effect.

All perk permissions have the default level Off (in-game plugin.yml: op). They are granted via ranks or for a limited time via /perms user <Spieler> perm add eternal.perk.fly 1 30d. In the world rules, individual perks can be blocked per server and world.

Common pitfalls

• „Coins-Modul ist aus — Kauf nicht möglich“ ("Coins module is off — purchase not possible"): turn on economy on the server or set prices to 0.
• A MagicItem cannot be put into a chest: intended with own-inventory-only: true; that is what eternal.magic.store is for.
• „Perks-Modul ist auf diesem Server aus“ ("Perks module is off on this server") when clicking in /settings: the perks module is missing on this server.
• A player no longer picks anything up: the no_pickup perk is turned on in /perks.