apt-mc 📦

The Advanced Packaging Tool for Minecraft Servers.

Stop downloading JARs manually. Start managing plugins like a pro.

apt-mc brings the familiar, powerful experience of the Linux command line (apt-get) to your Spigot/Paper server. Search, install, update, and manage your plugins directly from the game chat or console, all powered by the robust Modrinth API (with optional support for Hangar).

---

✨ Features

• 🚀 Seamless Installation: Install plugins by name (/apt install viaversion) or bulk install multiple plugins at once.
• 🧠 Smart Dependency Resolution: Automatically detects and installs required dependencies for you (Modrinth only).
• 🔄 Auto-Updates: Run /apt upgrade to scan your entire plugins folder, compare hashes with Modrinth, and download the latest versions automatically.
• 📋 State Management:
  • Export: Save your server's plugin state to a YAML manifest (/apt export).
  • Import: Restore a server's setup or replicate it to another server with a single command (/apt import).
• ⚡ High Performance:
  • Parallel Downloads: Updates and installs happen asynchronously.
  • Persistent Caching: Caches plugin metadata to minimize API usage and speed up commands.
• 🛡️ Safe Updates: Updates are downloaded to the standard update/ folder, ensuring a safe swap upon the next server restart.
• 🖥️ Clean UI:
  • Uses the Action Bar for progress updates to prevent chat spam.
  • Intelligent console throttling keeps your logs readable.

---

🛠️ Commands

Command	Description
/apt install <plugin...>	Install one or more plugins. Auto-resolves dependencies.
/apt remove <plugin>	Delete a plugin JAR file from the server.
/apt upgrade	Check all installed plugins for updates and download the latest versions.
/apt search <query>	Search the Modrinth (and optionally Hangar) database for plugins.
/apt info <plugin>	View detailed metadata, author, license, and dependencies.
/apt list	List all installed plugins and their resolved versions.
/apt export [file]	Export the current plugin state to a YAML manifest (default: apt-manifest.yml).
/apt import [file]	Import and install plugins from a YAML manifest.
/apt update	Refresh the package cache (simulated parody command).
/apt help	Show the help menu.

---

⚙️ Configuration

The config.yml allows you to customize the interface and sources:

# Whether to use the action bar for status updates and progress bars.
use-action-bar: true

# Interval in seconds to update progress in the console.
console-progress-interval: 5

# Enable references to the song "APT." by Rosé & Bruno Mars
apt-song-references: true

# Enable scanning the PaperMC Hangar API for plugins (default: false)
enable-hangar: false

# Priority order for search results and installations.
source-priority:
  - modrinth
  - hangar

---

📦 Manifest Format

The export file uses a simple YAML structure, allowing you to manually define plugins by Project ID or version for easy sharing.

project-details:
  title: My Server
  author: Admin

plugins:
  # Install specific version
  ViaVersion: "modrinth:viaversion/5.2.1"
  
  # Install latest version
  Sodium: "modrinth:sodium/latest"

---

📥 Installation

1. Download the latest apt-mc JAR from the Versions tab.
2. Drop it into your server's plugins folder.
3. Restart your server.
4. Run /apt update (just for fun!) and start installing.

---

🤝 Open Source

This project is open source! We welcome contributions, bug reports, and feature requests.

• License: MIT
• Build System: Gradle

---

Note: This plugin acts as a bridge to Modrinth and Hangar. Please ensure you comply with the licenses of the plugins you install.