GooCosmetics

Give your gear the look and particle effects of gear you have collected, a name of your choice, or no visible model. Stats, upgrades and durability never change, and nothing is used up.

How to use

1. Open your inventory, hover a piece of gear and press T (controller: select it and press Back).
2. Pick a look: drag an item onto Appearance, or click Collection.
3. Optional: pick Particles, type a Name, or tick Hide model.
4. Click Apply Illusion.

Works on weapons, shields, armor, capes and pickaxes. Not on tools, torches, fishing rods or utility items.

Controller

Collection

Each character remembers every piece of gear that passes through its inventory, even after it is sold or lost.

• Only looks that fit your item are shown.
• Search by name. Click a look's star (or right-click it) to favorite it; Favorites only shows just those.
• Show locked, under Illusion window in the config, shows looks and effects you don't have yet as dark silhouettes with ?. Names and details stay hidden until unlocked.
• Show Enemy Gear off hides all monster looks and trophy helmets.

Particle effects

Weapons can wear the effects of weapons you have collected, such as Frost fire or Blood lightning.

• Choosing a look also picks its effect. For another one, drag a weapon onto Particles or click its Collection.
• Original particles keeps your item's own effect, No particles removes it, Clear choice goes back to the look's.

Names

Name any gear in your inventory, with or without a look: type in the Name box and press Enter. Tick Look's name to use the look's name; Reset gives back the item's own. Names stay with the item, upgrades included. A colored name (or diamond) means the item wears an illusion.

Hide model

Helmets and capes: tick Hide model and apply. You keep the piece and its stats, but it isn't drawn.

Monster looks

Pick up the listed item to unlock a look. Items you had before installing count.

goocosmetics monsters lists them all and what unlocks them.

Trophy helmets

Turn your helmet into a creature's head: pick up its trophy, then choose it at the end of the helmet's Collection. Includes 48 trophy looks and compatible trophies from other mods.

Most trophies replace your character's head. Fuling Shaman is a hat; Bonemaw is a helmet. Removing the look restores your normal appearance. A dropped helmet shows its real model.

Adjust a trophy head

Enable Vanilla trophy fitting under Illusion window in the config. Fitting for modded trophies is on by default. Apply a trophy look, equip the helmet, then open Trophy fit > in the illusion window (controller: LB / RB).

• Adjust the trophy's size, rotation and position while watching your character.
• Inner hood adds a backing behind the trophy. Show head and Show beard keep your own head and beard visible.
• Save fit keeps your changes. Revert restores the last save; Reset to default restores the starting fit. Leaving the page discards unsaved changes.

Fits are saved per trophy for all your characters in this profile and affect only your view. Turning fitting off keeps your saved fits.

Monster projectiles

• A bow wearing the Charred bow shoots Charred Marksman arrows (elemental arrows keep their effects).
• A Staff of Embers wearing a Fuling shaman staff shoots the shaman's fireball and explosion.

Only the look changes; damage stays the real item's.

Particle fade and inertia

Effects on held weapons and torches react to how fast the weapon moves:

• Fade: particles fade sooner while the weapon moves fast, so trails are shorter.
• Inertia: particles keep part of the weapon's motion instead of stopping dead.

Each has a slider for attacks and one for everything else. These also work on fists. Lightning effects are excluded; Toxic cloud is excluded on non-fist weapons.

Also

• Armor stands, dropped gear and thrown spears show illusions.
• Epic Loot magic items keep their names and enchantments. Use the Marker indicator to keep rarity colors.

Settings

In your mod manager's config editor (gnls.GooCosmetics.cfg), or with the console commands below.

Set General > Enabled off and restart Valheim to disable GooCosmetics. Your saved illusions and fits are kept.

Particle sliders go from 0 (Valheim's own) to 100. Your existing settings and trophy fits are kept when updating.

Console commands

• goocosmetics monsters / effects: monster looks and trophy helmets / particle effects and what unlocks them.
• goocosmetics appearance, window, controls: show or change settings, keys and buttons.
• goocosmetics name [right|left] [set <text>|own|look]: name the window's item or a held item.
• goocosmetics undo: undo the last change.
• goocosmetics icons [clear]: saved monster icons; clear redraws them.
• goocosmetics debug [on|off|dump]: debug logging.
• goocosmetics report: write a diagnostic file.
• goocosmetics unlock <item|all> / lock <item|cheated>: add or remove looks (needs devcommands).

Multiplayer

Players with GooCosmetics see your illusions and monster projectiles, unless they turn off See illusions on other players. Use the same version to see all looks. Players without it see your real gear.

Changelog

1.0.1

Added

• Trophy heads for helmets, unlocked by collecting trophies. Supports compatible modded trophies too.
• Trophy fitting: adjust size, rotation, position, hood, head and beard. Vanilla fitting starts off; modded fitting starts on.
• Enabled setting to switch the mod off (restart Valheim).

Changed

• Updated for Valheim 1.0.20.
• Locked entries use dark silhouettes and a question mark, with names and details hidden.
• Show locked moved to the config and now includes trophies.

Fixed

• Particle fade and inertia now work on fists. Lightning effects remain excluded.

1.0.0

Added

• Controller support (open with Back; optional remove button).
• Item names: name any gear, or use its look's name.
• Hide model for helmets and capes.
• Monster looks: Fuling sword, troll log, burning troll log and Charred helmet.
• Odin's hood and cape for everyone; the flaming iron sword with the iron sword.
• Monster projectiles: Charred bow arrows, and the Fuling shaman fireball on a Staff of Embers.
• Particle fade and inertia sliders (in and outside attacks) with a Particle adjustments switch.
• Show locked and Show Enemy Gear in the collections.
• Unlock banners and "New" marks for new monster looks.
• Armor stands show illusions.
• Show real names and Debug logging settings.
• Console commands: effects, appearance, controls, name, undo, icons, debug, and unlock/lock (devcommands).

Changed

• Particles are chosen by effect (Frost fire, Blood lightning…) and unlocked by collecting any weapon with it.
• Staffs share looks with staffs held the same way.
• The Berserker mace look also fits two-handed axes.
• Monster weapons are sized better to the weapon they dress.
• Monster looks get vanilla-style icons.
• Collections list obtainable items first.
• Better performance; monster icons are saved and drawn once.
• Updating from 0.0.3: new settings start off in your existing config.

Removed

• Looks that can't work: the Voidcaller, enemy-only gear and the grappling hook.
• Fallen Warrior and Shadow armor, helmets and capes no longer unlock with the orb (weapons and tower shield still do).

Fixed

• Upgrading an item removed its illusion.
• Esc closed the whole inventory.
• Typing in the search box moved the character or ran console binds.
• The Flametal shield couldn't use illusions.
• Sheathed monster looks vanished or sat in the wrong spot.
• Your corpse showed your real gear with See illusions on other players off.
• With a dual-wield mod, off-hand monster looks showed the monster's swing trail.
• Hitches from monster icons.

0.0.3

• Added monster looks: 18 enemy weapons unlocked by their trophies, and 50 Fallen Warrior and Shadow recolors unlocked by a Fallen Warrior orb. Enemy weapons are resized to fit and keep your weapon's range and swing trail.
• Use donor icons shows a rendered icon for enemy weapons.
• Added the One collection at a time and Particles follow the chosen appearance settings (both on).
• Added the goocosmetics monsters and goocosmetics window console commands.
• Removed the character preview.
• Fixed clicking a collection star, and button text sometimes turning grey.

0.0.2

• Added a character collection that keeps looks after the item is sold, lost or stored.
• Added appearance and particle collections with search, favorites and pages.
• Particles can now come from a different weapon than the look.
• Added Original look and Original particles toggles, Undo, and a character preview.
• Moved Use donor icons into the illusion window.
• Added an option to mix unknown weapon types.

0.0.1

• First release: give gear the look of another owned item without changing its stats, with particle options, donor icons, name colors and a setting to hide other players' illusions.