From 8f877d3a56407a74fbe3b8c50e0b56993743e462 Mon Sep 17 00:00:00 2001
From: Brendan Golden <git@brendan.ie>
Date: Thu, 8 May 2025 17:39:44 +0100
Subject: [PATCH] doc: added how to set up a server as well as what suers need
 to do

---
 docs/Server_Setup_Minecraft.md | 88 ++++++++++++++++++++++++++++++++++
 docs/media/add_allocation.png  |  3 ++
 2 files changed, 91 insertions(+)
 create mode 100644 docs/Server_Setup_Minecraft.md
 create mode 100644 docs/media/add_allocation.png

diff --git a/docs/Server_Setup_Minecraft.md b/docs/Server_Setup_Minecraft.md
new file mode 100644
index 0000000..55c3c3f
--- /dev/null
+++ b/docs/Server_Setup_Minecraft.md
@@ -0,0 +1,88 @@
+# Server Setup
+
+## Requirements
+
+### Ports
+* 255XY - Java Port
+* 244XY - Bedrock Port
+* 233XY - Voice Chat port
+
+## Setup
+
+### Config
+1. In [this repo][config_01] create a new branch for the club/soc who wants the server.
+2. Push this branch to Forgejo.
+
+[config_01]: https://forgejo.skynet.ie/Skynet/minecraft_plugins_v2 
+
+### Server
+1. In the admin panel create a new server. [link][setup_01]
+2. ``Information``
+   * ``Primary Allocation``  
+     You will need to create allocations for both ports using the add allocation button   
+     ![add_allocation.png][setup_02]
+   * ``Owner``
+     * If the Club/Soc already has an account then use that
+     * Else use the plus:   
+       ![add_allocation.png][setup_02]  
+       To create a new account for them.
+       * ``username`` - THis should be the Club/Soc as lowercase.  
+         Check with Admin if they already have a Skynet account, if they have then use that.
+       * ``email`` - use ``$username@skynet.ie`` or ``$username@ulwolves.ie``
+         Do not use any other email.
+3. ``Egg Configuration``
+   * For the egg choose ``mcsleepingserverstarter-Packwiz-Purpur-Geyser-Floodgate``.
+   * For ``{{PACKWIZ_URL}}`` it is ``https://forgejo.skynet.ie/Skynet/minecraft_plugins_v2/raw/branch/$BRANCHNAME/pack.toml``.
+     * ``$BRANCHNAME`` is the name of the branch as done in [Config](#config).
+4. Move onto ``Environment Configuration``
+   * Memory give it about ``6144`` MB or so.
+   * Swap Memory give it about ``1024``
+   * ``Feature Limits`` give one or two backups.
+
+[setup_01]: https://panel.games.skynet.ie/admin/servers/create
+[setup_02]: media/add_allocation.png
+
+### Minecraft
+Now in the panel ye need to modify some files.  
+If an option is not already in teh file then create it.
+
+1. ``server.properties``
+   * ``enforce-secure-profile=false`` - This allows bedrock players to talk in text chat
+2. ``sleepingSettings.yml``
+   * ``serverName`` - This is what gets shown on users server listings when teh server is sleeping.  
+     ``GSoc, connect to wake up then reconnect in a min`` is what is on teh GSoc one,
+   * ``serverPort`` - Use the Java port ``255XY``
+   * ``bedrockPort`` - Use the Bedrock port ``244XY``
+3. ``plugins/Geyser-Spigot/config.yml``
+   * ``bedrock.port`` - Use the Bedrock port ``244XY``
+4. ``plugins/voicechat/voicechat-server.properties``
+    * ``port`` - Use the Voice port ``233XY``
+
+
+### DNS
+An entry needs to be added to the [Forgejo DNS Config][dns_01] in the form of ``minecraft.$NAME``.  
+Where ``$NAME`` is the name of teh club/soc, lowercase.
+
+[dns_01]: https://forgejo.skynet.ie/Skynet/nixos/src/branch/main/applications/games/minecraft.nix#L27
+
+### Users
+
+#### Discord Bot
+If the Club/Soc uses the Skynet Discord bot then you will need to add your username to it.  
+Instructions can be found here: [link][users_04]
+
+#### Java
+* Connect via ``minecraft.$NAME.games.skynet.ie``
+* If you want to use voice chat install it locally
+  * [Modrinth][users_02]
+  * [Wiki][users_03] (Has more detailed install instructions)
+
+#### Bedrock
+* Connect via ``minecraft.$NAME.games.skynet.ie``
+  * Port is ``244XY``
+* Bedrock users need to [link][users_01] their account to join the server
+
+[users_01]: https://link.geysermc.org/method/online
+[users_02]: https://modrinth.com/plugin/simple-voice-chat
+[users_03]: https://modrepo.de/minecraft/voicechat/wiki/installation
+[users_04]: https://forgejo.skynet.ie/Skynet/discord-bot/src/branch/main/doc/User.md#minecraft
\ No newline at end of file
diff --git a/docs/media/add_allocation.png b/docs/media/add_allocation.png
new file mode 100644
index 0000000..f96cf38
--- /dev/null
+++ b/docs/media/add_allocation.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:65145e8d9089d551162ce918919a16c93c2c685aa13cf344e393ebc9b52cdda8
+size 505