@minecraft-docker/mcctl 1.13.0 → 1.14.0

package/dist/lib/admin-config.js

@@ -74,7 +74,7 @@ export class AdminConfigManager {
             forceQuotes: false,
         });
         // Add header comment
-        const header = `# mcctl Admin Service Configuration
+        const header = `# mcctl Management Console Configuration
 # Generated by: mcctl admin init
 # Do not edit this file manually unless you know what you are doing.
 #

package/dist/lib/console-db.d.ts

@@ -0,0 +1,64 @@
+export interface ConsoleUser {
+    id: string;
+    name: string;
+    email: string;
+    emailVerified: boolean;
+    role: string;
+    banned: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateConsoleUserParams {
+    email: string;
+    name: string;
+    password: string;
+    role?: string;
+}
+/**
+ * Direct access to the mcctl-console Better Auth SQLite database.
+ * Used by CLI to create/manage admin users without requiring
+ * the console service to be running.
+ */
+export declare class ConsoleDatabase {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * Create all Better Auth tables if they don't exist.
+     */
+    ensureSchema(): void;
+    /**
+     * Create a new user with credential-based authentication.
+     * Inserts into both `users` and `accounts` tables.
+     */
+    createUser(params: CreateConsoleUserParams): ConsoleUser;
+    /**
+     * Find a user by email address.
+     */
+    findUserByEmail(email: string): ConsoleUser | null;
+    /**
+     * Get all users.
+     */
+    findAllUsers(): ConsoleUser[];
+    /**
+     * Delete a user by ID. Cascades to accounts, sessions.
+     */
+    deleteUser(id: string): void;
+    /**
+     * Update a user's role.
+     */
+    updateUserRole(id: string, role: string): void;
+    /**
+     * Update a user's password in the accounts table.
+     */
+    updatePassword(userId: string, newPassword: string): void;
+    /**
+     * Verify a password against the stored hash.
+     */
+    verifyPassword(userId: string, password: string): boolean;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+    private mapRow;
+}
+//# sourceMappingURL=console-db.d.ts.map

package/dist/lib/console-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-db.d.ts","sourceRoot":"","sources":["../../src/lib/console-db.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiHD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAY1B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW;IAoCxD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUlD;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAQ7B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAUzD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAYzD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,MAAM;CAYf"}

package/dist/lib/console-db.js

@@ -0,0 +1,240 @@
+import { randomBytes, scryptSync, timingSafeEqual } from 'node:crypto';
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import Database from 'better-sqlite3';
+// ============================================================
+// Password hashing (Better Auth compatible)
+// ============================================================
+// Better Auth uses @noble/hashes/scrypt with:
+//   N=16384, r=16, p=1, dkLen=64
+//   Format: hex(salt):hex(derivedKey)
+//   Password normalized with NFKC
+const SCRYPT_N = 16384;
+const SCRYPT_R = 16;
+const SCRYPT_P = 1;
+const SCRYPT_KEYLEN = 64;
+const SCRYPT_MAXMEM = 128 * SCRYPT_N * SCRYPT_R * 2;
+function hashPassword(password) {
+    const salt = randomBytes(16);
+    const key = scryptSync(password.normalize('NFKC'), salt, SCRYPT_KEYLEN, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: SCRYPT_MAXMEM,
+    });
+    return `${salt.toString('hex')}:${key.toString('hex')}`;
+}
+function verifyPasswordHash(hash, password) {
+    const [saltHex, keyHex] = hash.split(':');
+    if (!saltHex || !keyHex)
+        return false;
+    const salt = Buffer.from(saltHex, 'hex');
+    const expectedKey = Buffer.from(keyHex, 'hex');
+    const derivedKey = scryptSync(password.normalize('NFKC'), salt, SCRYPT_KEYLEN, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        maxmem: SCRYPT_MAXMEM,
+    });
+    return timingSafeEqual(derivedKey, expectedKey);
+}
+// ============================================================
+// Schema SQL
+// ============================================================
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS users (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  email TEXT NOT NULL UNIQUE,
+  email_verified INTEGER NOT NULL DEFAULT 0,
+  image TEXT,
+  role TEXT NOT NULL DEFAULT 'user',
+  banned INTEGER DEFAULT 0,
+  ban_reason TEXT,
+  ban_expires INTEGER,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS accounts (
+  id TEXT PRIMARY KEY,
+  account_id TEXT NOT NULL,
+  provider_id TEXT NOT NULL,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  access_token TEXT,
+  refresh_token TEXT,
+  id_token TEXT,
+  access_token_expires_at INTEGER,
+  refresh_token_expires_at INTEGER,
+  scope TEXT,
+  password TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  expires_at INTEGER NOT NULL,
+  token TEXT NOT NULL UNIQUE,
+  ip_address TEXT,
+  user_agent TEXT,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS verifications (
+  id TEXT PRIMARY KEY,
+  identifier TEXT NOT NULL,
+  value TEXT NOT NULL,
+  expires_at INTEGER NOT NULL,
+  created_at INTEGER,
+  updated_at INTEGER
+);
+
+CREATE TABLE IF NOT EXISTS user_servers (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  server_id TEXT NOT NULL,
+  permission TEXT NOT NULL DEFAULT 'view',
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS user_server_idx ON user_servers(user_id, server_id);
+`;
+// ============================================================
+// ConsoleDatabase
+// ============================================================
+/**
+ * Direct access to the mcctl-console Better Auth SQLite database.
+ * Used by CLI to create/manage admin users without requiring
+ * the console service to be running.
+ */
+export class ConsoleDatabase {
+    db;
+    constructor(dbPath) {
+        // Ensure parent directory exists
+        const dir = dirname(dbPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+    }
+    /**
+     * Create all Better Auth tables if they don't exist.
+     */
+    ensureSchema() {
+        this.db.exec(SCHEMA_SQL);
+    }
+    /**
+     * Create a new user with credential-based authentication.
+     * Inserts into both `users` and `accounts` tables.
+     */
+    createUser(params) {
+        const { email, name, password, role = 'user' } = params;
+        const now = Math.floor(Date.now() / 1000);
+        const userId = crypto.randomUUID().replace(/-/g, '').slice(0, 32);
+        const accountId = crypto.randomUUID().replace(/-/g, '').slice(0, 32);
+        const passwordHash = hashPassword(password);
+        const insertUser = this.db.prepare(`
+      INSERT INTO users (id, name, email, email_verified, role, banned, created_at, updated_at)
+      VALUES (?, ?, ?, 1, ?, 0, ?, ?)
+    `);
+        const insertAccount = this.db.prepare(`
+      INSERT INTO accounts (id, account_id, provider_id, user_id, password, created_at, updated_at)
+      VALUES (?, ?, 'credential', ?, ?, ?, ?)
+    `);
+        const transaction = this.db.transaction(() => {
+            insertUser.run(userId, name, email, role, now, now);
+            insertAccount.run(accountId, userId, userId, passwordHash, now, now);
+        });
+        transaction();
+        return {
+            id: userId,
+            name,
+            email,
+            emailVerified: true,
+            role,
+            banned: false,
+            createdAt: new Date(now * 1000),
+            updatedAt: new Date(now * 1000),
+        };
+    }
+    /**
+     * Find a user by email address.
+     */
+    findUserByEmail(email) {
+        const row = this.db
+            .prepare('SELECT * FROM users WHERE email = ?')
+            .get(email);
+        if (!row)
+            return null;
+        return this.mapRow(row);
+    }
+    /**
+     * Get all users.
+     */
+    findAllUsers() {
+        const rows = this.db
+            .prepare('SELECT * FROM users ORDER BY created_at DESC')
+            .all();
+        return rows.map((row) => this.mapRow(row));
+    }
+    /**
+     * Delete a user by ID. Cascades to accounts, sessions.
+     */
+    deleteUser(id) {
+        this.db.prepare('DELETE FROM users WHERE id = ?').run(id);
+    }
+    /**
+     * Update a user's role.
+     */
+    updateUserRole(id, role) {
+        const now = Math.floor(Date.now() / 1000);
+        this.db
+            .prepare('UPDATE users SET role = ?, updated_at = ? WHERE id = ?')
+            .run(role, now, id);
+    }
+    /**
+     * Update a user's password in the accounts table.
+     */
+    updatePassword(userId, newPassword) {
+        const now = Math.floor(Date.now() / 1000);
+        const passwordHash = hashPassword(newPassword);
+        this.db
+            .prepare("UPDATE accounts SET password = ?, updated_at = ? WHERE user_id = ? AND provider_id = 'credential'")
+            .run(passwordHash, now, userId);
+    }
+    /**
+     * Verify a password against the stored hash.
+     */
+    verifyPassword(userId, password) {
+        const row = this.db
+            .prepare("SELECT password FROM accounts WHERE user_id = ? AND provider_id = 'credential'")
+            .get(userId);
+        if (!row?.password)
+            return false;
+        return verifyPasswordHash(row.password, password);
+    }
+    /**
+     * Close the database connection.
+     */
+    close() {
+        this.db.close();
+    }
+    mapRow(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            email: row.email,
+            emailVerified: Boolean(row.email_verified),
+            role: row.role,
+            banned: Boolean(row.banned),
+            createdAt: new Date(row.created_at * 1000),
+            updatedAt: new Date(row.updated_at * 1000),
+        };
+    }
+}
+//# sourceMappingURL=console-db.js.map

package/dist/lib/console-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-db.js","sourceRoot":"","sources":["../../src/lib/console-db.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft-docker/mcctl",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "CLI tool for managing Docker Minecraft servers with mc-router",
   "type": "module",
   "bin": {
@@ -55,8 +55,9 @@
   ],
   "dependencies": {
     "@clack/prompts": "^0.8.0",
-    "@minecraft-docker/mod-source-modrinth": "^1.13.0",
-    "@minecraft-docker/shared": "^1.13.0",
+    "@minecraft-docker/mod-source-modrinth": "^1.14.0",
+    "@minecraft-docker/shared": "^1.14.0",
+    "better-sqlite3": "^12.6.2",
     "commander": "^12.0.0",
     "js-yaml": "^4.1.0",
     "picocolors": "^1.1.0",
@@ -65,6 +66,7 @@
     "tar": "^7.5.4"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
     "@types/tar": "^6.1.13",

package/scripts/create-server.sh

@@ -13,11 +13,14 @@
 #                  - Hostname: <server-name>.local
 #
 # Options:
-#   -t, --type TYPE      Server type: PAPER (default), VANILLA, FORGE, FABRIC
+#   -t, --type TYPE      Server type: PAPER (default), VANILLA, FORGE, FABRIC, MODRINTH, AUTO_CURSEFORGE
 #   -v, --version VER    Minecraft version (e.g., 1.21.1, 1.20.4)
 #   -s, --seed NUMBER    World seed for new world generation
 #   -u, --world-url URL  Download world from ZIP URL
 #   -w, --world NAME     Use existing world from worlds/ directory (creates symlink)
+#   --modpack SLUG       Modpack slug (required for MODRINTH/AUTO_CURSEFORGE)
+#   --modpack-version VER  Modpack version (optional)
+#   --mod-loader LOADER  Mod loader: fabric, forge, neoforge, quilt (optional)
 #   --no-start           Don't start the server after creation
 #   --start              Start the server after creation (default)
 #
@@ -222,6 +225,9 @@ MC_VERSION=""
 WORLD_SEED=""
 WORLD_URL=""
 WORLD_NAME=""
+MODPACK_SLUG=""
+MODPACK_VERSION=""
+MOD_LOADER=""
 START_SERVER="true"
 
 # Show usage
@@ -232,11 +238,14 @@ show_usage() {
     echo "  server-name  : Name for the new server (lowercase, no spaces)"
     echo ""
     echo "Options:"
-    echo "  -t, --type TYPE      Server type: PAPER (default), VANILLA, FORGE, FABRIC"
+    echo "  -t, --type TYPE      Server type: PAPER (default), VANILLA, FORGE, FABRIC, MODRINTH, AUTO_CURSEFORGE"
     echo "  -v, --version VER    Minecraft version (e.g., 1.21.1, 1.20.4)"
     echo "  -s, --seed NUMBER    World seed for new world generation"
     echo "  -u, --world-url URL  Download world from ZIP URL"
     echo "  -w, --world NAME     Use existing world from worlds/ directory (creates symlink)"
+    echo "  --modpack SLUG       Modpack slug (required for MODRINTH/AUTO_CURSEFORGE)"
+    echo "  --modpack-version VER  Modpack version (optional)"
+    echo "  --mod-loader LOADER  Mod loader: fabric, forge, neoforge, quilt (optional)"
     echo "  --no-start           Don't start the server after creation"
     echo "  --start              Start the server after creation (default)"
     echo ""
@@ -249,6 +258,7 @@ show_usage() {
     echo "  $0 myserver --seed 12345"
     echo "  $0 myserver --world-url https://example.com/world.zip"
     echo "  $0 myserver --world existing-world -v 1.21.1 --no-start"
+    echo "  $0 myserver -t MODRINTH --modpack fabric-example --modpack-version 1.0.0"
 }
 
 # Check if first argument exists
@@ -286,6 +296,18 @@ while [[ $# -gt 0 ]]; do
             WORLD_NAME="$2"
             shift 2
             ;;
+        --modpack)
+            MODPACK_SLUG="$2"
+            shift 2
+            ;;
+        --modpack-version)
+            MODPACK_VERSION="$2"
+            shift 2
+            ;;
+        --mod-loader)
+            MOD_LOADER="$2"
+            shift 2
+            ;;
         --no-start)
             START_SERVER="false"
             shift
@@ -300,7 +322,7 @@ while [[ $# -gt 0 ]]; do
             ;;
         *)
             # For backward compatibility: if it looks like a server type, use it
-            if [[ "$1" =~ ^(PAPER|VANILLA|FORGE|FABRIC|NEOFORGE|QUILT|SPIGOT)$ ]]; then
+            if [[ "$1" =~ ^(PAPER|VANILLA|FORGE|FABRIC|NEOFORGE|QUILT|SPIGOT|MODRINTH|AUTO_CURSEFORGE)$ ]]; then
                 SERVER_TYPE="$1"
                 shift
             else
@@ -325,6 +347,15 @@ if [ "$WORLD_OPTIONS_COUNT" -gt 1 ]; then
     exit 1
 fi
 
+# Validate modpack options for MODRINTH and AUTO_CURSEFORGE types
+if [[ "$SERVER_TYPE" =~ ^(MODRINTH|AUTO_CURSEFORGE)$ ]]; then
+    if [ -z "$MODPACK_SLUG" ]; then
+        echo -e "${RED}Error: --modpack SLUG is required for $SERVER_TYPE server type${NC}"
+        echo "Example: $0 $SERVER_NAME -t $SERVER_TYPE --modpack fabric-example"
+        exit 1
+    fi
+fi
+
 # Validate server name (lowercase, alphanumeric, hyphens only)
 if [[ ! "$SERVER_NAME" =~ ^[a-z][a-z0-9-]*$ ]]; then
     echo -e "${RED}Error: Server name must start with a letter and contain only lowercase letters, numbers, and hyphens${NC}"
@@ -440,6 +471,35 @@ if [ -f "$CONFIG_FILE" ]; then
             sed -i "s/^LEVEL=.*/LEVEL=$WORLD_NAME/" "$CONFIG_FILE"
         fi
     fi
+
+    # Apply modpack options
+    if [ -n "$MODPACK_SLUG" ]; then
+        echo "" >> "$CONFIG_FILE"
+        echo "# Modpack Configuration" >> "$CONFIG_FILE"
+        if [[ "$SERVER_TYPE" == "MODRINTH" ]]; then
+            echo "MODRINTH_MODPACK=$MODPACK_SLUG" >> "$CONFIG_FILE"
+            echo "   Modpack: $MODPACK_SLUG (Modrinth)"
+            if [ -n "$MODPACK_VERSION" ]; then
+                echo "MODRINTH_VERSION=$MODPACK_VERSION" >> "$CONFIG_FILE"
+                echo "   Modpack version: $MODPACK_VERSION"
+            fi
+            if [ -n "$MOD_LOADER" ]; then
+                echo "MODRINTH_LOADER=$MOD_LOADER" >> "$CONFIG_FILE"
+                echo "   Mod loader: $MOD_LOADER"
+            fi
+        elif [[ "$SERVER_TYPE" == "AUTO_CURSEFORGE" ]]; then
+            echo "CF_SLUG=$MODPACK_SLUG" >> "$CONFIG_FILE"
+            echo "   Modpack: $MODPACK_SLUG (CurseForge)"
+            if [ -n "$MODPACK_VERSION" ]; then
+                echo "CF_VERSION=$MODPACK_VERSION" >> "$CONFIG_FILE"
+                echo "   Modpack version: $MODPACK_VERSION"
+            fi
+            if [ -n "$MOD_LOADER" ]; then
+                echo "CF_LOADER=$MOD_LOADER" >> "$CONFIG_FILE"
+                echo "   Mod loader: $MOD_LOADER"
+            fi
+        fi
+    fi
 fi
 
 # Create data and logs directories

package/templates/.env.example

@@ -52,7 +52,7 @@ COMPOSE_PROJECT_NAME=minecraft
 # BACKUP_AUTO_ON_STOP=true
 
 # =============================================================================
-# Admin Service Configuration (Optional)
+# Management Console Configuration (Optional)
 # =============================================================================
 # Web-based management UI for Minecraft servers.
 # Start with: mcctl admin service start