Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/tinkerer9/collabokeys/llms.txt

Use this file to discover all available pages before exploring further.

CollaboKeys is not limited to a curated library of titles — it works with any game that meets three compatibility criteria. If a game clears all three, players can jump in, claim their keys, and start playing together with no additional setup required.

Compatibility Requirements

1

The game uses only keyboard input

CollaboKeys emulates keyboard events on the host machine, but it cannot move or click the mouse. Any game that requires mouse input for aiming, clicking UI elements, or controlling movement will not work. The entire gameplay loop — menus included — must be navigable by keyboard alone.
2

All keys the game uses are in the CollaboKeys supported list

CollaboKeys can only emulate the keys defined in src/keycodes.js. If a game requires a key that is not on the supported list (for example, Numpad keys), those inputs cannot be emulated and that game is not compatible. See Supported Keys for the full list of available and default-disabled keys.
3

The game uses at least as many keys as there are players

Because every player must own at least one key, the number of distinct keys a game uses must be greater than or equal to the number of players in the session. A 4-player session needs a game that uses at least 4 different keys. Games with only one or two active keys work best for solo or two-player sessions.

Game Genre Suggestions

These genres tend to be great fits for CollaboKeys because they rely on a small, predictable set of keyboard inputs that map cleanly to individual players.

Racing Games

Arrow keys for steering and acceleration make racing games a natural fit. Split the four arrow keys across four players and watch coordination (or the lack of it) unfold.

Platformers

Arrow keys for movement plus a jump key can be split between two players — one controls direction, the other controls jumping. Tight timing and constant communication required.

Puzzle Games

Directional input games like 2048 only need four keys, making them ideal for a clean four-way split. The slower pace also gives players more time to discuss strategy.

Party Games

Any game with simple, low-count key controls works well as a party game with CollaboKeys. The chaotic cooperative format is a game mechanic in itself.
2048 at https://2048-online.io is the perfect introductory CollaboKeys game. It uses exactly four keys — ArrowLeft, ArrowRight, ArrowDown, and ArrowUp — which means four players can each own one key and have complete, equal ownership over the board. Players can work together and communicate to maximize their score, or stay silent and let chaos decide. Either way makes for a great session.

Games That Won’t Work

Not every keyboard game is compatible. Here are the most common reasons a game may not work with CollaboKeys:
  • Mouse-dependent games — Any game that requires the mouse for aiming, shooting, interacting with objects, or navigating menus cannot be fully played through CollaboKeys alone.
  • Games using unsupported keys — If a game’s controls include keys that are not in the CollaboKeys supported list (such as Numpad keys), those inputs simply cannot be emulated.
  • Games with too few distinct keys for the group size — Technically, a game that uses only one key can still run, but only one player will ever be able to do anything. This is a poor experience for everyone else in the session.
You can enable or disable individual keys and revoke existing reservations from the admin panel at any time. This lets you customize which keys are available for a specific game — for example, disabling keys a game doesn’t use so players don’t accidentally claim them, or revoking all assignments between rounds to redistribute keys fairly.

Build docs developers (and LLMs) love