This repository has moved to https://codeberg.org/Adrodoc/MPL to avoid GitHubs two factor authentication (2FA) requirement. We believe that Microsofts decision to force all code contributors to use 2FA is very problematic for the following reasons:
2FA is a good technology, but it should be up to repository owners to decide whether it is appropriate for the project at hand. Requiring 2FA for all code contributions, even for code that is reviewed and merged by other people, is completely unnecessary and discourages contributions.
Author: Adrodoc
MPL is a language that makes it easier to write applications for Minecraft 1.9 or higher. The final result of compiling an MPL application are command blocks that can be imported into your world in various ways. MPL comes with it's own editor that supports syntax- and error-highlighting and has a built in compiler.
For an advanced example application written in MPL see ApertureCraft Vanilla
While MPL can be used to create very complex command block applications, it is also very easy to use for small projects. To use the command block generator you don't even need to know about any MPL specific syntax.
You can find a full tutorial for MPL here.
There are multiple ways to compile .mpl
files:
MPL is licensed under GNU General Public License. Any application compiled by the MPL compiler is free from this license even if the compiler inserted standard MPL code templates.
It would still be nice if you give credit to MPL, for example by using the following command in the installation of your application:
/tellraw @a [{"text":"This project was created using the\n ","color":"yellow"},{"text":"Minecraft Programming Language ","color":"gold"},{"text":"[MPL]","color":"aqua","hoverEvent":{"action":"show_text","value":{"text":"Click to open GitHub","color":"red"}},"clickEvent":{"action":"open_url","value":"https://github.com/Adrodoc/MPL"}}]
For manual use you can download the standalone compiler and IDE from GitHub.
MPL is also available both as library and standalone application at Sonatype OSS Maven Repository and Maven Central.
To get MPL using Maven add the following to your pom
:
<dependency>
<groupId>de.adrodoc55.mpl</groupId>
<artifactId>mpl-compiler</artifactId>
<version>1.3.2</version>
<scope>compile</scope>
</dependency>
In Gradle you can use the following example build.gradle
:
apply plugin: 'java'
repositories {
mavenCentral()
}
dependencies {
compile 'de.adrodoc55.mpl:mpl-compiler:1.3.2'
}
If you are missing a feature or just want to help out you can contribute to MPL by opening a pull request.
Here are some guidelines to make contributing easier:
compiler
and the ide
. Both of these directories are subprojects, that should be imported into your IDE.UTF-8
.gradlew eclipse
on a command line in the root directory.MPL is built using Gradle. You don't have to install Gradle, because the project contains a Gradle Wrapper along with the source files. To build custom jar files execute gradlew build
on Windows or ./gradlew build
on Unix systems. The jar files will be created in the directories MPL/ide/build/libs
and MPL/compiler/build/libs
.