ATTENTION: This mod is no longer being maintained by McHorse. It is now maintained by Chryfi. There are still going to be official updates by Chryfi and other contributors and there have been task forces that are investigating on porting it. If you also want to contribute to official updates, or to the porting effort, please join the official McHorse's Discord server, so we can communicate with you. Check out the source code.


CurseForge pageGitHubWiki

Mappet is a Minecraft mod (for 1.12.2 exclusively) that is designed as a tool set for far superior adventure maps than possible with vanilla. It's also possible to use Mappet for scripted roleplays, and, to some extent, in Minecraft machinimas.

Special thanks to Andruxioid for the mod's name, Jvonlins, Centryfuga and CustomNPCs Forever Vkontakte group for testing, suggestions and directing!


Install Minecraft Forge, download the latest stable version of jar file for available Minecraft version. Also install following mods: McLib, Metamorph, and Blockbuster. Put it in minecraft's mods folder, and launch the game.

After that, Mappet mod should be installed and will appear in Minecraft's mods menu. If Mappet didn't appear in the mods menu, then something went wrong.


Mappet features scripting API, which allows program game logic within Minecraft using JS (ES5 by default) or Kotlin scripts. For more information, visit Mappet wiki's page about scripts.

JavaScript (ES5)

For JS scripts to work, you would need to get Nashorn jar (which is located in Java's (JRE/JDK) home folder by path lib/ext/nashorn.jar) into Minecraft's mods folder.

If you're already If you're already using CustomNPCs mod with Mappet, you don't need to do this. If you use GraalVM instead of Oracle's Java or OpenJDK, scripts should work without Nashorn due to GraalJS.

Kotlin scripts

For Kotlin scripts to work, you would need Mappet 0.3+ and to download this fat jar and place it in Minecraft's mods folder. By default, scripts are assumed to be using JS.

To make your script use Kotlin scripting, you need re/name your script ending with .kts, then instead of JS scripting engine, Kotlin scripting would be used.


At the moment, the mod is still in development, however, here is a playlist of videos that cover some Mappet mod's features:

Alternatively, there is an almost complete wiki describing all Mappet's mechanics. If you'll have questions about the mod, you can also join Mappet's Discord server.