HORNMOD: a script that makes noise

Press the Item button with no item to honk.



Features:

• 99+ incredibly abrasive noises
• i've gay

NEW IN VERSION 4: https://youtu.be/oomyjEbpI9s (New horn indicator, Hitfeed support)
NEW IN VERSION 3: Hotfixes a handful of missing extags that I could have sworn were there, and """fixes""" one missing horn .ogg.
NEW IN VERSION 2: Fixed behavior when other scripts added horns, changed antispam to punish obvious idiots faster (will be slightly stricter by default), added horn preview to selection, and added a few new commands (see below). Oh, and added over 100 new horns. You're welcome.

Spoiler: Instructions

play a race lol

Spoiler: Customization

You're probably better off reading the script yourself, but here's a quick overview for hosts.

Spam-related:
hornobnoxious: Controls spam protection behavior. When On, spamming players are warned to shut up, then explode and respawn. When Off, instead of exploding, the player's horn is muted for all other players until they back off.
hornwarning: Threshold at which a spamming player gets the yellow warning message.
horndanger: Threshold at which a spamming player gets the red danger message.
hornlethal: Threshold at which a spamming player is killed, or silenced if hornobnoxious is off.
hornwarningreset: Time required with no horns for spam protection to reset.
hornexplosions: Controls the explosion effect. This is mostly for people who have trouble telling mines and spamming 14-year-olds apart.
hornmaxexplosions: Closes a player's game if they explode this many times in one race. Go somewhere else.
V2 hornfinaldeath: Controls whether players are kicked when reaching the spam limit. I didn't test this.
V2 hornduelmode: Controls whether to disable horn limits if only two players are racing. Taunt to your heart's content, it's just you and them.

Tweaks:
hornvisual: Controls the yellow flash when horns are triggered.
horntypeoverride: Makes all horns the same type, regardless of what a player's selected. This is a meme option and probably makes the horn selection UX kind of confusing.
horntypechaos: Makes all horns random each time they're triggered. Same disclaimer as above.
hornshowhelptext: Controls end-of-race command help. If you're using either horntypeoverride or horntypechaos as a permanent option instead of a one-off meme, you might want to set this to mitigate people getting confused about why horn changes don't work. (Players familiar with HORNMOD will still complain. WONTFIX)
hornattenuate: Post-race horns from players that didn't win are moved by this amount—this is a terrible horrible no good very bad volume hack because the native way of playing sounds at given volumes doesn't work unless the origin is yourself. I love video games.
V2 hornshowtutorial: Controls whether the "Press ITEM to honk!" text appears for players who haven't tried it yet. Provided for compatibility with other UI-altering mods.
V2 hornhell: Controls whether all players will be assigned a HELL HORN upon entering a Map Hell course.
V2 hornhellchance: Controls how often players with no horn set will be assigned a HELL HORN—value is chance out of 1000.

Weird Admin Nonsense:
horndebug: Floods console with debug print and displays spam-prevention variables on the game screen. Reminder: this is a netvar.
horntattle: Spies on horn-related events, like horn changes and antispam detonations, in a way that's a little less extreme than horndebug. Only prints for admins.

Expert Mode (for veteran HORNMOD players):
V2 hornadjust: Takes one number. Changes your selected horn and plays a preview; for example, hornadjust 1 will move you 1 forward, while hornadjust -5 will move you 5 back. Intended for use with custom binds in kartexec.cfg, so you can scroll through horns without using a text interface.

Spoiler: Expansions

Scripts loaded after HORNMOD can call "HORNMOD_AddHorns" to bolt their own awful meme sounds onto the existing list. HORNMOD will handle allocating these, just make sure the files are actually present.

HORNMOD_AddHorns({name = "sfx_foo", info = "Horn Example"}, {name = "sfx_ivegay", "info = "i've gay", extags = "this is used for searches but not displayed"})

V2 You can add HELL HORNs too:

HORNMOD_AddHellHorns({name = "sfx_bar", info = "GENUINELY TERRIBLE NOISE"})

[wolfs]

I feel like I've given this enough testing (at the expense of my sanity) to comfortably put this through. I guess over a month of public beta testing paid off after all!

At last, now you too can experience the joy of soundspam rivaling TF2 admin abuse circa-2012!

[Namolos]

Thanks, I hate it.

[TyroneSama]

HORNMOD 2 released. Changelog/updated documentation will be added when I'm finished moving cross-country. GLHF

[Red The Pyrohog]

N o i c e

[TyroneSama]

Version 3 now available, contains a few minor polish fixes.

[TyroneSama]

Version 4 now available.

[SCOTT0852]

For people who don't want to watch videos, v4 adds:
new horn indicator
hitfeed support

[RambunctiousReptile]

I made this account for the one and only purpose if expressing my gratitude for the joy (and probably some anger) that you've brought to this world through this mod.


So uh, thanks. I guess.

[TyroneSama]

Originally Posted by RambunctiousReptile

I made this account for the one and only purpose if expressing my gratitude for the joy (and probably some anger) that you've brought to this world through this mod.


So uh, thanks. I guess.

♥ 10characters

[TyroneSama]

Updated to support Hitfeed v2. Yes, I know this is 10 years overdue.

If you don't use the antispam features on your server, or you don't use Hitfeed, you can skip this one.