CLIcraft v0.4.2 (Live on NPM!) banner

CLIcraft v0.4.2 (Live on NPM!)

Created by: theinfamousben
8 devlogs
8h 35m 55s

A simple Minecraft Mod Package Manager and Launcher written in Node.JS

This project uses AI

Used GitHub Copilot for Documentation, code completion, and agent tasks (create command schema, web backend)

Demo Repository

README

Loading README...
theinfamousben
theinfamousben worked on CLIcraft v0.4.2 (Live on NPM!)
3 days ago
1h 12m logged

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
Attachment
1

Comments

chefpenguino
chefpenguino 3 days ago

this is nice, i could see this actually being super useful - cool stuff & keep going ๐Ÿ

theinfamousben
theinfamousben shipped CLIcraft v0.4.2 (Live on NPM!)
7 days ago

Shipped this project!

Hours: 2.09
Cookies: ๐Ÿช 19
Multiplier: 8.95 cookies/hr

The package is finally live on NPM, took only some timeโ€ฆ One thing I did learn was BE PATIENT, too many borked versions, sadly

theinfamousben
theinfamousben worked on CLIcraft v0.4.2 (Live on NPM!)
7 days ago
1h 17m logged

Devlog 4.1 [v0.4.1]

[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/
Attachment
0
theinfamousben
theinfamousben worked on CLIcraft v0.4.2 (Live on NPM!)
8 days ago
0h 47m logged

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
Attachment
0
theinfamousben
theinfamousben shipped CLIcraft v0.4.2 (Live on NPM!)
12 days ago

Shipped this project!

Hours: 3.88
Cookies: ๐Ÿช 43
Multiplier: 10.98 cookies/hr

#CLIcraft

Welcome to CLIcraft - A simple, powerful Minecraft Mod Package Manager written in Node.js.

๐ŸŽฎ What is CLIcraft?

CLIcraft is a command-line tool that simplifies managing Minecraft instances and mods. Create instances with Fabric or Forge, search and install mods from Modrinth, and launch the game directly from your terminal.

โœจ Key Features

  • ๐ŸŽฎ Create Instances - Set up new Minecraft client or server instances with Fabric or Forge
  • ๐Ÿ” Search Mods - Find mods on Modrinth with filters for version, loader, and more
  • ๐Ÿ“ฆ Install Mods - Download and install mods directly to your instance
  • ๐Ÿ”„ Upgrade - Update mods, mod loader, or Minecraft version
  • โ„น๏ธ Instance Info - View detailed information about your instances
  • ๐Ÿ” Microsoft Login - Authenticate with your Microsoft account to play online
  • ๐Ÿš€ Launch Game - Start Minecraft directly from the terminal

๐Ÿš€ Quick Start

# Create a new instance
clicraft create

# Search for mods
clicraft search sodium

# Install a mod
cd my-instance
clicraft install sodium

# Launch the game
clicraft launch
theinfamousben
theinfamousben worked on CLIcraft v0.4.2 (Live on NPM!)
12 days ago
1h 42m logged

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
Attachment
0
theinfamousben
theinfamousben worked on CLIcraft v0.4.2 (Live on NPM!)
13 days ago
0h 39m logged

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
Attachment
Attachment
0
theinfamousben
theinfamousben worked on CLIcraft v0.4.2 (Live on NPM!)
14 days ago
1h 9m logged

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!
Attachment
Attachment
Attachment
0