Veiled Soul Relic

Quickstart

1. Craft the Veiled Soul Relic — the recipe unlocks automatically when you join the world:

1. Place the crafted relic block in the world. It emits light and produces ambient particle effects.
2. For the cinematic and director tools, enter Creative mode — the Horde Marker, all Curse tools, and all Guardian attack items are Creative-only.
3. To trigger a Guardian attack, run /guardianitems give <player> (requires OP), then right-click the desired attack item in your hotbar. Effects fire instantly with no cooldown.
4. To try the Horde Marker, place it from your Creative inventory, then right-click it to open its configuration GUI.

---

Overview

Veiled Soul Relic is a cinematic and storytelling toolkit built around a dark-fantasy dungeon narrative. It provides a craftable artifact block (the Veiled Soul Relic / Heart of Denor centrepiece), decorative crystal blocks, and a suite of director-controlled tools for staging dramatic boss encounters and horde sequences — all without modifying mob AI or destroying terrain.

---

What It Adds

Blocks

Curse Tools (Creative-only, invisible in hand)

These seven items are used by directors to apply visual curse effects. Right-click to activate; Shift+right-click on the Corruption Aura Toggle to cycle through LOW / MEDIUM / HIGH intensity.

Guardian Attack Items (Creative-only, invisible in hand)

Obtained and removed exclusively via commands. Right-click the item in your hotbar to fire the attack instantly. All attacks produce cinematic particles, sounds, knockback/slowness, and a client-side screen shake.

---

How To Use

Heart of Denor

Place the block, then right-click it to step through its ceremonial activation phases. A status message is shown above your hotbar at each stage. Shift+right-click at any time to begin the shutdown sequence. Black Crystals placed nearby will automatically link to the core and begin firing dark beams at it once activated.

Horde Marker

Place from the Creative inventory. Right-click (while in Creative) to open the configuration screen. From there you can:

• Set the marker name
• Adjust charge distance (how close players must be before the horde activates)
• Toggle safety mode

The marker is invisible in the world — only its hitbox is present — making it unobtrusive in cinematic builds.

Curse Tools

Obtain from the Creative inventory. All curse tools are invisible while held. Right-click any curse item to fire its effect at or around your current position. For the Corruption Aura Toggle, Shift+right-click to step through LOW → MEDIUM → HIGH intensity cycles on yourself.

The Curse Smoke Trail runs continuously while enabled; right-click again to toggle it off. Soul-fire blocks it leaves behind are temporary.

Guardian Attack Items

Giving items (OP required):

/guardianitems give <player>
/guardianitems clear <player>

Once a player has the items, place the desired attack in the hotbar and right-click to trigger it. Attacks fire with no cooldown, so a director can chain them click-by-click. All effects are processed server-side, meaning every player in range sees them simultaneously.

---

Crafting And Obtaining

Veiled Soul Relic Block

The recipe is automatically unlocked for all players upon joining the world.

All Other Items and Blocks

The Heart of Denor, Black Crystal, Horde Marker, all Curse tools, and all Guardian attack items are Creative-mode only. Obtain them from the Creative inventory or use /guardianitems give for the Guardian attack set.

---

Abilities And Mechanics

Screen Shake

Guardian attacks trigger a client-side screen shake visible to all nearby players. This can be tuned or disabled in the mod's config:

• screenShakeEnabled — toggle shake on/off
• screenShakeMultiplier — scale the intensity

Effect Scaling

All Guardian attack areas can be resized in config without altering their cinematic safety (no block destruction):

No Terrain Destruction

All Guardian attacks are flagged non-destructive — blocks are never broken or altered by any effect.

Black Crystal Beaming

When Black Crystals are placed around the Heart of Denor and activated (by right-clicking to progress the core's state), each crystal emits a dark-purple beam toward the core and plays resonance sounds. Up to several crystals can participate simultaneously, intensifying the atmosphere.

---

Progression And Strategy

Veiled Soul Relic is designed for server events, machinima, and custom adventure maps rather than survival progression. A suggested director workflow:

1. Build your dungeon arena around the Heart of Denor block.
2. Surround the core with Black Crystals at scenic positions.
3. Place Horde Markers at entry corridors, configured with appropriate charge distances.
4. Assign a director with OP and give them the Guardian attack items via /guardianitems give.
5. During the encounter, the director right-clicks curse tools to apply visual corruption to actors, and right-clicks Guardian attack items one by one to choreograph the fight beat-by-beat.
6. Use /guardianitems clear to clean up after the scene.

The Phase 2 item (guardian_phase2) is intended as the dramatic mid-fight escalation — trigger it at the scripted turning point to visually signal to players that the encounter has intensified.