KyuubiSoft Heirlooms gives weapons, bows, tools and shields a story of their own. An item remembers who forged it, who carried it, what it slew, mined or blocked, and the moments that mattered. With every count it grows more famous: its name shines green, blue and finally gold. Items earn titles, and players can show them off in a hall of fame for the whole server. If an admin switches it on, weapons also learn boons and banes from what they lived through.
- Which items. Melee weapons, bows and crossbows, pickaxes, hatchets and shields can carry a story. Armor can be switched on as well (off by default). Only items that never stack and wear down qualify; shields are the exception and need no durability.
- The start. A crafted item begins its story with its maker and the crafting day. Any other item begins with its first count and is marked as found.
- What counts. Melee weapons count creatures they slay with the killing blow, bows count creatures their arrows slay, pickaxes count ores, hatchets count tree trunks and shields count blocked hits. Armor counts hits taken. Items in the hotbar and on the tool belt both count.
- Fame. At 50, 300 and 1000 counts an item becomes Proven, Famous and Legendary (adjustable). The name shines in the colour of its fame, and fame never goes down.
- The story lives on the item. It travels with the item through drops, chests and trades. When it lands with another player, that player becomes the next owner.
- Titles. Items earn titles such as Wolfsbane or Veteran. The owner chooses which one to wear; it then becomes part of the item’s name.
- Boons and banes (admin option, off by default). Weapons and bows grow banes against creature groups they slew often, and offer a boon to choose at every fame level. They never work against players.
/ksheirloom opens the story of the item in your hand. The window follows your hand: take another item and it shows that one.
- A side panel shows the item, its fame with the count to the next level, and the key facts: origin, age, count, bosses, repairs, breaks, owners and boons.
- Six tabs: Chronicle, Prey, Titles, Boons, Owners and Hall of fame.
- Show in chat sends a short line about the item to players nearby.
- The item’s own tooltip, in the game’s own frame, shows the name with its title in the colour of its fame, the fame level and the count to the next one, the origin, the counts, the favourite prey, boons and banes and the latest moment.
- Damage, durability and rarity stay the game’s own.
- The origin and the first moment, such as the first creature slain, always stay. Of the other moments the latest seven are kept: milestones, new fame levels, titles, bosses, breaks and repairs, new owners and boons.
- The prey list counts every kind of creature the weapon slew, the most hunted first. The favourite prey is the kind it slew most often.
- Twelve built-in titles, such as Wolfsbane, Trork Terror, Chieftain Slayer, The Unbreakable, Veteran and Ore Finder.
- Admins can switch built-in titles off and add their own, with a name in all nine languages.
- No title is put on by itself: the owner chooses one in the Titles tab.
- Every owner is counted. The latest five keep their names and their share of the count.
- A former owner who gets the item back is not counted again.
- The most famous heirlooms of the whole server, with filters for all weapons, melee, bows and tools.
- An heirloom joins once it is Proven. Admins can take single items out, for example after farming.
- Small cards at the top centre of the screen tell the owner about milestones, new fame levels, titles, banes, boon choices, a new owner and a broken item.
- One chat line for everybody when an heirloom becomes legendary.
- Cosmetics, on by default: a chime at milestones, a sparkle where a creature falls, and a golden glow on legendary heirlooms lying on the ground.
- Off by default, because they change combat values. An admin switches them on in the admin window.
- Banes grow by themselves at 100, 500 and 2000 kills of one creature group: +3, +6 or +10 % damage against that group. At most two work at once.
- Boons: with every fame level the item offers three boons that fit its story, such as Night Hunter, Giantslayer or Ember. The owner picks one.
- Extra damage is capped at +10 % in total. A new owner wakes the boons after 25 creatures.
/ksheirloom admin opens five pages: Overview (counters and the latest events), Rules (what gets a story, fame levels, messages, what counts), Titles, Boons and Item (tools for the item in your hand).
- Every change applies at once and is saved to the config file.
- Only creatures the world spawned count, not those from spawn eggs or commands, and not pets or NPCs.
- Many kills at the same spot count less, and ores and trunks a player placed do not count.
- A melee kill from farther than 8 blocks away is not credited, and shields and armor count at most one creature hit per 1.5 seconds.
- All texts come in nine languages: en-US, de-DE, es-ES, fr-FR, it-IT, pl-PL, pt-BR, ru-RU and tr-TR.
- Window and chat texts follow the language chosen with
/kslang (shared by all KyuubiSoft mods). The tooltip and the names of items, creatures, titles and boons follow the game language.
| Page | Read it for |
|---|
| Getting Started | Installing the mod, the files it creates, a first test |
| Commands | Every command with syntax and permission |
| Permissions | The two permission nodes and LuckPerms examples |
| Configuration | Every option of config.json with its default |
| UI Pages | The story window, the tooltip, the moment cards and the admin window |
| FAQ | What counts, the farming rules, owners and binding, other KyuubiSoft mods |
| Changelog | What changed in each version |
| Item | Details |
|---|
| Plugin | KyuubiSoft Heirlooms (manifest kyuubisoft:heirlooms) |
| Version | 1.0.1 (2026-11-10) |
| Jar | KyuubiSoftHeirlooms-1.0.1.jar |
| Main command | /ksheirloom (no aliases) |
| Admin commands | admin, test, check, clear, wear, reload |
| Permissions | ks.heirlooms.user.open (players, allowed unless denied), ks.heirlooms.admin (admins) |
| Data folder | mods/kyuubisoft_heirlooms/ |
| Config | mods/kyuubisoft_heirlooms/config.json |
| Where stories live | On the item itself, under 1 KB per item |
| Required | nothing else |
| Optional | KyuubiSoft Core (moment cards share one row lane with the cards of other KyuubiSoft mods) |
- Hytale server 0.7.x and Java 25.
- No other mod is required. The window textures are inside the jar.
- Optional: KyuubiSoft Core. Without it everything works the same; the moment cards then always use the first row at the top centre.
- Works with: Companions. Combat pets that fight right next to their owner credit the owner’s weapon with their kills, see FAQ.