Diamond Heart Guardian

Quickstart

Install the .mcaddon and activate both the Resource Pack and Behavior Pack for your world. That's all the setup required — the moment you load in, your personal Diamond Heart Guardian automatically spawns beside you. Walk up to her and press Interact / Use (right-click on Java-style controllers, or the interact button on touch/gamepad) to hear her say hello. She will follow you everywhere and immediately start defending you from hostile mobs.

Overview

Diamond Heart Guardian adds a powerful humanoid female companion that is permanently and exclusively bound to you. She appears automatically when you join, follows you across all three dimensions, fights off threats, and speaks to you with warm, wholesome dialogue. No commands, no crafting, and no taming are required.

What It Adds

How To Use

She Spawns Automatically

Every time you load a world, the mod checks whether your guardian already exists. If she doesn't, she spawns right next to you and introduces herself. You will never end up with duplicate guardians.

Following You

• She follows you within a 10-block radius, walking to keep pace.
• If you get more than 28 blocks away, she teleports to your side so she never gets left behind.
• She works in the Overworld, Nether, and The End.

Talking to Her

Walk up and press Interact / Use on her to trigger a line of dialogue. She will also speak to you automatically every so often when you're nearby, displaying her message in chat and as an action-bar message. Her dialogue is respectful, wholesome, and companion-focused.

Each guardian only responds to her own player. If another player tries to interact with your guardian, she will politely decline.

Renaming Her

You can rename your guardian using a Name Tag, just like any nameable mob.

Abilities And Mechanics

Combat — Melee

She deals 13 damage per melee hit and wields an enchanted diamond sword:

Combat — Ranged

At distances greater than 5 blocks she switches to her enchanted bow, dealing 9 damage per shot with a critical-hit particle effect on the target.

Armor

She wears a complete set of fully enchanted diamond armor, making her highly durable in prolonged fights.

Threat Detection

• She automatically targets any hostile mob within 22 blocks of you.
• When you take damage, she immediately retaliates against your attacker (dealing 16 damage) and calls out a rescue line so you know she's on it.
• She ignores other guardian companions and will not attack them.

Persistence

She is marked as a persistent entity — she will not despawn naturally under any circumstances.

No Drops

She does not drop any items when defeated, keeping the mod clean and balanced.

Progression And Strategy

• Early game: She provides an enormous safety net from the moment you spawn. Use this to explore confidently without rushing for armor or weapons.
• Multi-player worlds: Each player gets their own dedicated guardian. Guardians do not interfere with one another.
• Losing your guardian: If she is defeated, simply rejoin the world (or move far enough away and back) — the system will detect she is gone and spawn a fresh guardian for you automatically.
• Keeping her safe: Her 80 HP and fully enchanted diamond armor make her resilient, but very large groups of mobs or boss fights can overwhelm her. Try to avoid pulling entire dungeons at once.
• Spawn Egg use: The Diamond Heart Guardian Spawn Egg is available if you ever need to manually place a guardian, for example in Creative mode or for testing. The duplicate-prevention system still applies.