Developer Quota for third rewrite:
TBSC - to be scrapped
TBSH - to be shelved
I - idea
author comment: oh my fucking god
- Initial Code - 0.001
- [] Content
- [] Entity classes
- [] Weapon master entities
- [] Multi-life entities
- Ghost entities - 0.002
- []
Magic entities(Shelved)
- [] Weapon classes
- Named weapons - 0.002
- Toggle weapons - 0.002
- [] Basic control UI
- [] Bullet classes
- [] Invincibility bypass bullets
- [] Flying continuous lasers
- [] Yellow
- []
Balancing attempt(nah) - VFX (TODO) - 0.002
- []
- [] Weapons from legacy codebases + New weapons
- [] "Reasonable" weapons
- [] Rapid-fire Blasters
- [] Explosive Artillery Cannons
- [] High-powered Railgun
- [] Unreasonably overpowered weapons
- [] Laser Barrage
- [] Bullet Storms
- [] Homing Bomber Flares
- [] H.E. Rounds
- [] Electromagnetic Pulse Wave
- [] Ghost Call
- [] High-speed Booster
- [] 8X Rotating Lasers
- [] H.EN. Electric Orbs
- [] 4X Railguns
- [] "Reasonable" weapons
- []
Spells(Shelved)
- [] Entity classes
- [] UI (complete implementation)
- Notifications - 0.002
- [] Life counter
- [] Weapon manager
- []
Spell controller(Shelved)
- [] Others
- Automatic update checker - 0.002
- [] Downloader
- Popup (Notification) - 0.002
- [] Discord RPC
- [] Extensions (TBSH?)
- Automatic update checker - 0.002
A random piece of chaos I made. Mostly just a mod containing whatever comes in mind for me.
There's also the unmaintained JS version if you need it for some reason.
- Install Java 17+ (Select either regular EXE installer or MSI installer) and Git/GH (Optional) through
winget install -e --id Git.Git
/winget install -e --id GitHub.cli
. - Download the source code through GitHub or clone the repository with
git clone https://github.com/SMOLKEYS/yellow-java
orgh repo clone SMOLKEYS/yellow-java
. - Run
./gradlew jar
in the mod's root directory. This should download any needed dependencies and build a JAR file located inbuild/libs
. Import it into the game.
The steps are practically the same for Windows, but you go with it differently. It's also assumed you know what you're doing since it's, well, Linux. But a step-by-step is still provided anyway.
- Install Java 17+ (Mindustry is run using Java, so you probably already have it installed) and Git/GH (Optional) through your package manager.
- Download the source code through GitHub or clone the repository with
git clone https://github.com/SMOLKEYS/yellow-java
orgh repo clone SMOLKEYS/yellow-java
. - Run
./gradlew jar
in the mod's root directory. This should download any needed dependencies and build a JAR file located inbuild/libs
. Import it into the game.
Yes, you can build on Android. This also applies for most java mods out there.
- Install Termux through F-Droid or the repositories releases section. You're better off with the F-Droid one, as it automatically provides the correct APK for your device.
- Run
pkg update && pkg upgrade
to upgrade necessary packages. - Install Java 17 through
pkg in openjdk-17
and Git/GH (Optional) throughpkg in git gh
. - Download the source code through GitHub or clone the repository with
git clone https://github.com/SMOLKEYS/yellow-java
orgh repo clone SMOLKEYS/yellow-java
.
Warning
Building the mod at this point is useless and not recommended, as you can't even import it into Mindustry. See what Warning 2 says below.
Tip
For Windows and Linux only.
You can use the ./gradlew copy
task, so it builds the mod and copies it to Mindustry's mods directory.
Warning
The output JAR provided by building the mod in any of the first 2 ways is NOT compatible with Android. See Multiplatform section just below.
Warning
Because of limitations that Google applied to Android 14+, Mindustry v147 and beyond on such Android versions may fail loading Java mods entirely, depending on how OEMs implement said versions.
This is something us modders nor Anuke can fix.
"Google, fuck you."
Note
It is more than recommended to see how it works by following the steps above for the PC-only jar.
Because Android's a piece of shit, this section has to exist.
If you already have the necessary tools, you can skip the steps here and run ./gradlew deploy
.
- Run
setup-windows.bat
. This will download all necessary stuff needed to compile for Android. - Restart the command line window you ran it on. If you ran it in an IDE, restart it, so it detects the changes.
- Go back to the mod directory and run
.\gradlew deploy
. This should build a multiplatform JAR compatible for both Android and Desktop.
//TODO: I don't know how real Linux works. Android Linux sucks.
Yes, you can build the mod for Android in Android.
- Run
setup-android.sh
in the mod's root directory with./setup-sdk.sh
. This will only work in a Bash shell. 1.5. If it returns a permission denied error,chmod 755 setup-sdk.sh
then run it again. - Restart Termux.
- Go back to the mod directory and run
./gradlew deploy
. This should build a multiplatform JAR compatible for both Android and Desktop. By getting this far you should at least know how to import it.
Tip
For Windows and Linux: If you have access to ADB, you can connect your Android device to your machine either through USB or Wi-Fi and run ./gradlew androidCopy
. This builds the mod and copies it to Mindustry's mod directory in the device.
For Android: You can install ADB with pkg in android-tools
and connect it to your device. Once you do that, you can use ./gradlew androidCopy
in Termux too!
Any: Provi
6FD1
ding -Padb.quickstart=true
and/or -Padb.useBE=true
after ./gradlew androidCopy
works. adb.quickstart
tells it to open Mindustry after building the mod and copying it. adb.useBE
tells it to copy the mod to the Mindustry BE mods directory instead. Using both in tandem will build the mod, then open Mindustry BE after copying it.
NOTE: This only works if your device has Development settings enabled and either Wireless/USB debugging turned on.
xzxADIxzx - Weapon Switch UI, Import handling
Mnemotechnician - Weapon Switch Functionality
Dryehm - "Menu Man 3" Achievement
Janssendel - David's Star effect for Bullethell
Links |
---|
SMOLHome Discord Server |
The Original Project Repository (JS) |
Date | Event | Info |
---|---|---|
August 5, 2021 | Part 1 | The first image of the flare |
August 5, 2021 | Part 1 | Flare named "Yellow" (by ffx#0370) |
August 5, 2021 | Part 1 | Project commited to GitHub |
August 21, 2021 | Part 1 | Uploaded yellow sprite |
December 6, 2021 | Part 2 | Creation of the Java version of the project, aka this repository (+ archival of old JS repo) |
March 22, 2024 | Part 3 | Rewrite of entire codebase in pure Java (+ archival of this repo) |
January 2, 2025 | Part 4 | Second rewrite of entire codebase, with this repo |