Skip to main content

Configuration

spark has a limited set of configuration options. Most users will never need to change from the defaults. For this reason, the configuration file is not automatically generated.

To change options from their default settings, you need to create the configuration file. The file is named config.json, and should be placed inside the spark folder.

Options​

Below is a list of the available configuration settings.

backgroundProfiler​

If background profiling is enabled.

When true, spark will automatically start profiling in the background when the server/client/proxy starts up. The profile can be uploaded using the usual commands. The default value is true.

Example​

{
    "backgroundProfiler": true
}

backgroundProfilerInterval​

The interval that the background profiler should sample at. The default value is 10 (milliseconds).

Example​

{
    "backgroundProfilerInterval": 10
}

backgroundProfilerEngine​

The engine that the background profiler should use.

The default value is "async", but "java" is also supported.

Example​

{
    "backgroundProfilerEngine": "async"
}

viewerUrl​

The URL used when providing a link to the viewer in command outputs.

The data "code" is appended after the URL, so it should always end with a /.

The default value is "https://spark.lucko.me/".

Example​

{
    "viewerUrl": "https://spark.lucko.me/"
}

bytebinUrl​

The URL for the bytebin instance which profiles & heap dump summaries should be uploaded to. The URL should end with a /.

The default value is "https://spark-usercontent.lucko.me/".

Example​

{
    "bytebinUrl": "https://spark-usercontent.lucko.me/"
}

bytesocksHost​

The hostname for the bytesocks instance which should be used for communicating with the spark viewer.

The default value is "spark-usersockets.lucko.me".

Example​

{
    "bytesocksHost": "spark-usersockets.lucko.me"
}

overrideTpsCommand​

If spark should override the default TPS command with its own. This setting is only read when spark is running on a Bukkit server.

The default value is true.

Example​

{
    "overrideTpsCommand": true
}

disableResponseBroadcast​

If spark shouldn't broadcast command output to all online administrators (players with the necessary permissions to use spark).

The default value is false.

Example​

{
    "disableResponseBroadcast": false
}