WeaponsSMP - Custom Weapons Plugin

Overview

WeaponsSMP brings 8 powerful unique weapons to your Minecraft server! Each weapon has special left-click (L) abilities, with some also featuring right-click (R) abilities. All weapons feature a 35-second cooldown between uses, particle effects, and exciting combat mechanics.

Features

8 Unique Weapons

| Weapon | Type | L-Click Ability | R-Click Ability | |--------|------|-----------------|-----------------| | Ocean's Rage | Trident | Water & Lightning (20blk, 7dmg) | Throw trident | | Storm's Edge | Diamond Sword | Tornado & Lightning (5blk rad, 7dmg) | - | | Mythic Blade | Diamond Sword | Regeneration | Explode (15blk, 6dmg) | | Soul Collector | Diamond Sword | Mark souls (share/reflect damage) | - | | Death Knight's Sword | Iron Sword | Summon 6 skeletons (4-5dmg) + Strength III | - | | Edge Of Astral Plane | Diamond Sword | Freeze enemies | Dash (9 blocks) | | Mjolnir | Mace | Launch + Lightning + Shockwave (9blk) | Upward launch | | Fallen's Spear | Trident | Divine Rain (20blk, 9dmg) | - |

Visual Effects

• Custom particle effects for each ability (water, lightning, tornado, souls, ice, thunder)
• 12 craft animations with particle beams
• Color-coded weapon themes (blue, grey/yellow, purple/gold, cyan/purple, black/red, white/blue, yellow/blue, gold/white)

Cooldown System

• 35-second cooldown between ability uses
• HUD timer displayed near the health/hunger bars (action bar)
• Shows remaining time with weapon name

First Craft Celebration

• Special boss bar (1 minute) showing weapon name, crafter name, coordinates, and time
• Particle beams and title announcements
• Bonus item drops (weapon duplicate + gold ingots)
• Only triggers once per player per weapon

How to Use

Getting Weapons

• Players: Ask an admin or use /items (if permitted)
• Admins: Use /items to give all weapons to yourself

Using Abilities

1. Hold the weapon in your main hand
2. Left-click (L) to use the primary ability
3. Right-click (R) to use the secondary ability (if available)
4. Wait for the 35-second cooldown between uses

Admin Recipe Editor

1. Use /edit to open the recipe editor GUI
2. Click on a weapon to select it
3. Enter recipe materials in chat (format: MATERIAL,AMOUNT)
4. Type done to save or cancel to abort

Examples

• DIAMOND,3 - 3 diamonds
• IRON_INGOT,5 - 5 iron ingots
• GOLDEN_APPLE,1 - 1 golden apple

Tips & Tricks

• Storm's Edge: Use in open areas to hit multiple enemies with the tornado!
• Soul Collector: Mark multiple enemies before attacking to maximize damage reflection
• Death Knight's Sword: Your skeletons will fight for you - let them engage first!
• Edge Of Astral Plane: Combine freeze with dash for a quick escape
• Mjolnir: Use upward launch to reach high places or escape the nether

Permissions

• weaponssmp.admin - Required for /edit command (OP by default)

Known Limitations

• Cooldowns are tracked per-player and reset on server restart
• First craft celebrations are saved to a config file
• Weapons must be held in the main hand to trigger abilities
• Some abilities may have reduced effect in protected regions (claims, plots)