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 5: hornsafepowerups, hornlocaloverride, the "shutup" command to mute annoying players, and unleashhell.
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.
hornsafepowerups: When on, players are immune to spam protection under Invincibility or Grow.

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.
unleashhell: When used, all HELL HORNs will be added to the standard horn list, and HELL HORN chance will be set to 0—effectively removing the difference between HELL HORNs and normal horns.
hornlocaloverride: Client-side. When set to anything but 0, replaces every horn with the horn corresponding to that number. Try it with something quiet and short for a more relaxed experience.

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"})

Note: Starting with V5, HORNMOD is now Non-Reusable due to an apparently unresolvable conflict with a server host. If you want to add new features or make changes to existing features, contact me here (or wherever else you can find me) to ask first—this is not intended to restrict most good-faith edits.

[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.

[TyroneSama]

HORNMOD V5 released.

- Use "hornlocaloverride" with a number between 1 and 200 to change all horns client-side. Try it with something short and quiet for a more relaxed experience.
- Use "shutup [name]" to almost completely silence a specific player's honking. Tired of that one guy who's pressed Wario Laughing 5 times every second for the past 45 minutes? Shove a baseball in their mouth.
- Server hosts: "hornsafepowerups" comes On by default, and prevents players from triggering spam protection while they're in Grow or Invincibility. Honk to your heart's content, it's scarier this way.
- unleashhell.

Note: Starting with V5, HORNMOD is now Non-Reusable due to an apparently unresolvable conflict with a server host. If you want to add new features or make changes to existing features, contact me here (or wherever else you can find me) to ask first—this is not intended to restrict most good-faith edits. Horn expansion packs and companion scripts are also still OK, and always will be.

Spoiler: hotfixes

V5-but-actually-working is up, preventing "shutup" resetting when it shouldn't, and fixing an issue where unleashing hell also unleashed midrace syncbombs. I guess the only appropriate way to update this thing was by breaking the entire addon. Hosts, please redownload if you grabbed the original V5 or V5-hellfix.

I apologize for trainwrecking this release a bit, HORNMOD is largely really old code and there are some things in here that I probably wouldn't do the same again if I'd written this script today. Please look forward to actual new horns in 2024.

[Nkromancer]

I've seen custom horns added in some modpacks, and I'd rather not just steal from them for my own.

[TyroneSama]

Uploaded V5-io. In this version, configs will be loaded from the "luafiles" directory using 1.3's new(ish) I/O support. No new features.

This should resolve config-search stalling for players with slow drives, and should help mitigate timeout-on-join issues on servers with incorrectly configured nettimeout.

(AFAIK there is literally no reason not to have this maxed.)

EDIT: Version "-io2" resolves issues where some dedicated servers running vanilla 1.3 would freak out at the new config system. This is because of a base game bug (currently fixed in master).

[IsabelleTheStoopYT]

I swear, i can't put in the commands.
How do you do it.
I wan't to turn off the spam protection
pls i want infinite doots