@bobschlowinskii/clicraft 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -2,7 +2,29 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.4.4] - [TBA]
+## [0.4.6] - 2026-02-06
+
+### Added
+- **Added `--last` option to `launch` command**
+  - Launches the last ran instance
+  - call with `--last` or `-l`
+- **Allow user to launch server with `launch` command**
+
+## [0.4.5] - 2026-01-31
+
+### Added
+- **Added `force` option to `create` command**
+  - Overwrites existing instance if folder already exists in path
+  - call with `--force` or `-f`
+- **Added `path` option to `create` command**
+  - Specifies a path other than the working directory to install the instance
+  - call with `--path` or `-p`
+- **Multi-mod installation support**
+  - Install multiple mods in a single command: `clicraft install mod1 mod2 mod3`
+  - Shows installation summary when installing multiple mods
+  - Tracks success/failure count for batch installations
+
+## [0.4.4] - 2026-01-29
 
 ### Added
 

package/commands/create.js

@@ -482,7 +482,7 @@ export async function createInstance(options) {
             message: 'Instance Name:',
             validate: (input) => {
                 if (!input.trim()) return 'Instance name is required';
-                if (fs.existsSync(input.trim())) return 'A folder with this name already exists';
+                if (fs.existsSync(input.trim()) && !options.force) return 'A folder with this name already exists';
                 return true;
             }
         }]);
@@ -526,7 +526,16 @@ export async function createInstance(options) {
             loaderVersion = await paginatedSelect('Forge Version:', forgeChoices);
         }
 
-        const instancePath = path.resolve(instanceName.trim());
+        const instancePath = options.path
+            ? path.resolve(options.path) + path.resolve(instanceName.trim())
+            : path.resolve(instanceName.trim())
+        ;
+        if (fs.existsSync(instancePath) && !options.force) {
+            console.log(chalk.red(`A folder already exists at ${instancePath}. Use --force to overwrite.`));
+            return;
+        } else if (fs.existsSync(instancePath) && options.force) {
+            fs.rmSync(instancePath, { recursive: true, force: true });
+        }
         fs.mkdirSync(instancePath, { recursive: true });
         fs.mkdirSync(path.join(instancePath, 'mods'), { recursive: true });
 

package/commands/install.js

@@ -5,12 +5,41 @@ import { downloadFile, loadConfig, saveConfig, getInstancePath, requireConfig }
 import { getProject, getProjectVersions } from '../helpers/modrinth.js';
 import { callPostCommandActions } from '../helpers/post-command.js';
 
-export async function installMod(modSlug, options) {
+export async function installMod(modSlugs, options) {
     const instancePath = getInstancePath(options);
     
     const config = requireConfig(instancePath);
     if (!config) return;
 
+    // Handle multiple mods
+    const slugs = Array.isArray(modSlugs) ? modSlugs : [modSlugs];
+    
+    let successCount = 0;
+    let failCount = 0;
+
+    for (const modSlug of slugs) {
+        const success = await installSingleMod(modSlug, instancePath, config, options);
+        if (success) {
+            successCount++;
+        } else {
+            failCount++;
+        }
+    }
+
+    // Show summary if multiple mods were requested
+    if (slugs.length > 1) {
+        console.log(chalk.cyan('\n📊 Installation Summary:'));
+        console.log(chalk.green(`   ✅ ${successCount} mod(s) installed successfully`));
+        if (failCount > 0) {
+            console.log(chalk.red(`   ❌ ${failCount} mod(s) failed to install`));
+        }
+    }
+
+    callPostCommandActions();
+}
+
+async function installSingleMod(modSlug, instancePath, config, options) {
+
     console.log(chalk.cyan(`\n📦 Installing "${modSlug}" to ${config.name}...\n`));
 
     try {
@@ -19,12 +48,12 @@ export async function installMod(modSlug, options) {
         if (!project) {
             console.log(chalk.red(`Error: Mod "${modSlug}" not found on Modrinth.`));
             console.log(chalk.gray('Use "clicraft search <query>" to find available mods.'));
-            return;
+            return false;
         }
 
         if (project.project_type !== 'mod') {
             console.log(chalk.red(`Error: "${modSlug}" is a ${project.project_type}, not a mod.`));
-            return;
+            return false;
         }
 
         console.log(chalk.gray(`Found: ${project.title}`));
@@ -44,7 +73,7 @@ export async function installMod(modSlug, options) {
                 console.log(chalk.gray(`\nAvailable loaders: ${loaders.join(', ')}`));
                 console.log(chalk.gray(`Recent game versions: ${gameVersions.join(', ')}`));
             }
-            return;
+            return false;
         }
 
         // Use the latest compatible version
@@ -53,7 +82,7 @@ export async function installMod(modSlug, options) {
 
         if (!file) {
             console.log(chalk.red('Error: No downloadable file found for this version.'));
-            return;
+            return false;
         }
 
         // Check if already installed
@@ -61,7 +90,7 @@ export async function installMod(modSlug, options) {
         if (existingMod && !options.force) {
             console.log(chalk.yellow(`\n⚠️  ${project.title} is already installed (version ${existingMod.versionNumber})`));
             console.log(chalk.gray('Use --force to reinstall or update.'));
-            return;
+            return false;
         }
 
         // Create mods folder if needed
@@ -104,30 +133,52 @@ export async function installMod(modSlug, options) {
         // Show dependencies if any
         if (version.dependencies?.length > 0) {
             const requiredDeps = version.dependencies.filter(d => d.dependency_type === 'required');
-            if (requiredDeps.length > 0) {
-                console.log(chalk.yellow(`\n⚠️  This mod has ${requiredDeps.length} required dependencies:`));
-                for (const dep of requiredDeps) {
-                    if (dep.project_id) {
-                        const depProject = await getProject(dep.project_id);
-                        if (depProject) {
-                            const isInstalled = config.mods.some(m => m.projectId === dep.project_id);
-                            const status = isInstalled ? chalk.green('✓') : chalk.red('✗');
-                            console.log(chalk.gray(`   ${status} ${depProject.title} (${depProject.slug})`));
-                        }
+            let totalDeps = [];
+            let notInstalledDeps = [];
+            
+            for (const dep of requiredDeps) {
+                if (dep.project_id) {
+                    const depProject = await getProject(dep.project_id);
+                    if (depProject) {
+                        const isInstalled = config.mods.some(m => m.projectId === dep.project_id);
+                        // const status = isInstalled ? chalk.green('✓') : chalk.red('✗');
+                        totalDeps.push({ project: depProject, title: depProject.title, slug: depProject.slug, installed: isInstalled });
                     }
                 }
+            }
+
+            for (const dep of totalDeps) {
+                if (!dep.installed) {
+                    notInstalledDeps.push(dep); 
+                }
+            }
+            
+            if (notInstalledDeps.length > 0) {
+                console.log(chalk.yellow(`\n⚠️  This mod has ${notInstalledDeps.length} dependencies which are not installed:`));
+                totalDeps.forEach(dep => {
+                    if(dep.installed)
+                        console.log(chalk.green(`   - ${dep.title} (${dep.slug})`));
+                    if(!dep.installed)
+                        console.log(chalk.yellow(`   - ${dep.title} (${dep.slug})`));
+                });
                 console.log(chalk.gray('\nInstall dependencies with: clicraft install <slug>'));
             }
+
+            if (notInstalledDeps.length === 0) {
+                console.log(chalk.green('\n✅  All dependencies are already installed.'));
+                
+            }
         }
 
+        return true;
+
     } catch (error) {
         console.error(chalk.red('Error installing mod:'), error.message);
         if (options.verbose) {
             console.error(error);
         }
+        return false;
     }
-
-    callPostCommandActions();
 }
 
 export default { installMod };

package/commands/launch.js

@@ -4,7 +4,7 @@ import path from 'path';
 import { spawn } from 'child_process';
 import { refreshAuth } from './auth.js';
 import { captureGameSettings } from '../commands/config.js';
-import { loadSettings, writeGameSettings, getAliasByName } from '../helpers/config.js';
+import { loadSettings, writeGameSettings, getAliasByName, saveSettings } from '../helpers/config.js';
 import { 
     loadConfig, 
     getInstancePath, 
@@ -12,6 +12,7 @@ import {
     mavenToPath 
 } from '../helpers/utils.js';
 import { callPostCommandActions } from '../helpers/post-command.js';
+import { startServer } from '../helpers/server.js';
 
 // Find Java executable
 function findJava() {
@@ -126,7 +127,7 @@ export async function launchInstance(aliasOrOptions, options) {
     }
     
     const settings = loadSettings();
-    
+
     // Resolve instance path from alias, --instance flag, or current directory
     let instancePath;
     if (alias) {
@@ -145,7 +146,23 @@ export async function launchInstance(aliasOrOptions, options) {
             }
         }
     } else {
-        instancePath = getInstancePath(opts);
+        if (opts.last) {
+            if (!settings.lastInstance) {
+                console.log(chalk.red('Error: No last instance found in settings.'));
+                return;
+            }
+
+            if (!fs.existsSync(settings.lastInstance)) {
+                console.log(chalk.red('Error: Last instance path does not exist.'));
+                return;
+            }
+
+            instancePath = settings.lastInstance;
+            console.log(chalk.gray(`Using last instance → ${instancePath}`));
+        }
+        else {
+            instancePath = getInstancePath(opts);
+        }
     }
     
     // Apply saved game settings if enabled
@@ -163,11 +180,14 @@ export async function launchInstance(aliasOrOptions, options) {
     if (!config) return;
 
     if (config.type === 'server') {
-        console.log(chalk.red('Error: This is a server instance. Use ./start.sh to start the server.'));
+        console.log(chalk.yellow(`\n Detected server instance "${config.name}". Starting server...\n`));
+        startServer(instancePath);
         return;
     }
 
     console.log(chalk.cyan(`\n🎮 Launching ${config.name}...\n`));
+    settings.lastInstance = instancePath;
+    saveSettings(settings);
 
     try {
         // Get authentication

package/docs/commands/create.md

@@ -47,6 +47,8 @@ This is perfect for sharing modpack configurations or replicating setups across
 | Option | Description |
 |--------|-------------|
 | `--verbose` | Enable verbose output to see detailed progress |
+| `--force, -f` | Overwrites existing instance folder if necessary |
+| `--path, -p <path>` | Specifies path in which to install instance |
 
 ## 💡 Interactive Prompts
 

package/docs/commands/install.md

@@ -14,12 +14,12 @@ Install mods from Modrinth directly to your Minecraft instance.
 ## 📝 Synopsis
 
 ```bash
-clicraft install <mod> [options]
+clicraft install <mods...> [options]
 ```
 
 ## 📖 Description
 
-The `install` command downloads and installs mods from Modrinth to your Minecraft instance. It automatically:
+The `install` command downloads and installs one or more mods from Modrinth to your Minecraft instance. It automatically:
 
 1. Searches for the mod on Modrinth
 2. Finds the correct version for your Minecraft version and loader
@@ -31,7 +31,7 @@ The `install` command downloads and installs mods from Modrinth to your Minecraf
 
 | Argument | Description | Required |
 |----------|-------------|----------|
-| `<mod>` | Mod name or Modrinth project ID | Yes |
+| `<mods...>` | One or more mod names or Modrinth project IDs | Yes (at least one) |
 
 ## 🎯 Options
 
@@ -69,9 +69,13 @@ Use the project ID from `clicraft search` results.
 ### Install multiple mods
 ```bash
 cd my-instance
-clicraft install sodium
-clicraft install lithium
-clicraft install iris
+clicraft install sodium lithium iris
+```
+
+When installing multiple mods, you'll see a summary at the end:
+```
+📊 Installation Summary:
+   ✅ 3 mod(s) installed successfully
 ```
 
 ### Verbose installation
@@ -130,33 +134,25 @@ instance-directory/
 ### Building a Performance Pack
 ```bash
 cd my-instance
-clicraft install sodium      # Better FPS
-clicraft install lithium     # Server optimization
-clicraft install starlight   # Lighting engine
-clicraft install ferritecore # Memory optimization
+clicraft install sodium lithium starlight ferritecore
 ```
 
 ### Adding Quality of Life Mods
 ```bash
 cd my-instance
-clicraft install "just enough items"  # Recipe viewer
-clicraft install "journeymap"         # Minimap
-clicraft install "appleskin"          # Food info
+clicraft install jei journeymap appleskin
 ```
 
 ### Installing Shader Support
 ```bash
 cd my-instance
-clicraft install sodium  # Required for Iris
-clicraft install iris    # Shader loader
+clicraft install sodium iris
 ```
 
 ### Server Mods
 ```bash
 cd my-server
-clicraft install lithium
-clicraft install starlight
-clicraft install "fabric api"
+clicraft install lithium starlight fabric-api
 ```
 
 ## ⚠️ Important Notes

package/docs/commands/launch.md

@@ -33,8 +33,9 @@ The `launch` command starts your Minecraft instance with all the correct Java ar
 | Option | Description | Default |
 |--------|-------------|---------|
 | `-i, --instance <path>` | Path to instance directory | Current directory |
-| `--offline` | Launch in offline mode (no authentication) | false |
-| `--verbose` | Show detailed launch information | false |
+| `--offline` | Launch in offline mode (no authentication) | `false` |
+| `--verbose` | Show detailed launch information | `false` |
+| `-l, --last` | Launch last ran instance | `false` |
 
 ## 📋 Examples
 

package/docs/installation.md

@@ -70,7 +70,7 @@ This should display the current version of CLIcraft.
 
 ```bash
 cd clicraft
-git pull origin main
+git pull origin live
 npm install -g
 ```
 

package/helpers/config.js

@@ -29,6 +29,7 @@ const DEFAULT_SETTINGS = {
     checkUpdates: true,
     autoSaveToConfig: true,
     autoLoadConfigOnLaunch: true,
+    lastInstance: "",
 };
 
 // Default game settings to apply to new instances

package/helpers/server.js

@@ -0,0 +1,32 @@
+import path from "path";
+import { spawn } from "child_process";
+import fs from "fs";
+import chalk from "chalk";
+
+export function startServer(instancePath) {
+    const startScript = process.platform === 'win32' ? 'start.bat' : 'start.sh';
+    const startPath = path.join(instancePath, startScript);
+
+    if (!fs.existsSync(startPath)) {
+        console.error(chalk.red(`Error: Start script not found at ${startPath}`));
+        return;
+    }
+
+    const serverProcess = spawn(startPath, [], {
+        cwd: instancePath,
+        shell: true,
+        stdio: 'inherit'
+    });
+
+    serverProcess.on('error', (err) => {
+        console.error(chalk.red(`Failed to start server: ${err.message}`));
+    });
+
+    serverProcess.on('exit', (code) => {
+        if (code === 0) {
+            console.log(chalk.green('Server stopped successfully.'));
+        } else {
+            console.error(chalk.red(`Server exited with code ${code}`));
+        }
+    });
+}

package/helpers/versions.js

@@ -1,16 +1,8 @@
 const versions = [
     '0.1.0',
-    '0.2.0',
-    '0.2.1',
-    '0.2.2',
-    '0.3.0',
-    '0.3.1',
-    '0.3.2',
-    '0.4.0',
-    '0.4.1',
-    '0.4.2',
-    '0.4.3',
-    '0.4.4',
+    '0.2.0', '0.2.1', '0.2.2',
+    '0.3.0', '0.3.1', '0.3.2',
+    '0.4.0', '0.4.1', '0.4.2', '0.4.3', '0.4.4', '0.4.5', '0.4.6'
 ];
 
 

package/index.js

@@ -31,11 +31,13 @@ program
     .command('create')
     .description('Create a new Minecraft instance')
     .option('--verbose', 'Enable verbose output')
+    .option('-f, --force', 'Overwrite existing instance if it exists')
+    .option('-p, --path <path>', 'Path to create the instance in')
     .action(createInstance);
 
 program
-    .command('install <mod>')
-    .description('Install a mod to the current Minecraft instance')
+    .command('install <mods...>')
+    .description('Install one or more mods to the current Minecraft instance')
     .option('-i, --instance <path>', 'Path to the instance directory')
     .option('-f, --force', 'Force reinstall/update if already installed')
     .option('--verbose', 'Enable verbose output')
@@ -62,6 +64,7 @@ program
     .option('-i, --instance <path>', 'Path to the instance directory')
     .option('--offline', 'Launch in offline mode')
     .option('--verbose', 'Enable verbose output')
+    .option('-l, --last', 'Launch the last used instance')
     .action(launchInstance);
 
 program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobschlowinskii/clicraft",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "A simple Minecraft Mod Package Manager written in Node.JS",
   "main": "index.js",
   "type": "module",