Files
GeyserWebsite/docs/geyser/geyser-command-line-arguments-and-system-properties.md
T
2023-11-07 20:24:02 -06:00

76 lines
3.4 KiB
Markdown

---
title: Geyser Command Line Arguments and System Properties
---
# Geyser Command Line Arguments and System Properties
Geyser offers a few command line arguments/system properties to allow you to configure Geyser without editing the config files.
Additionally, you can suppress some warnings that may be printed to the console.
## Configuration system properties
You can set Geyser to automatically bind to a specific address and port by using the following command line arguments.
This is primarily aimed at server hosting providers to automatically configure servers for users.
:::note
The Geyser specific properties are prioritized over the plugin properties!
:::
- ```-DgeyserUdpPort=server``` or ```-DpluginUdpPort=server```
- ```-1``` means UDP is not supported and will forcibly stop Geyser.
- ```server``` means to match the port of the TCP server.
- any other number means to use that specific port
- ```-DgeyserUdpAddress=server``` or ```-DpluginUdpAddress=server```
- ```server``` means to match the bind address of the TCP server
- any other string will be used as-is for the bind address.
## Disabling warnings and advanced configuration
You may disable some warnings that may be printed to the console by using the following command line arguments:
:::caution
Disabling Geyser warnings from being logged will not fix the real issue! Only disable them if you know what you are doing.
:::
- `-DGeyser.PrintSecureChatInformation=true`
- Allows you to disable the warning about secure chat being disabled.
Since the warning is sent when the server sends the warning, this option does not do much anymore.
- `-DGeyser.ShowScoreboardLogs=true`
- Allows you to disable warnings related to scoreboards, such as "Tried to update score without the existence of its requested objective".
- `-DGeyser.ShowResourcePackLengthWarning=true`
- Allows you to disable the warning about a resource pack having too long paths. Disabling this warning will not fix the underlying issue!
Console players might not be able to join your server at all if you have a resource pack with paths exceeding the 80 character limit.
- `-DGeyser.PrintPingsInDebugMode=true`
- Controls if pings are being logged in debug mode.
- `-DGeyser.UseDirectAdapters=true`
- Allows you to disable the usage of NMS adapters. Disabling will result in a performance penalty and should only be used for debugging.
This is Spigot-only and will not work on other platforms.
- `-DGeyser.BedrockNetworkThreads=8`
- Allows you to set the number of threads used for the Bedrock networking. This is not set to a specific number by default, but is instead calculated based on the available resources.
- `-DGeyser.AddTeamSuggestions=true`
- Allows you to turn off suggestions for teams in the scoreboard command. This is enabled by default, disabling this can help with performance if there are a lot of teams defined.
Setting "command-suggestions" to false in the config will also disable this.
## Geyser-Standalone Specific Options
### `--config [file]`
- **Alias: `-c`**
- Points to an alternative config file to use.
### `--gui` / `--nogui`
- **Alias: `gui` / `nogui`**:
- Forces GUI or non-GUI usage, depending on context.
## Overriding specific config values
Overriding a standard config option (e.g. `command-suggestions`):
`--command-suggestions=false`
Overriding a nested config option(e.g. the `remote` section with `address`):
`--remote.address=test.geysermc.org`