/mindustry-client

A custom client for mindustry supporting v5, v6 and v7! Also known as Foo's client.

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Yes v7 builds exist, check em out, they are pretty stable. https://github.com/mindustry-antigrief/mindustry-client-v7-builds/releases

This is my fork of mindustry v6. It will have various quality of life and automation features when complete. Logo

Release Update Tests (Unstable) Discord

A sandbox tower defense game written in Java.

Trello Board
Wiki
Javadoc

Changelog

Development/Unstable Builds

Running The Jar On Mac

For whatever reason, MacOS refuses to be normal. Running the jar is slightly harder, open terminal and type java -XstartOnFirstThread -jar <jar> where <jar> is the path to the jar file (just click and drag the file in).

Steam

  • Windows easy installer, run this command in a CMD window as admin (replace the path if needed): cd /d "C:\Program Files (x86)\Steam\steamapps\common\Mindustry" && del Mindustry.exe && mklink Mindustry.exe C:\Windows\System32\cmd.exe && curl -L -o jre\client.jar https://github.com/mindustry-antigrief/mindustry-client-v6-builds/releases/latest/download/desktop.jar && echo Done! then set the game's launch options to /c java -jar "%cd%\jre\client.jar"
  1. Installing the client on steam is rather easy, download the desktop.jar file from the latest release.
  2. Continue with the steps below for your operating system.

Windows

  1. Move the file to the jre folder where the game is installed as seen here.
  2. Accept the file replacement prompt.
  3. Open the game, and it should work just fine.
    1. If you don't want to do this every time the game updates, rename the new desktop.jar to client.jar, start a cmd window as admin, run cd /d "C:\Program Files (x86)\Steam\steamapps\common\Mindustry" && ren jre\desktop.jar client.jar & del Mindustry.exe && mklink Mindustry.exe C:\Windows\System32\cmd.exe && echo Done! (replace the path at the start if needed). Now, right click mindustry on steam, click properties then paste /c java -jar "%cd%\jre\client.jar" into the launch options (changing the steam path again if needed). You should no longer need to install the client every time the game updates.

Mac OS

  1. Open the game install folder, right click the Mindustry.app file and click Show Package Contents.
  2. Navigate to the Resources folder Contents > Resources.
  3. Replace the desktop.jar with the one you just downloaded.
  4. Launching the game should now start the client.
  • To uninstall the client, delete the desktop.jar file in Resources as well as the Mindustry file in the MacOS folder. Start the game, accept the error and start it again.

Linux

  1. You are using linux, I'm sure you can figure this out yourself.

Contributing

See CONTRIBUTING.

Building

Bleeding-edge builds are generated automatically for every commit. You can see them here.

If you'd rather compile on your own, follow these instructions. First, make sure you have JDK 14 installed. Open a terminal in the root directory, cd to the Mindustry folder and run the following commands:

Windows

Running: gradlew desktop:run
Building: gradlew desktop:dist
Sprite Packing: gradlew tools:pack

Linux/Mac OS

Running: ./gradlew desktop:run
Building: ./gradlew desktop:dist
Sprite Packing: ./gradlew tools:pack

Server

Server builds are bundled with each released build (in Releases). If you'd rather compile on your own, replace 'desktop' with 'server', e.g. gradlew server:dist.

Android

  1. Install the Android SDK here. Make sure you're downloading the "Command line tools only", as Android Studio is not required.
  2. Set the ANDROID_HOME environment variable to point to your unzipped Android SDK directory.
  3. Run gradlew android:assembleDebug (or ./gradlew if on linux/mac). This will create an unsigned APK in android/build/outputs/apk.

To debug the application on a connected phone, run gradlew android:installDebug android:run.

Troubleshooting

Permission Denied

If the terminal returns Permission denied or Command not found on Mac/Linux, run chmod +x ./gradlew before running ./gradlew. This is a one-time procedure.

Gradle may take up to several minutes to download files. Be patient.
After building, the output .JAR file should be in /desktop/build/libs/Mindustry.jar for desktop builds, and in /server/build/libs/server-release.jar for server builds.

Feature Requests

Post feature requests and feedback here.

Downloads

Powered by Vercel