Bulletpies · wiki
Keepsake icon

Keepsake

Stamp your name on a tool and it is yours forever, wherever it ends up

ReleasedNeoForgeForgeFabric1.21.11.20.1
Status
Running on a private friends' server since v1.0
Mod loader
NeoForge, Forge, Fabric
Minecraft
1.21.1, 1.20.1
Who installs it
Everyone on the server needs it

What it is

Six people share one base and one messy tool chest, and nobody knows whose Fortune III pickaxe is whose. Keepsake gives you a cheap crafting item called a Claim Stamp: put it in a crafting grid with any tool and you get the identical tool back (same durability, same enchantments) now carrying one extra line in its tooltip that says it belongs to you. That is the whole advertised mod. It is also not quite the whole mod, because a claimed tool keeps working for you after you give it away.

For a week it is just tidy. You stamp your pickaxe, your friend stamps her elytra, the tool chest stops being an argument, and the little gray line under the enchantments is quietly satisfying in the way a name written inside a coat is. Then you notice that a claim never washes off, not in an anvil, not in a grindstone, not by repairing the thing with a second one, and that the mod's own store page ends a paragraph about generosity with the words "No spoilers." And you look at your fully-enchanted spare pickaxe, and at your friend who keeps borrowing tools, and you start thinking about it.

👥 Playing with friends

Built for shared servers; the hidden half only fires when someone else holds your tool

⚠️ Before you install

  • Updating from an older version? Delete the old jar first. The file names changed, and two Keepsake jars in one mods folder is a duplicate-mod-id crash.
  • The tithe is enabled by default at ten percent. Read the config before putting this on a server whose players have not agreed to be part of the joke.
  • Skim balances are held in memory only, so a server restart clears any part-accumulated amount.
  • Matching drops from vein-mining and area tools is a heuristic. It fails by skimming nothing rather than by crediting the wrong person, but it is not exact.

Your first 5 minutes

New to this mod? Do these in order and you will have seen the point of it.

  1. Craft a Claim Stamp: one paper, one gold nugget, one slime ball, shapeless.
  2. Put your favourite pickaxe and the stamp anywhere in a crafting grid.
  3. Take the result. It is the same pickaxe, and the stamp is gone.
  4. Hover it and read the new gray line: "✦ Belongs to <your name>".
  5. Try to remove the mark. There is no way to. That is the point.
  6. Stamp a second, generously enchanted tool. Give it to a friend. Wait.

How it works

The Claim Stamp

One item drives the whole mod. It is a shapeless recipe (one paper, one gold nugget, one slime ball) and it sits in the Ingredients tab in Creative. It costs about what a name tag costs, so nobody has to ration them.

Tip: Craft a stack. One stamp marks one item and is consumed doing it.

Claiming an item

Place any unstackable item and a Claim Stamp anywhere in a crafting grid and you get that exact item back: full durability or charge, every enchantment, and any anvil name preserved. The stamp is consumed. Because the mod attaches a small piece of data instead of replacing the item, it works on vanilla gear and most modded tools alike, including energy tools that have a charge bar instead of a damage bar.

Tip: If it stacks, it can't be claimed; a claimed stack would refuse to merge with unclaimed copies of itself.

The ownership line

A claimed item shows one extra line in its tooltip, in quiet gray italics: "✦ Belongs to <name>". That is the entire visible feature. No glint, no colour change, no renaming. The item looks exactly as it did.

A claim is permanent

There is no unclaim recipe; an early one was deleted on purpose. The mark survives anvils, grindstones and smithing upgrades, and it survives repairing a claimed tool with a second one in a crafting grid, which is the one route that used to strip it. Nobody can launder someone else's name off a tool.

Tip: Give a claimed tool away and it still, visibly, says your name.

The tithe: the part the store page does not mention

When a player who is not the owner mines a block with a claimed tool, and the owner is currently online, a fraction of the drops is quietly rerouted into the owner's inventory before they ever appear. The default is ten percent. There is no chat message, no particle, no sound and no log line anywhere in that code path. If the owner is offline the miner keeps one hundred percent, and machines and fake players are excluded outright.

Tip: A prank built for a private friends' server. It is on by default at 0.10; set titheRate to 0 to disable it.

How the skim is actually counted

Every eligible drop credits count times the rate to an in-memory balance kept per owner and per item type, and whole items are taken as that balance crosses one. At ten percent, the tenth iron ore always pays, rather than the mark streaking for dozens of blocks the way an independent coin flip did. Carry-over is capped at eight items so a long undelivered stretch can never turn into a visible vacuum, anything that doesn't fit in the owner's inventory is credited back and paid later, and nothing is ever deleted.

Tip: The balances live in memory only; nothing is written to the save, and a restart clears them.

Vein mining and area tools

Tools that shatter the surrounding blocks themselves report those extra blocks as though a piston broke them, with no player and no tool attached, so they used to be invisible to the skim. The mod now records who started a break and matches tool-less drops against it, requiring the same dimension, within thirty-two blocks, the same game tick, and never a drop that already names a different breaker. Anything outside that narrow window is simply not skimmed, which is the safe direction to fail in.

Server config

The file keepsake-server.toml holds three settings and is synced to clients on join. titheRate is the fraction skimmed per item, default 0.10, range 0 to 1. oreOnly, default false, restricts the skim to ore-type drops via a tag that also covers modded raw materials and gems. notifyOwner, default false, gives the owner a quiet dark-gray action-bar line like "+1 Raw Iron" each time a tithe lands.

Tip: notifyOwner is the only visible part of the siphon. Turn it on to confirm it works, then turn it back off.

Items & blocks

Claim Stamp

Claim Stamp

Marks one unstackable item as yours, permanently, and is consumed doing it. The only item the mod adds.

Where: Shapeless craft: one paper, one gold nugget, one slime ball. Found under Ingredients in Creative.

Lore

Flavour, not rules. None of this changes how the mod behaves.

A note for the generous

The mod's own store page describes Keepsake as a tidy little cosmetic thing (claim your gear, show your name, keep the peace on the server) and then adds that a claimed tool is still your keepsake after it leaves your hands. Some players, it observes, enjoy gifting a freshly claimed, fully-enchanted tool to a friend and seeing where the story goes. The paragraph ends: "No spoilers."

The folder is called Tithe

The published mod is called Keepsake and its id is keepsake. The folder it is built in is called keepsake-tithe, and the design document inside it is titled "Generous Benefactor". A tithe is a tenth part, paid to whoever the arrangement says it is owed to, forever, by people who mostly aren't consulted.

Jokes & trivia

Bits you might miss

  • The public store page and the README describe a purely cosmetic mod. The siphon is documented only under a heading that reads "Dev notes: not surfaced to players".
  • The changelog has its own recurring section title: "Not for the public page: siphon changes".
  • The one configurable output the siphon has is a dark-gray action-bar receipt that only the beneficiary can see: "+1 Raw Iron".
  • If the owner logs off, the person mining keeps everything. The arrangement politely observes office hours.
  • The nicest thing you can do on a shared server, gifting somebody a stamped and fully enchanted pickaxe, is also the profitable one.
  • Nobody can strip your name off a tool, which was originally a fairness feature.

From the workshop

  • For a whole version, shift-clicking the claim result gave back an unmarked item. Picking it up with the cursor worked fine, which is exactly why nobody noticed. The fix walks the crafter's inventory and stamps every unfinished claim it finds.
  • A crafting recipe cannot see who is crafting it, so the recipe writes a placeholder owner with a nil UUID and a separate handler overwrites it with the real name a moment later. If that handler never runs, the item just reads as unclaimed and nothing breaks.
  • A live-server complaint that the siphon "skips iron ore" turned out to be maths, not code: a per-item coin flip misses single-item drops for dozens of blocks. That report is why the deterministic ledger exists.
  • Forge on 1.20.1 has no block-drops event at all, so on that build the siphon is implemented as a global loot modifier instead: same behaviour, completely different machinery.
  • Claiming was originally gated on "has durability", which locked out every energy-powered tech-mod tool. Version 1.2.0 widened it to "doesn't stack", and Mekanism gear started working.

FAQ

Can I remove a claim?

No. There is no unclaim recipe and the mark survives anvils, grindstones, smithing and grid repair. That is deliberate.

Does it work on modded tools?

Anything that doesn't stack can be claimed, including tech-mod tools with charge bars. The mod attaches data rather than replacing the item.

A friend gave me a shiny claimed pickaxe. Should I use it?

It will work perfectly. Depending on the server's config, roughly a tenth of what you mine with it may end up in their inventory while they are online, and nothing in the game will tell you.

Do I need it on the client as well as the server?

Yes, both. The server does the claiming and the skimming; the client is what draws the ownership line in the tooltip.

How do I turn the hidden part off?

Set titheRate to 0 in keepsake-server.toml. On a dedicated server that file lives in world/serverconfig.

Crafting recipes

Crafting recipe for Claim Stamp
Claim Stamp

Get it

Status: Published or running on a live server. Safe to try.

  1. Install NeoForge, Forge, Fabric for Minecraft 1.21.1, 1.20.1. The install guide walks through this assuming no prior knowledge.
  2. Drop the mod's .jar file into your mods folder.
  3. Everyone on the server needs it.
  4. Launch the game with that loader's profile selected.

📦 Where is the file?

This wiki documents the mods; it does not host them. Builds live in the project's own repository under mc-keepsake-tithe/build/libs/.

Mod by Bulletpies. MIT licensed.

↑ Back to top · ← All mods