Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
WeaponRename
Shift+right-click a weapon in your inventory to rename it or reset it to the default localized name. Custom names travel with the item so every player with the mod can see them.
By TWOKEY
| Date uploaded | 10 hours ago |
| Version | 0.1.1 |
| Download link | TWOKEY-WeaponRename-0.1.1.zip |
| Downloads | 10 |
| Dependency string | TWOKEY-WeaponRename-0.1.1 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2333ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.29.2README
WeaponRename
Shift+right-click a weapon in your inventory to rename it, or reset it to the default localized name.
The custom name is stored on that item instance (not the prefab). Every player with this mod sees the same name on world drops, in chests, and on item stands.
Install
Install with r2modman or another Thunderstore manager. This mod depends on:
Dedicated servers and every client must have matching versions. Vanilla clients will be rejected at join so renamed weapons stay visible to everyone.
How to use
- Open your inventory.
- Hold Shift (configurable).
- Right-click a weapon.
- Rename, Reset (back to the default localized name), or Cancel. Escape also closes.
Features
- Weapons by default: one-handed, two-handed, two-handed left, and bows. A synced config can allow all items.
- Reset restores the real vanilla name, including other languages.
- Host rules (rename enabled, weapons-only, max length) sync from the server. The Shift key stays per-client.
- Does not change internal prefab ids. Other mods still see an Iron Sword.
- Optional: DarwinAwards death feed can show the custom weapon name.
DarwinAwards
WeaponRename does not require DarwinAwards. If both mods are installed, the victim's client fills the killing weapon into the death feed (and Discord, if DarwinAwards has a webhook).
DarwinAwards itself only knows {player} (the victim) and {enemy} (the killer's character name). It has no weapon token. WeaponRename adds {weapon} and, when a PvP line omits it, appends (Custom Name) so it works with the default jokes.
Out of the box
Keep DarwinAwards' default AwardCategories.yml. A PvP death looks like:
Alice wanted to hug Bob and found death instead. (Excalibur)
Turn this off with synced config DarwinAwardsShowWeapon.
Recommended YAML (host / dedicated server)
DarwinAwards syncs BepInEx/config/AwardCategories.yml from the server/host. Edit that file, then restart or wait for the file watcher. Example PvP lines:
death by player:
- "{player} was killed by {weapon}."
- "{player} was slain by {enemy}'s {weapon}."
You cannot add new category keys. You can only change the lines under the existing ones. Keep lines short so they fit the on-screen feed.
{weapon} is the custom name if the killer renamed that instance, otherwise the normal localized name (Iron Sword, etc.).
Changelog
0.1.1
- DarwinAwards death feed can show the killing weapon's custom name.
0.1.0
- First release.
CHANGELOG
0.1.2
- DarwinAwards no longer appends
(Name)to the death feed.{weapon}inAwardCategories.ymlis replaced; other lines are left as DarwinAwards wrote them. - Rename allowlist is skill-based: melee (axes, clubs, swords, spears, polearms, knives, fists, shields), bows, crossbows, elemental and blood magic, and ammo (arrows, bolts, missiles, bombs, blob bombs). Pickaxes and tools cannot be renamed when WeaponsOnly is on.
0.1.1
- DarwinAwards: death feed (and Discord, if you use the webhook) can show the killing weapon's custom name.
- Replaces
{weapon}inAwardCategories.yml, or appends(Name)to PvP lines that do not use the token.
0.1.0
- First release: Shift+right-click to rename a weapon or reset it to the default localized name.
- Custom names replicate with the item (inventory, chests, drops, item stands).
- Host-synced rules: rename enabled, weapons-only, max name length.