Enchanted Armaments

Quick rating

Community listing page, reviews here may not be monitored by the author.

Enchanted Armaments

No reviews yet

This project adds mulitple custom weapons that can be obtained through loot chests, trial chambers and killing mobs. It has a few custom enchants, and comes with a datapack to enforce loot tables inside of the spawning functionality.

Mod Loaders
Minecraft
26.2

About

Description

Enchanted Armaments

This plugin was made for an SMP called Enchanted SMP (hence the icon), and it adds a bunch of special weapons and enchants to the server. Players don't need any mods to use it. You just need a Paper or Purpur server set up correctly.


Server Setup

  1. Run a Paper (or Purpur) server on Java 25 (Oracle), Minecraft 26.2.
  2. Install ProtocolLib. The plugin depends on it and won't work without it.
  3. Drop EnchantedArmaments.jar into your server's /plugins folder and restart.
  4. Download the datapack from the mod page and extract it into your world folder's datapacks directory (for example world/datapacks/). It sets the loot tables the plugin needs for trial chamber loot to work, so drop it in before you start using the mod.
  5. Configure config.yml however you like, then reload or restart the server.
  6. A resource pack isn't required for the plugin to function, but it's recommended if you want to actually see the custom textures on the armaments.

Dependencies

Dependency Required? Notes
Java 25 (Oracle) Required The server needs to run on Java 25.
ProtocolLib Required A server side plugin dependency. Install it alongside EnchantedArmaments.jar in /plugins.
Resource Pack Recommended Download it here: EnchantedArmaments.zip. Apply it client side (or host it server side) so players can see the custom textures on the armaments.
Datapack Required Uploaded as a .zip on the mod page. Download it and extract it into your world folder's datapacks directory (for example world/datapacks/) before starting the server. It sets the loot tables the structure loot injection relies on.

Custom Gear (14 unique items)

Copper Armour Set

(Boots, Leggings, Chestplate, and Helmet)

Copper set

Every piece uses the same base stats as its netherite armour counterpart. All pieces are fireproof, tagged so they can be tracked, tuned so their durability never breaks, glinting, and built with custom model data so the resource pack textures show up correctly.

Piece Passive Active Ability Cooldown
Boots Permanent Speed I Copper Sense (double tap Shift and hold): reveals nearby players through walls, but only for you 60s
Leggings Blast Protection VIII Copper Charge: sets off an explosion you're immune to 60s
Chestplate Permanent Fire Resistance, Fire Aspect on all weapons, flaming arrows Inferno Shot (double tap offhand): launches a fireball 60s
Helmet Permanent Strength II, and Blood Tempered (gains +0.5 toughness per kill, capping at 10 kills) Blood Rage: auto triggers Speed III and Strength III for 5 seconds when you drop below 4 hearts 90s

Chainmail Armour Set

(Boots, Leggings, Chestplate, and Helmet)

Chainmail set

The chainmail set leans into wind and mobility, giving speed, flight, and knockback tools instead of pure damage output.

Piece Passive Active Ability Cooldown
Boots No fall damage (Windborne) Gale Wings: toggle flight on and off by sneaking 30s
Leggings Permanent Speed II with a wind trail effect that builds up as you sprint Cyclone Step (sneak and double left click): a dash that launches any entities you pass through 50s
Chestplate Windwall, which passively deflects incoming projectiles and melee hits Eye of the Gale (double tap offhand): a 10 second deflection shield 120s
Helmet Permanent Strength I Eye of the Storm (triggers automatically): a tornado that launches and damages everything within 6 blocks when you're hit below 6 hearts 90s

Unique and Rare Weapons

Item Passive Active Ability Cooldown
Copper Sword Same base stats as a netherite sword, plus Storm Strikes (every 4th hit calls down lightning) Lightning Ray (triple sneak): strikes wherever you're looking for 5 seconds 30s
Necromancer's Sword Collects "souls" from mob kills, and has a 5 level Soul Stealer progression that levels up from either player kills or cumulative souls, whichever is higher. Max soul capacity scales with each level. (Triple sneak): summons undead minions equal to your soul count None
Void Blade Bringing of the Void: every 60 seconds, your next hit drains 3 hearts to you, then reverts after 20 seconds Void Collapse (triple sneak): opens a black hole that pulls in entities and applies Wither within 3.5 blocks for 10 seconds 120s
Emberbrand Molten Touch (burns targets, and burns longer if you're wearing the Copper Chestplate), Scorched Earth (leaves fire behind while sprinting), and Forge Tempered (fire damage heals you instead of hurting you) Emberstrike (triple sneak): coats the blade in lava for splash damage, with a texture swap while it's active 80s
Sovereign's Tide Sea mobs stay passive around you and defend you, you get permanent Water Breathing, and hitting an enemy applies a Drowning Curse Tidal Army: summons an army from the ocean for 3 minutes 7 min
Warden's Heart Wardens stay passive around you and defend you. Void Guardian spawns a warden to hunt down anyone who attacks you while you're below 4 hearts, and Void Sentinel spawns an avenging warden when you die. Sonic Shriek (shift and click gesture): fires a sonic boom that corrupts blocks 40s (Void Guardian is 220s)

Custom Enchantments

Enchantment Applies To Effect Notes
Excavation Pickaxes and Shovels Mines a 3x3 area at once Registered through Paper's data driven enchantment system, respects durability and Unbreaking, blacklists tile entity blocks like chests, furnaces, and spawners, and is exclusive with Fortune
Auto Smelt Pickaxes only Automatically smelts ore drops and grants furnace XP Built from the live furnace recipe registry, and exclusive with Silk Touch

World Generation and Loot

The plugin injects one time unique items into naturally generated chests tied to specific structures:

Item Structure
Warden's Heart Ancient City
Void Blade End City
Necromancer's Sword, Emberbrand Nether Fortress
Chainmail Armour Set (all 4 pieces) Bastion Remnant
  • Spawn chance is configurable per item, defaulting to 5%
  • Keeps a persistent record of what's already been placed

Vault Token System

Copper armour pieces can also show up as disguised Copper Ingots (tokens with lore text on them). Picking one up decodes it and either gives you the real item if it's your first claim, or 3 to 6 diamonds as a consolation if it's already been claimed.


Protections and Quality of Life

  • Custom items can't be stored in ender chests. This is blocked on click, shift click, drag, and hopper or dropper transfer, and it's checked recursively inside shulker boxes and bundles too.
  • Custom items are immune to normal durability-lowering actions.
  • Renaming an item on an anvil keeps its custom display name on the renamed result.
  • The server broadcasts an announcement, with per player and per item history saved to JSON, whenever someone is found holding one of the tracked rare armaments.
  • Pickups and cooldowns show up as action bar notifications instead of cluttering the chat.

Commands

Command Description Permission
/givearmament <item> Gives any of the 14 items Op only
/removecooldown <item> Clears a player's ability cooldown Op only
/eaadmin reset_chest Resets a single structure chest's placement state Op only
/eaadmin reset_all_chests Resets all structure chest placement states Op only
/eaadmin reset_claim Resets a single vault token claim Op only
/eaadmin reset_all_claims Resets all vault token claims Op only
/ea reset <player> [item] | all Resets broadcast announcement history Op only

/eaadmin also works as enchantedadmin or armamentsadmin.


Config

config.yml keeps track of:

  • Claimed vault tokens
  • Spawn chances for each item's structure chest (you can adjust these)
  • A HIDECOORDS flag that stops the console from logging anything that would reveal chest locations