Headless

October 7, 2025 ยท View on GitHub

Minosoft has two gui modules, the main gui (so called eros) and the rendering. You can turn off both individually from each other.

Start arguments

Eros

To disable eros, just add --no-eros as start argument

Rendering

To disable rendering, just add --no-rendering as start argument.

Disable all gui

To disable all gui components you can also just add --headless as argument. If present, eros and rendering will be disabled.

Auto connect

Common options:

ArgumentDescriptionExampleDefault
--protocol-versionUse a specific version to connect1.20.4automatic
--accountUUID of the account to use. You can create an account with the account cli command. If the account does not exist, a temporary account with that name is automatically createdmoritzUsername of computer

Local

ArgumentDescriptionExampleDefault
--localSet connection mode to local--
--world-generatorType of the world generatordebug, flat, voiddebug
--world-storageType of the world storagedebug, memorymemory

Example: java -jar Minosoft.jar --local

Server

ArgumentDescriptionExampleDefault
--connectSet connection mode to server--
--addressAddress (with optional port) to connect tohypixel.net-

Example: java -jar Minosoft.jar --connect --address=hypixel.net --protocol-version=1.19.4 --account=9e6ce7c5-40d3-483e-8e5a-b6350987d65f

CLI

Minosoft features a command line shell, that can be used to manage it. Auto complete is available everywhere. It can also be accessed in the normal chat (starting with a dot .)

Account

  • account add microsoft
  • account list
  • account list @[type=minosoft:microsoft_account]

Ping

  • ping hypixel.net
  • ping hypixel.net 1.8.9

Connect

  • connect hypixel.net 1.19.4

Connection

  • session list
  • session disconnect @
  • session select 1 (The current selected session is used for session specific other commands)

Say

  • say Moritz is the best developer ever!

There are way more commands, those are just examples.