DrakesRenameIt

Rename items, rewrite descriptions, and update the Crafted by line (display only). Good for roleplay or labeling gear. 1.1.x adds craftable / placeable paper notes and shared inventory tabs with LockSmith via DrakeModsLibs. 1.1.4 hotfixes Valheim 1.0 build-HUD corruption from paper place-table guards (FieldAccessException).

Requires DrakeModsLibs 0.9.4+ — shared display patches, tab host, and server config sync live there so this mod stays lean and Valheim updates are easier to track. Valheim 1.0 item-stand labels (including durability wear) refresh when those Libs settings change.

Piece of Paper (1.1)

Craft blank Piece of Paper from the inventory craft list (default recipe 1 Wood + 1 Coal; override with PaperCost). Blanks stack (default 50). Open the Drake menu and set a name and/or description — that uses one sheet and creates a Written Page (always stack size 1) with your text.

Written Page can be pinned in the world from the hotbar (Use), or built as hammer furniture (Blank Paper wall / flat, Paper Stack). Ward owners can Shift+Use a pinned page to let anyone take it (PaperTakePublicEnabled). Synced config section 10 Paper covers enable, names, recipe, station, item type, stack size, place orientation, take-public, and hammer pieces. ExcludedCategory alias Paper targets blank and written paper.

LockSmith integration

With LockSmith (or any other DrakeMods tab) and DrakeModsLibs 0.9.4+, inventory modifier + right-click opens the shared DrakeTabHost strip (same idea as Craft|Upgrade). Rename registers as a tab; LockSmith can claim the default tab on keys. When both tabs are usable you see Lock | Rename and switch without closing. LockSmith hard-blocks / deferred keys still hide Rename for normal players; elevated admin/VIP (TagBypass) can get both tabs when Libs soft-suppress allows it. Shared open keys and tab priority live in Libs Integration config — RenameIt’s own MenuOpenModifier still applies as this mod’s binding.

How to use

Hold your configured keys (ServerDefaultMenuOpenModifier on the server, or your own MenuOpenModifier override in UI-NotSynced — Shift, Ctrl, Alt, combos like Shift+Alt, F1, or None for right-click only) and right-click an inventory item. With only RenameIt usable you get the rename action menu; with LockSmith (or another tab) also usable you get the shared tab strip first. Leave local MenuOpenModifier empty to follow the server default; set it only when you want a personal override. Choose an action; only available options are clickable.

Okay confirms your change; Reset restores the original localized string; Cancel closes without saving. Reset all asks for confirmation before clearing every Drake customization on that stack. When Unlock cost is enabled, use Unlock once per stack (from your inventory) before edits apply — stacks you already customized are grandfathered in automatically. It always appears with the current name including localization. If you would like to maintain localization with an additional name, simply leave the $string intact and add around it.

Rename anything:

Lock others from changing your names:

Easy to use Shift + Right click in inventory: You can recolor and even keep localized strings.

Start your own rock collection:

Edit descriptions!

Works on item stands: edit them with font styles

Now with customizable "crafted by" names and messages

New simplified single modifier. Right click menu to access 3 editible items, with fast reset.

Configurable cost mode: set in game prices to make renaming more meaningful.

Configurable list of alternates to "Crafted By" to update

Configurable flag warded item stands. Great for showing things off in a shop setting. Able to add price tags on them, etc.

Features with rename:

• Fully supports the same sign codes like <color=blue>, <b>bold</b>, etc. — see official Valheim sign documentation for the full list.
  • You can resize using <size=...>. Values over ~200 are not recommended; layout can break.
• Supports localization strings ($item_... tokens); leave tokens intact and wrap extra text around them to keep localization.
• Rename, description, and Crafted by (display name + optional tooltip line prefix such as “Belongs To”) on that item instance only — internal prefab ids are unchanged for other mods.
• Fully supports multiplayer; every client needs the mod.
• ServerDefaultMenuOpenModifier (server-synced) with optional per-client MenuOpenModifier override, plus MenuHintColor.
• Toggle rename, descriptions, and crafted-by independently; ShowDenialUi / ShowReason control blocked-item feedback.
• AllowAdminOverride + VipList / API VIPs bypass ownership and exclusions; VipOnlyOverride can require VIP list only (ignore Valheim server admin).
• Unlock cost — optional per-stack payment before edits; tooltip shows lock / pen icons; admins and VIPs skip when override applies.
• Separate stacks — customized stacks only merge when name, description, and crafted-by data match; optional hard lock blocks manual drag-merges too.
• ExcludeStacks — block non-elevated edits on vanilla stackable items (m_maxStackSize > 1), separate from merge rules.
• Durability modifiers — optional wear labels prepended to display names (Pristine / tiers / Broken).
• Piece of Paper / Written Page — craftable blanks that peel into written notes; hotbar place + hammer décor; optional public take; config under 10 Paper.
• Public rewrite — optional per-stack flag so non-owners may rewrite name/description (PublicRewriteEnabled).
• LockSmith / DrakeTabHost — shared inventory tabs and open binding via DrakeModsLibs when both mods are installed.
• Exclusions by item name, category, and RenameAllowlist bypasses; reference file generated for category tokens.
• Unified action menu (rename, description, crafted by) with fast reset; Cancel and Reset all confirmation.
• Item stands: custom names on hover; ShowItemStandItemNameWhenNoAccess shows the stand item name even in warded “no access” areas.
• Centralized localization (Assets/Localization/*.json); English and Spanish included.
• API hooks for other mods (RenameEvents: name, description, crafted-by display changes).
• Tooltip rich-text safety (unclosed tags auto-closed); crafted-by display can get default orange coloring when unstyled.

What this Mod doesn't do:

• your taxes
• change every single item that exists
• actually change the name of the item behind the scenes
• give you up
• let you down!
• (It does add craftable Piece of Paper / Written Page for rename RP and world notes.)

Configurations:

Settings live in BepInEx/config/ (e.g. com.drakesworkshop.renameit.cfg; older installs may use com.DrakeMods.DrakesRenameit.cfg). Sections are numbered in the file so Configuration Manager sorts in tab order. Sections 01–09 and 10 Paper are server-synced and enforced (via DrakeModsLibs / ServerSync embedded in Libs) when LockSyncedConfig is true (default): clients receive the host’s values and cannot push gameplay changes unless they are on the Valheim server adminlist. Section 11 UI-NotSynced (MenuHintColor, MenuOpenModifier, LogSpam) is per-client only. Install DrakeModsLibs as a dependency — no separate ServerSync mod required. Legacy section names are migrated automatically on load.

Features (server-synced)

• RenameEnabled — When on, players may edit display names from the action menu (subject to all other rules). Turn off to block new renames while keeping descriptions or crafted-by.
• RewriteDescriptionsEnabled — When on, descriptions may be edited from the menu. Can be used without rename, or turned off if you only want custom names.
• CraftedByLabelEnabled — When on, players may set a display-only override for the crafted-by line in tooltips (name and optional line prefix). Real crafter id/name used by the game (ownership, locks) is unchanged.
• PublicRewriteEnabled — When on (default), the item menu can flag a stack so non-owners may rewrite its name and description (Drake_PublicRewrite in DrakeModsLibs). Crafted-by stays owner-only. Useful for shared notes and shop labels.

Admin (server-synced)

• AllowAdminOverride — When on, “elevated” players (see below) bypass LockToOwner, exclusions, unowned-resource blocks, unlock cost, and most per-item rules. Elevated players can still edit when feature toggles are off for everyone else.
• LockSyncedConfig — When true (default), only Valheim server admins can change server-synced settings in-game (including VipList). Clients cannot push config edits to the host. Keep this on for public servers.
• VipList — Comma- or semicolon-separated character names and/or platform user IDs (Steam ID / GetPlayerID(), same format as adminlist.txt). Server-synced; edit on the server cfg when locked. Grants mod bypass only — not Valheim admin (ghost, kick, etc.).
• VipOnlyOverride — When true (and AllowAdminOverride is on), only VIP list / API VIPs count as elevated; Valheim’s server admin flag is ignored for bypassing rules. When false, either Valheim admin or VIP counts as elevated.

Exclusions (server-synced)

• ExcludedNames — Comma-separated items that cannot be renamed or have descriptions/crafted-by changed (for non-elevated players). Each entry can be a Jotunn item list Item (spawn name, e.g. AxeStone), Token ($item_...), or English Name column. Elevated users ignore this when AllowAdminOverride is on.
• ExcludedCategory — Comma-separated category tokens, e.g. Swords, Armor, Material, Bows, Paper (Piece of Paper vessel), or Skills.SkillType / ItemType enum names. Alias words like armor, weapons, melee, paper also work. Reference file: BepInEx/config/com.drakesworkshop.renameit/ExcludedCategoryReference.txt on first run or version change (GUID changed in DrakesWorkshop rebrand).
• RenameAllowlist — Same entry format as ExcludedNames. For normal players, items on this list skip excluded-by-name, excluded-by-category, ExcludeStacks, and the unowned-resource check, but still require the relevant Features toggles to be on and still obey LockToOwner if another player owns the item.

Crafted by (server-synced)

• LabelCustomizable — When on, players who may open the crafted-by editor can pick a tooltip line prefix from AllowedLabels. When off, the picker is greyed for normal players; elevated players can still change it.
• AllowedLabels — Comma- or semicolon-separated prefixes shown before the crafter name (e.g. Belongs To: Name). The first entry is the default row (uses the game’s localized crafted-by line when selected). Further entries are stored on the item when chosen.

General (server-synced)

• LockToOwner — When on, only the crafter / owner can rename or change description/crafted-by. Stacks with no crafter yet are not locked until claimed or crafted.
• NameClaimsOwner — When on, successfully applying a new name or description on an unowned stack sets you as crafter so LockToOwner can protect it. Requires AllowRenameUnownedItems or RenameAllowlist for raw resources.
• AllowRenameUnownedItems — When on, unowned stacks (no crafter id and no crafter name — picked up resources, loot, etc.) may be edited. When off, blocked unless on RenameAllowlist. Separate from ExcludedCategory Material, which blocks by item type even when crafted.
• ShowDenialUi — When on, access denials show a red menu hint, tooltip denial lines, and a center message on failed modifier+right-click. When off, those cues are hidden (silent). Unlock-cost, not-in-inventory, and validation errors are unchanged.
• ShowReason — When on (and ShowDenialUi is on), denial text explains why (ownership, exclusion, etc.). When off, generic messages only. No effect when ShowDenialUi is off. Denials are still logged to BepInEx for admins.
• ShowItemStandItemNameWhenNoAccess — When on, item stands in warded/private areas still show “no access” but also append the stand’s current item name on the hover label (display only; permissions unchanged).
• ServerDefaultMenuOpenModifier — Default keys for opening the Drake / shared tab menu when a player’s local MenuOpenModifier is empty. Set on the host for modpack compatibility (e.g. None if another mod uses Shift). Examples: Shift, Ctrl, Alt, Shift+Alt, F1. Combine with +, ,, or &. Use None for right-click only. When LockSmith (or another Drake tab) is installed, Libs may also apply its Integration inventory open binding — keep them aligned in modpacks.

Stacks (server-synced)

• SeparateStacks — When on, stacks only merge when Drake identity matches (custom name, description, crafted-by display, and crafted-by line label). Auto pickup will not combine mismatched customized stacks.
• SeparateStacksHardLock — Only when SeparateStacks is on. When true, mismatched stacks never merge, including manual drags. When false, auto pickup still separates mismatches, but you can drag-merge in one step (target keeps its custom data).
• ExcludeStacks — When true, non-elevated players cannot rename, edit descriptions, or crafted-by on vanilla stackable items (m_maxStackSize > 1). RenameAllowlist and elevated override bypass this. Independent of SeparateStacks merge behavior.

Unlock cost (server-synced)

• UnlockCostEnabled — When on (and UnlockCost parses to at least one item), each stack must be unlocked once before rename/description/crafted-by edits. Pay from inventory via Unlock in the action menu. Elevated players skip when AllowAdminOverride applies. Stacks already customized before unlock existed are grandfathered (unlock flag written once).
• UnlockCost — Comma- or semicolon-separated PrefabName:amount (e.g. Coins:5, Coal:10) or $item_token:amount. Invalid or empty cost is ignored.

Limits (server-synced)

• NameCharacterLimit — Max length for custom names (rich-text tag codes count toward the limit).
• CraftedByCharLimit — Max length for crafted-by display names (rich-text tags count).
• DescriptionCharacterLimit — Max length for custom descriptions.

Modifiers (server-synced)

• DurabilityModifierEnabled — When on, prepends a wear label to display names for items with forge durability (m_useDurability), not spoilage timers. Does not change stored rename text.
• DurabilityUnbrokenLabel — Label at full durability (~100%). Rich-text allowed; empty = no label when pristine.
• DurabilityBrokenLabel — Label only at 0 durability (broken in-game). Not used for merely worn gear.
• DurabilityTierModifiers — In-between wear bands: {Name,fraction} or {Name,percent} (e.g. {Rusty,0.4},{Worn,0.6}). Lowest matching threshold wins; gap above highest tier but below full gets no extra label. Skips items with no durability (m_maxDurability 0).

Paper (server-synced, section 10)

• PaperEnabled — When on, players can craft Piece of Paper. Prefabs stay registered for multiplayer; this only toggles craftability.
• PaperName / PaperDescription — Defaults for blank paper (before writing).
• WrittenPaperName / WrittenPaperDescription — Defaults for Written Page when no custom text is set.
• PaperCost — Recipe as PrefabName:amount list (default Wood:1,Coal:1). Same format as UnlockCost. Applied at registration.
• PaperCraftingStation — Station prefab (e.g. piece_workbench). Empty = craft anywhere from the inventory craft list.
• PaperScale — World size multiplier for sheets and hammer décor (default 1.5). Restart menu/world to re-apply.
• PaperItemType — Vanilla category: Material (default) or Misc. ExcludedCategory alias Paper targets blank and written paper.
• BlankPaperStackSize — Max stack for blank Piece of Paper (default 50). Written Page is always stack size 1.
• WrittenPaperIgnoresRestrictions — When on, Written Page name/description ignore feature-off / exclusion / ExcludeStacks for normal players; ownership and public-rewrite rules still apply.
• PaperPlaceEnabled — When on, Written Page hotbar Use opens place mode (vertical/horizontal). Blank paper Use opens rename / write instead.
• BlankPaperPlaceOrientation — Vertical Only, Horizontal Only, or Both (default). Only Both shows the switch tooltip and lets Use toggle wall/flat.
• PaperTakePublicEnabled — When on, the creator (or elevated override) inside an allowed ward can Shift+Use a pinned Written Page so anyone can take it; Shift+Use again makes it private. Placement and hammer-remove stay warded.
• VerticalPaperPlaceable / HorizontalPaperPlaceable / StackPaperPlaceable — Hammer furniture pieces (each default on).

UI-NotSynced (client only, section 11)

• MenuOpenModifier — Optional per-client override for menu keys. Leave empty to use ServerDefaultMenuOpenModifier from the server. When set, always applies on this machine. Same key syntax as the server default.
• MenuHintColor — Tooltip hint color for the menu shortcut (Unity color name or #rrggbb).
• LogSpam — Verbose BepInEx traces on this client only (leave off unless debugging).

Permission order (how rules stack)

Admin/VIP override (and unlock-cost skip when elevated) → Features toggles (rename, description, crafted-by) → LockToOwner (once an owner exists) → RenameAllowlist → excluded names, excluded category, ExcludeStacks, and AllowRenameUnownedItems for raw resources → unlock cost (if enabled) for the stack.

Known Issues:

• None currently but please report if you find any!

Wishlist for future

• If there is high demand: renamable pieces that have hover names.
• Reskin (custom item visuals) is something we want to look into when priorities allow — no timeline promised.
• Other customization ideas may show up later as separate DrakeMods that share DrakeModsLibs; we are not shipping a full customization suite right now.

API Docs:

Types live in namespace DrakeRenameit.API.

Events (RenameEvents):

using DrakeRenameit.API;

RenameEvents.OnItemNameChanged += (player, item, oldName, newName) => { /* ... */ };
RenameEvents.OnItemDescriptionChanged += (player, item, oldDesc, newDesc) => { /* ... */ };
RenameEvents.OnCraftedByDisplayChanged += (player, item, itemPrefabName, oldDisplay, newDisplay) => { /* ... */ };

VIP / elevated checks (RenameitPermission) — requires AllowAdminOverride on the server for bypass rules to apply. Use the player’s character name or GetPlayerID().ToString() (same values as VipList in config):

using DrakeRenameit.API;

// At mod startup or when your mod grants perks:
RenameitPermission.AddVIP("SomePlayerName");
RenameitPermission.AddVIP(Player.m_localPlayer.GetPlayerID().ToString());

// Or bulk from your own list:
RenameitPermission.AddVIP(new List<string> { "Alice", "76561198000000000" });

RenameitPermission.RemoveVIP("SomePlayerName");

foreach (string vip in RenameitPermission.GetVIPs())
    Logger.LogInfo($"VIP: {vip}");

if (RenameitPermission.IsElevatedForOverrides(Player.m_localPlayer))
    Logger.LogInfo("Local player bypasses ownership/exclusions (VIP or Valheim admin, per config).");

Contact me:

• Want to drop a line tell me how I'm doing. -Report a bug (THATS NOT IN THE KNOWN ISSUES ALREADY), or a request for new features.

• I cannot guarantee the request will be met but if there's a high enough demand and the ask isn't too difficult I may take it into consideration. Email: [email protected] Discord: Drakethos

• discord server: https://discord.gg/cQegN9fB6r

• buy me a coffee ☕ https://paypal.me/Drakethos?country.x=US&locale.x=en_US

Publishing (GitHub Actions)

Pushing a tag v{Version} that matches <Version> in mod.package.props runs .github/workflows/release.yml:

1. Build the Thunderstore zip and create a GitHub Release with the zip attached
2. Publish that zip to Thunderstore (DrakeMods-DrakesRenameit)
3. Publish the same zip to Hexium (valheim.hexium.gg) after Thunderstore succeeds

Repo secrets required:

Credits: Used Cursor AI assitance to complete desired features Big shout out and thanks to nchnc for the intense testing of this mod!