Component for clothes to suppress emotes and scream action in general, and the muzzle to suppress vocal emotes in particular

Southbridge · July 11, 2025, 5:18pm

github.com/space-wizards/space-station-14

Component for clothes to suppress emotes and scream action in general, and the muzzle to suppress vocal emotes in particular

master ← Centronias:gag-screams-13776

opened 01:43AM - 02 Oct 24 UTC

## About the PR Made it so that Muzzles suppress all vocal emotes as well as th…e scream action, instead giving you a "You can't `emote` right now", eg. "You can't scream right now!". This is implemented by adding the `EmoteBlocker` component which marks an equippable as blocking emotes as specified by the component's configuration, which can block any combination of specific emotes or emote categories. ## Why / Balance Fixes https://github.com/space-wizards/space-station-14/issues/13776 The people want to be able to muzzle each other and have it be effective. ## Technical details - Added `BeforeEmoteEvent`, which is cancellable and contains a `Blocker: EntityUid?` field to indicate why the emote was cancelled, in the case that it was blocked by gear (modeled after how masks block food consumption) - This event was created rather than making `EmoteEvent` itself cancellable for two reasons: - Avoids needing to order a bunch of system handling of the event to make sure possible cancellation occurs before handling - `EmoteEvent` couldn't be both `HandledEvent` and `CancellableEvent` - This even is inventory relayed so that when it's raised on an entity, it's also raised on all of the gear the entity is wearing. - Made `EmoteEvent` extend `HandledEvent` instead of manually including a `Handled` field. - `ChatSystem` now raises a `BeforeEmoteEvent` just before `EmoteEvent` in order for systems to cancel the emote before any other system can try to perform it - A bunch of functions on this class related to emotes now return a boolean indicating if an emote did/should occur. - IMO this is messy and the system should instead handle sending a chat message as a reaction to the event, rather than to this boolean, but that seems like a larger change that shouldn't go in this PR. - In the case that `BeforeEmoteEvent` is cancelled, a popup is displayed to the emoter. If `Blocker` is not null, its included in the popup (eg. `You can't laugh because of the muzzle!`) - Added `EmoteBlockerComponent` which is the component which marks if something blocks emotes. It can block individual emotes, entire categories of emotes, or both. - Added `EmoteBlockerSystem` which is what actually checks if a `BeforeEmoteEvent` should be cancelled, and sets `Blocker` as appropriate. ## Media https://github.com/user-attachments/assets/69d7c138-9f37-4a2c-b33a-65cf00b1d54d Normal mob with and without muzzle, mime with and without muzzle, normal mob auto-gasping from airloss, zombie with muzzle. (Slightly out of date -- the `/me` emote style gets blocked now too) https://github.com/user-attachments/assets/137d7e95-ea61-404a-a3d1-52e706cc7c84 <details><summary>Old Media</summary> Screenshots: (Lemme know if you want a gifs -- but I'll need a recommendation on not-garbage screen recording software for Windows) *Note that for testing, I set the power gloves to block snapping and only snapping.* Can't cry while muzzled <img width="198" alt="image" src="https://github.com/user-attachments/assets/22b0bef3-1dd2-4201-8bc0-3121179f69d8"> Can't action scream while muzzled <img width="229" alt="image" src="https://github.com/user-attachments/assets/0d8a8efb-647c-4ea8-972a-0ca67e3b8e0a"> Can't snap while power gloved (again, only while testing) <img width="235" alt="image" src="https://github.com/user-attachments/assets/a4d24266-6851-4650-8b08-5d8e9e172fe6"> <details> <summary>Verification that the emotes still work without the clothes on</summary> Can cry without the muzzle on <img width="276" alt="image" src="https://github.com/user-attachments/assets/7240720b-6c8c-4a8a-96e1-f489119eefa9"> Can action scream without the muzzle on <img width="276" alt="image" src="https://github.com/user-attachments/assets/32cb8956-c8a4-4521-81fc-65e7e236dfc4"> Can snap without the gloves on <img width="258" alt="image" src="https://github.com/user-attachments/assets/45d94c1d-1341-49c4-b459-51dfecfa64a0"> Can clap with the gloves on <img width="274" alt="image" src="https://github.com/user-attachments/assets/c27a8f59-dfbe-4665-825b-b6b90faa1b9c"> Can `@custom emote` with the gloves on <img width="258" alt="image" src="https://github.com/user-attachments/assets/33d9e5be-8646-4eba-9100-13e3a21750e6"> </details> </details> ## Requirements - [X] I have read and am following the [Pull Request and Changelog Guidelines](https://docs.spacestation14.com/en/general-development/codebase-info/pull-request-guidelines.html). ## Breaking changes - Some public functions on `ChatSystem` related to emoting now return bools when they before didn't return a value - `EmoteEvent` is a class rather than a struct now - The emote "pipeline" now includes firing `BeforeEmoteEvent` prior to `EmoteEvent`, and can be cancelled by way of cancelling `BeforeEmoteEvent`. Modified en-US Localization of - `chat-emote-name-crying` - `chat-emote-name-cathisses` - `chat-emote-name-monkeyscreeches` to be in the imperative mood, which is consistent with the rest of the emote names. **Changelog** :cl: - tweak: Muzzles now prevent wearers from screaming and suppress sounds on audio emotes.

[Breaking Changes]

Some public functions on ChatSystem related to emoting now return bools when they before didn’t return a value
EmoteEvent is a class rather than a struct now
The emote “pipeline” now includes firing BeforeEmoteEvent prior to EmoteEvent, and can be cancelled by way of cancelling BeforeEmoteEvent.

Modified en-US Localization of

chat-emote-name-crying
chat-emote-name-cathisses
chat-emote-name-monkeyscreeches
to be in the imperative mood, which is consistent with the rest of the emote names.