Skip to content

Client#

The client{} closure is inside of mindustry{} closure hereinafter.

Related tasks: downloadClient, runClient

NOTE: Client and Server configuration have almost the same syntax, so in these chapters, client/server are used, which indicates that syntax can work both sides. Please select the proper one.

Game location#

The game location is an abstract file, which represents the Mindustry game.

You can rename the downloaded file with this clause, named.

client/server {
    official version: latest named 'LatestClient.jar'
}

client/server {
    mindustry official latest named "LatestClient.jar"
}

MGPP provides some simple clauses for downloading Mindustry: - official - be

Official#

To download the game from Mindustry official release. 

client/server {
    official version: 'v136'
}

client/server {
    mindustry official "v136"
}

As default, mgpp will download v136.

Notations#
  • latest: To download the latest official Mindustry from Mindustry official release, such as v126.2. NOTE: It will skip the pre-release.
client/server {
    official version: latest
}

client/server {
    mindustry official latest
}

Bleeding-edge#

To download the bleeding-edge from Mindustry bleeding-edge release. 

client/server {
    be version: '22853'
}

client/server {
    mindustry be "22853"
}

As default, mgpp will download a certain version to prevent errors when gradle configuring, but you shouldn't except this behavior.

Notations#
client/server {
    be version: latest
}

client/server {
    be official latest
}

From local file#

To copy the game file from a local file.

client/server {
    fromLocal 'E:/Mindustry/myMindustry.jar'
}

client/server {
    mindustry fromLocal 'E:/Mindustry/myMindustry.jar'
}

Overwrite from local properties#

You can declare a property mentioned below in local.properties, mgpp will consider it as a path to overwrite what you have already set before

  • For client: mgpp.client.location
  • For server: mgpp.server.location

TYPE: String

mgpp.client.location=E:/Mindustry/client.jar
mgpp.server.location=E:/Mindustry/server.jar

Foo's Client#

To download the Foo's Client from AntiGrief release.

NOTE: Since Foo's Client isn't an official client, mgpp doesn't guarantee the arguments below will properly work in your times.

At lease, as of press date, it works. Therefore, you may have to configure it on your own if necessary. 

client/server {
    from Foo(
        version: 'v8.0.0',
        release: 'erekir-client.jar'
    )
}

client/server {
    mindustry from Foo(
        version = "v8.0.0",
        release = "erekir-client.jar"
    )
}
  • version: The tag/version of which release you want to download.
  • release: The name of file attached into the release.

Keep other version#

Whether to keep other versions when a new version is downloaded.

  • keepOthers: To keep other versions when a new version is downloaded.
  • clearUp: To clean all other versions when a new version is downloaded.
client/server {
    keepOthers
    clearUp
}

client/server {
    keepOthers
    clearUp
}

Startup args#

The extra startup arguments for Mindustry game.

client/server {
    args += [ '-gl2' ]
}

client/server {
    args += listOf("-gl2") 
}