CraftLock

Overview

CraftLock is a hardcore-challenge mod built for content creators and self-imposed-challenge enjoyers. The premise is simple and brutal:

Every recipe in the game can only be crafted once. After that, it’s gone forever.

The first time you craft oak planks, sticks, a furnace, a diamond pickaxe, an Eye of Ender — that recipe locks. The next time you put the same ingredients in a crafting table, the result slot stays empty. The mod plays a denial sound, shows you the actionbar message “Already crafted Oak Planks once”, and the run continues with one fewer tool in your kit.

It covers crafting tables, the 2×2 inventory grid, furnaces, blast furnaces, smokers, campfires, smithing tables, stonecutters, and the brewing stand. Two recipes are exempt by default — Blaze Powder and Eye of Ender — because without them, you can’t finish the game.

Features

Locking

• Universal coverage — crafting table, inventory 2×2, furnace family, smithing, stonecutter, brewing stand
• Recipe-level granularity — oak_planks from logs locks separately from oak_planks from stripped logs
• Persistent across restarts — the lock list is stored in the world save and survives sessions
• Exempt list — recipes you choose stay infinite (default: blaze_powder, ender_eye)

UX polish for streaming

• Yellow chat broadcast on every first-time craft: Chompii has crafted: Iron Ingot
• Bell ping plays for all players when a new recipe is locked
• Actionbar warning + villager-no sound when a blocked craft is attempted
• Tooltip badge — locked items display a red italic Locked line with attribution: by Chompii · day 7
• Recipe-book overlay — locked recipes are highlighted with a red tint inside the recipe book
• Animated title played on /craftlock start (light-blue italic CraftLock with subtitle, plus a calm amethyst chime)

Tooling

• A full command suite for moderators / streamers (see below)
• JSON config at config/craftlock.json for sound tuning, exempt list, and brand text
• Translation support via assets/craftlock/lang/en_us.json
• SLF4J logger under the craftlock namespace

Installation

Requirements

| Component | Version |
| ————— | —————— |
| Minecraft | 1.21.11 |
| Fabric Loader | >= 0.19.2 |
| Fabric API | 0.141.4+1.21.11 |
| Java | 21 |

Steps

1. Install Fabric Loader for Minecraft 1.21.11.
2. Drop Fabric API into your mods/ folder.
3. Drop the latest craftlock-1.0.jar (from the Releases page) alongside it.
4. Launch the game. The mod will run as soon as you load a world — locking does not start until you invoke /craftlock start.

Commands

All commands require permission level gamemaster (level 2 in vanilla terms — automatically granted to the singleplayer host).

| Command | Description |
| — | — |
| /craftlock start | Begin enforcing locks. Shows the CraftLock title to all players. |
| /craftlock stop | Pause enforcement without clearing the lock list. Resume with start. |
| /craftlock status | Print run state, locked-recipe count, and exempt-recipe count. |
| /craftlock list | List every locked recipe by ID. |
| /craftlock reset | Wipe the entire lock list. Does not affect the started flag. |
| /craftlock lock <recipe> | Manually lock a recipe (useful for setting up challenges). |
| /craftlock unlock <recipe> | Manually unlock a single recipe. |

Example

> /craftlock start
[CraftLock started.]
[Title: CraftLock]
[Subtitle: Created by Chompii]

> /craftlock list
Locked recipes (3):
  - minecraft:oak_planks
  - minecraft:stick
  - minecraft:crafting_table

> /craftlock unlock minecraft:stick
Unlocked minecraft:stick

Configuration

On first launch the mod writes config/craftlock.json with the defaults below. Edit the file and restart the world to apply changes.

{
  "titleText": "CraftLock",
  "subtitleText": "Created by Chompii",
  "exemptRecipes": [
    "minecraft:blaze_powder",
    "minecraft:ender_eye"
  ],
  "craftPingVolume": 0.6,
  "craftPingPitch": 1.5,
  "startSoundVolume": 1.0,
  "startSoundPitch": 1.0,
  "blockedSoundVolume": 1.0,
  "blockedSoundPitch": 1.0
}

| Field | Type | Notes |
| — | — | — |
| titleText | string | Text shown when /craftlock start fires. |
| subtitleText | string | Subtitle paired with the title. |
| exemptRecipes | string[] | Recipe IDs that can be crafted any number of times. |
| craftPingVolume / craftPingPitch | float | Bell sound played on every first-time craft. |
| startSoundVolume / startSoundPitch | float | Amethyst chime played on /craftlock start. |
| blockedSoundVolume / blockedSoundPitch | float | Villager “no” played when a craft is blocked. |

How it works

CraftLock is built around a per-world SavedData instance that stores:

• A set of locked recipe IDs
• A metadata map: {recipe_id -> {crafter, world_day}}
• A started flag

Mixins attach to the appropriate vanilla menus and block entities:

| Class | Hook | Purpose |
| — | — | — |
| CraftingMenu | slotChangedCraftingGrid (TAIL) | Clear the result slot + send a ClientboundContainerSetSlotPacket if the matched recipe is locked. Also caches the recipe so ResultSlot.onTake can still see it after vanilla’s shift-click drain. |
| ResultSlot | onTake (HEAD) | Record the lock + broadcast. |
| AbstractFurnaceBlockEntity | canBurn (HEAD) + setRecipeUsed (HEAD) | Block smelting if locked; record on completion. |
| CampfireBlockEntity | getCookableRecipe (RETURN) + placeFood (RETURN) | Block placement if locked; record on placement. |
| SmithingMenu | createResult (TAIL) + onTake (HEAD) | Clear result if locked; record on take. |
| StonecutterMenu | setupResultSlot (TAIL) + onTake (HEAD) | Same pattern. |
| PotionBrewing | mix (RETURN) | Return the unmixed input if the output would be a locked potion variant; lock on successful brew. |
| RecipeButton | renderWidget (TAIL) — client only | Paint a red overlay on locked recipes inside the recipe book. |

State syncs to all connected clients via a craftlock:lock_list custom payload whenever the lock list changes, so tooltips and the recipe-book overlay update live.

For challenge runners

A typical run flow:

1. Create a fresh world. The lock list persists per-save, so don’t reuse old ones.
2. Run /craftlock start to begin enforcement. Until you do, the mod runs in observe-only mode.
3. Plan your path. Eye of Ender and Blaze Powder are exempt, so the End is reachable. Everything else — every single recipe — locks on first craft.
4. Use /craftlock reset between filming takes if you need to redo a segment.
5. Use /craftlock list to audit what you’ve spent.

Tip for editors: the yellow chat broadcasts (Chompii has crafted: ...) are designed to be readable in compressed YouTube footage and pair well with the bell ping for “milestone moment” cuts.

Building from source

git clone <repository-url>
cd CraftLock
./gradlew build

The compiled jar lands in build/libs/.

For development you can use:

./gradlew runClient   # launch a dev client with the mod loaded
./gradlew runServer   # launch a dedicated dev server
./gradlew genSources  # decompile Minecraft for IDE navigation

Credits

Made by Chompii.

Built on the Fabric modding toolchain. Powered by SpongePowered Mixin and MixinExtras.

License

Released under the CraftLock License — see LICENSE for the full text.

In short:

• You may use, modify, distribute, fork, repackage, and embed the mod.
• You must credit Chompii visibly in any use of the mod (video descriptions, modpack credits, derivative mod readmes, etc.).
• You may not claim to be the original author of CraftLock.
• The software is provided “as is” with no warranty.

If you’re publishing a video, a fair-use credit looks like:

“Featuring CraftLock by Chompii — github.com/Chompii/CraftLock”