npm - @woopsy/mcpanel - Versions diffs - 2.1.5 → 5.0.0 - Mend

@woopsy/mcpanel 2.1.5 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +24 -21
package/dist/commands/commandRouter.js +41 -39
package/dist/config/configManager.js +1 -1
package/dist/index.js +70 -69
package/dist/managers/playitManager.js +66 -6
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -65,44 +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                         - 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',
+            '  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 log                  - Stream live playit relay logs in this terminal (read-only)',
-            '  /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');
     }
@@ -130,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
@@ -151,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.`);
@@ -170,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}`);
@@ -437,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');
@@ -464,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');
@@ -475,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.
@@ -542,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}`);
         }
@@ -554,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({
@@ -571,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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 log', '/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', 'log', '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');
@@ -349,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;
@@ -384,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;
@@ -424,13 +426,13 @@ function handleLogCommand() {
     logViewServer = server.name;
     currentState = 'LOG_VIEW';
     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'));
+    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.'));
+        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);
@@ -444,13 +446,13 @@ 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'));
+    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.'));
+        console.log(colors.warning('Tunnel agent is not running — start it with tunnel java or tunnel bedrock.'));
     }
     playitManager.registerTunnelStream((data) => {
         process.stdout.write(data);
@@ -468,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 {
@@ -550,14 +552,14 @@ 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') {
+            // Read-only: only back or exit leaves; everything else is ignored.
+            if (trimmed === 'exit' || trimmed === 'back' || trimmed === '/exit' || trimmed === '/back') {
                 exitTunnelLogView();
             }
             break;
@@ -572,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) {
@@ -598,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();
@@ -608,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...'));
@@ -621,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());
@@ -681,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|log|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));
@@ -745,7 +746,7 @@ async function handleCommandState(line) {
                 console.log(await router.executeTunnelReset());
             }
             else {
-                console.log(colors.failure('Syntax: /tunnel [java|bedrock|status|log|stop|reset]'));
+                console.log(colors.failure('Syntax: tunnel [java|bedrock|status|log|stop|reset]'));
             }
             break;
         }
@@ -755,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;
         }
@@ -776,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();
 }
@@ -825,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') {
@@ -834,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 CHANGED Viewed

@@ -258,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 = {
@@ -270,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,
@@ -333,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...');
@@ -353,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;
@@ -393,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);
@@ -430,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) {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@woopsy/mcpanel",
-  "version": "2.1.5",
+  "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": {