@bobschlowinskii/clicraft 0.4.6 → 1.0.0

package/.github/ISSUES/backup-restore.md

@@ -0,0 +1,16 @@
+# Backup and restore instances
+
+## Description
+Add the ability to backup and restore Minecraft instances.
+
+## Features
+- `clicraft backup [name]` - Create a backup of the current instance
+- `clicraft restore <backup>` - Restore from a backup
+- `clicraft backup list` - List available backups
+- Configurable backup location (default: `~/.clicraft/backups/`)
+- Option to include/exclude worlds, resource packs, etc.
+
+## Implementation Notes
+- Use zip/tar for compression
+- Store metadata (date, instance name, MC version) in backup
+- Consider incremental backups for large instances

package/.github/ISSUES/crash-log-analysis.md

@@ -0,0 +1,21 @@
+# Crash log analysis
+
+## Description
+Help users diagnose crashes by analyzing crash reports and logs.
+
+## Features
+- `clicraft logs` - Show recent log output
+- `clicraft logs --crash` - Find and display latest crash report
+- `clicraft diagnose` - Analyze crash for common issues
+- Detect common problems:
+  - Mod conflicts
+  - Missing dependencies
+  - Java version issues
+  - Out of memory
+  - Incompatible mod versions
+
+## Implementation Notes
+- Parse `crash-reports/` and `logs/latest.log`
+- Build knowledge base of common crash patterns
+- Could integrate with AI for more complex analysis
+- Suggest fixes based on detected issues

package/.github/ISSUES/mod-rollback.md

@@ -0,0 +1,15 @@
+# Rollback to previous mod version
+
+## Description
+Allow users to rollback mods to a previous version if an update causes issues.
+
+## Features
+- `clicraft rollback <mod>` - Rollback to previous version
+- `clicraft rollback <mod> <version>` - Rollback to specific version
+- Keep version history in mcconfig.json
+- Option to list available versions before rollback
+
+## Implementation Notes
+- Store previous version info when upgrading
+- May need to keep old .jar files or re-download
+- Consider how many versions to track (configurable?)

package/.github/ISSUES/server-utilities.md

@@ -0,0 +1,16 @@
+# Server management utilities
+
+## Description
+Add utilities for managing Minecraft servers beyond just launching.
+
+## Features
+- `clicraft server whitelist <add|remove|list> [player]` - Manage whitelist
+- `clicraft server ops <add|remove|list> [player]` - Manage operators
+- `clicraft server ban <add|remove|list> [player]` - Manage bans
+- `clicraft server properties [key] [value]` - View/edit server.properties
+- `clicraft server status` - Check if server is running, player count
+
+## Implementation Notes
+- Parse and modify server.properties, whitelist.json, ops.json, banned-players.json
+- For status, could check if port is in use or parse logs
+- Consider RCON integration for live commands

package/CHANGELOG.md

@@ -2,6 +2,60 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.0] - 2026-02-09
+
+### Added
+- **Automatic dependency installation**
+  - Mods with required dependencies are now installed automatically
+  - Configure with `clicraft config set autoInstallDeps true/false`
+  - Skip for single install with `--no-deps` flag
+
+- **Upgrade `--check` flag**
+  - `clicraft upgrade --check` shows available updates without installing
+  - Summarizes up-to-date, outdated, incompatible, and errored mods
+
+- **Modpack import**
+  - `clicraft import <file.mrpack>` imports Modrinth modpacks
+  - Creates new instance from modpack or imports into existing
+  - Extracts overrides and downloads all mod files
+
+- **Resource pack and shader support**
+  - `clicraft search <query> --resourcepacks` searches resource packs
+  - `clicraft search <query> --shaders` searches shaders
+  - `clicraft install <slug> --resourcepacks` installs to resourcepacks/
+  - `clicraft install <slug> --shaders` installs to shaderpacks/
+
+- **Shell completions**
+  - `clicraft completions bash` generates bash completions
+  - `clicraft completions zsh` generates zsh completions
+  - `clicraft completions fish` generates fish completions
+
+- **Java version detection**
+  - `clicraft info` shows Java version and compatibility status
+  - `clicraft launch` warns if Java version is incompatible
+  - Automatic version requirement detection based on Minecraft version
+
+- **Instance-aware search filtering**
+  - Search automatically filters by Minecraft version and mod loader when run from an instance directory
+  - Use `-i, --instance <path>` to specify an instance explicitly
+  - Use `--any` flag to ignore filtering and search all versions
+  - Flags `-m` and `--loader` override instance defaults
+
+- **Upgrade command keywords**
+  - `clicraft upgrade mods` — Update all mods directly
+  - `clicraft upgrade loader` — Update mod loader directly
+  - `clicraft upgrade minecraft` — Update Minecraft version directly
+  - `clicraft upgrade config` — Update config format directly
+
+### Changed
+- **Renamed search version flag** from `-v, --version` to `-m, --mc-version` to avoid conflict with global `--version` flag
+- **Refactored documentation** — All docs rewritten to be concise and direct
+
+### Fixed
+- **Typo in version option** — "curent" → "current"
+- **Search `--limit` validation** — Now shows error for non-numeric input instead of HTTP 400
+- **Tilde expansion in paths** — `~/path` now correctly expands to home directory in search `-i` flag
+
 ## [0.4.6] - 2026-02-06
 
 ### Added

package/commands/completions.js

@@ -0,0 +1,309 @@
+import { program } from 'commander';
+
+// Generate shell completions for bash, zsh, and fish
+export function generateCompletions(shell) {
+    const commands = [
+        'search', 'create', 'install', 'uninstall', 'import', 
+        'auth', 'launch', 'info', 'upgrade', 'config', 'alias'
+    ];
+
+    const loaders = ['fabric', 'forge', 'quilt', 'neoforge'];
+    const authActions = ['login', 'logout', 'switch', 'status'];
+    const configActions = ['get', 'set', 'list', 'reset'];
+    const upgradeKeywords = ['mods', 'loader', 'minecraft', 'config'];
+
+    switch (shell) {
+        case 'bash':
+            console.log(generateBashCompletions(commands, loaders, authActions, configActions, upgradeKeywords));
+            break;
+        case 'zsh':
+            console.log(generateZshCompletions(commands, loaders, authActions, configActions, upgradeKeywords));
+            break;
+        case 'fish':
+            console.log(generateFishCompletions(commands, loaders, authActions, configActions, upgradeKeywords));
+            break;
+        default:
+            console.log(`Unknown shell: ${shell}`);
+            console.log('Supported shells: bash, zsh, fish');
+            console.log('\nUsage:');
+            console.log('  clicraft completions bash >> ~/.bashrc');
+            console.log('  clicraft completions zsh >> ~/.zshrc');
+            console.log('  clicraft completions fish > ~/.config/fish/completions/clicraft.fish');
+    }
+}
+
+function generateBashCompletions(commands, loaders, authActions, configActions, upgradeKeywords) {
+    return `# clicraft bash completion
+_clicraft() {
+    local cur prev words cword
+    _init_completion || return
+
+    local commands="${commands.join(' ')}"
+    local loaders="${loaders.join(' ')}"
+    local auth_actions="${authActions.join(' ')}"
+    local config_actions="${configActions.join(' ')}"
+    local upgrade_keywords="${upgradeKeywords.join(' ')}"
+
+    case $prev in
+        clicraft)
+            COMPREPLY=( $(compgen -W "$commands -v --version -h --help" -- "$cur") )
+            return
+            ;;
+        search)
+            # No completions for search query
+            return
+            ;;
+        install|uninstall)
+            # Complete with mod slugs from config if in instance directory
+            if [[ -f mcconfig.json ]]; then
+                local mods=$(grep -oP '"slug":\\s*"\\K[^"]+' mcconfig.json 2>/dev/null)
+                COMPREPLY=( $(compgen -W "$mods" -- "$cur") )
+            fi
+            return
+            ;;
+        upgrade)
+            COMPREPLY=( $(compgen -W "$upgrade_keywords" -- "$cur") )
+            return
+            ;;
+        auth)
+            COMPREPLY=( $(compgen -W "$auth_actions" -- "$cur") )
+            return
+            ;;
+        config)
+            COMPREPLY=( $(compgen -W "$config_actions" -- "$cur") )
+            return
+            ;;
+        --loader)
+            COMPREPLY=( $(compgen -W "$loaders" -- "$cur") )
+            return
+            ;;
+        -i|--instance)
+            _filedir -d
+            return
+            ;;
+    esac
+
+    case $cur in
+        -*)
+            case \${words[1]} in
+                search)
+                    COMPREPLY=( $(compgen -W "-l --limit -m --mc-version --loader -i --instance --any -r --resourcepacks -s --shaders --verbose -h --help" -- "$cur") )
+                    ;;
+                install)
+                    COMPREPLY=( $(compgen -W "-i --instance -f --force --no-deps -r --resourcepacks -s --shaders --verbose -h --help" -- "$cur") )
+                    ;;
+                uninstall)
+                    COMPREPLY=( $(compgen -W "-i --instance -f --force --verbose -h --help" -- "$cur") )
+                    ;;
+                upgrade)
+                    COMPREPLY=( $(compgen -W "-i --instance -f --force -c --check --verbose -h --help" -- "$cur") )
+                    ;;
+                create)
+                    COMPREPLY=( $(compgen -W "-p --path -f --force --verbose -h --help" -- "$cur") )
+                    ;;
+                launch)
+                    COMPREPLY=( $(compgen -W "-i --instance -h --help" -- "$cur") )
+                    ;;
+                import)
+                    COMPREPLY=( $(compgen -W "-i --instance -f --force --verbose -h --help" -- "$cur") )
+                    ;;
+                *)
+                    COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+                    ;;
+            esac
+            return
+            ;;
+    esac
+}
+
+complete -F _clicraft clicraft`;
+}
+
+function generateZshCompletions(commands, loaders, authActions, configActions, upgradeKeywords) {
+    return `#compdef clicraft
+# clicraft zsh completion
+
+_clicraft() {
+    local -a commands
+    commands=(
+        'search:Search for Minecraft mods on Modrinth'
+        'create:Create a new Minecraft instance'
+        'install:Install mods, resource packs, or shaders'
+        'uninstall:Uninstall a mod from the instance'
+        'import:Import a modpack (.mrpack)'
+        'auth:Manage Minecraft accounts'
+        'launch:Launch the Minecraft instance'
+        'info:Show instance information'
+        'upgrade:Upgrade mods, Minecraft version, or mod loader'
+        'config:Manage CLIcraft settings'
+        'alias:Manage command aliases'
+    )
+
+    _arguments -C \\
+        '-v[Show the current version]' \\
+        '--version[Show the current version]' \\
+        '-h[Show help]' \\
+        '--help[Show help]' \\
+        '1: :->command' \\
+        '*:: :->args'
+
+    case $state in
+        command)
+            _describe 'command' commands
+            ;;
+        args)
+            case $words[1] in
+                search)
+                    _arguments \\
+                        '-l[Number of results]:limit:' \\
+                        '--limit[Number of results]:limit:' \\
+                        '-m[Minecraft version]:version:' \\
+                        '--mc-version[Minecraft version]:version:' \\
+                        '--loader[Mod loader]:loader:(fabric forge quilt neoforge)' \\
+                        '-i[Instance path]:instance:_files -/' \\
+                        '--instance[Instance path]:instance:_files -/' \\
+                        '--any[Ignore instance filtering]' \\
+                        '-r[Search resource packs]' \\
+                        '--resourcepacks[Search resource packs]' \\
+                        '-s[Search shaders]' \\
+                        '--shaders[Search shaders]' \\
+                        '--verbose[Enable verbose output]' \\
+                        '*:query:'
+                    ;;
+                install)
+                    _arguments \\
+                        '-i[Instance path]:instance:_files -/' \\
+                        '--instance[Instance path]:instance:_files -/' \\
+                        '-f[Force reinstall]' \\
+                        '--force[Force reinstall]' \\
+                        '--no-deps[Skip dependencies]' \\
+                        '-r[Install as resource packs]' \\
+                        '--resourcepacks[Install as resource packs]' \\
+                        '-s[Install as shaders]' \\
+                        '--shaders[Install as shaders]' \\
+                        '--verbose[Enable verbose output]' \\
+                        '*:mod slug:'
+                    ;;
+                uninstall)
+                    _arguments \\
+                        '-i[Instance path]:instance:_files -/' \\
+                        '--instance[Instance path]:instance:_files -/' \\
+                        '-f[Skip confirmation]' \\
+                        '--force[Skip confirmation]' \\
+                        '--verbose[Enable verbose output]' \\
+                        '*:mod:'
+                    ;;
+                upgrade)
+                    _arguments \\
+                        '-i[Instance path]:instance:_files -/' \\
+                        '--instance[Instance path]:instance:_files -/' \\
+                        '-f[Force upgrade]' \\
+                        '--force[Force upgrade]' \\
+                        '-c[Check only]' \\
+                        '--check[Check only]' \\
+                        '--verbose[Enable verbose output]' \\
+                        '*:target:(mods loader minecraft config)'
+                    ;;
+                import)
+                    _arguments \\
+                        '-i[Instance path]:instance:_files -/' \\
+                        '--instance[Instance path]:instance:_files -/' \\
+                        '-f[Overwrite existing]' \\
+                        '--force[Overwrite existing]' \\
+                        '--verbose[Enable verbose output]' \\
+                        '*:packfile:_files -g "*.mrpack"'
+                    ;;
+                auth)
+                    _arguments \\
+                        '-f[Skip confirmation]' \\
+                        '--force[Skip confirmation]' \\
+                        '1:action:(login logout switch status)'
+                    ;;
+                config)
+                    _arguments \\
+                        '1:action:(get set list reset)' \\
+                        '*:args:'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_clicraft "$@"`;
+}
+
+function generateFishCompletions(commands, loaders, authActions, configActions, upgradeKeywords) {
+    return `# clicraft fish completion
+
+# Disable file completion by default
+complete -c clicraft -f
+
+# Commands
+complete -c clicraft -n '__fish_use_subcommand' -a 'search' -d 'Search for Minecraft mods on Modrinth'
+complete -c clicraft -n '__fish_use_subcommand' -a 'create' -d 'Create a new Minecraft instance'
+complete -c clicraft -n '__fish_use_subcommand' -a 'install' -d 'Install mods, resource packs, or shaders'
+complete -c clicraft -n '__fish_use_subcommand' -a 'uninstall' -d 'Uninstall a mod from the instance'
+complete -c clicraft -n '__fish_use_subcommand' -a 'import' -d 'Import a modpack (.mrpack)'
+complete -c clicraft -n '__fish_use_subcommand' -a 'auth' -d 'Manage Minecraft accounts'
+complete -c clicraft -n '__fish_use_subcommand' -a 'launch' -d 'Launch the Minecraft instance'
+complete -c clicraft -n '__fish_use_subcommand' -a 'info' -d 'Show instance information'
+complete -c clicraft -n '__fish_use_subcommand' -a 'upgrade' -d 'Upgrade mods, Minecraft, or loader'
+complete -c clicraft -n '__fish_use_subcommand' -a 'config' -d 'Manage CLIcraft settings'
+complete -c clicraft -n '__fish_use_subcommand' -a 'alias' -d 'Manage command aliases'
+
+# Global options
+complete -c clicraft -s v -l version -d 'Show the current version'
+complete -c clicraft -s h -l help -d 'Show help'
+
+# search options
+complete -c clicraft -n '__fish_seen_subcommand_from search' -s l -l limit -d 'Number of results'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -s m -l mc-version -d 'Minecraft version'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -l loader -a '${loaders.join(' ')}' -d 'Mod loader'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -s i -l instance -ra '(__fish_complete_directories)' -d 'Instance path'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -l any -d 'Ignore instance filtering'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -s r -l resourcepacks -d 'Search resource packs'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -s s -l shaders -d 'Search shaders'
+complete -c clicraft -n '__fish_seen_subcommand_from search' -l verbose -d 'Enable verbose output'
+
+# install options
+complete -c clicraft -n '__fish_seen_subcommand_from install' -s i -l instance -ra '(__fish_complete_directories)' -d 'Instance path'
+complete -c clicraft -n '__fish_seen_subcommand_from install' -s f -l force -d 'Force reinstall'
+complete -c clicraft -n '__fish_seen_subcommand_from install' -l no-deps -d 'Skip dependencies'
+complete -c clicraft -n '__fish_seen_subcommand_from install' -s r -l resourcepacks -d 'Install as resource packs'
+complete -c clicraft -n '__fish_seen_subcommand_from install' -s s -l shaders -d 'Install as shaders'
+complete -c clicraft -n '__fish_seen_subcommand_from install' -l verbose -d 'Enable verbose output'
+
+# uninstall options
+complete -c clicraft -n '__fish_seen_subcommand_from uninstall' -s i -l instance -ra '(__fish_complete_directories)' -d 'Instance path'
+complete -c clicraft -n '__fish_seen_subcommand_from uninstall' -s f -l force -d 'Skip confirmation'
+complete -c clicraft -n '__fish_seen_subcommand_from uninstall' -l verbose -d 'Enable verbose output'
+
+# upgrade options
+complete -c clicraft -n '__fish_seen_subcommand_from upgrade' -s i -l instance -ra '(__fish_complete_directories)' -d 'Instance path'
+complete -c clicraft -n '__fish_seen_subcommand_from upgrade' -s f -l force -d 'Force upgrade'
+complete -c clicraft -n '__fish_seen_subcommand_from upgrade' -s c -l check -d 'Check only'
+complete -c clicraft -n '__fish_seen_subcommand_from upgrade' -l verbose -d 'Enable verbose output'
+complete -c clicraft -n '__fish_seen_subcommand_from upgrade' -a '${upgradeKeywords.join(' ')}' -d 'Upgrade target'
+
+# import options
+complete -c clicraft -n '__fish_seen_subcommand_from import' -s i -l instance -ra '(__fish_complete_directories)' -d 'Instance path'
+complete -c clicraft -n '__fish_seen_subcommand_from import' -s f -l force -d 'Overwrite existing'
+complete -c clicraft -n '__fish_seen_subcommand_from import' -l verbose -d 'Enable verbose output'
+complete -c clicraft -n '__fish_seen_subcommand_from import' -ra '(__fish_complete_suffix .mrpack)' -d 'Modpack file'
+
+# auth subcommands
+complete -c clicraft -n '__fish_seen_subcommand_from auth' -a '${authActions.join(' ')}'
+
+# config subcommands  
+complete -c clicraft -n '__fish_seen_subcommand_from config' -a '${configActions.join(' ')}'
+
+# create options
+complete -c clicraft -n '__fish_seen_subcommand_from create' -s p -l path -ra '(__fish_complete_directories)' -d 'Instance path'
+complete -c clicraft -n '__fish_seen_subcommand_from create' -s f -l force -d 'Overwrite existing'
+complete -c clicraft -n '__fish_seen_subcommand_from create' -l verbose -d 'Enable verbose output'
+
+# launch options
+complete -c clicraft -n '__fish_seen_subcommand_from launch' -s i -l instance -ra '(__fish_complete_directories)' -d 'Instance path'`;
+}
+
+export default { generateCompletions };