Transformice Wiki
Collectible 54.png Cleanup
This page needs a cleanup to meet the Transformice Wiki's quality standards. You can help by editing it.

The Map Editor as it looks like in the menu

The Map Editor was released as part of update V0.63 on 22 August 2010. It's an official Transformice feature tool for helping mice to create user-generated maps. It's used to make maps, and without it, we would be stuck playing the same maps over and over. The map maker is the essence of uniqueness, and users use it to make maps so we may play them on Transformice.

Maps can then be published to everyone, and will be spawned randomly. Currently, the game interchanges between playing an official map, followed by a user created one. At the end of playing an unofficial map, players can vote if they like the map or not. If the popularity vote is below 50% and the map has 100 votes, maps get deleted from the server.

The numbers on the top bar indicate:

  • Grounds: #/50 means your ground limit. # is the number of grounds you have placed already. You can only place 50 grounds in a map. All grounds count towards this limit, it doesn't matter if they are dynamic or not.
  • Objects: #/30 means your object limit. 'Objects' are those that are found in the list of 'Shaman objects' (see left). Dynamic grounds do not count towards this. You may have a maximum of 30 objects in one map.

Related to the topic, the decorations limit is 40 and the maximum map size is 20kB. This is supposedly there to avoid decoration spam.


The basic interface

The Map Editor can be accessed by clicking on the menu button and then pressing "Map Editor." This takes the player to a different room from the one they were in—[Editeur] (and player's name next to it). No one besides that person can enter the room.

At the bottom of the editor are 5 categories:

  • Selector: When clicked, the player can click on already created objects to change their positions or delete them. While a "ground" or an "object" is selected, the player can change its properties. Everything has the X and Y Location properties.
    • For "Grounds", these properties include:
      • Length
      • Height
      • Dynamic Ground (whether or not it is movable while playing the map)
      • Mass (The "density" of the ground, most commonly used for weight)
      • Friction
      • Restitution (Also known as bounciness)
      • Rotation (The angle at which the ground is set at the beginning of map play)
      • Fixed rotation (Whether or not the ground can be rotated during play)
      • Linear Damping (The slowness of a ground in relation to gravity and the mass of the object moving it)
      • Angular Damping (The slowness of a ground in rotating).
    • For "Shaman Objects", these properties include only Rotation and Ghost Object (whether or not an object is invisible during play and mice can move through it). This does not apply to "Anchors", however, which have no properties other than X and Y Location (along with "Mice Stuff."
  • Grounds: This allows the player to put normal ground, ice ground, purple (trampoline) ground, red (lava) ground, or sticky (chocolate) ground into the stage. Click and drag to create large pieces of ground. These "preset" grounds have preset settings already. In comparison to normal ground, ice ground has 0 Friction; trampoline ground has 0 Friction and 1.2 Restitution (as opposed to 0.2); lava ground has 0 Friction and 20 Restitution; and chocolate ground has 20 Friction (and 0.2 Restitution).
  • Mice stuff: This allows the player to place mouse holes and cheese, and to specify where the shaman and the mice will spawn. On 7 July 2011, a new feature was added. You can now add decorations, like trees, grass and sand elements onto your map.
  • Shaman objects: This allows the player to place shaman items and anchors onto the map.
  • Map Settings: This allows the player to change the gravity, wind, collision (overlap) mode, and soul mates (partners) mode. The night mode setting has been removed, however, some maps such as map 97 still have it.

You can use the scroll wheel on your computer mouse to rotate grounds and shaman items. Objects located in the "Mice stuff" tab (decorations, spawns and cheese) are not rotateable.

There is currently a limit of 30 items per user created map and 40 ground blocks, though this can be exceeded with XML editing. (See below.)

Crane.png BugIf Mice Spawn or Shaman Spawn is selected with Selector, it will follow computer's mouse within game area, until player clicks on something else.

You can place shaman items that aren't available in editor menu by copying the map to the clipboard and editing the B value for objects.

The items seem to have been here since the 20 August 2010 update.


A map must be validated before it can be published. After pressing "validate map" you will start the map as a shaman, and you must get to the cheese and bring it to the hole to validate your map and prove that your map can be solved. After you have validated it you may upload your map. To upload a map, you must have already collected 1,000 overall, as well have 40 cheese in your possession at the time. The 40 cheese will be taken, but the 1,000 cheese is simply a prerequisite and will not be taken from you. After it has been uploaded it is available for other mice to play and vote on. You will be given a code that will allow you to reload your map to make changes and to see what your map's popularity is. After publishing, a map may get protected, thus reducing the initial cost of map creation to less than 40 cheese.


User created maps are randomly chosen in game just like the official maps are. After the map is finished only the mice that gathered more than 500 cheese are given the option to vote on the map. Users can see the current number of votes and the current percentage. They may vote yes, no, or don't vote. After a short period of time the voting window is closed. If a user has not voted by this time no vote is counted for them. Voting occurs after the map has finished and before the next map will start. The map will be deleted if less than 50% of the users say that they liked it. Ratings do not go into effect until a total of 50 votes have been cast. Maps are not immediately deleted once they reach under 50% rating, they might be deleted on a frequent basis.


Due to the fact voting is open to all mice, who all have their own map preference, some players feel that maps get rated on the difficulty rather than the quality of the map. Some players enjoy easier maps whilst others prefer more of a challenge or more unique maps. This can cause a difference in opinion regarding the voting system.

In an attempt to improve the quality of submitted maps, it was made so a requirement of 1000+ collected cheese is needed to upload a map as well as the sacrificing of 40 cheese. However again, people disagree on whether this attempt was a success.


Megaphone.png Main article: Ground

XML editing[]

Megaphone.png Main article: Map XML editing
Please note that XML editing is completely optional and not needed at all for standard maps. Simply using the Map Editor makes this XML for you behind the scenes. XML editing is often needed for more complex maps, or to bypass editor constraints (such as not allowing negative mass, or making a scrolling map). This section attempts to cover XML basics, however for more information check official forums

If you don't know about XML, you can learn more about XML on Wikipedia. In short, XML is comprised of tags and attributes. Tags have 2 different ways they can be written:

  • Element tag: <X>[more tags]</X>
  • Empty element tag: <X />

In Transformice, most data for our maps is stored in empty element tags, with element tags primarily being used to hold all the remaining tags.

Attributes go inside the tags like so, with the H being the attribute name and the "data" being the attribute value:

<X H="data" />

The XML of a map can be taken from the Map Editor by going to "Save / Load / Test", and hitting "Copy map to clipboard". From here, you should paste it into a text editor (a popular choice is notepad++). To place XML back into the editor, go to the "Save / Load / Test", and paste it in the text area right above the "load" button, and then hit load.

If you get disconnected while in the map editor, the XML will be in the disconnection message.


Megaphone.png Main article: Map Editor techniques


Megaphone.png Main article: Background


Megaphone.png Main article: Decoration

Patch notes[]

  • V0.72 – Admins can designate user-made maps as official maps, causing them to load only on the official maps. These are distinguished from non-permanent maps by the yellow creator's name and a cheese icon next to it.

See also[]

External links[]