Merge remote-tracking branch 'potatocider/docker' into general-devel

docs/_sidebar.md

@@ -1,6 +1,7 @@
 * [☕️⚡️ TShock documentation home](/)
 * [Changelog](/changelog.md)
 * [Command line parameters](/command-line-parameters.md)
+* [Docker Setup](/docker.md)
 
 * Subsystems
   * [Tile providers](/tile-providers.md)

docs/changelog.md

@@ -70,6 +70,8 @@ Use past tense when adding new entries; sign your name off when you add or chang
 * Fix players being kicked after using the Flamethrower to apply the `OnFire3` debuff for `1200` ticks. (@BashGuy10)
 * Fix being kicked for using the new sponge types on liquid. (@BashGuy10)
 * Allow flask buffs to be applied on town npc due to the Flymeal. Add a permission could skip the buff detection. (@KawaiiYuyu)
+* Dockerize TShock (@PotatoCider)
+
 
 ## TShock 4.5.18
 * Fixed `TSPlayer.GiveItem` not working if the player is in lava. (@PotatoCider)

docs/docker.md

@@ -0,0 +1,45 @@
+# Docker Setup
+
+In order to run TShock in a docker container, you would need to have mountpoints for
+ - `/tshock` (TShock config files, logs and crash reports)
+ - `/worlds`
+ - `/plugins`
+ - `/server` (optional, if you want to mount TShock's cwd)
+
+These folders can be mounted using `-v <host_folder>:<container>`
+
+Open ports can also be passed through using `-p <host_port>:<container_port>`.
+ - `7777` for Terraria
+ - `7878` for TShock's REST API
+
+For Example:
+```bash
+# Building the image
+docker build -t tshock:linux-x64 --build-arg TARGETPLATFORM=linux-x64 .
+
+# Running the image
+docker run -p 7777:7777 -p 7878:7878 \
+           -v /home/cider/tshock/:/tshock \
+           -v /home/cider/.local/share/Terraria/Worlds:/worlds \
+           -v /home/cider/tshock/plugins:/plugins \
+           --rm -it tshock:linux-x64 \
+           -world /worlds/backflip.wld -motd "OMFG DOCKER"
+```
+
+## Building for Other Platforms
+
+Using `docker buildx`, you could build [multi-platform images](https://docs.docker.com/build/building/multi-platform/) for TShock.
+
+For Example:
+```bash
+# Building the image using buildx and loading it into docker
+sudo docker buildx build -t tshock:linux-arm64 --platform linux/arm64 --load .
+
+# Running the image
+docker run -p 7777:7777 -p 7878:7878 \
+           -v /home/cider/tshock/:/tshock \
+           -v /home/cider/.local/share/Terraria/Worlds:/worlds \
+           -v /home/cider/tshock/plugins:/plugins \
+           --rm -it tshock:linux-arm64 \
+           -world /worlds/backflip.wld -motd "ARM64 ftw"
+```