55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
## Connecting to a server's CLI
|
|
To connect to a server's RCON Minecraft console, run
|
|
`docker exec -it minecraft_e6 rcon-cli --password thanksitzg`
|
|
If you get "Failed to connect to RCON serverrcon: authentication failed", check the `server.properties` values for `enable-rcon` and `rcon.password`.
|
|
Do not prefix commands with `/`.
|
|
|
|
- https://github.com/itzg/docker-minecraft-server#interactive-and-color-console
|
|
- https://github.com/itzg/docker-minecraft-server#use-rcon-commands
|
|
|
|
## Updating MC-Router mappings
|
|
MC-Router must be running for all active MC connections. Restarting it kicks everyone off their servers
|
|
|
|
To update the mappings while running, use `docker exec minecraft_mc-router /mc-router --mapping <new-mapping string>`
|
|
|
|
## Before Starting a Server
|
|
Check the following server.properties values:
|
|
| Parameter | Value | Why |
|
|
|:--:|:--:|:--:|
|
|
| `allow-flight` | true | Many modded features trigger Minecraft's flight detection. Allow flight to prevent wrongful bans.
|
|
| `enable-rcon` | true | This overrides any rcon settings in the compose file. Enable rcon to interact with the server's command line |
|
|
| `max-tick-time` | 600 normally, 120000 when pre-genning chunks | Increase the max tick time to prevent the hang watchdog from killing the server when pregenning chunks |
|
|
| `rcon.password` | `thanksitzg` | Set a simple password to protect the rcon port |
|
|
| `rcon.port` | `25575` | Set this to what itzg's rcon-cli expects as default |
|
|
| `view-distance` | 10 for lightweight servers, 6 for heavy servers | View distance has great impact on server load |
|
|
|
|
## Chunk Pregenerator
|
|
Chunk pregeneration is very valuable for getting a playable SMP server expierence.
|
|
### Installing Chunk Pregenerator
|
|
Make sure that the [Chunk Pregenerator](https://www.curseforge.com/minecraft/mc-mods/chunkpregenerator) mod is installed. It is compatible with most Minecraft versions between 1.7.2 and 1.16.5.
|
|
### Pregenerating World Spawn
|
|
To pregen chunks, first connect to the server's RCON CLI. Then, run the following,
|
|
`pregen start gen radius Pregen SQUARE 0 0 100`
|
|
This should take about half an hour and will generate about 40,000 chunks (2r^2).
|
|
For a job closer to 8 hours, run
|
|
`pregen start gen radius Pregen SQUARE 0 0 500`
|
|
Which will generate about 500,000 chunks.
|
|
|
|
A Ryzen 7 5800X generates chunks at about 1.35 chunks per tick (27 chunks per second @ 20 TPS).
|
|
|
|
### Automating Chunk Pregen
|
|
Itzg's [container supports](https://github.com/itzg/docker-minecraft-server#use-rcon-commands) `RCON_CMDS_FIRST_CONNECT` and `RCON_CMDS_LAST_DISCONNECT` environment variables, which allow us to automatically begin pregenerating chunks when no one is connected, and pause this task when players begin joining.
|
|
|
|
Use these variables when the server supports pregen and would benefit from this:
|
|
```
|
|
RCON_CMDS_STARTUP= |-
|
|
/pregen start gen radius Pregen SQUARE 0 0 500
|
|
RCON_CMDS_FIRST_CONNECT= |-
|
|
/pregen pause
|
|
RCON_CMDS_LAST_DISCONNECT= |-
|
|
/pregen continue
|
|
```
|
|
This pregen will significantly reduce load on the server during playtime *unless*:
|
|
* Players explore beyond the pregenerated regions, or
|
|
* Players join the server before a significant area can be pregenerated.
|