A Minecraft Mod, based entirely off of the AliensVsPredator franchise. It's also based off of other related franchises. That means it includes everything from xenomorphs to predaliens, plasma casters to pulse rifles, equipment to study the species with, dimensions, and of course plenty of blocks to start Building Better Worlds™


AliensVsPredator (Minecraft Mod)




Please read the following if you plan on contributing to this project. It is very important to have your development environment set up properly. Aside from that, pull requests that do not follow the same format will not be accepted.

1) Clone The Repository

Open your command line, and execute the following commands:

  1. git clone git@github.com:Ri5ux/AliensVsPredator.git
  2. cd AliensVsPredator

2) Setup the Development Environment

Note: If Gradle is not installed on your system, you may use ./gradlew on Unix based platforms or ./gradlew.bat on Windows platforms.

  1. Run gradle setupDecompWorkspace and wait for it to complete.
  2. Once completed, copy mdxlib_at.cfg from the mdxlib jar located in your .gradle cache directory with the following structure .gradle\caches\modules-2\files-2.1\com.arisux\mdxlib\X.X.X.X\0000000000000000000000000000000000000000\mdxlib-X.X.X.X-deobf.jar.
  3. Paste mdxlib_at.cfg into this repo's src\main\resources\ directory.
  4. Run gradle setupDecompWorkspace once more. This time, it should detect an Access Transformer. If it does not, then you have copied it to the wrong location.

3) Setup your IDE

Note: If you experience any errors setting up your IDE, please run gradle setupDecompWorkspace --refresh-dependencies to rule out any dependency related issues.

IntelliJ IDEA

  1. gradle idea


  1. gradle eclipse

Updating your Repository

Run the following to sync your copy of the repository up with the latest changes:

  • git pull

If you experience any new errors, it may be due to a dependency change. Please refresh your dependencies:

  • gradle --refresh-dependencies

Building the Project

Before you can initiate the build process, you must create a new text document with the name gradle.properties in the root directory of the repository. Then add curseForgeApiKey=00000-00000-00000-00000-00000 to the start of the configuration and save it.

Note: If the above entry is not added, the build process will fail.

If you run into build problems, you may also need to add mavenUsername=null and mavenPassword=null on their own respective lines.

To initiate the build process, run gradle build. You can find the compiled project artifacts in ./build/libs.