SCP 294

SCP-294

SCP-294 matches typed requests against configurable drink IDs and aliases.

Matching

Matching is case- and punctuation-insensitive:

1. exact aliases are checked first;
2. optional partial matching follows;
3. remaining candidates use fuzzy similarity against fuzzy_threshold.

Every drink also accepts its ID path and the path with underscores converted to spaces.

Drink definitions

A drink can configure:

• ID, enabled state, and aliases;
• result item and count;
• delay and pouring sound;
• coin use;
• cup color;
• whether the result is drinkable;
• refusal and action-bar text;
• potion effects;
• dispense and drink actions.

The configuration center includes a color picker and shows the configured cup color in drink and SCP-914 recipe lists.

From 3.0.7 onward, configurable drinks use one generic cup item instead of dozens of separately registered legacy drink items. Old-world item remapping and configuration normalization preserve the previous drink ID, aliases, color, effects, actions, delays, messages, and other supported behavior.

The cup's display name is generated from the configured drink without duplicating the Cup of prefix. Missing-texture output models from earlier 3.0.x builds were also corrected in 3.0.7.

Supported actions

• actionbar
• message
• sound
• particle
• visual_explosion
• effect
• remove_effect
• heal
• hurt
• kill
• set_fire

Every action may use delay_ticks. The older actions array is accepted as an additional alias for drink_actions.

Entity spawning is intentionally not a supported SCP-294 output.

Reloading

Use the configuration center's save action or:

/scpadditions reload

Unavailable optional item, effect, sound, or particle IDs are reported without invalidating unrelated drink entries.