Termux + Playit Minecraft Server Guide

content/termux-+-playit-minecraft-server-guide.md

@@ -0,0 +1,200 @@
++++
+title = "Termux + Playit Minecraft Server Guide"
+tags = ["Minecraft", "Termux"]
++++
+
+# Termux + Playit Minecraft Server Setup Guide
+
+This guide walks you through setting up a Minecraft 1.21.11 vanilla server on an Android device using Termux, and then sharing it to the internet using playit.gg
+
+> **⚠️ Note: Running servers on Android is for small private servers. Performance depends heavily on your device.**
+
+> Minecraft server documentation:  
+> https://minecraft.fandom.com/wiki/Tutorials/Setting_up_a_server
+
+## Requirements
+
+* Android device  
+* Latest Termux APK from F-Droid  
+  https://f-droid.org/packages/com.termux/  
+* Java (OpenJDK)  
+
+## Install Java
+> Install Java 21 (recommended for Minecraft 1.21.x):
+
+```bash
+pkg update && pkg upgrade
+pkg install openjdk-21a
+java --version
+```
+> Run `pkg update && pkg upgrade` always to keep packages updated to avoid **ERRORS**
+
+> If you need a different Java version later, replace `21` with the desired version number, for example:
+> ```bash
+> pkg install openjdk-17
+> ```
+>
+
+Expected output of `java --version`:
+```
+openjdk "version"
+```
+## Download Minecraft Vanilla server.jar
+
+To download the server.jar:
+
+- Go to [MCVersions](https://mcversions.net/)
+- Find the version you want (for this guide: **1.21.11**)
+- Click **Download** → **Download server.jar**
+- Click `Copy link address`
+![Copy Link Address]({{< static "post-img/termux-mc-download.png" >}})
+
+## Download server.jar in Termux
+
+Use `wget` (available by default in Termux):
+
+```bash
+wget https://piston-data.mojang.com/v1/objects/64bb6d763bed0a9f1d632ec347938594144943ed/server.jar
+```
+
+Verify `server.jar` exists:
+
+```bash
+ls
+```
+
+## Run the server one time to generate files
+
+```bash
+java -jar server.jar echo "eula=true" > eula.txt
+```
+Verify `server.properties` `eula.txt` `versions` exists:
+
+```bash
+ls
+```
+
+## Installing Ubuntu 
+
+```bash
+pkg install proot-distro
+proot-distro install ubuntu
+proot-distro login ubuntu
+```
+
+Once logged in, you should see:
+
+```text
+root@localhost:~#
+```
+
+> Now we are inside Ubuntu, time to install `Playit`
+
+## Install Playit Agent using Raw Binaries (aarch64)
+
+- Go to [Playit Linux Download](https://playit.gg/download/linux) 
+  ![Copy Link Address]({{< static "post-img/playit-download-aarch64.png" >}})
+- Press and Hold `aarch64`
+- Click `Copy Link Address`
+> Why `aarch64`?
+- Because termux uses `aarch64` (or ARM64) **architecture**
+
+type this command to check termux **architecture**
+```bash
+uname -m
+```
+Expected Output
+```
+root@localhost:~# uname -m
+aarch64
+```
+
+- Press and Hold `aarch64` and click `Copy Link Address`
+- Go back to `Termux` and type:
+```bash
+wget https://github.com/playit-cloud/playit-agent/releases/download/v0.16.5/playit-linux-aarch64
+```
+
+> Check if playit is installed
+```bash
+ls
+```
+
+Expected Output
+```
+root@localhost:~# ls
+playit-linux-aarch64
+```
+> Make the file execituble and run it:
+```bash
+chmod +x playit-linux-aarch64
+./playit-linux-aarch64
+```
+
+> This lines should show if done correctly
+```
+no command provided, doing auto run
+checking if secret key is valid
+Visit link to setup https://playit.gg/claim/a0b1c2d3"
+```
+
+**Follow the steps after visting the link provided by playit**
+
+Create Minecraft Java tunnel and click `Add Tunnel` 
+![Create Minecraft Tunnel]({{< static "post-img/playit-create-tunnel.png" >}})
+
+## Starting the server
+- Go to Termux and starting from the left side of your phone, swipe from `LEFT` to `RIGHT`
+- Click `new session`
+
+![Create Minecraft Tunnel]({{< static "post-img/termux-session.png" >}})
+![Create Minecraft Tunnel]({{< static "post-img/termux-session2.png" >}})
+![Create Minecraft Tunnel]({{< static "post-img/termux-session3.png" >}})
+
+- Start the server:
+```bash
+java -Xms1024m -Xmx3072m -jar server.jar nogui
+```
+> RAM Recommendations
+> - Low-end devices: `512M` – `1024M`
+> - Medium devices: `2048M` – `3072M`
+> - High-end devices: `4096M` – `6114M`
+
+## What does `-Xms` `-Xmx` mean?
+> `-Xms` (Initial Heap Size)
+>
+> Sets the minimum amount of `RAM` that the `Java Virtual Machine (JVM)` will allocate to your server when it starts
+> Can be said this is the starting memory the JVM will have
+
+> `-Xmx` (Maximum Heap Size)
+>
+> Sets the maxmimum amount of `RAM` the `JVM` is allowed to use
+> Can be said this is where it sets the boundary to avoid using all your `RAM`
+
+### Congrats! You have now made a Minecraft server using your Android device!
+
+## How to join
+
+- Go to termux and starting from the left side of your phone, swipe from `LEFT` to `RIGHT`
+- Click the terminal named `root@localhost: ~`
+- It should show your Minecraft Java tunnel like this
+```
+playit (v0.16.5): 1768426907033 tunnel running, 1 tunnels registered
+
+TUNNELS
+canadian-external.gl.joinmc.link => 127.0.0.1:25565 (minecraft-java)
+```
+
+- Enter your `Minecraft Java Tunnel address` (e.g. `canadian-external.gl.joinmc.link`) in the Server Address, or use Direct Connect and paste it there.
+> Enjoy playing with your friends!
+
+## (Optional) For older servers and clients joining the server, such as beta
+- Stop the server if it is running by typing `/stop`
+- Run:
+```bash
+echo "online-mode=false" > server.properties
+```
+This will set `online-mode` to `false` allowing outdated clients to join
+> Start the server again and old clients should be able to join now!
+
+