Skip to content

Repository files navigation

Pluginator

Built with BunTypeScriptInk React CLILicensePlatform

A powerful Minecraft server plugin manager with multi-source update checking, sync/backup workflows, and a modern terminal UI.

Features

Core

  • Multi-Source Updates — Check updates from Spigot, Modrinth, GitHub, Hangar, Jenkins, GeyserMC, Voxel, BuiltByBit, and custom web manifests (9 source types)
  • Server Sync — Synchronize plugins between production and test servers
  • Smart Backups — Timestamped tar.gz backups with automatic cleanup, atomic writes, and crash recovery
  • Modern Terminal UI — Interactive, keyboard-driven interface with 8 tabs and customizable themes
  • Plugin Registry — 120+ popular plugins pre-configured with verified sources
  • Checksum Verification — SHA-256 verification for all downloads

Update Automation

  • Hash-Based Identification — Fingerprints each plugin JAR to identify it precisely across sources, even with no version in the filename
  • Premium Plugin Support — Version checks and store deep-links for paid plugins; pluginator complete installs a browser-downloaded update from your Downloads folder, ToS-safely
  • Test → Production Promotion — Updates soak on your test server before pluginator promote moves them to production; bad updates can be quarantined
  • Snapshots & Rollback — Automatic JAR + data-folder snapshot before every update; pluginator rollback <plugin> fully restores a previous version
  • Safe Live-Server Updates — Stages updates into Bukkit's plugins/update/ folder when the server is running, applied on next restart
  • Scheduled / Unattended Updates — Headless auto-update for cron/systemd with JSON output, CI exit codes, and Discord/webhook notifications
  • Compatibility Gates — Checks each update against your server's Minecraft and Java version before installing
  • Off-Market Plugin Manifests — Track plugins from any source via a simple JSON manifest (pluginator manifest)

Health & Recommendations

  • Health Dashboard — 5-component health scoring (compatibility, security, version, maintenance, dependencies) with A+/F grading
  • Recommendations Engine — Smart plugin recommendations based on your setup
  • Superseded-By Advisories — Abandoned plugins suggest a maintained replacement instead of showing "up to date" forever

Organization & Workflows

  • Tags & Groups — Organize plugins with custom tags and groups
  • Profiles — Save and switch between different plugin configurations
  • Data Import/Export — Export and import plugin configurations
  • Plugin Notes — Attach notes to individual plugins
  • Notification History — Persistent toast log accessible via /notifications
  • Post-Action Hooks — Run user-configured shell commands after sync/download/backup/migrate

Power-User

  • Command Palette — 80+ commands accessible via : or / with fuzzy search
  • Vim Mode — Optional modal navigation (Plus+) with motions, marks, search, and macros
  • Jump ListCtrl+o / Ctrl+i to navigate between recent positions
  • Quick ActionsCtrl+P for context-aware quick actions
  • Custom Keybindings — 5 presets (default, vim, emacs, minimal, custom) with full inheritance

Security

  • SSRF Protection — Blocks private-IP and metadata-endpoint URLs by default
  • Atomic File Writes — Crash-safe writes for cache, config, and journal files
  • Operation Journal — Records destructive operations with crash recovery on next launch
  • PID Locks — File-based exclusive locks prevent concurrent operations

Installation

Download Binary

PlatformDownload
Windows (x64)pluginator-windows-x64.zip
macOS (Intel)pluginator-darwin-x64.tar.gz
macOS (Apple Silicon)pluginator-darwin-arm64.tar.gz
Linux (x64)pluginator-linux-x64.tar.gz
Linux (ARM64)pluginator-linux-arm64.tar.gz

Quick Install

# macOS (Homebrew)
brew tap NindroidA/pluginator && brew install pluginator
# Windows (Scoop)
scoop bucket add pluginator https://github.com/NindroidA/scoop-pluginator && scoop install pluginator
# npm (any platform)
npm install -g @nindroidsystems/pluginator
# Bun (any platform)
bun install -g @nindroidsystems/pluginator
# curl | bash (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/NindroidA/pluginator/main/scripts/install.sh | bash

See Installation Guide for detailed instructions.

Quick Start

# Initialize configuration
pluginator setup
# Launch interactive UI
pluginator
# Or use CLI commands
pluginator scan --prod # Scan production server
pluginator check-updates # Check for plugin updates
pluginator auto-update # Scan, check, and download updates to test
pluginator complete# Finish a premium update from your Downloads folder
pluginator promote --list # See what's soaking / ready to promote to prod
pluginator rollback <plugin># Restore a plugin's previous version
pluginator sync # Sync prod to test
pluginator self-update # Update Pluginator itself

Keyboard Shortcuts

KeyAction
1-8Switch tabs (Home/Servers/Plugins/Updates/Logs/Stats/Health/Recs)
: or /Open command palette (80+ commands)
Ctrl+PQuick actions menu
Ctrl+O / Ctrl+IJump back/forward (history)
j / k or / Navigate lists
g / GJump to top/bottom
?Show help
Ctrl+C (2x)Quit

Tier System

TierPriceUpdate Checks/DayDownloads/DayTabs
Free$015Home/Plugins/Updates only
Plus$9.99 (one-time)5025+ Servers/Logs/Stats
Pro$2.99/mo or $24.99/yr10050+ Health/Recs, scheduling, promotion, vim mode
Max$4.99/mo or $44.99/yrUnlimitedUnlimitedAll features, priority support

Plus owners get discounted upgrades ($1.99/mo Pro, $3.99/mo Max). See Tier System for full details.

Documentation

Support

Development

This project's development has been accelerated through the use of AI-assisted development tools, including GitHub Copilot, Claude Code, and other AI programming assistants. These tools have enhanced productivity while maintaining code quality and best practices. All AI-generated code has been reviewed, tested, and refined to ensure reliability.

License

Copyright (c) 2026 Nindroid Systems (Andrew Curtis - NindroidA). All Rights Reserved.

This is proprietary software. See LICENSE for details.