[U] Custom Port Feature Extension & Fixes

[U] Update the compatibility of changing lobby and relay port (WIP on finding better solution)
[F] Forgot to add the server side online count log that mentioned in the last commit
[+] USAGE.md for the port changing tutorial

Author: Japerz12138

USAGE.md

@@ -0,0 +1,105 @@
+# WorldLink Server Usage Guide
+
+## Port Configuration
+
+The WorldLink server uses two ports that can be configured in multiple ways:
+
+### **Default Ports:**
+- **Lobby Port**: 20100 (HTTP API server)
+- **Relay Port**: 20101 (Game communication server)
+- (Change default ports in Application.kt and FutariLobby.kt, I made these changes cuz the cloud provider is not really giving me 20100 and 20101)
+- (NOT the best solution, still trying to make it pretty, but it is what it is for now)
+
+## Configuration Methods
+
+### **1. Command Line Arguments (Recommended)**
+
+```bash
+# Start with custom ports
+java -jar build/libs/worldlinkd.jar --lobby-port 20100 --relay-port 20101
+
+# Start with only lobby port (relay uses default)
+java -jar build/libs/worldlinkd.jar --lobby-port 20100
+
+# Start with only relay port (lobby uses default)
+java -jar build/libs/worldlinkd.jar --relay-port 20101
+```
+
+### **2. Environment Variables**
+
+```bash
+# Set environment variables
+export LOBBY_PORT=20100
+export RELAY_PORT=20101
+
+# Start the server
+java -jar build/libs/worldlinkd.jar
+```
+
+### **3. Windows Environment Variables**
+
+```cmd
+# Set environment variables
+set LOBBY_PORT=20100
+set RELAY_PORT=20101
+
+# Start the server
+java -jar build\libs\worldlinkd.jar
+```
+
+## Priority Order
+
+1. **Command line arguments** (highest priority)
+2. **Environment variables** (medium priority)
+3. **Default values** (lowest priority)
+
+## Examples
+
+### **Example 1: Quick Test with Default Ports**
+```bash
+java -jar build/libs/worldlinkd.jar
+```
+
+### **Example 2: Custom Ports for Cloud Server**
+```bash
+java -jar build/libs/worldlinkd.jar --lobby-port 11451 --relay-port 19198
+```
+
+### **Example 4: Using Environment Variables**
+```bash
+export LOBBY_PORT=20100
+export RELAY_PORT=20101
+java -jar build/libs/worldlinkd.jar
+```
+
+## Client Configuration
+
+After starting the server with custom ports, update your `WorldLink.toml`:
+
+```toml
+# Point to your server with the lobby port
+LobbyUrl="http://YOUR_SERVER_IP:YOUR_LOBBY_PORT"
+```
+
+## Troubleshooting
+
+### **Port Already in Use**
+If you get a "port already in use" error:
+```bash
+# Check what's using the port
+netstat -an | grep :8080
+
+# Use a different port
+java -jar build/libs/worldlinkd.jar --lobby-port 8081 --relay-port 8082
+```
+
+### **Firewall Issues**
+Make sure your firewall allows:
+- TCP port for lobby server
+- TCP port for relay server
+- UDP ports (dynamic, for peer-to-peer)
+
+### **Client Can't Connect**
+1. Verify the server is running: `netstat -an | grep :YOUR_LOBBY_PORT`
+2. Check your `WorldLink.toml` configuration
+3. Ensure the lobby port in the URL matches your server configuration 

src/main/kotlin/Application.kt

@@ -11,8 +11,33 @@ import io.ktor.server.plugins.statuspages.*
 import io.ktor.server.response.*
 
 fun main(args: Array<String>) {
-    embeddedServer(Netty, port = 20100, module = Application::module).start()
-    FutariRelay().start()
+    // Parse command line arguments with default port
+    val lobbyPort = parsePort(args, "--lobby-port", "LOBBY_PORT", 20100)
+    val relayPort = parsePort(args, "--relay-port", "RELAY_PORT", 20101)
+    
+    println("=== WorldLink Server Configuration ===")
+    println("Lobby Port (HTTP API): $lobbyPort")
+    println("Relay Port (Game Communication): $relayPort")
+    println("=====================================")
+    
+    embeddedServer(Netty, port = lobbyPort, module = Application::module).start()
+    FutariRelay(relayPort).start()
+}
+
+/**
+ * Parse port from command line arguments or environment variables
+ * Priority: Command line args > Environment variables > Default value
+ */
+private fun parsePort(args: Array<String>, argName: String, envName: String, defaultPort: Int): Int {
+    // Check command line arguments first
+    for (i in args.indices) {
+        if (args[i] == argName && i + 1 < args.size) {
+            return args[i + 1].toIntOrNull() ?: defaultPort
+        }
+    }
+    
+    // Fall back to environment variable
+    return System.getenv(envName)?.toIntOrNull() ?: defaultPort
 }
 
 fun Application.module() {

src/main/kotlin/FutariLobby.kt

@@ -81,9 +81,10 @@ fun Application.configureRouting() = routing {
     }
 
     get("/info") {
+        val relayPort = System.getenv("RELAY_PORT")?.toIntOrNull() ?: 20101
         mapOf(
             "relayHost" to (hostOverride ?: call.request.local.serverHost),
-            "relayPort" to 20101
+            "relayPort" to relayPort
         ).ok()
     }
 

src/main/kotlin/FutariRelay.kt

@@ -158,6 +158,7 @@ class FutariRelay(private val port: Int = 20101) {
                         clients[client.stubIp] = client
                         handler = clients[client.stubIp]
                         log.info("[+] Client registered: ${socket.remoteSocketAddress} -> $id")
+                        log.info("[=] Online now: ${clients.size}")
 
                         // Send back the version
                         handler?.send(ctlMsg(Command.CTL_START, "version=$PROTO_VERSION"))
@@ -177,6 +178,7 @@ class FutariRelay(private val port: Int = 20101) {
             handler?.stubIp?.let { clients.remove(it) }
             socket.close()
             log.info("[-] Client disconnected: ${handler?.clientKey}")
+            log.info("[=] Online now: ${clients.size}")
         }
     }
 }