** UltimateSouls – Complete Documentation Package<\/p>\n
—<\/p>\n
\ud83d\udcd6 Plugin Description<\/p>\n
Overview<\/p>\n
**UltimateSouls** is a premium-quality, feature-rich Minecraft Paper plugin that introduces a revolutionary soul-based weapon progression system. Transform ordinary weapons into living entities that grow stronger with each kill, unlock devastating abilities, and eventually awaken into legendary artifacts with unique powers.<\/p>\n
The Concept<\/p>\n
In UltimateSouls, every kill matters. When you slay an enemy with a compatible weapon, their soul is absorbed into your blade. Each soul increases your weapon’s power, but comes with a terrible price – the curse grows stronger. Your weapon becomes increasingly unstable, consuming durability at alarming rates, blocking mending, and afflicting you with corruption effects.<\/p>\n
This creates a compelling **risk vs. reward** dynamic:
\n– **More souls = More power** (increased damage, abilities, legendary potential)
\n– **More souls = More risk** (faster breaking, corruption effects, instability)<\/p>\n
Players must balance their hunger for power against the very real possibility of their prized weapon shattering in their hands.<\/p>\n
Target Audience<\/p>\n
– **PvP Servers**: Perfect for faction, KitPvP, and survival PvP servers
\n– **Survival Servers**: Adds depth to the PvE experience
\n– **RPG Servers**: Integrates seamlessly with RPG-style gameplay
\n– **Competitive Servers**: Leaderboards and bounty systems drive competition<\/p>\n
—<\/p>\n
\u2728 Feature Summary<\/p>\n
Core Features<\/p>\n
| Feature | Description | Configurable |
\n|———|————-|————–|
\n| **Soul Collection** | Absorb souls from kills into your weapon | \u2705 |
\n| **Damage Scaling** | Each soul increases attack damage | \u2705 |
\n| **Curse System** | Souls increase durability consumption | \u2705 |
\n| **Mending Restriction** | High souls block mending enchantment | \u2705 |
\n| **Weapon Support** | Swords, axes, tridents, mace | \u2705 |
\n| **Per-Weapon Config** | Different settings per weapon type | \u2705 |<\/p>\n
Extended Features (All Toggleable)<\/p>\n
| Feature | Description | Default |
\n|———|————-|———|
\n| **Soul Tiers** | Unlock abilities at soul milestones | Enabled |
\n| **Soul Decay** | Weapons lose souls over time without kills | Enabled |
\n| **Soul Whispers** | Weapon “speaks” to the player | Enabled |
\n| **Soul Shatter** | Explosive weapon break with soul scattering | Enabled |
\n| **Corruption Effects** | Negative effects at high soul counts | Enabled |
\n| **Soul Instability** | Random weapon lashouts | Enabled |
\n| **Bounty System** | High-soul players become targets | Enabled |
\n| **Soul Stealing** | Steal souls from killed players | Enabled |
\n| **Revenge Marks** | Damage bonus against your killer | Enabled |
\n| **Nemesis System** | Bonus damage vs repeated victims | Enabled |
\n| **Cursed Visuals** | Particles and effects on weapons | Enabled |
\n| **Dynamic Naming** | Weapon names change with souls | Enabled |
\n| **Kill Announcements** | Broadcast milestone achievements | Enabled |
\n| **Soul Extraction** | Extract souls into items | Enabled |
\n| **Soul Infusion** | Transfer souls between weapons | Enabled |
\n| **Purification Altar** | Remove curse, keep some power | Enabled |
\n| **Kill Streaks** | Chain kills for multipliers | Enabled |
\n| **Soul Types** | Different mobs give different bonuses | Enabled |
\n| **Legendary Awakening** | Transform into unique legendaries | Enabled |
\n| **Soul Resonance** | Nearby soul weapons interact | Enabled |
\n| **Leaderboards** | Competitive rankings | Enabled |<\/p>\n
Technical Features<\/p>\n
| Feature | Description |
\n|———|————-|
\n| **PDC Storage** | Data stored on items (no database needed) |
\n| **SQLite\/MySQL** | Optional database for stats\/leaderboards |
\n| **Full API** | Developer API with custom events |
\n| **PlaceholderAPI** | Full placeholder support |
\n| **Vault Integration** | Economy support for features |
\n| **WorldGuard** | Region protection compatibility |
\n| **Async Operations** | Database operations are async |
\n| **Performance Optimized** | Efficient event handling |<\/p>\n
—<\/p>\n
\ud83d\udcda Detailed Feature Documentation<\/p>\n
1. Soul Collection System<\/p>\n
How It Works
\nWhen you kill an entity while holding a valid soul weapon, you have a chance to absorb their soul. The soul is permanently bound to that weapon until extracted or lost.<\/p>\n
Configuration Options
\n“`yaml
\nsouls:
\n max-souls: 100 Maximum souls per weapon
\n damage-per-soul: 0.5 Damage increase per soul
\n player-kills-only: false Only count player kills
\n require-pvp: false Require PvP enabled
\n blocked-gamemodes: Gamemodes that can’t gain souls
\n – CREATIVE
\n – SPECTATOR
\n“`<\/p>\n
Soul Gain Formula
\n“`
\nBase Souls = 1 (per kill)
\nStreak Multiplier = varies (1.0x – 3.0x)
\nBounty Multiplier = 2.0x (if target was bounty)
\nBounty Bonus = +5 (flat bonus for bounty kills)
\nStolen Souls = 25% of victim’s weapon souls<\/p>\n
Total Souls = (Base \u00d7 Streak \u00d7 Bounty) + Bounty Bonus + Stolen
\n“`<\/p>\n
—<\/p>\n
2. Curse System (Durability Penalty)<\/p>\n
How It Works
\nEach soul on your weapon increases durability consumption. At high soul counts, your weapon breaks extremely fast.<\/p>\n
Durability Formula
\n“`
\nDurability Lost = Base Damage \u00d7 (1 + (Souls \u00d7 Multiplier))<\/p>\n
Example with 50 souls and 0.15 multiplier:
\nDurability Lost = 1 \u00d7 (1 + (50 \u00d7 0.15)) = 8.5x normal
\n“`<\/p>\n
Configuration Options
\n“`yaml
\ncurse:
\n enabled: true
\n durability-multiplier-per-soul: 0.15
\n instant-break-at-max: true<\/p>\n
Alternative: Custom thresholds
\n custom-durability:
\n enabled: false
\n thresholds:
\n 10: 2 2x at 10 souls
\n 25: 4 4x at 25 souls
\n 50: 8 8x at 50 souls
\n 100: 9999 Instant break
\n“`<\/p>\n
—<\/p>\n
3. Mending Restriction<\/p>\n
How It Works
\nAt a configurable soul threshold, the mending enchantment stops working. The curse is too powerful for mending to repair.<\/p>\n
Options
\n– **BLOCK**: Mending stops working but stays on the item
\n– **REMOVE**: Mending is forcibly removed from the item<\/p>\n
Configuration
\n“`yaml
\nmending:
\n enabled: true
\n disable-threshold: 25 Souls needed to block mending
\n action: “BLOCK” “BLOCK” or “REMOVE”
\n prevent-application: true Prevent adding mending via anvil
\n“`<\/p>\n
—<\/p>\n
4. Soul Tiers & Abilities<\/p>\n
Tier Progression<\/p>\n
| Tier | Souls Required | Name | Ability |
\n|——|—————-|——|———|
\n| 1 | 10 | Awakened | Lifesteal (15% heal) |
\n| 2 | 25 | Empowered | Speed II on kill (5s) |
\n| 3 | 50 | Ascended | AOE damage on kill (4 damage, 3.5 radius) |
\n| 4 | 100 | LEGENDARY | 20% lightning strike chance |<\/p>\n
Ability Details<\/p>\n
**Lifesteal (Tier 1)**
\n– Heals player for percentage of damage dealt
\n– Works on every hit
\n– Configurable percentage<\/p>\n
**Speed on Kill (Tier 2)**
\n– Grants Speed potion effect after kills
\n– Configurable level and duration
\n– Stacks refresh duration<\/p>\n
**AOE Damage (Tier 3)**
\n– Deals damage to nearby enemies on kill
\n– Creates particle explosion
\n– Configurable radius and damage<\/p>\n
**Lightning Strike (Tier 4)**
\n– Chance to strike lightning on hit
\n– Can deal real damage or just visual
\n– Configurable chance<\/p>\n
—<\/p>\n
5. Soul Decay<\/p>\n
How It Works
\nWeapons “hunger” for souls. If you don’t feed them with kills, they lose souls over time.<\/p>\n
Configuration
\n“`yaml
\nsoul-decay:
\n enabled: true
\n check-interval: 60 Check every 60 minutes
\n decay-amount: 1 Lose 1 soul per check
\n only-while-online: true Only decay when holding player is online
\n decay-threshold: 5 Don’t decay below 5 souls
\n grace-period: 120 2 hour grace after last kill
\n“`<\/p>\n
Decay Prevention
\n– Kill enemies regularly to reset the timer
\n– Players with `ultimatesouls.bypass.decay` never decay
\n– Weapons below threshold don’t decay<\/p>\n
—<\/p>\n
6. Soul Whispers<\/p>\n
How It Works
\nYour weapon develops personality! It sends you messages based on how many souls it contains.<\/p>\n
Message Examples<\/p>\n
| Soul Count | Example Messages |
\n|————|——————|
\n| 5+ | “I hunger for more…”, “Feed me…” |
\n| 10+ | “We grow stronger together…” |
\n| 25+ | “Their screams fuel me…”, “I taste their fear…” |
\n| 50+ | “We are becoming one…”, “Your hand, my blade…” |
\n| 75+ | “BLOOD. SOULS. POWER.” |
\n| 100+ | “I AM ETERNAL”, “THEY WILL ALL FALL” |<\/p>\n
Kill Whispers
\n50% chance on kill to receive messages like:
\n– “Yes… YES!”
\n– “Another offering…”
\n– “Their soul is MINE!”<\/p>\n
—<\/p>\n
7. Soul Shatter<\/p>\n
How It Works
\nWhen a high-soul weapon breaks, it doesn’t go quietly. It explodes!<\/p>\n
Shatter Effects
\n1. **Explosion**: Visual explosion at weapon location
\n2. **Wielder Damage**: Player takes damage (configurable)
\n3. **Soul Scatter**: Souls drop as collectible fragments
\n4. **Nearby Alert**: Players nearby see a message<\/p>\n
Soul Fragments
\n– Drop as glowing items
\n– Can be picked up by anyone
\n– Used with Soul Infusion system
\n– Despawn after configurable time<\/p>\n
—<\/p>\n
8. Corruption Effects<\/p>\n
Effect Progression<\/p>\n
| Effect | Souls Required | Description |
\n|——–|—————-|————-|
\n| Hunger Drain | 25 | Slowly lose food |
\n| Blindness Flicker | 50 | Brief blindness moments |
\n| Wither Aura | 75 | Smoke particles around you |
\n| Soul Sounds | 100 | Eerie ambient sounds |
\n| Slowness | 150 | Constant slowness effect |
\n| Nausea | 200 | Random nausea episodes |<\/p>\n
Bypass
\nPlayers with `ultimatesouls.bypass.corruption` are immune.<\/p>\n
—<\/p>\n
9. Soul Instability<\/p>\n
How It Works
\nAt 50+ souls, weapons become unstable. Each hit has a chance to “lash out” against the wielder.<\/p>\n
Lashout Effects
\n– **Damage**: Player takes 3 damage
\n– **Lightning**: Visual lightning effect
\n– **Particles**: Soul fire burst
\n– **Sound**: Thunder crack<\/p>\n
Chance Calculation
\n“`
\nChance = Base (2%) + (Souls \u00d7 0.1%)<\/p>\n
At 50 souls: 2% + 5% = 7%
\nAt 100 souls: 2% + 10% = 12%
\n“`<\/p>\n
—<\/p>\n
10. Bounty System<\/p>\n
How It Works
\nPlayers wielding weapons with 30+ souls become “bounty targets”. Other players are notified and rewarded for hunting them.<\/p>\n
Features
\n– **Announcement**: Server-wide broadcast when someone becomes bounty
\n– **Glowing Effect**: Bounty targets glow red
\n– **Particle Trail**: Flame particles follow bounty targets
\n– **Rewards**: 2x souls + 5 bonus for killing bounties<\/p>\n
Compass Tracking
\nPlayers can use a compass to track the nearest bounty target (optional feature).<\/p>\n
—<\/p>\n
11. Soul Stealing<\/p>\n
How It Works
\nWhen you kill a player who has a soul weapon equipped, you steal some of their souls!<\/p>\n
Configuration
\n“`yaml
\nsoul-stealing:
\n enabled: true
\n steal-percentage: 0.25 Steal 25% of their souls
\n minimum-victim-souls: 5 Victim needs at least 5 souls
\n max-steal-per-kill: 10 Maximum 10 souls per kill
\n require-weapon-equipped: true Victim must hold weapon
\n“`<\/p>\n
—<\/p>\n
12. Revenge Mark System<\/p>\n
How It Works
\nWhen killed by someone, you receive a “revenge mark” giving you bonus damage against them.<\/p>\n
Features
\n– **Damage Bonus**: +20% damage against your killer
\n– **Duration**: 30 minutes
\n– **Stacking**: Up to 3 stacks (+30% total with stacking)
\n– **Satisfaction**: Special message when you get revenge<\/p>\n
—<\/p>\n
13. Nemesis System<\/p>\n
How It Works
\nYour weapon remembers victims. Kill the same player repeatedly for increasing damage bonuses!<\/p>\n
Damage Scaling
\n“`
\nBonus = Kills \u00d7 5% (capped at 50%)<\/p>\n
Kill count 1: +5%
\nKill count 5: +25%
\nKill count 10+: +50% (max)
\n“`<\/p>\n
Lore Display
\nWeapons show “Blood-Sworn Enemies” in lore with kill counts.<\/p>\n
—<\/p>\n
14. Cursed Visual Effects<\/p>\n
Effect Progression<\/p>\n
| Souls | Effects |
\n|——-|———|
\n| 10 | Red dust particles |
\n| 25 | Flame particles, glowing |
\n| 50 | Soul fire, enchant glow |
\n| 75 | Soul particles, smoke, player aura |
\n| 100 | Intense particles, lightning crackles |<\/p>\n
—<\/p>\n
15. Dynamic Weapon Naming<\/p>\n
Name Progression<\/p>\n
| Souls | Name Format |
\n|——-|————-|
\n| 0 | Original name |
\n| 10 | Bloodied {name} |
\n| 25 | Crimson {name} |
\n| 50 | Soulbound {name} |
\n| 75 | {name} of Slaughter |
\n| 100 | Soulreaver |
\n| 150+ | Random legendary name |<\/p>\n
Legendary Names Pool
\n– Eternal Reaper
\n– Voidbringer
\n– Bloodmoon’s Edge
\n– Shadowfang
\n– Damnation
\n– Soulrender
\n– Oblivion<\/p>\n
—<\/p>\n
16. Kill Announcements<\/p>\n
Milestone Broadcasts<\/p>\n
| Souls | Announcement | Effects |
\n|——-|————–|———|
\n| 10 | “{player}’s weapon has claimed its 10th victim!” | Broadcast |
\n| 25 | “{player}’s weapon bathes in 25 souls!” | Broadcast + Sound |
\n| 50 | “{player}’s weapon ascends with 50 souls!” | Broadcast + Title |
\n| 100 | “LEGENDARY WEAPON FORGED! {player} reaches 100 SOULS!” | Everything + Firework |<\/p>\n
—<\/p>\n
17. Soul Extraction<\/p>\n
How It Works
\nExtract souls from your weapon into portable “Soul Fragments” that can be traded or saved.<\/p>\n
Process
\n1. Hold your soul weapon
\n2. Use `\/us extract` command
\n3. Pay entropy tax (30% souls lost)
\n4. Receive Soul Fragment item<\/p>\n
Fragment Item
\n– Material: Echo Shard
\n– Glowing effect
\n– Shows soul count in lore
\n– Can be infused into other weapons<\/p>\n
—<\/p>\n
18. Soul Infusion<\/p>\n
How It Works
\nRight-click a soul fragment on a weapon to transfer souls.<\/p>\n
Mechanics
\n– **Efficiency**: Only 75% of fragment souls transfer
\n– **Limit**: Maximum 50 infused souls per weapon
\n– **Stacking**: Can infuse multiple times up to limit<\/p>\n
—<\/p>\n
19. Purification Altar<\/p>\n
How It Works
\nBuild a multiblock altar to remove the curse from your weapon while keeping some power.<\/p>\n
Structure
\n“`
\n [S] [S]
\n | \/
\n [C]–[E]–[C]
\n \/ |
\n [S] [S]<\/p>\n
E = Enchanting Table (center, interact here)
\nC = Crying Obsidian (4 pieces)
\nS = Soul Campfire (4 pieces)
\n“`<\/p>\n
Requirements
\n– 16 Diamonds
\n– 1 Nether Star
\n– 1 Totem of Undying
\n– 30 seconds ritual time<\/p>\n
Results
\n– **Soul Retention**: Keep 50% of damage bonus
\n– **Curse Removal**: No more durability penalty
\n– **Corruption Clear**: No more negative effects
\n– **Legendary Lost**: Removes legendary status<\/p>\n
—<\/p>\n
20. Kill Streaks<\/p>\n
Streak Multipliers<\/p>\n
| Streak | Multiplier | Message |
\n|——–|————|———|
\n| 3 | 1.5x | KILLING SPREE! |
\n| 5 | 2.0x | RAMPAGE! |
\n| 7 | 2.5x | UNSTOPPABLE! |
\n| 10 | 3.0x | GODLIKE! |<\/p>\n
Mechanics
\n– **Timeout**: 60 seconds between kills
\n– **Reset**: Death resets streak
\n– **Action Bar**: Shows current streak and multiplier<\/p>\n
—<\/p>\n
21. Soul Types<\/p>\n
Mob Soul Effects<\/p>\n
| Mob | Drop Rate | Max | Effect |
\n|—–|———–|—–|——–|
\n| Player | 100% | \u221e | +0.5 damage per soul |
\n| Zombie | 5% | 20 | +2% lifesteal per soul |
\n| Skeleton | 4% | 15 | +10% projectile damage per soul |
\n| Creeper | 3% | 10 | +5% explosion resistance per soul |
\n| Enderman | 6% | 12 | +1% teleport chance per soul |
\n| Blaze | 5% | 15 | +1s fire aspect per soul |
\n| Wither Skeleton | 2% | 10 | +2% wither chance per soul |
\n| Warden | 80% | 3 | +5% sonic boom chance per soul |
\n| Ender Dragon | 100% | 1 | Dragon breath AOE ability |
\n| Wither | 100% | 1 | Wither aura ability |<\/p>\n
—<\/p>\n
22. Legendary Awakening<\/p>\n
Requirements
\n– 100+ souls on weapon
\n– Beacon altar structure
\n– Sacrifice materials<\/p>\n
Altar Structure
\n“`
\n [N] [N] [N]
\n [N] [B] [N]
\n [N] [N] [N]
\n |
\n [N] (below)<\/p>\n
B = Beacon (center)
\nN = Netherite Block (9 total)
\n“`<\/p>\n
Sacrifices Required
\n– 3 Nether Stars
\n– 1 Dragon Egg
\n– 2 Totems of Undying<\/p>\n
Available Legendaries<\/p>\n
**Shadowfang**
\n– Ability: Shadow Step
\n– Effect: 3 seconds invisibility on kill
\n– Damage Multiplier: 1.5x<\/p>\n
**Bloodmoon’s Edge**
\n– Ability: Blood Frenzy
\n– Effect: +10% damage per kill (stacks 5x, 10s)
\n– Damage Multiplier: 1.3x<\/p>\n
**Voidbringer**
\n– Ability: Void Rift
\n– Effect: 20% chance AOE void damage on kill
\n– Damage Multiplier: 1.4x<\/p>\n
—<\/p>\n
23. Soul Resonance<\/p>\n
Modes<\/p>\n
**BUFF Mode** (Default)
\n– Nearby soul weapons strengthen each other
\n– +5% damage per nearby weapon (max +25%)<\/p>\n
**CONFLICT Mode**
\n– Nearby soul weapons weaken each other
\n– -10% damage per nearby weapon (max -40%)<\/p>\n
**DYNAMIC Mode**
\n– Higher-soul weapon drains from lower
\n– Dominant weapon: +15% buff
\n– Submissive weapon: -10% debuff<\/p>\n
—<\/p>\n
24. Leaderboards<\/p>\n
Types
\n1. **Weapon Souls**: Most souls on a single weapon
\n2. **Total Souls**: Total souls ever collected
\n3. **Kill Streaks**: Best kill streak achieved<\/p>\n
Weekly Rewards (Optional)
\n“`yaml
\nrewards:
\n 1st: 64 Diamonds, 16 Netherite
\n 2nd: 32 Diamonds, 8 Netherite
\n 3rd: 16 Diamonds, 4 Netherite
\n“`<\/p>\n
\ud83d\udce5 Installation Guide<\/p>\n
Requirements<\/p>\n
| Requirement | Version |
\n|————-|———|
\n| Server | Paper 1.21 – 1.21.11 |
\n| Java | 21 or higher |
\n| RAM | 512MB+ recommended |<\/p>\n
Optional Dependencies<\/p>\n
| Plugin | Purpose |
\n|——–|———|
\n| Vault | Economy for extraction costs |
\n| PlaceholderAPI | Placeholder support |
\n| WorldGuard | Region protection |<\/p>\n
Installation Steps<\/p>\n
Step 1: Download
\nDownload `UltimateSouls-1.0.0.jar` from the releases page.<\/p>\n
Step 2: Install
\nPlace the JAR file in your server’s `plugins` folder.<\/p>\n
Step 3: Restart
\nRestart your server (not reload).<\/p>\n
Step 4: Configure
\nEdit `plugins\/UltimateSouls\/config.yml` to your preferences.<\/p>\n
Step 5: Reload
\nUse `\/us reload` to apply configuration changes.<\/p>\n
—<\/p>\n
\ud83d\ude80 Quick Start Guide<\/p>\n
For Server Owners<\/p>\n
Minimal Setup (Use Defaults)
\n1. Install plugin
\n2. Restart server
\n3. Done! All features enabled with balanced defaults<\/p>\n
Recommended Customization
\n1. Adjust `max-souls` based on server style
\n2. Set `damage-per-soul` for desired power level
\n3. Configure `bounty-threshold` for your player count
\n4. Customize announcement messages<\/p>\n
PvP Server Settings
\n“`yaml
\nsouls:
\n player-kills-only: true
\n max-souls: 150<\/p>\n
soul-stealing:
\n enabled: true
\n steal-percentage: 0.30<\/p>\n
soul-bounty:
\n enabled: true
\n bounty-threshold: 25
\n“`<\/p>\n
PvE Server Settings
\n“`yaml
\nsouls:
\n player-kills-only: false
\n max-souls: 100<\/p>\n
soul-types:
\n enabled: true<\/p>\n
soul-decay:
\n enabled: false Less punishing for casual play
\n“`<\/p>\n
For Players<\/p>\n
Getting Started
\n1. Get a sword or axe
\n2. Kill mobs or players
\n3. Watch souls accumulate
\n4. Enjoy increased damage!<\/p>\n
Tips
\n– **Extract souls** before weapon breaks to save them
\n– **Purify** when you reach max souls
\n– **Watch durability** – high souls = fast breaking
\n– **Hunt bounties** for massive soul gains<\/p>\n
—<\/p>\n
\ud83d\udcbb Complete Command Reference<\/p>\n
Player Commands<\/p>\n
| Command | Description | Permission | Admin Commands<\/p>\n | Command | Description | Permission | Command Aliases —<\/p>\n \ud83d\udd10 Permission Reference<\/p>\n Basic Permissions<\/p>\n | Permission | Description | Default | Admin Permissions<\/p>\n | Permission | Description | Default | Bypass Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n \u2699\ufe0f Configuration Guide<\/p>\n Configuration File Location Configuration Sections<\/p>\n Core Settings Soul Settings Weapon Settings Feature Toggles soul-decay: soul-whispers: Set to false to disable any feature Storage Settings sqlite: mysql: —<\/p>\n \ud83c\udfd7\ufe0f Multiblock Structures<\/p>\n Purification Altar<\/p>\n Visual Layout Materials Building Instructions —<\/p>\n Legendary Awakening Altar<\/p>\n Visual Layout Side View: Materials Building Instructions —<\/p>\n PlaceholderAPI Placeholders<\/p>\n | Placeholder | Description | —<\/p>\n \u2753 Frequently Asked Questions<\/p>\n General Questions<\/p>\n **Q: Does this work on Spigot?** **Q: Will my weapons lose data on server restart?** **Q: Can I disable specific features?** **Q: Does this work in creative mode?** —<\/p>\n Technical Questions<\/p>\n **Q: How is data stored?** **Q: Is it async?** **Q: Will it lag my server?** **Q: Can I use MySQL?** —<\/p>\n Gameplay Questions<\/p>\n **Q: Can I transfer souls between weapons?** **Q: How do I remove the curse?** **Q: Why does my mending not work?** **Q: How do I become legendary?** —<\/p>\n Troubleshooting<\/p>\n **Q: Souls aren’t being collected!** **Q: Config changes don’t apply!** **Q: Getting errors in console!** \ud83d\ude4f Credits & Support<\/p>\n Author Support Special Thanks License \ud83c\udfae Thank You for Using UltimateSouls!<\/p>\n **Made with \u2764\ufe0f by geturplugins**<\/p>\n  When you kill your enemies you capture their souls and become strong ……<\/p>\n","protected":false},"featured_media":161594,"template":"","meta":{"_minecraft_slug":"ultimatesouls","_minecraft_project_id":"5KGB0Zpc","_minecraft_author":"geturplugins","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":12,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ultimatesouls.zip","_minecraft_size_bytes":382873,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:01:12.798983Z","_minecraft_date_created":"2026-04-11T02:46:30.188663Z","_minecraft_date_modified":"2026-03-22T05:35:58.874076Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ultimatesouls","_minecraft_icon_attachment_id":161594,"_minecraft_imported_at":"2026-06-09T15:33:06+00:00","_minecraft_import_hash":"7d413028b2e50e38f7803da4e718f542","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,122,137,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-161593","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-magic","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/us help` | Display help menu | `ultimatesouls.use` |
\n| `\/us info` | View held weapon’s soul info | `ultimatesouls.info` |
\n| `\/us stats` | View your statistics | `ultimatesouls.stats` |
\n| `\/us stats
\n| `\/us top` | View weapon souls leaderboard | `ultimatesouls.leaderboard` |
\n| `\/us top total` | View total souls leaderboard | `ultimatesouls.leaderboard` |
\n| `\/us top streak` | View kill streak leaderboard | `ultimatesouls.leaderboard` |
\n| `\/us extract` | Extract souls from held weapon | `ultimatesouls.extract` |<\/p>\n
\n|———|————-|————|
\n| `\/us reload` | Reload configuration | `ultimatesouls.reload` |
\n| `\/us set
\n| `\/us set
\n| `\/us give
\n| `\/us give
\n| `\/us clear` | Clear souls from held weapon | `ultimatesouls.clear` |
\n| `\/us clear
\n– `\/ultimatesouls`
\n– `\/us`
\n– `\/souls`
\n– `\/soulbound`
\n– `\/soul`<\/p>\n
\n|————|————-|———|
\n| `ultimatesouls.use` | Basic plugin usage, soul collection | `true` |
\n| `ultimatesouls.info` | View weapon information | `true` |
\n| `ultimatesouls.stats` | View personal statistics | `true` |
\n| `ultimatesouls.stats.others` | View other players’ stats | `op` |
\n| `ultimatesouls.leaderboard` | View leaderboards | `true` |
\n| `ultimatesouls.extract` | Extract souls from weapons | `true` |
\n| `ultimatesouls.legendary` | Awaken legendary weapons | `true` |
\n| `ultimatesouls.purify` | Use purification altars | `true` |
\n| `ultimatesouls.infuse` | Infuse soul fragments | `true` |<\/p>\n
\n|————|————-|———|
\n| `ultimatesouls.admin` | All admin commands | `op` |
\n| `ultimatesouls.reload` | Reload configuration | `op` |
\n| `ultimatesouls.set` | Set weapon souls | `op` |
\n| `ultimatesouls.give` | Give souls to weapons | `op` |
\n| `ultimatesouls.clear` | Clear weapon souls | `op` |
\n| `ultimatesouls.extract.others` | Extract from others’ weapons | `op` |<\/p>\n
\n|————|————-|———|
\n| `ultimatesouls.bypass` | All bypass permissions | `false` |
\n| `ultimatesouls.bypass.gain` | Others can’t gain souls from killing you | `false` |
\n| `ultimatesouls.bypass.curse` | Immune to durability curse | `false` |
\n| `ultimatesouls.bypass.mending` | Mending always works | `false` |
\n| `ultimatesouls.bypass.corruption` | No corruption effects | `false` |
\n| `ultimatesouls.bypass.decay` | Souls never decay | `false` |
\n| `ultimatesouls.bypass.bounty` | Never become bounty target | `false` |
\n| `ultimatesouls.bypass.instability` | No weapon instability | `false` |<\/p>\n
\n`plugins\/UltimateSouls\/config.yml`<\/p>\n
\n“`yaml
\nprefix: “&8[&9B59B6UltimateSouls&8] ”
\ndebug: false
\n“`<\/p>\n
\n“`yaml
\nsouls:
\n max-souls: 100
\n damage-per-soul: 0.5
\n player-kills-only: false
\n require-pvp: false
\n blocked-gamemodes:
\n – CREATIVE
\n – SPECTATOR
\n“`<\/p>\n
\n“`yaml
\nweapons:
\n enabled-materials:
\n – DIAMOND_SWORD
\n – NETHERITE_SWORD
\n … etc
\n overrides:
\n NETHERITE_SWORD:
\n max-souls: 150
\n damage-per-soul: 0.75
\n“`<\/p>\n
\nEvery extended feature has `enabled: true\/false`:
\n“`yaml
\nsoul-tiers:
\n enabled: true<\/p>\n
\n enabled: true<\/p>\n
\n enabled: true<\/p>\n
\n“`<\/p>\n
\n“`yaml
\nstorage:
\n type: “PDC” PDC, SQLITE, or MYSQL<\/p>\n
\n file: “ultimatesouls_data.db”<\/p>\n
\n host: “localhost”
\n port: 3306
\n database: “ultimatesouls”
\n username: “root”
\n password: “”
\n“`<\/p>\n
\n“`
\nTop View:
\n [S] [S]
\n | \/
\n [C]–[E]–[C]
\n \/ |
\n [S] [S]
\n“`<\/p>\n
\n| Block | Material | Count |
\n|——-|———-|——-|
\n| E | Enchanting Table | 1 |
\n| C | Crying Obsidian | 4 |
\n| S | Soul Campfire | 4 |<\/p>\n
\n1. Place Enchanting Table in center
\n2. Place Crying Obsidian on N\/S\/E\/W sides
\n3. Place Soul Campfires in corners
\n4. Shift+Right-click Enchanting Table with soul weapon<\/p>\n
\n“`
\nTop View:
\n[N] [N] [N]
\n[N] [B] [N]
\n[N] [N] [N]<\/p>\n
\n [B]
\n [N]
\n“`<\/p>\n
\n| Block | Material | Count |
\n|——-|———-|——-|
\n| B | Beacon | 1 |
\n| N | Netherite Block | 9 |<\/p>\n
\n1. Place Netherite Block as base (below beacon)
\n2. Place Beacon on top
\n3. Surround beacon with 8 Netherite Blocks
\n4. Shift+Right-click Beacon with 100+ soul weapon
\n5. Wait 60 seconds for awakening<\/p>\n
\n|————-|————-|
\n| `%ultimatesouls_souls%` | Souls on held weapon |
\n| `%ultimatesouls_max_souls%` | Max souls for weapon |
\n| `%ultimatesouls_tier%` | Current tier name |
\n| `%ultimatesouls_tier_number%` | Current tier number |
\n| `%ultimatesouls_total_collected%` | Total souls collected |
\n| `%ultimatesouls_total_kills%` | Total kills |
\n| `%ultimatesouls_best_streak%` | Best kill streak |
\n| `%ultimatesouls_current_streak%` | Current streak |
\n| `%ultimatesouls_is_bounty%` | “true” or “false” |
\n| `%ultimatesouls_is_legendary%` | “true” or “false” |
\n| `%ultimatesouls_legendary_type%` | Legendary name or empty |
\n| `%ultimatesouls_rank_souls%` | Leaderboard rank |
\n| `%ultimatesouls_rank_streak%` | Streak rank |
\n| `%ultimatesouls_damage_bonus%` | Bonus damage value |<\/p>\n
\nA: No, UltimateSouls requires Paper or a Paper fork (Purpur, Pufferfish).<\/p>\n
\nA: No, all data is stored persistently using PDC (on the item itself).<\/p>\n
\nA: Yes, every feature has `enabled: true\/false` in config.<\/p>\n
\nA: By default, creative mode is blocked. You can change this in config.<\/p>\n
\nA: Weapon data uses PersistentDataContainer (PDC), stored on the item. Player statistics use SQLite\/MySQL.<\/p>\n
\nA: Database operations are async. Event handling is sync for safety.<\/p>\n
\nA: No, the plugin is optimized. Visual effects can be disabled if needed.<\/p>\n
\nA: Yes, configure the mysql section in config.yml.<\/p>\n
\nA: Yes, use extraction then infusion.<\/p>\n
\nA: Build and use the Purification Altar.<\/p>\n
\nA: At 25+ souls, mending is blocked by the curse.<\/p>\n
\nA: Reach 100 souls, build the altar, and complete the awakening ritual.<\/p>\n
\nA: Check: valid weapon, correct world, correct gamemode, has permission.<\/p>\n
\nA: Use `\/us reload` after editing config.yml.<\/p>\n
\nA: Enable debug mode, check the error, report on Discord.
\n—<\/p>\n
\n**geturplugins**<\/p>\n
\n– **Discord**: https:\/\/discord.gg\/xctckUQukB<\/p>\n
\n– Paper team for the amazing API
\n– Community members for feedback and suggestions<\/p>\n
\nARR License – All Rights Reserved
\n—<\/p>\n
\n**<\/p>\n","protected":false},"excerpt":{"rendered":"