apt-mc

The Missing Package Manager for Minecraft Servers. 🍺

Features

• Parody Interface: Mimics the familiar Debian/Ubuntu apt commands.
• Modrinth Integration: Searches and downloads plugins directly from Modrinth.
• Smart Filtering: Automatically filters for Spigot/Paper compatible plugins (ignoring mods).
• Colorful Output: Uses rich for a modern CLI experience.
• TUI: When ran without command line arguments, textual gets used to open a modern TUI to manage your plugins

Warning

If you build a proprietary SaaS (Software as a Service) on top of this, you are now PART of the problem. Don't be that person.

Installation

1. Clone this repository.
2. Install dependencies:

   pip install -r requirements.txt

3. Run the script:

   chmod +x main.py
   ./main.py --help

Usage

Update

Updates the local "package lists" (mostly for show, ensures API connectivity).

./main.py update

Search

Search for plugins on Modrinth.

./main.py search <query>

Example: ./main.py search worldedit

Install

Download and install a plugin to the ./plugins directory.

./main.py install <plugin_slug>

Example: ./main.py install worldedit

Remove

Remove a plugin from the ./plugins directory.

./main.py remove <plugin_slug>

Example: ./main.py remove worldedit