---

🟢 Official Community & Support Server

This mod's official, endorsed Discord is the best place for support, updates, sneak peeks, and sharing your creations:

👉 discord.gg/HaXBGEPXyE

Come say hi. Bug reports, feature requests, and help are all welcome.

---

Shurui's DMZ Utilities is an add-on for DragonMine Z that hands server owners a full suite of creation tools styled to match DMZ's own UI. Whether you're building a story-driven RPG server or just want tougher enemies and unique bosses, everything is configured live, in-game, and saved straight into your world or DMZ's config.

---

✨ Features

🧍 Fully Configurable Custom NPCs

A single, endlessly tunable GeckoLib NPC. Right-click it with the NPC Editor to open a DMZ-styled menu and set:

• Model, texture & animations: drop your own GeckoLib models into a resource pack and pick them from a searchable dropdown
• Stats: health, melee/ki damage, defense, scale
• Saga-fighter combat (New!): pick a DMZ fighter's moveset (Frieza, Cell, Buu, Androids, Ginyu, …) and an AI tier (Simple / Tactical / Advanced): your NPCs then teleport, dodge and block like DMZ's saga fighters, firing that fighter's ki attacks, with a simple on/off ki toggle
• Abilities: regeneration, melee knockback
• Behavior: passive, wander, follower, guard, hostile, and a DMZ-style fighter AI
• Save any setup as a reusable definition and spawn unlimited copies with an item or a command

📜 Saga & Quest Editor

Build complete DMZ story sagas without touching a file. Create quests, chain them into a real branching quest tree (fork the story with "Branch after"), and set objectives (kill, collect, talk, reach a biome/dimension/structure or exact coordinates, level a skill), rewards, and start requirements. Quest-spawned enemies can be your own fully-configured custom NPCs.

🗺️ Side Quest Editor

Design standalone DMZ side quests with their own objectives, rewards, and requirements, complete with searchable quest-giver and turn-in NPC dropdowns. Perfect for optional content, daily-style tasks, and side stories. Quests and side quests can now even reward real, castable DMZ ki and strike techniques.

🧭 Quest Compass & Waypoints (New!)

A clean compass bar sits at the top of the HUD and points players toward their current DragonMine Z quest. It follows the quest's active objective automatically, targeting an exact coordinate pin or the nearest structure, biome, or enemy, and clears itself the moment the quest is completed.

• Pin coordinates in your quests: a new COORDS objective lets you drop players on an exact spot (with an arrival radius), which the compass points straight at.
• Named waypoints per player: place, clear, and list custom markers for any player with /sdu waypoint, great for events, hub directions, or guided tours.
• Dimension-aware: every marker only appears in the dimension it belongs to, so overworld pins won't clutter your compass on Namek or in Other World.
• Grab your coordinates (New!): a "Use my current coordinates" button fills a COORDS objective straight from where you're standing.
• Location-gated spawns (New!): a KILL objective can hold its enemies back until the player reaches the quest's coordinates.

🐉 Wish Editor (New!)

Edit each dragon's wish list right in-game with /sdu wish. Add, tweak, or remove wishes of every DMZ type (item, multi-item, TP, skill, command, and the reset/relocate/recustomize wishes), with searchable item and skill dropdowns. Craft your server's own reward table for summoning the dragons.

🔮 Custom Form Editor (now with a live 3D preview!)

Create brand-new transformations with custom models, auras, hair, colors, stat multipliers, drains, mastery, stacking rules, and shader outlines, all saved in DMZ's own format so they persist and work in-game.

• Live 3D preview: a rotatable character model renders right beside the editor and updates as you build: custom model, hair style & hair code, body and eye colors, the full aura (flame, ground ring, sparks and lightning) and the outline shader, exactly as they'll look in-game.
• Stacked, multi-layer auras and per-race colors for forms shared across several races (each race can have its own body/hair/eye colors).
• Custom stack form types with their own TP unlock costs and an "always available" mastery option.
• Forms can also grant auto-dodge, damage mitigation, and damage-taken stat buffs, giving each transformation real combat identity.

🧬 Custom Race Editor

Add entirely new playable races with their own stats, classes, appearance, colors, and display names, selectable at character creation. Custom racial abilities now actually work, wire them to a trigger (always-on, low HP, on-hit, on-kill, or a hotkey) and grant stat boosts, regen, restores, damage resistance, and potion effects.

---

🛠️ Getting Started

1. Grab the NPC Editor and NPC Spawner items (/give @s sdu:npc_editor).
2. Spawn an NPC, then right-click it with the NPC Editor to configure it.
3. Open the creation tools with /sdu saga, /sdu sidequest, /sdu form, /sdu race, and /sdu wish.
4. Guide players with the quest compass, or place your own markers with /sdu waypoint set <player> <name>.
5. Drop your custom models into the auto-generated resource pack and they'll appear in the editors.

All editing is operator-gated and server-validated, so these tools are safe to hand to trusted staff. Everything is dedicated-server ready: custom race/form display names and multi-layer auras are synced to players automatically, so your content shows up correctly for everyone (run the same build on the client and server).

---

📦 Requirements

Dependency	Version	Required?
Minecraft	1.20.1 (Forge)	✅ Yes
DragonMine Z	2.1.1b or newer	✅ Yes
GeckoLib	4.8.3 or newer	✅ Yes

---

---

---

Dependencies

Required

• DragonMine Z
• GeckoLib

Optional

• CustomNPCs-Unofficial
• CNPC-Geckolib-Addon