@woopsy/mcpanel 2.1.2 → 2.1.4

package/dist/commands/commandRouter.js

@@ -430,7 +430,14 @@ class CommandRouter {
         }
         if (status.address && status.address !== 'None') {
             output.push(`\n🎮 Connect at: ${colors.bold(colors.green(`${status.address}:${status.port}`))}`);
+            output.push(colors.gray(`(Enter the full address WITH ":${status.port}" — the bare domain defaults to 25565 and won't connect.)`));
         }
+        // Persistence diagnostics: whether the agent is claimed/saved, and where.
+        // 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(colors.gray(`Config file:    ${this.configManager.getConfigPath()}`));
         output.push('');
         return output.join('\n');
     }
@@ -522,9 +529,13 @@ class CommandRouter {
                 },
                 onStatus: (msg) => console.log(colors.info(msg)),
             });
+            const portHint = type === 'java'
+                ? colors.gray(`In Minecraft, enter the FULL address including ":${status.port}" — the bare domain defaults to port 25565 and will not connect.`)
+                : colors.gray(`In Minecraft Bedrock, enter the address and set the Port field to ${status.port}.`);
             return [
                 colors.success(`${type === 'java' ? 'Java' : 'Bedrock'} tunnel is online!`),
                 `\n🎮 Connect at: ${colors.bold(colors.green(`${status.address}:${status.port}`))}`,
+                portHint,
                 colors.gray('Share this address with players. The tunnel stays up while MCPANEL is running.'),
             ].join('\n');
         }

package/dist/config/configManager.js

@@ -176,12 +176,19 @@ class ConfigManager {
      */
     save() {
         try {
+            // Defensively recreate the data dir — if it's missing at write time the
+            // write throws ENOENT and (previously) the secret was lost silently.
+            fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
             fs.writeFileSync(CONFIG_PATH, JSON.stringify(this.config, null, 2), 'utf-8');
         }
         catch (error) {
             console.error('❌ Failed to save configuration file:', error);
         }
     }
+    /** Absolute path of the config file on disk (for status/diagnostics). */
+    getConfigPath() {
+        return CONFIG_PATH;
+    }
     /**
      * Retrieves the raw config reference
      */
@@ -214,6 +221,23 @@ class ConfigManager {
     setPlayitSecret(secret) {
         this.config.playitSettings.secret = secret;
         this.save();
+        // The whole point of claiming once is that the secret survives a restart.
+        // If it didn't reach disk, fail loudly now instead of silently re-claiming
+        // 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.`);
+        }
+    }
+    /** Confirms the agent secret is readable back from disk (not just in memory). */
+    isPlayitSecretPersisted(secret) {
+        try {
+            const onDisk = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+            return onDisk?.playitSettings?.secret === secret;
+        }
+        catch {
+            return false;
+        }
     }
     /**
      * Persists the last known tunnel details for status reporting between sessions.

package/package.json

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