Anomalous Coffee Machine Modding Guide – Add Your Own Words

Anomalous Coffee Machine officially supports modding: you can add your own words, transformations, and events, and share them on itch.io. This guide explains how modding works and how to make your first word mod.

What you can mod

• Words: add new input words the machine recognizes, with custom cup art and descriptions.
• Transformations: define what happens when a word is drunk — by the girl or by you.
• Events: script multi-step sequences tied to words or word combinations.

Mods are distributed as files you drop into the game's mod folder, and they appear in-game alongside the base word list. The community hub for sharing them is the game's itch.io page, where modders upload their packs as separate downloads.

Before you start

You need the desktop build (Windows, Mac, or Linux) — modding is a files-on-disk workflow, so the browser version will not work for creating mods. Basic comfort with editing text/JSON files helps; no programming background is required for simple word mods. Back up your save first: mods that add broken words can usually be removed cleanly, but a backup removes all risk.

Making your first word mod

1. Find the mod folder. In the game's install directory, look for the mods folder (check the game's itch.io devlog or community guides for the exact path in the current version — it has moved between updates).
2. Copy an example. The community shares template mods with one working word. Start from a template, not from scratch.
3. Define your word. Give it the input text, the cup description, and what happens on drink. Keep the first one simple: a word, a cup, one event.
4. Test in-game. Load the game, type your word, and check both drink options (girl and self).
5. Share it. Upload the mod file to itch.io with a clear description of what it adds and which game version it targets.

Modding etiquette

Label your mod clearly: which game version it needs, what it adds, and whether it changes base-game words. Do not re-upload other people's mods as your own. And keep mods within itch.io's content rules — the platform hosts the game, so its guidelines apply to mods too.

Where to find mods

Browse the game's itch.io community section and the devlog comments — that is where modders announce releases. Word-pack mods are the most popular category: they extend the discovery list far beyond the base 730+ words, which makes them great for players who have exhausted the vanilla game.

New to the game itself? Start with our beginner's guide.