Little Combat Expansion (Two handed, Dual Wield)

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

- Tag Management: Weapons that require both hands to use, automatically clearing the offhand slot - Tag Management: 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

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

🎯 Visual Feedback

- Attack Effects: Animated cooldown bar showing weapon readiness - Attack Effects: Configurable cooldown symbols and colors - Attack Effects: Visual and audio feedback for different attack types

🛡️ Inventory Management

- Inventory Validation: Automatic offhand management for two-handed weapons - Inventory Validation: 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

- Dependencies: 1.21+ - Dependencies: 1.21 - Dependencies: 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.