Resource icon

[Reusable] Cosmetics v1.7

Demonstration video:



Cosmetics adds 18 stylish hats and a variety of custom sound effects to the game! Customize your look, play funny sound effects when you get killed, or enable helpful hitsounds for PVP modes like Match and BattleMod. Not only that, but modders can easily add additional hats and sound effects!

Press Custom 1 to open the cosmetics menu. This can be done at any time in coop and race modes. In other modes, the cosmetics menu is only available to spectators and dead players. Your settings will be saved and loaded automatically!

- Hat sprites created by Inazuma, Chuckles Troll, PeneBoi, lightdasher, and Ice Face. Huge thanks to these contributors for helping make Cosmetics a reality, and for allowing me to release it as a reusable addon.
- If you're hosting with this addon and BattleMod, it's recommended (but not required) to add this file before BattleMod.
- This mod may work awkwardly with custom characters that need the Custom 1 button. Sorry about that.

:welcometoreleases::welcometoreleases::welcometoreleases: Modder's guide :welcometoreleases::welcometoreleases::welcometoreleases:

New content can be added using functions stored in the Cosmetics global variable. Use if Cosmetics to check for the mod's existence, similarly to how one would check for the existence of BattleMod using if CBW_Battle. The Lua/Content folder of the Cosmetics addon should provide a decent blueprint to learn how adding new content works, but here's some more detailed documentation:

Cosmetics.AddHat(name, artist, hudsprite, state, ismask, thinker)
Adds a new hat to the cosmetics menu.
name (string): The name of the hat
artist (string): The name of the sprite artist that created the hat
hudsprite (string): Sprite that will be displayed on the hat selection menu. Keep it consistent with the others by using an A2 or A0 angled sprite.
state (enum S_*): State that the hat will use
ismask (boolean): Is this hat a mask? If true, the hat will float slightly in front of the wearer's face.
thinker (function): Function that is run by the hat every tic. Takes mo as an argument.

Cosmetics.AddDeathsound(name, sound), Cosmetics.AddHitsound(name, sound), Cosmetics.AddChatsound(name, sound)
Adds a new sound effect to the cosmetics menu.
name (string): The name of the sound
sound (enum sfx_*): The sound effect that will be played (make sure to freeslot it first!)
Extension type
File size
769.4 KB
MD5 Hash
First release
Last update
4.67 star(s) 6 ratings

More resources from Krabs

Share this resource

Latest updates

  1. v1.7

    Fixed a lua error
  2. v1.6

    - Fixed a bug where player's chat messages would go through even if they were ignored using a...
  3. v1.4

    - Added hat offset value for Adventure Sonic (it's not perfect, but his proportions are pretty...

Latest reviews

Yooo this is a very neat and awesome mod!
Upvote 0
with the recent update fixing the main issue that me and a good number of other had with this, i wholly cannot recommend this enough server owners and sound/hat creators go wild on this one!
Upvote 0
This is a great addition to any server, but my only problem is that the menu is mapped with C1, so i cant use this with modded characters.
Upvote 0
This addon is a nice addition to any server! It reminds me of the hats.wad for 2.1. My only gripe is the lack of setting the button to something like weapon 6 or something of the sorts. Otherwise I really enjoy this mod!
Upvote 1
Amazing addition to any server! :D
Upvote 1
while this is an awesome addition to a server, their is one thing from holding it back from being used in some servers and thats the fact the menu uses the C1 button as such it will be difficult for modded characters that uses custom buttons to use their abilities. though this is not the mod's nor the character that relies on the button's fault on this however. other than that. for servers that have only 2 button characters will certainly enjoy this one
Upvote 2
Awesome work! An awesome addition to any server!
Upvote 3