Lucy

The package manager for Minecraft servers.

Documentation | English | 中文

Important

Lucy is in active pre-beta development. APIs and schemas may change before 1.0. Join the QQ Group or open an issue to contribute.

Lucy brings modern package management experience to Minecraft servers. Define and manage your server with simple and declarative workflows.

We (are working to) support multiple ecosystems, and their combinations:

• Fabric
• Forge
• NeoForge
• MCDReforged
• Bukkit/Spigot/Paper

Lucy fetches metadata and artifacts from multiple soucres:

• Modrinth
• Curseforge
• Host your own on GitHub!

Installation

# Homebrew (macOS / Linux)
brew install --HEAD mclucy/tap/lucy

# Go
go install github.com/mclucy/lucy@latest

Pre-built binaries are available on Releases.

Quickstart

# Initialize in a server directory
lucy init

# Add packages with dependency resolution
lucy add fabric/fabric-api lithium sodium

# Inspect runtime platform and managed dependencies
lucy status

# Sync files deterministically from lockfile
lucy install

Commands

Command	Usage
lucy init	Scaffold lucy.yaml and lucy-lock.yaml
lucy add <pkg>	Resolve dependencies, update lockfile, and install
lucy remove <pkg>	Remove packages and prune unused transitive dependencies
lucy install	Sync server runtime deterministically from lucy-lock.yaml
lucy status	Show server core, loader, runtime status, and packages
lucy tree	Inspect dependency graph (supports --live probe)
lucy leaves	List unreferenced packages safe to remove
lucy bisect	Binary search installed mods to isolate crash causes
lucy search <query>	Query Modrinth, CurseForge, and GitHub

Full guides, configuration, and flags: lucy.lc/docs

---

Note

The logo and axolotl pixel art are copyright Mojang AB. Original replacements are in progress.