Soulbound Arsenal

# Soulbound Arsenal

Soulbound Arsenal is a progression-focused combat and RPG plugin designed for Minecraft SMP, Survival, PvP, and RPG servers.

The plugin introduces a complete Soulbound Weapon System where players can obtain a unique Soul, develop it through levels and tiers, unlock powerful abilities, and build their own combat progression.

Instead of replacing the vanilla combat system entirely, Soulbound Arsenal expands it with a structured progression system built around familiar Minecraft weapons and tools.

## Core Features

### 5 Unique Soul Types

Each Soul is associated with a different Minecraft weapon or tool and provides its own dedicated ability set.

⚔ Sword Soul
Focused on direct combat, mobility, target marking, and burst damage.

Axe Soul
Focused on heavy attacks, burst damage, and aggressive combat.

⛏ Pickaxe Soul
Focused on mobility, earth-based abilities, and terrain interaction.

Shovel Soul
Focused on area control, traps, defensive abilities, and terrain manipulation.

Hoe Soul
Focused on healing, sustain, life drain, and nature-based abilities.

### 25 Unique Skills

Each Soul provides 5 unique abilities, including an ultimate ability.

Sword:
• Blood Slash
• Shadow Step
• Crimson Mark
• Soul Blade
• Reaper

Axe:
• Heavy Strike
• Axe Throw
• Timber Crash
• Execution Zone
• Lumberjack

Pickaxe:
• Ore Sense
• Tunnel Dash
• Earth Breaker
• Seismic Wave
• Earthquake

Shovel:
• Sand Blast
• Earth Wall
• Ground Trap
• Ground Wave
• Landslide

Hoe:
• Nature Slash
• Life Drain
• Healing Field
• Thorn Garden
• Nature's Wrath

### Soul Progression

Players can develop their Soul from Level 1 to Level 50.

Progression can include:

• Player kills
• Mob kills
• Block breaking
• Experience progression
• Kill streaks
• Skill unlocks
• Tier upgrades

The progression system is configurable, allowing server owners to create their own progression curve.

### 5 Soul Tiers

The default progression contains five tiers:

Wood → Stone → Iron → Diamond → Netherite

Each tier can affect:

• Skill damage
• Cooldowns
• Combat scaling
• Player progression
• Skill effectiveness

### Soul Energy

Skills use a dedicated Soul Energy system.

Energy management prevents unlimited Skill usage and adds another layer of decision-making to combat.

Soul Energy can be configured to:

• Increase through combat
• Regenerate outside combat
• Decrease when taking damage
• Be consumed by Skills
• Interact with combat states

### Skill & Combat System

Soulbound Arsenal includes a complete Skill system with:

• Skill cooldowns
• Energy costs
• Skill requirements
• Target detection
• Damage handling
• Skill interruption
• PvP/PvE balancing
• Particle effects
• Visual feedback
• Ultimate abilities
• Combat restrictions

### Combo System

Chain attacks and abilities together using the built-in Combo System.

The system supports configurable combo windows, damage modifiers, skill chains, and combat tracking.

### Soulbound Item Protection

Soul Items are protected through an ownership and integrity system.

Protection includes:

• Owner verification
• Item identification
• Anti-copy protection
• Drop protection
• Container protection
• Hopper protection
• Automatic restoration
• Item integrity checks

The restoration system is designed to avoid overwriting existing inventory items when restoring a missing Soul Item.

### Death & Progression

Death can interact with Soul progression according to server configuration.

Administrators can configure different progression behaviors, including full reset, partial reset, or no reset.

### Terrain Skills

Some abilities can interact with the Minecraft environment.

The terrain system supports:

• Temporary terrain changes
• Visual terrain effects
• Real terrain changes
• Terrain limits
• Rollback
• Smart rollback
• Protected worlds
• Safe zones
• World restrictions

Smart rollback can detect player modifications and avoid unnecessarily overwriting legitimate changes.

### PvP & PvE Balancing

Server owners can independently configure combat behavior for PvP and PvE.

Available settings include:

• PvP damage multiplier
• PvE damage multiplier
• Skill damage
• Combo damage
• Maximum Skill damage
• Cooldowns
• Crowd control
• Ultimate interruption
• Dash protection
• Tier scaling

### Achievements & Ranking

The plugin includes progression-based achievements and a Soul ranking system.

Players can track their progress and compete through Soul-based rankings.

### Cosmetics & Visual Effects

Soulbound Arsenal provides optional visual customization features including:

• Soul Trails
• Skill particles
• Combat effects
• Screen Shake
• Visual Skill feedback

Players can control their Screen Shake preference.

### GUI System

Built-in interfaces are available for:

• Soul information
• Rankings
• Achievements
• Cosmetics
• Administration

### Optional Integrations

Soulbound Arsenal supports optional integrations with:

• PlaceholderAPI
• WorldGuard
• Vault

These integrations are optional and are not required for the core plugin.

### Storage

Persistent data can be stored using:

• SQLite
• YAML

SQLite is recommended for multiplayer servers.

## Installation

1. Download the Soulbound Arsenal JAR.
2. Place the JAR inside your server's `plugins` folder.
3. Start or restart the server.
4. Allow the plugin to generate its configuration files.
5. Configure the plugin inside `plugins/SoulboundArsenal/`.
6. Use `/soul` to access the player system.

A server backup is recommended before installing the plugin on an existing production server.

## Compatibility

• Minecraft 1.21.x
• Paper / Spigot-compatible servers
• SQLite / YAML storage
• Optional PlaceholderAPI, WorldGuard, and Vault integrations

Soulbound Arsenal is designed for SMP, Survival, PvP, RPG, Hardcore-style, and progression-based Minecraft servers.

## License

All Rights Reserved.

Redistribution, re-uploading, resale, modification, decompilation, reverse engineering, or publication of modified versions is not permitted without explicit authorization from the author.

Sharing the official project page is permitted.