logo

Craftmark lets modpack authors give blocks a different skin depending on how they were crafted — the same machine built from brass looks brass, built from steel looks steel, built normally looks normal. Per-instance, not per-block: two barrels can sit side by side wearing different skins.

Why packs want this

You've integrated recipes across mods — a storage controller crafted from Create's brass, a furnace built from Thermal's ingots. The recipes tell that story; the blocks don't. A resource pack can't help: it retextures every copy, however it was obtained. Craftmark makes the skin follow the individual crafted item:

🎒 In the inventory — and the hotbar, the cursor, the recipe book
✋ In your hand — first and third person
🧱 Placed in the world — instantly, no relog
⛏️ Broken and picked back up — the skin round-trips forever
🖼️ Ground drops, item frames, even breaking particles match

Built like an engine

Zero code for authors. A variant = one recipe line (KubeJS) + PNGs in a resource pack that mirror the original texture paths. No mapping files, no block registration.
Works on every block-entity block — barrels, chests, furnaces, and effectively every modded machine, automatically.
Mixin-free. Built entirely on official NeoForge hooks — including the model-data path that Sodium-family renderers honor. As of 1.2.0, if you are also running the Create mod, mixins are present for kinetic rendering. If you don't have Create installed, 1.2.0 will not mix anything.
Ships with a working example (craftmark:brass barrel) — one recipe script and you'll see it work in two minutes.
Variant items that don't stack with their plain counterparts, and diagnostics logging that tells you exactly how many of your pack's textures matched.

Requires: NeoForge 1.21.1, installed on client and server. Data can be applied through recipes editors like KubeJs or CraftTweaker, given out as quest rewards, or just through commands.

Optional Dependencies:

Create (1.2.0)
Jade (1.4.0)
Just Enough Items (1.4.0)

Optional dependencies add new features, but the mod works perfectly fine without them.

Permissions:

You can add this to your modpack without permission.
You can make addon mods without permission, as long as they list Craftmark as a dependency.
You absolutely cannot upload this mod's files to other websites

📚 Author Documentation

How variants work

On first launch, Craftmark creates a craftmark_variants/ folder in your Minecraft instance directory (next to mods/, config/, saves/) and seeds a ready-to-edit brass example:

craftmark_variants/
└── brass/                                   ← one folder = one variant (id: craftmark:brass)
    └── assets/minecraft/textures/block/
        ├── barrel_side.png
        ├── barrel_top.png
        ├── barrel_bottom.png
        └── barrel_top_open.png

Inside a variant folder you use the exact resource-pack layout of the original textures. brass/assets/minecraft/textures/block/barrel_side.png replaces the vanilla sprite minecraft:block/barrel_side. The rule is simply: put your PNG where the original lives, under your variant folder.

Quick start (2 minutes — no KubeJS, no textures to make)

The brass folder is already there. With cheats on, run:

/give @p minecraft:barrel[craftmark:variant="craftmark:brass"]

Place it — brass barrel. It's brass in your hand, inventory, on the ground, and in item frames; break it and the drop keeps its skin and won't stack with plain barrels. Edit the PNGs in craftmark_variants/brass/ and press F3+T to see changes live.

Make your own variant

Create a folder in craftmark_variants/ — lowercase letters, numbers, _ . -: ruby, steel, diamond… Its id becomes craftmark:<folder>.
Drop in textures, mirroring each original's path under assets/:
```
craftmark_variants/ruby/assets/refinedstorage/textures/block/controller.png
```
(overrides refinedstorage:block/controller)
F3+T to rescan — new folders are picked up without a restart.

Tag items with the id:

/give @p refinedstorage:controller[craftmark:variant="craftmark:ruby"]

Override only what you want — skip a face and it renders normally. A wrong path silently keeps the original (never magenta).
Find original paths by unzipping the source mod's jar under assets/<ns>/textures/; mirror that whole path inside your folder.
Block-shaped items reuse the block textures automatically, flat item sprites are mirrored the same way (assets/<ns>/textures/item/…).

When a face won't skin: per-block overrides (new in 1.1.0)

Most blocks skin perfectly with the folder above — mirror the texture path and you're done. But a few blocks use a shared, generic texture for one face. A classic example: a machine whose bottom is somemod:block/bottom rather than somemod:block/<that-machine>/bottom. If you mirror the path you'd expect, nothing happens — the file stitches, but no face actually uses it, so that face stays vanilla.

For those stubborn faces there's an optional shortcut — reach for it only when a face refuses to skin. Instead of hunting for the texture path, you name the block and the face directly:

craftmark_variants/<variant>/by_block/<block-namespace>/<block-path>/<face>.png

For example, to skin the Refined Storage storage monitor's stubborn bottom under the brass variant:

craftmark_variants/brass/by_block/refinedstorage/storage_monitor/bottom.png

<face> is one of:

top.png — the upward face
bottom.png — the downward face
front.png — the face the block faces (e.g. a furnace's lit face)
back.png — the face opposite the front
left.png / right.png — the left/right face as you look at the front
side.png — all four horizontal faces at once

The four horizontal faces are relative to the block's front, so the skin follows the block however it's rotated — front.png always lands on the front. A specific face (e.g. front.png) takes priority over side.png.

Good to know:

Scoped to that one block. It never bleeds onto other blocks that share the texture — and it can even give two faces that share a single texture different skins.
No path detective work. You name the face, not the underlying sprite, so shared/generic textures stop being a guessing game.
top/bottom work on every block. front/back/left/right need a block with a horizontal facing — vanilla blocks and mods that rotate via a facing or custom direction property (e.g. Refined Storage) both work; for blocks with no facing (or placed pointing up/down), use side.png.
It doesn't cover non-cube faces (insets, odd shapes) — those still use the normal folder above.
F3+T reloads it live, exactly like the normal folder.

Wiring it into recipes (KubeJS)

Commands are for testing; in a real pack you tag the crafted output so players earn the skin. In kubejs/server_scripts/:

ServerEvents.recipes(event => {
    event.shapeless(
        Item.of('refinedstorage:controller', '[craftmark:variant="craftmark:ruby"]'),
        ['refinedstorage:controller', 'mymod:ruby']
    ).id('mypack:ruby_controller');
});

Debugging your variants

Every resource (re)load logs one line per variant folder found:

craftmark: variant craftmark:brass: 4 texture(s) stitched

Count lower than expected = a path didn't match. F3+T re-runs the scan and re-reads new folders.

Future Plans

This mod will eventually be ported to recent versions like 26.1.2, but only when all major features are implemented and any bugs are fixed. An update is planned for later on that adds JEI support.

If you find a bug or have suggestions for the mod, let me know in the Curseforge comments or the Discord server. For bug reports, make sure you are on the most recent version of the mod and give me steps so I can reproduce the bug.

Crafted by JaquavionBennet & ClaudeCode Fable 5.

Craftmark: Data-Driven Texture Variants