Devlog 5 [v1.0.0]

I am proud to announce that I have finally released Version 1.0, working (hopefully) perfectly out of the box, so here’s a list of what’s new:

Added

• Automatic dependency installation

  • Mods with required dependencies are now installed automatically

• 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

• 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

• Java version detection

  • clicraft info shows Java version and compatibility status
  • clicraft launch warns if Java version is incompatible

• Instance-aware search filtering

  • Search automatically filters by Minecraft version and mod loader when run from an instance directory

• Upgrade command keywords

  • clicraft upgrade mods — Update all mods directly
  • clicraft upgrade loader — Update mod loader directly
  • etc

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

Devlog 4.5 [v0.4.6]

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

Devlog 4.4 [v0.4.5]

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

Devlog 4.3 [v0.4.4]

Added

• Added config entry for custom JVM args
• Cleaned up the Docs

Devlog 4.2 [0.4.3]

Added

• Launch by Alias clicraft alias
  • Add alias clicraft alias add [name] [path]
  • remove alias clicraft alias remove [name]
  • list aliases clicraft alias

Devlog 4.1 [v0.4.1 - 0.4.2]

[0.4.2] - 2026-01-24

Emergency Patch

Changed

• Fixed post-command.js

[0.4.1] - 2026-01-24

Added

• Published to npm
  • Package available as @bobschlowinskii/clicraft
  • Install globally with npm install -g @bobschlowinskii/clicraft
• Added Auto-update checking
  • disable by setting checkUpdates to false in ~/.clicraft/settings/

Devlog 4.0 [v0.3.1-v0.4.0]

[0.4.0] - 2026-01-22

Added

• Multi-Account Authentication (clicraft auth)
  • Support for multiple Microsoft/Minecraft accounts
  • New unified clicraft auth command with subcommands:
    • auth login - Add a new account or update existing
    • auth logout [account] - Remove an account (interactive selection if multiple)
    • auth switch [account] - Switch between saved accounts
    • auth status [account] - Show all accounts or specific account details
    • auth list - List all saved accounts
  • Accounts stored in ~/.clicraft/auth/accounts.json
  • Active account highlighted with ▶ marker in status
  • Token status (valid/expired) shown for each account
  • Automatic migration from legacy auth.json format

Changed

• Auth Commands Restructured
  • Replaced standalone login, logout, status commands with auth subcommand
  • Backward compatible loadAuth() and refreshAuth() exports maintained

Deprecated

• Old clicraft login, clicraft logout, clicraft status commands are now under clicraft auth

[0.3.2] - 2026-01-22

Changed

• Major Codebase Refactoring

[0.3.1] - 2026-01-22

Added

• Uninstall Command (clicraft uninstall)
  • Remove mods from your Minecraft instance
  • Interactive multi-select when no mod specified
  • Confirmation prompt before deletion (skip with --force)
  • Removes mod file and updates mcconfig.json

Devlog 3.0 [v0.3.0]

I am renaming this program to CLIcraft to avoid confusion with mcpkg by crispyricepc

Added

• Config Command (clicraft config)

  • New command to manage CLI settings and game settings

• Global Configuration Directory (~/.clicraft/)

  • Centralized config directory for CLI-wide settings
  • settings.json - CLI settings (Java path, memory, mod source, etc.)
  • game-settings-ignore.json - Patterns for settings to exclude when capturing
  • default-game-settings.json - Default Minecraft settings applied to new instances
  • auth.json - Authentication tokens (migrated from ~/.mcpkg/)

• Game Settings in mcconfig.json

  • New gameSettings field to store Minecraft options
  • Capture settings from options.txt with customizable ignore list
  • Automatically apply game settings when creating from config

• Create from Existing Config (clicraft create with mcconfig.json)

  • Detects mcconfig.json in current directory
  • Creates new instance from existing configuration
  • Installs same Minecraft version, mod loader, and loader version
  • Automatically installs all mods from the config
  • Applies game settings if present

• Added --mods option to clicraft info

  • Shows only installed mods instead of the entire instance info

Changed

• Improved mod installation with better error handling

Devlog 2.1 [v0.2.1-v0.2.2]

Added

• Version Command (mcpkg -v, --version)
  • Displays cool art and version!

Devlog 2.0 [v0.2.0]

Added

• Instance Info (mcpkg info)

  • Display comprehensive instance information
  • Shows instance name, type, mod loader, and versions
  • Lists installed mods with version numbers
  • Storage breakdown by directory (libraries, assets, mods, etc.)
  • World saves count and details
  • Verbose mode for detailed output (--verbose)

• Upgrade Command (mcpkg upgrade)

  • Interactive upgrade menu for mods, loader, or Minecraft version
  • Upgrade all mods at once to latest compatible versions
  • Upgrade individual mods by name (mcpkg upgrade sodium)
  • Upgrade Fabric loader version with automatic library downloads
  • Config format migration for future compatibility
  • Force upgrade option (--force)

• Config Versioning

  • Added configVersion field to mcconfig.json
  • Enables future migrations and compatibility checks

Changed

• Improved mod tracking with updatedAt timestamp on upgrades

Devlog 1.0 [v0.1.0]

I eventually want this package to be installable through npm, but my account is broken rn, so ill fix it later :p

Added

• Instance Creation (mcpkg create)

  • Interactive prompts for instance configuration
  • Support for Fabric and Forge mod loaders
  • Client and server instance types
  • Automatic download of Minecraft client/server JAR
  • Automatic download of all required libraries
  • Automatic download of game assets
  • Paginated version selection (10 items per page)
  • Creates mcconfig.json with instance metadata

• Mod Search (mcpkg search)

  • Search mods on Modrinth by name
  • Filter by Minecraft version (--version)
  • Filter by mod loader (--loader)
  • Limit results (--limit)
  • Displays download counts, supported loaders, and Modrinth links

• Mod Installation (mcpkg install)

  • Install mods from Modrinth to instance
  • Automatic version matching for Minecraft version and loader
  • Dependency detection with warnings
  • Force reinstall option (--force)
  • Instance path option (--instance)

• Microsoft Authentication (mcpkg login, mcpkg logout, mcpkg status)

  • Microsoft OAuth login via browser
  • Xbox Live and Minecraft Services authentication
  • Token refresh for persistent sessions
  • Secure token storage in ~/.mcpkg/auth.json

• Game Launching (mcpkg launch)

  • Launch Minecraft directly from terminal
  • Automatic classpath building for vanilla and Fabric libraries
  • Support for offline mode (--offline)
  • Verbose output option (--verbose)
  • Instance path option (--instance)

What I aim to add:

• Loading settings from a settings.json file
• Support for importing profiles from mcconfig.json files
• and more!