Mappet

ATTENTION: Development of the mod is no longer maintained by McHorse. It is now maintained by Chryfi. Official updates from Chryfi and other contributors continue, and efforts are underway to port it. If you want to help with official updates or porting, join the official McHorse's Discord server, so we can communicate with you. Source code is available on GitHub.

Mappet is a Minecraft mod (for 1.12.2 only) designed as a toolkit for creating adventure maps that surpass vanilla game capabilities. It can also be used for roleplay scenarios and, to some extent, for machinima in Minecraft.

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

Installation

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

After that, the Mappet mod should be installed and appear in Minecraft's mods menu. If Mappet does not appear in the mods menu, something went wrong.

Scripting

Mappet includes a scripting API that allows programming game logic in Minecraft using JS (ES5 by default) or Kotlin scripts. For more information, visit the Mappet wiki page about scripts.

JavaScript (ES5)

For JS scripts to work, you need to place the Nashorn jar (located in the Java (JRE/JDK) home folder at path lib/ext/nashorn.jar) into Minecraft's mods folder.

If you are already using the CustomNPCs mod with Mappet, you do not need to do this. If you use GraalVM instead of Oracle Java or OpenJDK, scripts should work without Nashorn due to GraalJS.

Kotlin Scripts

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

To make your script use Kotlin, rename the script to end with .kts, then Kotlin scripting will be used instead of the JS engine.

Resources

Currently, the mod is still in development, but here is a playlist of videos covering some Mappet mod features:

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