Soulbound

Soulbound is a dynamic Soul Alignment system for Minecraft Fabric where players absorb soul fragments from the mobs they kill, gradually transforming how the world's creatures perceive and react to them. Kill enough zombies and the undead begin to hesitate—or flee. Slaughter Endermen and reality bends around you. Every kill shapes your identity, unlocking tiered passive effects, altering mob AI, changing villager trade prices, and eventually reaching Apex and Transcendent states of power.

Key Features

• 7 Soul Alignments — Decay, Precision, Volatility, Void, Instinct, Order, and Savagery. Each alignment is earned by killing specific mob types and grants unique passive effects, combat bonuses, and world interactions.
• 6-Tier Progression — Progress from Dormant → Fledgling → Attuned → Resonant → Apex → Transcendent, with escalating power at each stage.
• Mob Perception System — Mobs dynamically react to your alignment. Zombies hesitate to attack Decay players, Endermen become neutral toward Void players, Creepers delay their fuse for Volatility players, and more.
• Fracture System — Spreading your kills too evenly across alignments fractures your soul, inflicting escalating debuffs, reality tears that spawn hostile mobs, and visual corruption.
• Apex & Transcendent States — Reaching high alignment values unlocks powerful abilities: Void Blink teleportation, Savagery berserker healing, Order aura buffs for nearby allies, and more.
• Soul Resonance — Nearby players with the same or synergistic alignments amplify each other's power.
• Soul Echoes — Leave behind alignment-infused zones that grant effects to anyone who enters.
• Dimensional Affinity — Each alignment has a home dimension where it grows faster and grants bonus effects.
• Momentum System — Consecutive kills of the same alignment type build a streak multiplier up to 2.5x.
• Soul Whispers — Immersive alignment-themed messages appear as your power grows.
• Anti-Grinder Protection — Spatial detection and kill-window tracking prevent farming exploits.
• PvP Integration — Opposing alignments deal bonus damage to each other; synergistic alignments deal reduced damage.
• Visual Particles — Alignment-specific particles orbit players, with special effects for Apex, Transcendent, and Fractured states.
• Villager Trade Modification — Order players get discounts; Decay and Savagery players pay more.
• Persistent Data — Alignment data persists across death, dimensions, and server restarts via NBT.
• Multiplayer-Safe — Per-player alignment data works correctly on servers.
• Fully Configurable — Every threshold, multiplier, radius, and toggle is exposed in the config file.

How It Works

Soul Alignments

Every mob in Minecraft is mapped to one of seven soul alignments. When you kill a mob, you absorb its soul fragment, increasing your alignment value for that type:

Alignment Relationships

Alignments have opposing and synergistic relationships that affect gameplay:

• Synergy Bonus: Having a synergistic secondary alignment grants up to +50% effective strength.
• Conflict Penalty: Having an opposing secondary alignment reduces effective strength by up to 30%.
• Opposing Decay: Gaining alignment in one type automatically decays its opposing type by 30% of the amount gained.

Tier Progression

Your dominant alignment value determines your tier, which unlocks escalating passive effects:

Passive Effects by Alignment

Each alignment grants different stat bonuses and status effects as you progress through tiers:

Decay — The Undying

Precision — The Sharpshooter

Volatility — The Pyromaniac

Void — The Wanderer

Instinct — The Predator

Order — The Guardian

Savagery — The Berserker

Apex Abilities

At Apex tier (100+ alignment value), each alignment grants unique active abilities:

Mob Perception

Your alignment changes how mobs react to you through five mixin-driven behaviors:

Combat Damage Modifiers

The Fracture System

Spreading your kills across too many alignment types causes your soul to fracture. Fracture occurs when your top 3 alignment values are too close together.

Reality Tears

At severe fracture levels, reality tears open around you, spawning hostile mobs:

Soul Resonance

When nearby players share the same (or synergistic) dominant alignment, everyone gets a resonance bonus:

Soul Echoes

When certain conditions are met, a Soul Echo is created at your location:

Each alignment grants a different echo effect:

Dimensional Affinity

Each alignment has a home dimension where it receives bonuses:

• Home Dimension: Bonus status effects (Fire Resistance in Nether, Slow Falling + Night Vision in End, Regeneration in Overworld).
• Hostile Dimension: Occasional Weakness debuff.

Momentum System

Consecutive kills of the same alignment type build a momentum streak:

• Killing a mob of a different alignment resets the streak to 1.
• Momentum decays naturally over time.

Anti-Grinder Protection

The mod detects and penalizes mob farming:

Commands

All commands are under /soul:

Visual Indicators

Particles by State

Alignment Particles

Soul Whispers

Contextual messages appear based on your alignment:

Configuration

Config file location: .minecraft/config/soulbound.json

{
  "globalEnabled": true,
  "alignmentGainRate": 1.0,
  "alignmentDecayRate": 0.05,
  "apexThreshold": 100.0,
  "transcendentThreshold": 150.0,
  "fractureThreshold": 10.0,
  "effectStrengthMultiplier": 1.0,
  "hardcoreMultiplier": 1.5,
  "bossAlignmentMultiplier": 3.0,
  "eliteAlignmentMultiplier": 1.8,
  "grinderPenaltyFactor": 0.25,
  "grinderCooldownTicks": 100,
  "maxKillsPerTypePerWindow": 5,
  "killWindowTicks": 6000,
  "spatialGrinderRadius": 16.0,
  "spatialKillThreshold": 10,
  "spatialPenaltyFactor": 0.15,
  "decayIntervalTicks": 24000,
  "fractureDecayRate": 0.1,
  "momentumEnabled": true,
  "maxMomentumMultiplier": 2.5,
  "momentumGainPerKill": 0.1,
  "momentumDecayPerCycle": 1,
  "opposingDecayEnabled": true,
  "opposingDecayFactor": 0.3,
  "dimensionalBonusEnabled": true,
  "dimensionalOverworldBonus": 1.25,
  "dimensionalNetherBonus": 1.35,
  "dimensionalEndBonus": 1.5,
  "resonanceEnabled": true,
  "resonanceRadius": 32.0,
  "resonanceBonusPerPlayer": 0.15,
  "maxResonanceBonus": 0.6,
  "resonanceCheckInterval": 200,
  "soulEchoEnabled": true,
  "soulEchoDurationTicks": 6000,
  "soulEchoRadius": 8.0,
  "fractureSeverityMultiplier": 1.0,
  "fractureRealityTearEnabled": true,
  "fractureEffectInterval": 200,
  "particlesEnabled": true,
  "particleInterval": 40,
  "soulWhispersEnabled": true,
  "whisperCooldownTicks": 2400,
  "pvpAlignmentModifiersEnabled": true,
  "opposingPvpDamageBonus": 0.15,
  "synergyPvpDamageReduction": 0.1,
  "commandEnabled": true,
  "secondaryAlignmentEnabled": true,
  "secondaryAlignmentRatio": 0.35,
  "passiveMobFearEnabled": true,
  "passiveMobFearRadius": 8.0
}

Config Options Explained

Core Settings

Anti-Grinder

Boss & Elite

Alignment Decay

Momentum

Opposing & Synergy

Dimensional Bonus

Soul Resonance

Soul Echo

Fracture

Visual & Feedback

PvP

Mob Behavior

Mob Alignment Registry

Decay Mobs

Precision Mobs

Volatility Mobs

Void Mobs

Instinct Mobs

Order Mobs

Savagery Mobs

Multiplayer Compatibility

This mod is server-side and works on both singleplayer and multiplayer:

• Alignment data is stored per-player and persists across death via copyFrom
• Soul Resonance detects nearby aligned players for multiplayer bonuses
• PvP modifiers apply per-player alignment comparisons
• Soul Echoes affect all players who enter the zone

Data Storage

Persistent data is stored in the world save via player NBT:

Data is saved automatically when players disconnect and when the server stops. Alignment data survives player death.

Installation

1. Install Fabric Loader (0.15.6 or newer) for Minecraft 1.20.1.
2. Install Fabric API (0.92.0+1.20.1 or newer).
3. Download the mod JAR file.
4. Place the JAR into your .minecraft/mods folder (or server mods folder).
5. Launch Minecraft with the Fabric profile.

Building from Source

Clone the repository and run the Gradle build:

git clone https://github.com/AaravVishal1/SoulBound
cd soulbound
./gradlew build

The compiled JAR will be in build/libs/.

For development:

./gradlew runClient    # Run Minecraft client
./gradlew runServer    # Run dedicated server

Requirements

Troubleshooting

Alignment isn't changing when I kill mobs

1. Check that globalEnabled is true in the config.
2. Verify the mob type is registered (not all mobs grant alignment—passive mobs don't).
3. Check anti-grinder protections aren't triggering (try killing varied mobs in different locations).
4. If alignmentGainRate is set very low, increases may be imperceptible.

No passive effects are appearing

1. Your alignment value may be too low—you need at least 10 (Fledgling tier) for the first effects.
2. Check that effectStrengthMultiplier isn't set to 0.
3. Some effects are alignment-specific and conditional (e.g., Instinct effects only activate at night).

Fracture effects are too harsh

• Reduce fractureSeverityMultiplier (e.g., 0.5).
• Set fractureRealityTearEnabled to false to disable mob spawning.
• Increase fractureThreshold to make fracture harder to trigger.
• Focus your kills on one or two alignments to reduce fracture.

Mob behavior isn't changing

1. Your alignment strength may be too low—most perception changes require 25%+ of Apex threshold.
2. Verify individual toggles like passiveMobFearEnabled are true.
3. Mob perception is probabilistic—it won't trigger 100% of the time.

No particles showing

1. Check that particlesEnabled is true in the config.
2. Your alignment strength must be at least 20% for ambient particles, or 40% for visible effects.
3. Particles are server-side and should be visible to all players.

Performance issues

• Increase particleInterval and resonanceCheckInterval values.
• Reduce resonanceRadius and soulEchoRadius.
• Disable individual systems you don't want (resonanceEnabled, soulEchoEnabled, particlesEnabled).
• Increase fractureEffectInterval if fracture processing is heavy.

License

This project is licensed under the MIT License. See LICENSE for details.