Essentials

Add more commands to the server.

This plugin was created because the creators were very angry with too many Griefers in Mindustry 4.0 Alpha version.
To create this plugin, I'm spent all night studying a programming language I hadn't looked at in my entire life. lol

Basically, this plugin focuses on finding cheats and griefers, but it adds additional features to make it useful on other servers as well.

Requirements

Requires Java 17 or higher!

It does not support use with other plugins.
This's a limitation of Mindustry and a problem that cannot be solved unless all plugin creators create a new common API specification.

For example, if libraries such as kotlin, ktor, flyway, exposed, slf4j, etc. are used by other plugins, they cause errors due to shared classloader and package conflicts.

Installation

Put this plugin in the <server folder location>/config/mods folder.

Modular builds

Use -PexcludeModules to compile an artifact without optional services. The matching Kotlin source, generated code, resources, and (for web) web-server libraries are excluded from both shadowJar and proguardJar.

# Standard JAR without the Web service and its assets/libraries
./gradlew :Essential:shadowJar -PexcludeModules=web

# Standard JAR without Discord and achievements
./gradlew :Essential:shadowJar -PexcludeModules=discord,achievements

# ProGuard JAR with every optional service omitted
./gradlew :Essential:proguardJar -PexcludeModules=services

Supported module names are achievements, bridge, chat, contribution, discord, effect, protect, vote, and web. achievement is accepted as an alias; services (also core/services) expands to every optional module. Run :Essential:verifyModuleExclusions with a shadowJar build to inspect the artifact and enforce that the requested code/resources are absent.

The full test suite targets the full distribution. For a modular build, the test task runs a headless Mindustry boot smoke test against the exact sources packaged in that artifact.

Client commands

Command	Parameter	Description
achievements	[page]	Show your achievements
broadcast	<message...>	Send message to all connected servers
changemap	<name> [gamemode]	Change the world or game mode immediately.
changename	<target> <new_name>	Change player name
changepw	<new_password> <password_repeat>	Change account password.
chars	<text...>	Make pixel texts on ground.
chat	<on/off>	Mute all players without admins
color		Enable color nickname
discord		Open server discord url
effect	<on/off/level> [color]	Turn other players' effects on or off, or set effects and colors for each level.
exp	<set/hide/add/remove> [values/player] [player]	Edit account exp values
fillitems	[team]	Fill the core with items.
fuck	[command]	Corrects and executes a command with typos
gg	[team]	Make game over immediately.
god	[player]	Set max player health
help	[page]	Show command lists
hub	<parameter> [ip] [parameters...]	Create a server to server point.
info	[player...]	Show player info
js	[code...]	Execute JavaScript code
kickall		Kick all players without admins.
kill	[player]	Kill player's unit.
killall	[team]	Kill all enemy units
killunit	<name> [amount] [team]	Destroy specific units
login	<id> <password>	Log-in to account.
log		Enable block history view mode
maps	[page]	Show server map lists
me	<text...>	Chat with special prefix
meme	<type>	Enjoy mindustry meme features!
motd		Show server's message of the day
mute	<player>	Mute player
nextmap	[map]	Set the next map to move to after game over
pause		Pause or Unpause map
players	[page]	Show current players list
pm	<player> <message...>	Send a private message
ranking	<time/exp/attack/place/break/pvp> [page]	Show player ranking
reg	<id> <password> <password_repeat>	Register account
report	<player> <reason...>	Report a player
rollback	<player>	Undo all actions taken by the player.
setitem	<item> <amount> [team]	Set item to team core
setperm	<player> <group>	Set the player's permission group.
skip	<wave>	Start n wave immediately
spawn	<unit/block> <name> [amount(rotate)/block_team] [unit_team]	Spawn units or block at the player's current location.
status		Show current server status
strict	<player>	Set whether the target player can build or not.
t	<message...>	Send a meaage only to your teammates.
team	<team> [name]	Set player team
time		Show current server time
tp	<player>	Teleport to other players
track		Display the mouse positions of players.
unban	<player>	Unban player
unmute	<player>	Unmute player
url	<command>	Opens a URL contained in a specific command.
vote	<kick/map/gg/skip/back/random> [player/amount/world] [reason]	Start voting
votekick	<player>	Start kick voting
weather	<weather> <seconds>	Adds a weather effect to the map.
ws	[args...]	WorldEdit selection and block manipulation

Server commands

Command	Parameter	Description
chat	<on/off>	Mute all players without admins
debug	[parameter...]	Debug any commands
gen		Generate wiki docs
kickall		Kick all players.
kill	<player>	Kill player's unit
killall	[team]	Kill all units
killunit	<name> [amount] [team]	Destroy specific units
mergeplayer	<from_uuid> <to_uuid>	Merge two player accounts (from → to).
mute	<player>	Mute player
reload		Reload essential plugin configs.
setfeedbackprovider	<player>	Set the FeedbackProvider achievement for a player
setmapprovider	<player>	Set the MapProvider achievement for a player
setperm	<player> <group>	Set the player's permission group.
strict	<player>	Set whether the target player can build or not.
team	<team> <name>	Set player team
tempban	<player> <time> [reason]	Ban the player for a certain period of time
unmute	<player>	Unmute player

README.md Generated time: 2026-05-20 20:44

License

Free License

You can copy and modify my source code and claim it as your own!
Because if you want to implement a specific features, the source code will be the same after all lol