DrakesRenameIt V0.9.0 Release Canidate

A Valheim mod that lets you rename items, rewrite descriptions and now even update the Crafted by line (display only). Good for roleplay or labeling gear.

How to use

Hold Shift or Ctrl (configurable: MenuOpenModifier in UI-NotSynced) and right-click an inventory item to open a small menu: Rename, Description, or Crafted by. Choose an action; only allowed options are clickable. The other modifier + right-click keeps vanilla inventory behavior.

Okay confirms; Reset restores the vanilla string for that field.

Okay will confirm the dialog with your change, reset button will bring it back to the items original localized string. 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!

Features with rename:

• Fully supports the same sign codes like <color=blue> bold etc for full information check official Valheim documentation on sign features.
  • You can even resize using <size=...> Do not recommend over 200, things start to get funky.
• Supports localization strings
• Lets you rename any existing item and renames that instance.
• Fully supports multiplayer play, just ensure each client has the mod.
• recolor the UI tips with configs
• Admin override to not apply to the rules
• You can enable and disable parts of the mod now.
• API hooks for other mods to track name and description changes
• Doesn't ACTUALLY rename items, so any mod that needs to deal with the items shared: name won't experience any issues! (hopefully...)
• New Change crafted by name.
• New Seperate stacks by customization with configurable options.
• New Admin override configurable for auto detection or VIP list only
• New Configurable options for showing reasons for denials and more detailed config options for exclusions and allowlists.
• New one unified menu for all rename, description, and crafted by edits with a slick new design.
• New configurable costs for editing items to make it more special and prevent abuse.
• New Vast array of configurations for whats allowed to be edited, by name and category.

What this Mod doesn't do:

• your taxes
• change every single item that exists
• makes new instances of an item
• actually change the name of the item under the hood
• give you up
• let you down!

Configurations:

Settings live in BepInEx/config/ (e.g. com.DrakeMods.DrakesRenameit.cfg). Almost everything is server-synced so the host controls rules for the world; the exceptions are ShiftColor and CtrlColor (per-client UI only).

General (server-synced)

• RenameEnabled — When on, non-elevated players may rename items (via the action menu). Turn off to block new renames while keeping other features.
• 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. Real crafter id/name used by the game (ownership, locks) is unchanged.
• SeparateStacks — When on, stacks only merge automatically when tag matches (custom name, description, and crafted-by display key). Auto pickup and other automatic merges will not combine mismatched stacks.
• SeparateStacksHardLock — Only applies when SeparateStacks is on. When true (default), mismatched stacks never merge—including manual drags onto another stack. When false, you can drag one stack onto another and they combine immediatel; the target stack keeps its custom name, description, and crafted-by display.
• LockToOwner — When on, only the crafter / owner can rename or change description. Stacks with no crafter yet (raw picked-up resources: no crafter id and no crafter name) are not treated as “someone else’s” until they are crafted or claimed. After NameClaimsOwner assigns you as crafter, others are blocked as usual.
• NameClaimsOwner — When on, successfully applying a new name or description on an unowned stack sets you as crafter (and “crafted by” style ownership) so LockToOwner can protect that stack. Works with uncrafted resources when AllowRenameResources (and allowlist if needed) permits the edit.
• AllowRenameResources — When on, unowned resource-style stacks (no crafter yet) can be renamed or given a description. When off, those stacks are blocked unless they are on RenameAllowlist (then claim rules can still apply). This is separate from ExcludedCategory Material, which can still block by item type for crafted gear.
• ShowReason — When on, denied rename/description attempts show why (ownership, exclusion, resources, etc.) in the center message and inventory tooltip. When off, messages stay generic. Server-synced so clients cannot enable detailed reasons against the host’s preference. Denials are still logged to the BepInEx log for admins.

Limits (server-synced)

• NameCharacterLimit — Max length for custom names. Counts rich text tags (<color>, <size>, etc.), so leave headroom.
• DescriptionCharacterLimit — Same idea for custom descriptions.

Admin (server-synced)

• AllowAdminOverride — When on, “elevated” players (see below) bypass LockToOwner, exclusions, and resource rules, and can still rename or edit descriptions even when RenameEnabled / RewriteDescriptionsEnabled are off for everyone else (“regardless of ownership or enabled,” per config).
• VipList — Comma-separated player names or player IDs (same strings as the API AddVIP). Used when AllowAdminOverride is on. Valheim server admins also count as elevated unless VipOnlyOverride is on.
• 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. Useful to test VIP-only behavior. When false, either Valheim admin or VIP counts as elevated.

Exclusions (server-synced)

• ExcludedNames — Comma-separated items that cannot be renamed or have descriptions changed (for non-elevated players). Each entry can be a Jotunn item list Item (spawn name, e.g. AxeStone), Token ($item_..., matches internal item name), or English Name column. Elevated users ignore this when AllowAdminOverride is on.
• ExcludedCategory — Comma-separated category tokens, e.g. Swords, Armor, Material, Bows, or Skills.SkillType / ItemType enum names. Alias words like armor, weapons, melee also work. A full reference file is generated at BepInEx/config/com.DrakeMods.DrakesRenameit/ExcludedCategoryReference.txt on first run or when the mod version changes.
• RenameAllowlist — Same entry format as ExcludedNames. For normal players, items on this list skip excluded-by-name, excluded-by-category, and the unowned-resource check, but still require RenameEnabled / RewriteDescriptionsEnabled to be on and still obey LockToOwner if another player owns the stack. AllowAdminOverride elevation bypasses the global toggles and most restrictions as usual.

UI (not synced — client only)

• MenuOpenModifier — Shift or Ctrl: which key + right-click opens the Drake menu. The other modifier + right-click uses vanilla behavior.
• ModifierColor — Tooltip hint color for MenuOpenModifier (Unity color name or #rrggbb).

Permission order (how rules stack)

Admin/VIP override → global toggles (rename, description, crafted-by label) → LockToOwner (only matters once an owner exists) → RenameAllowlist → then allow of the following: excluded names, excluded category, and AllowRenameResources for raw resources.

Known Issues:

Known Issues: - None currently but please report if you find any!

Wishlist for future

• if there is a high demand for this:
  • Renamable pieces (that have hover names)

Distant crazy features

• Someday if it seems doable, I may add customizations like color changes to the icon or item itself, things like that, However this may require a lot of work since I believe it would require new prefabs of items which may be a mess for valheim.
• Probably a seperate mod though!

API Docs:

Events live in namespace DrakeRenameit.API (RenameEvents).

using DrakeRenameit.API;

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

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 isnt 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