@bobschlowinskii/clicraft 0.4.4 → 0.4.5

package/CHANGELOG.md

@@ -2,7 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.4.4] - [TBA]
+## [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/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/helpers/versions.js

@@ -11,6 +11,7 @@ const versions = [
     '0.4.2',
     '0.4.3',
     '0.4.4',
+    '0.4.5',
 ];
 
 

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')

package/package.json

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