🌟 Debug Mode Unlock 🌟

Use the original Debug Stick in Survival, Creative, and Adventure, collect it automatically or with Z, and preserve customized block states as lasting world decorations.

DEBUG STICK — PERMANENT DECOR
CHANGELOG | DEBUG MODE BRANCH UPDATE

Based on the original Debug Mode concept, this independent branch expands beyond simply exposing Minecraft's vanilla Debug World.

ADDED
• Original Debug Stick access in Survival, Creative, and Adventure, without the standard operator-permission gate.
• Automatic Debug Stick delivery when joining or respawning without one.
• A Z-key English GUI with a “Get Debug Stick” action and duplicate-inventory checks.
• Permanent decoration records for blocks successfully modified with the Debug Stick.
• Protection against normal block breaking at saved decoration positions.
• Server-side restoration of saved block states after ordinary world updates.
• Persistent per-world, per-dimension saved state data.

DESIGN DIRECTION
• The initial Debug Mode release focused on selecting the vanilla Debug World at world creation.
• Permanent Decor is the building-focused branch: edit unusual block states in ordinary worlds and keep the result.
• Distributed as its own JAR; the original Debug Mode Unlock installation is not required.

All planned features of this branch are included in this release.

DEBUG STICK — PERMANENT DECOR
A Debug Mode branch for creating lasting block-state decorations
Minecraft Java Edition 1.21.11 • Fabric

OVERVIEW
The Debug Stick is one of Minecraft's most interesting technical tools: it can switch a block between its available states without having to rebuild the surrounding structure. Debug Stick — Permanent Decor turns that idea into a practical building and decoration system. Change a placed block's state, preserve the result, and use state combinations that are normally difficult to keep in a regular world.

This is a standalone branch of the original Debug Mode project. Where the original release made the vanilla Debug World selectable during world creation, Permanent Decor brings the power of block-state experimentation into ordinary building. It does not require the original Debug Mode Unlock JAR.

FEATURES

1. THE ORIGINAL DEBUG STICK, WITH BROADER ACCESS
• Uses Minecraft's own Debug Stick rather than a replacement or imitation item.
• Works for players in Survival, Creative, and Adventure modes, without the usual Debug Stick operator-permission restriction.
• Keeps the familiar controls: left-click a block to choose a property; right-click to cycle that property's values.
• Allows builders to explore supported block properties and create unusual appearances directly in their worlds.

2. AUTOMATIC STICK DELIVERY
• Players who do not already carry a Debug Stick receive one when joining a world.
• A player who respawns without one can receive it again automatically.
• Inventory checks prevent repeated automatic copies when a stick is already present.

3. PRESS Z TO GET A DEBUG STICK
• Press Z to open a simple, English-language Debug Stick screen.
• Select “Get Debug Stick” to request the original item instantly.
• If you already have a Debug Stick in your inventory, the mod does not give you a duplicate through this action.
• The key can be changed in Minecraft's key-binding settings.

4. PERMANENT BLOCK-STATE DECORATION
• When a Debug Stick successfully changes a placed block's state, the resulting state is registered as a protected decoration.
• Normal block breaking at that protected position is blocked.
• The server checks protected positions and restores their saved states if ordinary world updates alter them.
• This is especially useful for building details with fragile, unusual, or otherwise hard-to-maintain block-state arrangements.
• Decorations are recorded by block position and dimension, so the effect belongs to the world rather than to one player's inventory.

5. SAVED ACROSS SESSIONS
• Protected state records are saved with the world in debug_decor_locks.json.
• Returning to the same world restores the decoration records.
• Different dimensions are recorded separately, allowing independent decorations in each dimension.

HOW TO USE
1. Install the JAR in your Fabric instance's mods folder, together with Fabric API.
2. Start Minecraft and enter a world in Survival, Creative, or Adventure mode.
3. Find the Debug Stick supplied in your inventory. If you need one later, press Z and choose “Get Debug Stick”.
4. Hold the stick. Left-click a suitable block to select its state property, then right-click to change that property to the desired value.
5. Once the change succeeds, the selected block position is protected and its state is remembered by the world.
6. Continue building and exploring different state combinations. Your saved decorations remain protected when you return to the world.

PROJECT GOALS — ACHIEVED
• Make the original Debug Stick practical outside its ordinary restricted use.
• Support Survival, Creative, and Adventure players.
• Provide a stick automatically when needed and a convenient Z-key retrieval screen.
• Turn edited block states into stable, persistent decorative details.
• Protect those details from normal breaking and state changes.
• Retain the decorations after leaving and reopening a world.

FROM DEBUG MODE TO PERMANENT DECOR
The first Debug Mode release unlocked access to Minecraft's existing Debug World. This branch takes a different path: instead of changing the world-type menu, it lets you create and preserve Debug Stick designs wherever you build. It is a separate release with its own purpose and can be installed without the original unlocker.

COMPATIBILITY
• Minecraft Java Edition 1.21.11
• Fabric Loader 0.19.3 or a compatible later release
• Fabric API
• Java 21 or later

No additional Debug Mode mod, armor museum, or other project is required.