mirrors/Mindustry
1
Fork 0
mirror of https://github.com/Anuken/Mindustry.git synced 2025-12-05 18:30:22 -08:00
Code Issues Projects Releases Wiki Activity
The automation tower defense RTS
19414 commits 4 branches 172 tags 2.3 GiB
Find a file
Github Actions 4981808529 Automatic bundle update
2025-08-24 22:37:19 +00:00
.github Update deployment.yml 2025-04-14 11:38:31 -04:00
android Fix Android loadJar (#10867) 2025-06-02 14:32:24 -04:00
annotations Merging changes from private branch 2025-04-04 11:47:35 -04:00
core Automatic bundle update 2025-08-24 22:37:19 +00:00
desktop Added -gltrace desktop launch flag 2025-07-23 11:41:16 -04:00
fastlane Typo & gammar fix for Vietnamese translation on Steam achivements (#10718) 2025-07-22 00:13:59 -04:00
gradle/wrapper Closes Anuken/Mindustry-Suggestions/issues/5742 2025-07-22 11:41:15 -04:00
ios More iOS arch fixes 2025-04-30 21:54:27 -04:00
server Improve server control and logging of the DOS blacklist (#10904) 2025-06-07 00:13:15 -04:00
tests Fixed tests 2025-05-04 23:32:32 -04:00
tools Runes added to font 2025-08-24 17:53:35 -04:00
.gitignore WIP sector icons 2025-04-08 01:23:58 -04:00
build.gradle Added -gltrace desktop launch flag 2025-07-23 11:41:16 -04:00
CONTRIBUTING.md Merging changes from private branch 2025-04-04 11:47:35 -04:00
gradle.properties Utility schematic method changes / Geothermal map submission update 2025-08-20 12:09:25 -04:00
gradlew Upgraded to Gradle 7 & JDK 16 2021-06-14 10:41:19 -04:00
gradlew.bat Upgraded to Gradle 7 & JDK 16 2021-06-14 10:41:19 -04:00
ISSUES.md
jitpack.yml Unusual. 2022-09-19 11:04:33 -04:00
LICENSE Removed non-license notice from the end (#8524) 2023-04-21 21:32:30 -04:00
README.md Update README.md (#10954) 2025-06-21 21:15:57 -04:00
SERVERLIST.md Update SERVERLIST.md 2025-08-09 12:16:45 -04:00
servers_v6.json Removed v7 server from v6 list 2023-10-31 19:37:48 -04:00
servers_v7.json Update servers_v7.json (#11116) 2025-08-16 15:34:00 -04:00
settings.gradle Finalized launch pad mechanics 2025-02-02 18:10:15 -05:00
TRANSLATING.md Update TRANSLATING.md 2021-10-10 13:47:44 -04:00

README.md

Logo

Build Status Discord

The automation tower defense RTS, written in Java.

Trello Board
Wiki
Javadoc

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 17 installed. Other JDK versions will not work. Open a terminal in the Mindustry directory 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. In the unzipped Android SDK folder, find the cmdline-tools directory. Then create a folder inside of it called latest and put all of its contents into the newly created folder.
  3. In the same directory run the command sdkmanager --licenses (or ./sdkmanager --licenses if on linux/mac)
  4. Set the ANDROID_HOME environment variable to point to your unzipped Android SDK directory.
  5. Enable developer mode on your device/emulator. If you are on testing on a phone you can follow these instructions, otherwise you need to google how to enable your emulator's developer mode specifically.
  6. 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 device/emulator, 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.

Where is the mindustry.gen package?

As the name implies, mindustry.gen is generated at build time based on other code. You will not find source code for this package in the repository, and it should not be edited by hand.

The following is a non-exhaustive list of the "source" of generated code in mindustry.gen:

  • Call, *Packet classes: Generated from methods marked with @Remote.
  • All entity classes (Unit, EffectState, Posc, etc): Generated from component classes in the mindustry.entities.comp package, and combined using definitions in mindustry.content.UnitTypes.
  • Sounds, Musics, Tex, Icon, etc: Generated based on files in the respective asset folders.

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