WeaponSystem Plugin

A comprehensive weapon system plugin for Minecraft servers that adds advanced weapon mechanics, dual-wielding capabilities, and enhanced combat features.

Features

🗡️ Weapon Tagging System

• Two-Handed Weapons: Weapons that require both hands to use, automatically clearing the offhand slot
• Offhand Weapons: Special weapons that can be used in the offhand slot for dual-wielding
• Tag Management: Easy command-based system to tag weapons with special properties

⚔️ Enhanced Combat Mechanics

• Attack Speed System: Realistic weapon cooldowns based on weapon type and attributes
• Damage Calculation: Advanced damage calculation including:
  • Base weapon damage
  • Enchantment bonuses (Sharpness, Smite, Bane of Arthropods)
  • Critical hit mechanics
  • Attribute modifiers
• Knockback System: Customizable knockback based on weapon properties
• Fire Aspect: Proper fire damage application with immunity checks

🎯 Visual Feedback

• Cooldown Indicator: Animated cooldown bar showing weapon readiness
• Customizable UI: Configurable cooldown symbols and colors
• Attack Effects: Visual and audio feedback for different attack types

🛡️ Inventory Management

• Smart Item Handling: Automatic offhand management for two-handed weapons
• Drop Protection: Prevents accidental item loss when switching weapons
• Inventory Validation: Ensures proper weapon placement and usage

Commands

/weapontag twohanded [remove]     - Make item two-handed or remove the tag
/weapontag offhanded [remove]     - Allow item in offhand or remove the tag
/weapontag clear                  - Remove all weapon tags
/weapontag check                  - Show current weapon tags

Permissions

• weaponsystem.tags - Access to weapon tagging commands
• weaponsystem.use - Basic command access (default: op)

Configuration

The plugin includes a config.yml file for customizing:

• Cooldown animation frames
• Cooldown indicator colors
• Weapon behavior settings

Technical Details

• Minecraft Version: 1.21+
• API Version: 1.21
• Java Version: 21
• Dependencies: Paper API

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure the plugin via config.yml

Development

Built with Gradle and Paper API, this plugin provides a solid foundation for advanced weapon mechanics on Minecraft servers.