✨ Ghastlings

A companion mod that lets you capture, customize, and command your own elemental Ghast Soul friends.

Ghastlings introduces a brand-new companion system to Minecraft. Capture ethereal Ghast Souls, infuse them with powerful elemental essences, and watch as they loyally orbit around you—ready to defend you with their unique abilities!

🎯 What does this mod do?

Ever wanted a ghostly companion that fights by your side? One that floats behind you, reacts to enemies, and grows stronger over time? Ghastlings makes it happen.

Capture. Infuse. Command.

✨ Key Features

👻	Adorable Ghast Soul companions that follow you everywhere
⚔️	9 unique elemental affinities with distinct combat abilities
📈	Level-up system (1-5) for stronger attacks and more health
💔	Durability system—your soul can take damage and needs healing
✨	Passive regeneration when resting in your inventory
🔧	Soul Smithing Table for crafting and upgrading
🎒	Dedicated companion slot in your inventory

👻 Meet the Ghastlings

Collect all 9 elemental variants, each with their own unique style and power.

⚒️ Soul Smithing Table

The dedicated workstation for all Ghast Soul operations. Craft souls, infuse elements, and level up your companions.

🔥 Elemental Affinities

Each Ghast Soul can be infused with a unique elemental essence:

Element	Ability	Essence Location
🔥 Fire	Shoots explosive fireballs	Bastions, Nether Fortress
⚡ Lightning	Summons lightning strikes	Trial Chambers, Buried Treasure
💚 Healing	Heals you when low on health	Witch Huts, Village Temples
💨 Wind	Launches wind charge projectiles	Trial Chambers
🧊 Ice	Freezes enemies with slowness	Igloos, Snow Villages
☠️ Poison	Inflicts poison on enemies	Jungle Temples, Pillager Outposts
💧 Water	Grants water breathing & speed	Ocean Ruins, Shipwrecks
💀 Wither	Applies wither effect	Wither Skeletons
🟣 Ender	Fires homing shulker bullets	End Cities

📈 Level System

Your Ghast Soul grows stronger with each level:

Level	Powered Soul HP	Damage Multiplier
⭐ Level 1	20 HP	1.0x
⭐⭐ Level 2	25 HP	1.1x
⭐⭐⭐ Level 3	30 HP	1.2x
⭐⭐⭐⭐ Level 4	35 HP	1.3x
⭐⭐⭐⭐⭐ Level 5	40 HP	1.5x
Upgrade your souls using Soul Essence in the Soul Smithing Table!

💔 Durability System

Your Ghast Soul isn't invincible! When equipped, your companion can take damage from enemies:

📊	Durability bar shows current health
🟢→🟡→🔴	Color changes from green to red as health drops
💀	If health reaches 0, the soul dies and the item is destroyed
🩹	Unequipped souls heal 1 HP every 30 seconds
⚒️	Soul Smithing Table requires 100% health to upgrade

🔍 Category Details

👹 Soul Keepers & Soul Shards

In the depths of the Soul Sand Valley, mysterious Soul Keepers roam the foggy wasteland. Defeat them to obtain Soul Shards—a rare material essential for capturing Ghast Souls!

🎮 Compatibility


Minecraft	1.21.11
Mod Loader	Fabric
Requires	Fabric API

📥 Installation

Download and install Fabric Loader
Download Fabric API
Download Ghastlings
Place both .jar files in your mods folder
Done!

❓ FAQ

How do I get my first Ghast Soul?

Craft a Soul Vessel, then combine it with a Dried Ghast in the Soul Smithing Table.

How do I get Soul Crystal?

Smelt Soul Sand in a furnace to obtain Soul Crystal.

How do I level up my Ghast Soul?

Craft Soul Essence using Soul Shards + Soul Crystal, then combine it with your soul in the Soul Smithing Table.

Can my Ghast Soul die permanently?

Yes! If its health reaches 0, the item is destroyed. Keep it safe!

Does it work on servers?

Yes. It's a server-side mod that syncs with clients.

Is it compatible with other mods?

Yes, it should work with most mods. It uses its own custom systems.

"Even the smallest ghost can have the biggest heart."

Ghastlings – Companion Souls