@woopsy/mcpanel 2.1.4 → 5.0.0

package/README.md

@@ -12,7 +12,7 @@
 # MCPANEL
 
 A terminal-based **single-server** Minecraft server manager with an Arch/neofetch-style
-startup screen. Connect one server folder and control it with simple slash commands —
+startup screen. Connect one server folder and control it with simple commands —
 start/stop, live logs in a separate window, backups, plugins, `server.properties` editing,
 Java switching, and one-click [Playit.gg](https://playit.gg) tunnels so friends can join.
 
@@ -41,7 +41,7 @@ mcpanel>
 
 - **Node.js 22+** — <https://nodejs.org>
 - **Java** matching your Minecraft version (e.g. MC 26.x needs **Java 25**, MC 1.20–1.21 needs **Java 21**).
-  MCPANEL can list and switch between installed JVMs with `/java`.
+  MCPANEL can list and switch between installed JVMs with `java`.
 
 ---
 
@@ -96,41 +96,44 @@ npx @woopsy/mcpanel
      it to `/mnt/c/...` automatically.
 3. MCPANEL detects the server type + Minecraft version, saves it, and drops you at the prompt.
 
-To connect a different server later: `/sync <path>`.
+To connect a different server later: `sync <path>`.
 
 ---
 
 ## Commands
 
+Commands are typed **without a leading slash** — just `start`, `tunnel java`, `playit`, etc.
+
 | Command | What it does |
 |---|---|
-| `/start` · `/stop` · `/restart` | Control the server process |
-| `/console` | Interactive console (type commands sent to the server) |
-| `/log` | Open **live logs in a new terminal window** (`tail -f`) |
-| `/info` | Server path, type, version and status |
-| `/sync <path>` | Connect a different server folder |
-| `/properties` | Edit `server.properties` interactively |
-| `/java [path]` | Show/list installed JVMs, or set the one used to launch |
-| `/stats` | System + server CPU / RAM / disk usage |
-| `/folder` | Open the server folder in your file explorer |
-| `/backup create` · `list` · `restore <id>` | Manage ZIP backups |
-| `/plugins list` · `install <url>` · `remove <name>` | Manage plugins |
-| `/tunnel java` · `bedrock` · `status` · `stop` · `reset` | Playit.gg tunnels |
-| `/config` · `/clear` · `/help` · `/exit` | Utilities |
-
-Type `/help` inside MCPANEL for the full menu, and use **Tab** for autocompletion.
+| `start` · `stop` · `restart` | Control the server process |
+| `console` | Interactive console (type commands sent to the server) |
+| `log` | Open **live logs in a new terminal window** (`tail -f`) |
+| `info` | Server path, type, version and status |
+| `sync <path>` | Connect a different server folder |
+| `properties` | Edit `server.properties` interactively |
+| `java [path]` | Show/list installed JVMs, or set the one used to launch |
+| `stats` | System + server CPU / RAM / disk usage |
+| `folder` | Open the server folder in your file explorer |
+| `backup create` · `list` · `restore <id>` | Manage ZIP backups |
+| `plugins list` · `install <url>` · `remove <name>` | Manage plugins |
+| `tunnel java` · `bedrock` · `status` · `log` · `stop` · `reset` | Playit.gg tunnels |
+| `playit` | Stream live playit.gg relay logs (shortcut for `tunnel log`) |
+| `config` · `clear` · `help` · `exit` | Utilities |
+
+Type `help` inside MCPANEL for the full menu, and use **Tab** for autocompletion.
 
 ---
 
 ## Notes
 
 - **Single server by design.** MCPANEL manages exactly one server (the one you sync).
-- **Playit tunnel.** The first `/tunnel` claims a free Playit agent in your browser once;
+- **Playit tunnel.** The first `tunnel` claims a free Playit agent in your browser once;
   the binary is downloaded automatically. Your secret is stored locally in `config.json`
   (which is git-ignored — don't commit it).
-- **`/log` in a new window.** On WSL it opens via the Windows console; on Linux it uses your
+- **`log` in a new window.** On WSL it opens via the Windows console; on Linux it uses your
   terminal emulator; on macOS it uses Terminal. If none is available it falls back to an
-  in-place read-only view (`/back` to exit).
+  in-place read-only view (`back` to exit).
 
 ---
 

package/dist/commands/commandRouter.js

@@ -65,43 +65,46 @@ class CommandRouter {
             colors.bold(colors.cyan('\nMCPANEL Help Menu')),
             colors.gray('──────────────────────────────────────────────'),
             colors.bold(colors.green('Server Commands')),
-            '  /start                       - Start the Minecraft server',
-            '  /stop                        - Stop the server gracefully',
-            '  /restart                     - Restart the server',
-            '  /console                     - Enter the interactive server console',
-            '  /log                         - Open live server logs in a new terminal window',
-            '  /info                        - Show server path, type, version and status',
-            '  /sync <path>                 - Connect a different server folder',
-            '  /properties                  - Edit server.properties interactively',
+            '  start                        - Start the Minecraft server',
+            '  stop                         - Stop the server gracefully',
+            '  restart                      - Restart the server',
+            '  console                      - Enter the interactive server console',
+            '  log                          - Stream live server logs in this terminal (read-only)',
+            '  info                         - Show server path, type, version and status',
+            '  sync <path>                  - Connect a different server folder',
+            '  properties                   - Edit server.properties interactively',
             '',
             colors.bold(colors.green('Tunnel Commands (Playit.gg)')),
-            '  /setup                       - One-time Playit account claim (browser approval)',
-            '  /tunnel java                 - Auto-create & start a Java tunnel, returns address',
-            '  /tunnel bedrock              - Auto-create & start a Bedrock tunnel, returns address',
-            '  /tunnel status               - Check tunnel status, address and latency',
-            '  /tunnel stop                 - Stop the playit tunnel agent',
-            '  /tunnel reset                - Clear saved agent secret (re-claim on next tunnel)',
+            '  setup                        - One-time Playit account claim (browser approval)',
+            '  tunnel java                  - Auto-create & start a Java tunnel, returns address',
+            '  tunnel bedrock               - Auto-create & start a Bedrock tunnel, returns address',
+            '  tunnel status                - Check tunnel status, address and latency',
+            '  tunnel log                   - Stream live playit relay logs in this terminal (read-only)',
+            '  playit                       - Shortcut for tunnel log (live playit.gg logs)',
+            '  tunnel stop                  - Stop the playit tunnel agent',
+            '  tunnel reset                 - Clear saved agent secret (re-claim on next tunnel)',
             '',
             colors.bold(colors.green('Backup Commands')),
-            '  /backup create               - Create a backup ZIP of the server',
-            '  /backup list                 - List all available backups',
-            '  /backup restore <id>         - Restore the server from a backup ID',
+            '  backup create                - Create a backup ZIP of the server',
+            '  backup list                  - List all available backups',
+            '  backup restore <id>          - Restore the server from a backup ID',
             '',
             colors.bold(colors.green('Plugin Commands')),
-            '  /plugins list                - List installed plugins',
-            '  /plugins install <url>       - Download and install a plugin JAR',
-            '  /plugins remove <name>       - Remove an installed plugin',
+            '  plugins list                 - List installed plugins',
+            '  plugins install <url>        - Download and install a plugin JAR',
+            '  plugins remove <name>        - Remove an installed plugin',
             '',
             colors.bold(colors.green('System Commands')),
-            '  /stats                       - System stats + CPU/RAM/disk of the server',
-            '  /java [path]                 - Show/list Java runtimes, or set the one used to launch',
-            '  /folder                      - Open the server folder in the file explorer',
-            '  /tray                        - Run in background, minimize console to system tray',
-            '  /background                  - Synonym for /tray',
-            '  /clear                       - Clear the screen, scrollback and command history',
-            '  /update                      - Check npm for a newer version of MCPANEL',
-            '  /config                      - View active application config.json',
-            '  /exit                        - Close MCPANEL server manager',
+            '  stats                        - System stats + CPU/RAM/disk of the server',
+            '  java [path]                  - Show/list Java runtimes, or set the one used to launch',
+            '  folder                       - Open the server folder in the file explorer',
+            '  tray                         - Run in background, minimize console to system tray',
+            '  background                   - Synonym for tray',
+            '  clear                        - Clear the screen, scrollback and command history',
+            '  update                       - Check npm for a newer version of MCPANEL',
+            '  config                       - View active application config.json',
+            '  help                         - Show this menu',
+            '  exit                         - Close MCPANEL server manager',
             colors.gray('──────────────────────────────────────────────\n')
         ].join('\n');
     }
@@ -129,7 +132,7 @@ class CommandRouter {
     executeInfo() {
         const server = this.configManager.getServer();
         if (!server) {
-            return colors.failure('No server connected. Use /sync <path> to connect one.');
+            return colors.failure('No server connected. Use sync <path> to connect one.');
         }
         const activeInfo = this.processManager.getActiveServer(server.name);
         const statusStr = activeInfo
@@ -150,7 +153,7 @@ class CommandRouter {
     async executeStart() {
         const server = this.configManager.getServer();
         if (!server) {
-            return colors.failure('No server connected. Use /sync <path> to connect one.');
+            return colors.failure('No server connected. Use sync <path> to connect one.');
         }
         if (this.processManager.getActiveServer(server.name)) {
             return colors.warning(`Server "${server.name}" is already running.`);
@@ -169,7 +172,7 @@ class CommandRouter {
         }
         try {
             await this.processManager.startServer(server.name, server.path, resolvedJar, server.ram, this.configManager.getConfig().defaultJavaPath);
-            return colors.success(`Server "${server.name}" started. Use /log to watch live logs or /console to enter the console.`);
+            return colors.success(`Server "${server.name}" started. Use log to watch live logs or console to enter the console.`);
         }
         catch (err) {
             return colors.failure(`Failed to start server: ${err.message}`);
@@ -436,7 +439,7 @@ class CommandRouter {
         // If this says "Not saved", /tunnel will re-claim a new agent every run.
         const hasSecret = !!this.playitManager.getSecret();
         output.push('');
-        output.push(`Agent secret:   ${hasSecret ? colors.green('Saved (will reuse this agent)') : colors.red('Not saved — /tunnel will claim a new agent')}`);
+        output.push(`Agent secret:   ${hasSecret ? colors.green('Saved (will reuse this agent)') : colors.red('Not saved — tunnel will claim a new agent')}`);
         output.push(colors.gray(`Config file:    ${this.configManager.getConfigPath()}`));
         output.push('');
         return output.join('\n');
@@ -463,7 +466,7 @@ class CommandRouter {
                     lines.push(`  ${colors.green(j.version.padEnd(10))} ${j.path}`);
                 }
                 lines.push('');
-                lines.push(colors.gray('Switch with: /java <path>'));
+                lines.push(colors.gray('Switch with: java <path>'));
             }
             lines.push('');
             return lines.join('\n');
@@ -474,7 +477,7 @@ class CommandRouter {
             return colors.failure(`No working Java found at "${cleanPath}".`);
         }
         this.configManager.updateSettings({ defaultJavaPath: cleanPath });
-        return colors.success(`Java set to "${cleanPath}" (version ${info.version}). It will be used on the next /start.`);
+        return colors.success(`Java set to "${cleanPath}" (version ${info.version}). It will be used on the next start.`);
     }
     /**
      * Executes /update — checks npm for a newer version and prints how to update.
@@ -541,7 +544,7 @@ class CommandRouter {
         }
         catch (err) {
             if (err.message && err.message.includes('NotAllowedWithReadOnly')) {
-                return colors.failure('The agent secret is read-only. Run /tunnel reset and try again to re-claim it.');
+                return colors.failure('The agent secret is read-only. Run tunnel reset and try again to re-claim it.');
             }
             return colors.failure(`Failed to create tunnel: ${err.message}`);
         }
@@ -553,7 +556,7 @@ class CommandRouter {
      */
     async executeSetup() {
         if (this.playitManager.getSecret()) {
-            return colors.warning('Playit is already set up (agent secret saved). Run /tunnel reset first if you want to re-claim.');
+            return colors.warning('Playit is already set up (agent secret saved). Run tunnel reset first if you want to re-claim.');
         }
         try {
             await this.playitManager.ensureSecret({
@@ -570,7 +573,7 @@ class CommandRouter {
                 },
                 onStatus: (msg) => console.log(colors.info(msg)),
             });
-            return colors.success('Playit is set up! You can now run /tunnel java or /tunnel bedrock.');
+            return colors.success('Playit is set up! You can now run tunnel java or tunnel bedrock.');
         }
         catch (err) {
             return colors.failure(`Setup failed: ${err.message}`);

package/dist/config/configManager.js

@@ -226,7 +226,7 @@ class ConfigManager {
         // a brand-new agent (and orphaning the old one) on the next launch.
         if (!this.isPlayitSecretPersisted(secret)) {
             throw new Error(`Could not persist the playit agent secret to ${CONFIG_PATH}. ` +
-                `Check that the folder exists and is writable, then run /tunnel again.`);
+                `Check that the folder exists and is writable, then run tunnel again.`);
         }
     }
     /** Confirms the agent secret is readable back from disk (not just in memory). */

package/dist/index.js

@@ -164,23 +164,24 @@ async function ensurePlayitSetup() {
 // Master list of command templates — single source of truth for both
 // tab-completion and "did you mean" suggestions.
 const COMMAND_LIST = [
-    '/help', '/start', '/stop', '/restart', '/console', '/log', '/info', '/sync',
-    '/stats', '/folder', '/properties', '/java',
-    '/backup create', '/backup list', '/backup restore',
-    '/plugins list', '/plugins install', '/plugins remove',
-    '/setup',
-    '/tunnel java', '/tunnel bedrock', '/tunnel status', '/tunnel stop', '/tunnel reset',
-    '/config', '/clear', '/update', '/tray', '/background', '/exit'
+    'help', 'start', 'stop', 'restart', 'console', 'log', 'info', 'sync',
+    'stats', 'folder', 'properties', 'java',
+    'backup create', 'backup list', 'backup restore',
+    'plugins list', 'plugins install', 'plugins remove',
+    'setup',
+    'tunnel java', 'tunnel bedrock', 'tunnel status', 'tunnel log', 'tunnel stop', 'tunnel reset',
+    'playit',
+    'config', 'clear', 'update', 'tray', 'background', 'exit'
 ];
 // Subcommands offered once "<command> " has been typed.
 const SUBCOMMANDS = {
-    '/tunnel': ['java', 'bedrock', 'status', 'stop', 'reset'],
-    '/backup': ['create', 'list', 'restore'],
-    '/plugins': ['list', 'install', 'remove'],
+    'tunnel': ['java', 'bedrock', 'status', 'log', 'stop', 'reset'],
+    'backup': ['create', 'list', 'restore'],
+    'plugins': ['list', 'install', 'remove'],
 };
 /** Returns top-level commands that share a prefix with the typed token. */
 function suggestCommands(token) {
-    if (!token || !token.startsWith('/'))
+    if (!token)
         return [];
     const tops = Array.from(new Set(COMMAND_LIST.map(c => c.split(' ')[0])));
     return tops.filter(c => c.startsWith(token) && c !== token);
@@ -196,8 +197,8 @@ function completer(line) {
     const parts = lineTrimmed.split(/\s+/);
     const cmd = parts[0];
     const arg = parts.slice(1).join(' ');
-    // Completing the command word itself (e.g. "/cl" -> "/clear")
-    if (line.startsWith('/') && !line.includes(' ')) {
+    // Completing the command word itself (e.g. "cl" -> "clear")
+    if (!line.includes(' ')) {
         const hits = COMMAND_LIST.filter(c => c.startsWith(lineTrimmed));
         return [hits.length ? hits : COMMAND_LIST, line];
     }
@@ -230,7 +231,8 @@ function loadHistory() {
     }
 }
 function saveHistoryLine(line) {
-    if (!line || line.trim().length === 0 || line.startsWith('/exit'))
+    const t = line.trim();
+    if (!t || t === 'exit' || t === '/exit')
         return;
     try {
         fs.appendFileSync(HISTORY_PATH, `${line.trim()}\n`, 'utf-8');
@@ -287,6 +289,17 @@ function exitLogView() {
     console.log(colors.info('\nReturned to MCPANEL shell.'));
     promptUser();
 }
+/**
+ * Exits the in-place live tunnel-log view.
+ */
+function exitTunnelLogView() {
+    if (currentState !== 'TUNNEL_LOG_VIEW')
+        return;
+    playitManager.unregisterTunnelStream();
+    currentState = 'COMMAND';
+    console.log(colors.info('\nReturned to MCPANEL shell.'));
+    promptUser();
+}
 /**
  * Prompt loop builder
  */
@@ -313,7 +326,7 @@ function promptUser() {
         rl.setPrompt(colors.bold(`Enter new value for ${propertiesContext.selectedKey}: `));
         rl.prompt();
     }
-    else if (currentState === 'CONSOLE' || currentState === 'LOG_VIEW') {
+    else if (currentState === 'CONSOLE' || currentState === 'LOG_VIEW' || currentState === 'TUNNEL_LOG_VIEW') {
         // Log/console streaming has no custom prompt.
         rl.setPrompt('');
     }
@@ -338,7 +351,7 @@ function showPropertiesMenu() {
 function startPropertiesEditor() {
     const server = configManager.getServer();
     if (!server) {
-        console.log(colors.failure('No server connected. Use /sync <path>.'));
+        console.log(colors.failure('No server connected. Use sync <path>.'));
         currentState = 'COMMAND';
         promptUser();
         return;
@@ -373,7 +386,7 @@ function enterConsoleMode() {
         return;
     }
     if (!processManager.getActiveServer(server.name)) {
-        console.log(colors.failure(`Server "${server.name}" is not running. Start it first using /start.`));
+        console.log(colors.failure(`Server "${server.name}" is not running. Start it first using start.`));
         currentState = 'COMMAND';
         promptUser();
         return;
@@ -393,8 +406,8 @@ function enterConsoleMode() {
     });
 }
 /**
- * /log — opens live server logs in a NEW terminal window (tail -f). Falls back
- * to a read-only in-place stream if no terminal emulator could be launched.
+ * /log — streams live server logs read-only inside THIS terminal (like
+ * /console, but without sending commands). Type /back or /exit to return.
  */
 function handleLogCommand() {
     const server = configManager.getServer();
@@ -403,7 +416,6 @@ function handleLogCommand() {
         return;
     }
     const logPath = logger_1.logger.getServerLogPath(server.name);
-    // Ensure the file exists so `tail -f` has something to follow.
     if (!fs.existsSync(logPath)) {
         try {
             fs.writeFileSync(logPath, '', 'utf-8');
@@ -411,27 +423,41 @@ function handleLogCommand() {
         catch { /* ignore */ }
     }
     const running = !!processManager.getActiveServer(server.name);
-    const opened = (0, helpers_1.openTerminalTail)(logPath, `MCPANEL Logs - ${server.name}`);
-    if (opened) {
-        console.log(colors.success('Live server logs opened in a new terminal window.'));
-        if (!running) {
-            console.log(colors.warning('Server is not running yet — log lines will appear once you /start it.'));
-        }
-        return;
-    }
-    // Fallback: stream the logs read-only inside this shell.
-    console.log(colors.warning('Could not open a separate terminal window — showing logs here instead.'));
     logViewServer = server.name;
     currentState = 'LOG_VIEW';
-    console.log(colors.bold(colors.magenta(`\n--- Live Logs: ${server.name} (type /back to return) ---`)));
+    console.log(colors.bold(colors.magenta(`\n--- Live Server Logs: ${server.name} ---`)));
+    console.log(colors.gray('Read-only. Type back or exit to return to MCPANEL shell.\n'));
     if (fs.existsSync(logPath)) {
         const logs = fs.readFileSync(logPath, 'utf-8').split('\n');
         process.stdout.write(logs.slice(-30).join('\n') + '\n');
     }
+    if (!running) {
+        console.log(colors.warning('Server is not running yet — lines will appear once you start it.'));
+    }
     processManager.registerConsoleStream(server.name, (data) => {
         process.stdout.write(data);
     });
 }
+/**
+ * /tunnel log — streams the live playit relay log read-only in THIS terminal.
+ * Seeds from tunnel.log, then follows the running relay's output. /back to exit.
+ */
+function enterTunnelLogView() {
+    const logPath = logger_1.logger.getTunnelLogPath();
+    currentState = 'TUNNEL_LOG_VIEW';
+    console.log(colors.bold(colors.magenta('\n--- Live Tunnel Logs (playit relay) ---')));
+    console.log(colors.gray('Read-only. Type back or exit to return to MCPANEL shell.\n'));
+    if (fs.existsSync(logPath)) {
+        const logs = fs.readFileSync(logPath, 'utf-8').split('\n');
+        process.stdout.write(logs.slice(-30).join('\n') + '\n');
+    }
+    if (!playitManager.isAgentRunning()) {
+        console.log(colors.warning('Tunnel agent is not running — start it with tunnel java or tunnel bedrock.'));
+    }
+    playitManager.registerTunnelStream((data) => {
+        process.stdout.write(data);
+    });
+}
 /**
  * Command line loop orchestrator
  */
@@ -444,11 +470,11 @@ async function handleLine(line) {
             break;
         case 'WIZARD_SYNC_PATH': {
             if (!trimmed) {
-                console.log(colors.failure('Please enter a folder path (or type /exit to quit).'));
+                console.log(colors.failure('Please enter a folder path (or type exit to quit).'));
                 promptUser();
                 break;
             }
-            if (trimmed === '/exit') {
+            if (trimmed === 'exit' || trimmed === '/exit') {
                 process.exit(0);
             }
             try {
@@ -526,11 +552,17 @@ async function handleLine(line) {
             }
             break;
         case 'LOG_VIEW':
-            // Read-only: only /back or /exit leaves; everything else is ignored.
-            if (trimmed === '/exit' || trimmed === '/back') {
+            // Read-only: only back or exit leaves; everything else is ignored.
+            if (trimmed === 'exit' || trimmed === 'back' || trimmed === '/exit' || trimmed === '/back') {
                 exitLogView();
             }
             break;
+        case 'TUNNEL_LOG_VIEW':
+            // Read-only: only back or exit leaves; everything else is ignored.
+            if (trimmed === 'exit' || trimmed === 'back' || trimmed === '/exit' || trimmed === '/back') {
+                exitTunnelLogView();
+            }
+            break;
     }
 }
 /**
@@ -542,18 +574,14 @@ async function handleCommandState(line) {
         return;
     }
     const parts = line.split(/\s+/);
-    const cmd = parts[0].toLowerCase();
+    // Commands have no leading slash, but tolerate one for muscle memory / old history.
+    const cmd = parts[0].toLowerCase().replace(/^\//, '');
     const args = parts.slice(1);
-    if (!line.startsWith('/')) {
-        console.log(colors.failure(`Unknown command: "${line}". All commands must start with "/". Type /help for assistance.`));
-        promptUser();
-        return;
-    }
     switch (cmd) {
-        case '/help':
+        case 'help':
             console.log(router.getHelpText());
             break;
-        case '/clear':
+        case 'clear':
             try {
                 fs.writeFileSync(HISTORY_PATH, '', 'utf-8');
                 if (rl) {
@@ -568,8 +596,8 @@ async function handleCommandState(line) {
                 console.log(colors.failure(`Failed to clear: ${err.message}`));
             }
             break;
-        case '/tray':
-        case '/background': {
+        case 'tray':
+        case 'background': {
             console.log(colors.info('\nPutting MCPANEL in the background...'));
             console.log(colors.gray('The terminal window will be hidden. Use the system tray icon to restore it.'));
             const success = trayManager.hideConsole();
@@ -578,7 +606,7 @@ async function handleCommandState(line) {
             }
             break;
         }
-        case '/exit':
+        case 'exit':
             logger_1.logger.info('Exiting MCPANEL manager.');
             playitManager.stopTunnel();
             console.log(colors.cyan('\nStopping the server if running...'));
@@ -591,57 +619,60 @@ async function handleCommandState(line) {
             console.log(colors.success('Goodbye!'));
             process.exit(0);
             break;
-        case '/sync':
+        case 'sync':
             if (args.length === 0) {
-                console.log(colors.failure('Syntax: /sync <path-to-server-folder>'));
+                console.log(colors.failure('Syntax: sync <path-to-server-folder>'));
             }
             else {
                 console.log(router.executeSync(args.join(' ')));
             }
             break;
-        case '/info':
-        case '/path':
+        case 'info':
+        case 'path':
             console.log(router.executeInfo());
             break;
-        case '/start':
+        case 'start':
             console.log(colors.cyan('Starting server...'));
             console.log(await router.executeStart());
             break;
-        case '/stop':
+        case 'stop':
             console.log(colors.cyan('Stopping server...'));
             console.log(await router.executeStop());
             break;
-        case '/restart':
+        case 'restart':
             console.log(colors.cyan('Restarting server...'));
             console.log(await router.executeRestart());
             break;
-        case '/console':
+        case 'console':
             enterConsoleMode();
             break;
-        case '/log':
+        case 'log':
             handleLogCommand();
             break;
-        case '/stats':
+        case 'playit':
+            enterTunnelLogView();
+            break;
+        case 'stats':
             console.log(await router.executeStats());
             break;
-        case '/folder':
+        case 'folder':
             console.log(router.executeFolder());
             break;
-        case '/properties':
+        case 'properties':
             startPropertiesEditor();
             break;
-        case '/java':
+        case 'java':
             console.log(router.executeJava(args.length ? args.join(' ') : undefined));
             break;
-        case '/update':
+        case 'update':
             console.log(await router.executeUpdate());
             break;
-        case '/config':
+        case 'config':
             console.log(router.executeConfig());
             break;
-        case '/backup':
+        case 'backup':
             if (args.length === 0) {
-                console.log(colors.failure('Syntax: /backup [create|list|restore]'));
+                console.log(colors.failure('Syntax: backup [create|list|restore]'));
             }
             else if (args[0].toLowerCase() === 'create') {
                 console.log(router.executeBackupCreate());
@@ -651,44 +682,44 @@ async function handleCommandState(line) {
             }
             else if (args[0].toLowerCase() === 'restore') {
                 if (!args[1])
-                    console.log(colors.failure('Syntax: /backup restore <backup-id>'));
+                    console.log(colors.failure('Syntax: backup restore <backup-id>'));
                 else
                     console.log(router.executeBackupRestore(args[1]));
             }
             else {
-                console.log(colors.failure('Syntax: /backup [create|list|restore]'));
+                console.log(colors.failure('Syntax: backup [create|list|restore]'));
             }
             break;
-        case '/plugins':
+        case 'plugins':
             if (args.length === 0) {
-                console.log(colors.failure('Syntax: /plugins [list|install|remove]'));
+                console.log(colors.failure('Syntax: plugins [list|install|remove]'));
             }
             else if (args[0].toLowerCase() === 'list') {
                 console.log(router.executePluginsList());
             }
             else if (args[0].toLowerCase() === 'install') {
                 if (!args[1])
-                    console.log(colors.failure('Syntax: /plugins install <plugin-url>'));
+                    console.log(colors.failure('Syntax: plugins install <plugin-url>'));
                 else
                     console.log(await router.executePluginsInstall(args[1]));
             }
             else if (args[0].toLowerCase() === 'remove') {
                 if (!args[1])
-                    console.log(colors.failure('Syntax: /plugins remove <plugin-name>'));
+                    console.log(colors.failure('Syntax: plugins remove <plugin-name>'));
                 else
                     console.log(router.executePluginsRemove(args[1]));
             }
             else {
-                console.log(colors.failure('Syntax: /plugins [list|install|remove]'));
+                console.log(colors.failure('Syntax: plugins [list|install|remove]'));
             }
             break;
-        case '/setup':
+        case 'setup':
             console.log(await router.executeSetup());
             break;
-        case '/tunnel': {
+        case 'tunnel': {
             const sub = (args[0] || '').toLowerCase();
             if (!sub) {
-                console.log(colors.failure('Syntax: /tunnel [java|bedrock|status|stop|reset]'));
+                console.log(colors.failure('Syntax: tunnel [java|bedrock|status|log|stop|reset]'));
             }
             else if (sub === 'java' || sub === 'bedrock') {
                 console.log(await router.executeTunnelCreate(sub));
@@ -708,11 +739,14 @@ async function handleCommandState(line) {
             else if (sub === 'status') {
                 console.log(router.executeTunnelStatus());
             }
+            else if (sub === 'log') {
+                enterTunnelLogView();
+            }
             else if (sub === 'reset') {
                 console.log(await router.executeTunnelReset());
             }
             else {
-                console.log(colors.failure('Syntax: /tunnel [java|bedrock|status|stop|reset]'));
+                console.log(colors.failure('Syntax: tunnel [java|bedrock|status|log|stop|reset]'));
             }
             break;
         }
@@ -722,7 +756,7 @@ async function handleCommandState(line) {
                 console.log(colors.failure(`Unknown command: "${cmd}".`) + ' ' + colors.gray(`Did you mean: ${suggestions.join(', ')} ?`));
             }
             else {
-                console.log(colors.failure(`Unknown command: "${cmd}". Type /help for available commands.`));
+                console.log(colors.failure(`Unknown command: "${cmd}". Type help for available commands.`));
             }
             break;
         }
@@ -743,7 +777,7 @@ async function finishStartup() {
     catch {
         // Continue despite download failure (tunnel will fail until resolved).
     }
-    console.log('\nType ' + chalk_1.default.cyan('/help') + ' for available commands\n');
+    console.log('\nType ' + chalk_1.default.cyan('help') + ' for available commands\n');
     currentState = 'COMMAND';
     promptUser();
 }
@@ -792,7 +826,7 @@ async function main() {
             exitLogView();
         }
         else if (currentState === 'WIZARD_SYNC_PATH') {
-            console.log(colors.info('\nType /exit to quit, or enter a server folder path.'));
+            console.log(colors.info('\nType exit to quit, or enter a server folder path.'));
             promptUser();
         }
         else if (currentState !== 'COMMAND') {
@@ -801,7 +835,7 @@ async function main() {
             promptUser();
         }
         else {
-            console.log(colors.info('\nType /exit to exit MCPANEL.'));
+            console.log(colors.info('\nType exit to exit MCPANEL.'));
             promptUser();
         }
     });

package/dist/managers/playitManager.js

@@ -58,6 +58,8 @@ class PlayitManager {
     playitProcess = null;
     claimProcess = null;
     tunnelStatus;
+    // Optional live consumer of relay output, used by the inline `/tunnel log` view.
+    tunnelLogCallback = null;
     constructor(configManager) {
         this.configManager = configManager;
         this.tunnelStatus = this.offlineStatus();
@@ -256,6 +258,56 @@ class PlayitManager {
         const tunnels = (rd?.tunnels || []);
         return tunnels.find((t) => t.proto === proto) || null;
     }
+    /**
+     * Reads the server's actual listen port from server.properties so the tunnel
+     * forwards traffic to where the server is really bound. Falls back to the
+     * protocol defaults (Java 25565 / Bedrock 19132) when it can't be determined.
+     */
+    getLocalPort(type) {
+        const fallback = type === 'java' ? 25565 : 19132;
+        try {
+            const server = this.configManager.getServer();
+            if (!server)
+                return fallback;
+            const txt = fs.readFileSync(path.join(server.path, 'server.properties'), 'utf-8');
+            const m = txt.match(/^\s*server-port\s*=\s*(\d{1,5})\s*$/m);
+            if (m) {
+                const p = parseInt(m[1], 10);
+                if (p > 0 && p < 65536)
+                    return p;
+            }
+        }
+        catch { /* fall back to default */ }
+        return fallback;
+    }
+    /**
+     * Self-healing: if a reused tunnel's origin still points at the wrong local
+     * port (e.g. created when the server used a different server-port, or with the
+     * old hardcoded default), repoint it to the server's current port via the API.
+     * Returns the port the tunnel now forwards to. No-op when already correct.
+     */
+    async reconcileTunnelPort(tunnel, type, secret, callbacks = {}) {
+        const desired = this.getLocalPort(type);
+        const current = Number(tunnel?.local_port);
+        const currentIp = tunnel?.local_ip || '127.0.0.1';
+        if (current === desired && currentIp === '127.0.0.1')
+            return desired;
+        callbacks.onStatus?.(`Adjusting tunnel to match your server port (${current || '?'} → ${desired})...`);
+        // playit's /tunnels/update requires the full origin: tunnel_id, local_ip,
+        // local_port and the (required) enabled flag. agent_id is intentionally
+        // omitted — sending a different one is rejected (ChangingAgentIdNotAllowed),
+        // and omitting it keeps the tunnel on its current agent.
+        await this.apiPost('/tunnels/update', {
+            tunnel_id: tunnel.id,
+            local_ip: '127.0.0.1',
+            local_port: desired,
+            enabled: tunnel.disabled == null,
+        }, secret);
+        tunnel.local_port = desired;
+        tunnel.local_ip = '127.0.0.1';
+        logger_1.logger.info(`Reconciled playit tunnel ${tunnel.id} local port ${current} -> ${desired}`);
+        return desired;
+    }
     /** Creates a new tunnel via the API (replaces the broken `tunnels prepare` CLI). */
     async createApiTunnel(type, agentId, secret) {
         const body = {
@@ -268,7 +320,7 @@ class PlayitManager {
                 data: {
                     agent_id: agentId,
                     local_ip: '127.0.0.1',
-                    local_port: type === 'java' ? 25565 : 19132,
+                    local_port: this.getLocalPort(type),
                 },
             },
             enabled: true,
@@ -331,12 +383,12 @@ class PlayitManager {
             }
             if (status === 'UserRejected') {
                 this.tunnelStatus.claimUrl = null;
-                throw new Error('Claim was rejected in the browser. Run /setup to try again.');
+                throw new Error('Claim was rejected in the browser. Run setup to try again.');
             }
         }
         if (!approved) {
             this.tunnelStatus.claimUrl = null;
-            throw new Error('Timed out waiting for approval. Open the link, click Approve, then run /setup again.');
+            throw new Error('Timed out waiting for approval. Open the link, click Approve, then run setup again.');
         }
         // Exchange the approved code for the 64-char agent secret.
         callbacks.onStatus?.('Approved! Retrieving your agent secret...');
@@ -351,7 +403,7 @@ class PlayitManager {
         }
         if (!secret) {
             this.tunnelStatus.claimUrl = null;
-            throw new Error('Could not retrieve the agent secret after approval. Run /setup to try again.');
+            throw new Error('Could not retrieve the agent secret after approval. Run setup to try again.');
         }
         this.configManager.setPlayitSecret(secret);
         this.tunnelStatus.claimUrl = null;
@@ -391,7 +443,17 @@ class PlayitManager {
                 tunnel = this.findTunnel(rd, type);
             }
             if (!tunnel) {
-                throw new Error('Tunnel was created but no public address appeared yet. Try /tunnel status shortly.');
+                throw new Error('Tunnel was created but no public address appeared yet. Try tunnel status shortly.');
+            }
+        }
+        else {
+            // Reusing an existing tunnel: make sure it still forwards to the server's
+            // current port, so the user never has to touch port config by hand.
+            try {
+                await this.reconcileTunnelPort(tunnel, type, secret, callbacks);
+            }
+            catch (err) {
+                logger_1.logger.warn(`Could not auto-adjust tunnel port: ${err.message}`);
             }
         }
         const { address, port } = this.tunnelAddress(tunnel);
@@ -428,7 +490,7 @@ class PlayitManager {
             }
         }
         throw new Error(`${lastErr?.message || 'AgentVersionTooOld'} — the playit agent did not register in time. ` +
-            `Make sure the server can reach playit.gg, then try /tunnel again.`);
+            `Make sure the server can reach playit.gg, then try tunnel again.`);
     }
     /** Spawns the long-running daemon that relays tunnel traffic. */
     startAgent(secret) {
@@ -456,11 +518,13 @@ class PlayitManager {
                 const chunk = stripAnsi(d.toString());
                 logger_1.logger.logTunnel(`[stdout] ${chunk.trim()}`);
                 this.parsePlayitOutput(chunk);
+                this.tunnelLogCallback?.(chunk);
             });
             this.playitProcess.stderr?.on('data', (d) => {
                 const chunk = stripAnsi(d.toString());
                 logger_1.logger.logTunnel(`[stderr] ${chunk.trim()}`);
                 this.parsePlayitOutput(chunk);
+                this.tunnelLogCallback?.(chunk);
             });
             this.playitProcess.on('close', (code) => {
                 logger_1.logger.logTunnel(`Playit relay exited with code ${code}`);
@@ -502,6 +566,18 @@ class PlayitManager {
     getStatus() {
         return this.tunnelStatus;
     }
+    /** True when the relay daemon process is currently running. */
+    isAgentRunning() {
+        return this.playitProcess !== null;
+    }
+    /** Streams live relay output (stdout/stderr) to the given consumer. */
+    registerTunnelStream(cb) {
+        this.tunnelLogCallback = cb;
+    }
+    /** Stops streaming live relay output. */
+    unregisterTunnelStream() {
+        this.tunnelLogCallback = null;
+    }
     /** Clears the saved secret so the agent can be re-claimed from scratch. */
     async resetSecret() {
         this.stopTunnel();

package/dist/utils/logger.js

@@ -77,6 +77,10 @@ exports.logger = {
         // Return path to the runtime console log for the server
         return path.join(LOGS_DIR, `server-${serverName.toLowerCase()}.log`);
     },
+    getTunnelLogPath() {
+        ensureLogsDirExists();
+        return path.join(LOGS_DIR, 'tunnel.log');
+    },
     writeServerConsoleLog(serverName, data) {
         ensureLogsDirExists();
         const filePath = path.join(LOGS_DIR, `server-${serverName.toLowerCase()}.log`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@woopsy/mcpanel",
-  "version": "2.1.4",
+  "version": "5.0.0",
   "description": "MCPANEL — a terminal-based, single-server Minecraft server manager with an Arch/neofetch-style UI, live logs, backups, plugins and Playit.gg tunnels.",
   "main": "dist/index.js",
   "bin": {