If you are a streamer looking to let your chat control the game, a guild leader wanting to run statistics, or a developer building an external tool, understanding the Transformice API is your first step.
| Command | Example | Purpose | |---------|---------|---------| | a[name] | aAlice | Authenticate as guest | | m[msg] | mHello! | Send chat message | | j[roomName] | jRoom1 | Join a specific room | | c | c | Create a new default room | | g | g | Get ready (start game) | | R | R | Respawn as mouse | | B | B | Become shaman (if eligible) | | e[itemId] | e3 | Place shaman item (3 = wooden plank) |
: You can manipulate map physics, listen to player events (joining, chatting, dying), and spawn objects or projectiles. in your tribe house or use the Lua script editor provided by Atelier 801 Key Events eventNewGame() : Triggered when a new map loads. eventPlayerChat(name, message) : Monitors chat for specific commands. eventSummoningEnd(playerName, itemType, x, y) : Runs when a shaman finishes a summon. Official Documentation : The most up-to-date reference is usually the Module FAQ & Documentation on the official forums or the in-game 2. External Bot Development (Transfromage)
While they don't always have a public REST API, many developers "scrape" or use community-shared database dumps from Atelier 801 Fansites How to Get Started Join a Module Team: transformice api
I can provide tailored code snippets and step-by-step setup instructions. Share public link
help you extract and use official game assets for your scripts. Pro-Tip: Official vs. Semi-Official Modules Official Modules : These are high-traffic minigames (like
These bots can log in, join rooms, listen to chat, and moderate tribes automatically. Authentication: The bot connects to the Atelier 801 socket servers. Packet Handling: If you are a streamer looking to let
Many developers use Python or Node.js to communicate with "Tribulle," the internal service Atelier 801 uses for social features (friends lists, tribe chat, and messaging). Community libraries mimic a game client to log into Tribulle and read these chat streams automatically. 2. Python-Transformice (aiotfm)
Have you built something cool with the Transformice Lua API? Share your scripts on the community forums—just don’t forget to save the cheese!
: Custom scripts that players can run in their own private rooms or tribe houses for testing and casual play. Development Resources in your tribe house or use the Lua
For over a decade, the existence of an accessible API has transformed this simple platformer into a sandbox for developers, graphic designers, and community leaders. This article explores the architecture of the Transformice API, how it enables custom rooms, modules, and bots, and why it remains a gold standard for community-driven game design.
: Access lists of tribe members, ranks, total spiritual points, and historical data.
: Use the tfm.exec functions for standard actions or define an event handler. For example, to post a message in the chat when a player joins:
For developers, creating a bot that interacts with Transformice is a rite of passage. Here is a high-level overview using Node.js or Python.
: Code triggers automatically on specific game events like a player joining, a mouse dying, or a game chat command being typed. 💻 Writing Your First Script