Transformice Api [TESTED]

Transformice uses a custom binary protocol over TCP. You cannot simply send JSON. You must either:

Transformice is a flash-turned-HTML5 multiplayer puzzle-platformer. Atelier 801 has never released an official external API. However, the game operates over a persistent socket connection (XMLSocket/WebSocket) using a proprietary text-based protocol. Community developers have reverse-engineered this protocol to create: transformice api

This report documents the known message formats, authentication flow, and practical usage. Transformice uses a custom binary protocol over TCP


Melanie (Atelier 801’s lead developer) has historically been private about API roadmaps. However, recent trends in the community suggest three developments: not critical infrastructure.


Here is a quick snippet of how you might fetch a player's statistics using a Node.js wrapper.

const tfapi = require('tfapi');
// Initialize with your API key (if required by the wrapper)
const api = new tfapi.Client('YOUR_API_KEY');
async function getPlayerStats(username) 
    try 
        const player = await api.player.get(username);
        console.log(`Player: $player.name`);
        console.log(`Cheese Gathered: $player.cheese`);
        console.log(`Firsts: $player.firsts`);
        console.log(`Tribe: $player.tribeName`);
     catch (error) 
        console.error("Mouse not found! Did they get banned?");
getPlayerStats("ExampleUser");

Atelier 801 does not officially publish a REST API for third-party developers. However, the official website and launcher use several JSON endpoints. The community has reverse-engineered these.

Warning: These endpoints may change without notice. Use them for small statistics bots, not critical infrastructure.