@nindroidsystems/pluginator 2.3.0

package/LICENSE

@@ -0,0 +1,50 @@
+Pluginator - Proprietary Software License
+
+Copyright (c) 2026 Nindroid Systems (Andrew Curtis - NindroidA)
+All Rights Reserved
+
+THE CONTENTS OF THIS PROJECT ARE PROPRIETARY AND CONFIDENTIAL.
+
+1. GRANT OF LICENSE
+   This license grants you the right to download, install, and use the compiled
+   binary software ("Software") for personal or commercial use in managing
+   Minecraft server plugins.
+
+2. RESTRICTIONS
+   You may NOT:
+   - Reverse engineer, decompile, or disassemble the Software
+   - Modify, adapt, or create derivative works based on the Software
+   - Redistribute, sublicense, rent, lease, or lend the Software
+   - Remove or alter any proprietary notices, labels, or marks
+
+3. INTELLECTUAL PROPERTY
+   The Software and all copies thereof are proprietary to the copyright holder
+   and title thereto remains in the copyright holder. All rights in the Software
+   not specifically granted in this license are reserved to the copyright holder.
+
+4. DISCLAIMER OF WARRANTIES
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+5. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+   DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+   OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+   USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+6. USER DATA AND CONFIGURATION
+   The restrictions in Section 2 apply only to the Software itself, not to user
+   data. You are free to create, modify, and distribute:
+   - Configuration files (e.g., plugins.json, pluginator.config)
+   - Plugin lists and server configurations
+   - Backup archives created by the Software
+   - Log files generated during operation
+   - Any other data files you create through normal use of the Software
+
+   These files are your property and are not subject to this license.
+
+7. TERMINATION
+   This license is effective until terminated. Your rights under this license
+   will terminate automatically without notice if you fail to comply with any
+   of its terms.

package/README.md

@@ -0,0 +1,268 @@
+# Pluginator
+
+[![Proprietary](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)
+[![Bun](https://img.shields.io/badge/runtime-Bun-black)](https://bun.sh)
+[![TypeScript](https://img.shields.io/badge/language-TypeScript-blue)](https://www.typescriptlang.org/)
+
+> **Last Updated:** February 20, 2026
+
+A sophisticated Minecraft server plugin manager with multi-source update checking, sync/backup workflows, and a modern terminal UI.
+
+## Features
+
+### Core Features
+- **Multi-Source Support** - Check updates from Spigot, Modrinth, GitHub, CurseForge, Hangar, Jenkins, and custom web manifests
+- **Server Sync** - Synchronize plugins between production and test servers
+- **Smart Backups** - Create timestamped tar.gz backups with automatic cleanup
+- **Modern Terminal UI** - Interactive, keyboard-driven interface with 9 tabs and customizable themes
+- **Plugin Scanning** - Extract metadata from JAR files automatically
+- **Checksum Verification** - SHA-256 verification for all downloads
+- **Parallel Updates** - Check multiple plugins concurrently
+- **Plugin Registry** - 100+ popular plugins pre-configured with verified sources
+- **Tier System** - Free, Plus, Pro, and Max tiers with usage-based limits
+- **Auto-Updater** - Automatic update checking with one-command updates
+
+### Analytics & Health (v2.0)
+- **Health Dashboard** - Plugin health scoring based on compatibility, security, and update status
+- **Performance Analytics** - Server performance monitoring with metrics collection and alerts
+- **Recommendations Engine** - Smart plugin recommendations based on your setup and usage patterns
+- **Server Panel Integrations** - Connect to AMP, Pterodactyl, Crafty Controller, and MCSManager
+
+### Organization & Workflows (v2.0)
+- **Plugin Templates** - Apply pre-configured plugin bundles for different server types
+- **Widget Dashboard** - Customizable dashboard with health, analytics, and streaming widgets
+- **Tags & Groups** - Organize plugins with custom tags and groups
+- **Profiles** - Save and switch between different plugin configurations
+- **Scheduled Updates** - Configure automatic update windows with major version handling
+- **Data Import/Export** - Export and import plugin configurations
+
+## Installation
+
+### Quick Install
+
+```bash
+# 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
+
+# One-line script (Linux/macOS)
+curl -fsSL https://pluginator.dev/install.sh | bash
+```
+
+See [Installation Guide](docs/INSTALLATION.md) for detailed instructions.
+
+### Prerequisites (npm/Bun install only)
+
+- [Bun](https://bun.sh) v1.1.0 or higher (or Node.js 18+)
+
+## Usage
+
+### Interactive Mode (Default)
+
+```bash
+pluginator
+```
+
+This launches the interactive terminal UI with tab-based navigation.
+
+#### Keyboard Shortcuts
+
+Pluginator uses a state-aware input system (v1.4.0) for consistent behavior.
+
+| Key | Action | Notes |
+|-----|--------|-------|
+| `Tab` / `Shift+Tab` | Navigate between tabs | |
+| `1-9` | Jump to tab | Home/Servers/Plugins/Updates/Logs/Sync/Health/Recs/Perf |
+| `j` / `↓` | Move down in lists | |
+| `k` / `↑` | Move up in lists | |
+| `g` / `G` | Jump to top/bottom | |
+| `Ctrl+C` | Quit (press twice) | 2s timeout |
+| `Ctrl+D` | Jump to Logs | Quick access |
+| `?` | Show help | |
+| `r` | Refresh | Home tab only |
+| `s` | Scan servers | Home tab only, throttled 500ms |
+| `u` | Check updates | Home tab only, throttled 1000ms |
+| `b` | Quick backup | Home tab only |
+| `c` | View changelog | In Updates view |
+| `Space` | Toggle selection | |
+| `Enter` | Confirm | |
+| `Esc` | Cancel | Context-aware |
+| `/` or `:` | Open command palette | 25+ commands |
+
+Keys are validated against the current UI state to prevent accidental actions during operations.
+
+## CLI Commands
+
+```bash
+# Setup wizard
+pluginator setup
+
+# Sync plugins from production to test
+pluginator sync
+
+# Migrate plugins from test to production
+pluginator migrate
+
+# Create a backup
+pluginator backup
+
+# Check for updates
+pluginator check-updates
+```
+
+## Configuration
+
+Configuration file: `config/pluginator.config`
+
+```ini
+# Debug mode (0 = off, 1 = on)
+PLUGINATOR_DEBUG=0
+
+# Server paths
+PROD_SERVER_PATH=./SERVER/prod
+TEST_SERVER_PATH=./SERVER/test
+
+# Backup settings
+BACKUP_DIR=./data/backups
+MAX_BACKUPS=5
+
+# Logging
+LOGS_DIR=./data/logs
+MAX_LOG_DAYS=30
+
+# Minecraft version for compatibility checks
+MINECRAFT_VERSION=1.21.1
+
+# Network settings
+API_TIMEOUT=30
+DOWNLOAD_THREADS=2
+```
+
+## Plugin Sources
+
+Pluginator supports multiple plugin sources:
+
+| Source | API | Rate Limit |
+|--------|-----|------------|
+| Spigot | Spiget API v2 | ~100 req/min |
+| Modrinth | Modrinth API v2 | 300 req/min |
+| GitHub | GitHub API v3 | 60/hr (unauth), 5000/hr (auth) |
+| CurseForge | CurseForge API | Requires API key |
+| Jenkins | Jenkins REST API | Server-dependent |
+| Hangar | Hangar API v1 | Generous |
+| Web Manifest | Custom JSON | Unlimited |
+
+## Theming
+
+Choose from four built-in color themes: `default`, `ocean`, `forest`, `sunset`
+
+```bash
+pluginator --theme ocean
+```
+
+Or set in `~/.pluginator/config.json`:
+```json
+{ "theme": "ocean" }
+```
+
+
+## Plugin Configuration
+
+Plugins are configured in `plugins.json`:
+
+```json
+{
+  "plugins": [
+    {
+      "name": "EssentialsX",
+      "type": "spigot",
+      "resourceId": "9089"
+    },
+    {
+      "name": "LuckPerms",
+      "type": "modrinth",
+      "projectSlug": "luckperms"
+    },
+    {
+      "name": "Vault",
+      "type": "github",
+      "repoSlug": "MilkBowl/Vault"
+    }
+  ]
+}
+```
+
+### Plugin Types
+
+| Type | Required Fields | Description |
+|------|-----------------|-------------|
+| `spigot` | `resourceId` | Spiget resource ID |
+| `modrinth` | `projectSlug` | Modrinth project slug |
+| `github` | `repoSlug` | GitHub owner/repo format |
+| `bukkit` | `id` | CurseForge project ID |
+| `web` | `sourceUrl` | Custom manifest URL |
+| `jenkins` | `job` | Jenkins job name |
+| `manual` | - | Manual updates only |
+
+### Optional Plugin Fields
+
+- `version` - Current installed version
+- `enabled` - Enable/disable plugin (default: true)
+- `disableOnTest` - Disable when synced to test server
+- `mcVersion` - Target Minecraft version
+- `filenamePattern` - Regex for JAR filename matching
+
+## Tier System
+
+Pluginator offers tiered subscriptions for different usage levels:
+
+| Tier | Price | Checks/Day | Downloads/Day |
+|------|-------|------------|---------------|
+| Free | $0 | 10 | 5 |
+| Plus | $14.99 (one-time) | 50 | 25 |
+| Pro | $4.99/mo | 100 | 50 |
+| Max | $9.99/mo | Unlimited | Unlimited |
+
+See [Tier System](docs/TIER_SYSTEM.md) for details.
+
+## Documentation
+
+### Getting Started
+- [Installation](docs/INSTALLATION.md) - Quick install for all platforms
+- [User Guide](docs/USER_GUIDE.md) - Detailed usage instructions
+- [Commands Reference](docs/COMMANDS.md) - Full command palette reference
+
+### Features
+- [Health System](docs/HEALTH_SYSTEM.md) - Plugin health scoring and dashboard
+- [Analytics](docs/ANALYTICS.md) - Performance monitoring and alerts
+- [Templates](docs/TEMPLATES.md) - Plugin configuration templates
+- [Organization](docs/ORGANIZATION.md) - Tags, groups, profiles, and favorites
+
+### Reference
+- [Architecture](docs/ARCHITECTURE.md) - System design and component overview
+- [Plugin Registry](docs/PLUGIN_REGISTRY.md) - Using the curated plugin database
+- [Tier System](docs/TIER_SYSTEM.md) - Subscription tiers and authentication
+- [File Organization](docs/FILE_ORGANIZATION.md) - Where files are stored
+- [Auto-Updater](docs/AUTO_UPDATER.md) - Keeping Pluginator up to date
+- [Security](docs/SECURITY.md) - Security considerations and best practices
+- [Changelog](docs/CHANGELOG.md) - Version history
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[Proprietary](LICENSE) - Copyright (c) 2026 Nindroid Systems (Andrew Curtis)
+
+## 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.

package/data/defaults/config.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "./config-schema.json",
+  "version": "1.0",
+  "description": "Default Pluginator configuration - copy to ~/.pluginator/config.json to customize",
+  "config": {
+    "debug": false,
+    "minecraftVersion": "1.21.5",
+    "serverType": "paper",
+    "apiTimeout": 30,
+    "downloadThreads": 2,
+    "theme": "default",
+    "language": "en",
+    "backup": {
+      "maxBackups": 5,
+      "autoBackupBeforeUpdate": true
+    },
+    "logging": {
+      "maxLogDays": 30,
+      "logLevel": "info"
+    }
+  }
+}

package/data/defaults/conflicts.json

@@ -0,0 +1,135 @@
+{
+  "version": "1.0",
+  "conflicts": [
+    {
+      "id": "essentials-cmi-commands",
+      "plugins": ["EssentialsX", "CMI"],
+      "severity": "warning",
+      "type": "overlap",
+      "description": "Both plugins provide similar features and commands. May cause confusion and command conflicts.",
+      "resolution": "Use only one plugin, or carefully configure command aliases to avoid conflicts."
+    },
+    {
+      "id": "permissions-conflict",
+      "plugins": ["LuckPerms", "PermissionsEx", "GroupManager", "UltraPermissions"],
+      "severity": "error",
+      "type": "exclusive",
+      "description": "Multiple permission systems detected. Only one permission plugin should be active.",
+      "resolution": "Remove all but one permission plugin. LuckPerms is recommended."
+    },
+    {
+      "id": "tab-citizens-scoreboard",
+      "plugins": ["TAB", "Citizens"],
+      "severity": "warning",
+      "type": "resource",
+      "description": "TAB and Citizens both control the scoreboard. May cause display issues.",
+      "resolution": "Configure TAB to not use scoreboard, or configure Citizens to not modify scoreboard.",
+      "links": ["https://wiki.citizensnpcs.co/Plugin_Conflict"]
+    },
+    {
+      "id": "worldguard-griefprevention",
+      "plugins": ["WorldGuard", "GriefPrevention"],
+      "severity": "info",
+      "type": "overlap",
+      "description": "Both plugins provide region protection. Consider using only one for simpler management.",
+      "resolution": "Use WorldGuard for advanced protection or GriefPrevention for simpler claim-based protection."
+    },
+    {
+      "id": "multiverse-myworlds",
+      "plugins": ["Multiverse-Core", "MyWorlds"],
+      "severity": "error",
+      "type": "exclusive",
+      "description": "Multiple world management plugins can cause world loading conflicts.",
+      "resolution": "Use only one world management plugin."
+    },
+    {
+      "id": "protocollib-viaversion",
+      "plugins": ["ProtocolLib", "ViaVersion"],
+      "severity": "info",
+      "type": "api",
+      "description": "Ensure compatible versions are used. Old ProtocolLib versions may conflict with ViaVersion.",
+      "resolution": "Keep both plugins updated to their latest versions.",
+      "links": ["https://www.spigotmc.org/resources/viaversion.19254/"]
+    },
+    {
+      "id": "economy-conflict",
+      "plugins": ["Vault", "Reserve"],
+      "severity": "info",
+      "type": "overlap",
+      "description": "Both provide economy API. Vault is more widely supported.",
+      "resolution": "Use Vault unless a plugin specifically requires Reserve."
+    },
+    {
+      "id": "chat-plugins",
+      "plugins": ["EssentialsXChat", "ChatControl", "HeroChat", "VentureChat"],
+      "severity": "warning",
+      "type": "overlap",
+      "description": "Multiple chat formatting plugins can cause message duplication or formatting issues.",
+      "resolution": "Use only one chat formatting plugin."
+    },
+    {
+      "id": "anticheat-conflict",
+      "plugins": ["AAC", "Spartan", "Matrix", "Vulcan", "NoCheatPlus"],
+      "severity": "error",
+      "type": "exclusive",
+      "description": "Multiple anti-cheat plugins will cause severe performance issues and false positives.",
+      "resolution": "Use only one anti-cheat plugin."
+    },
+    {
+      "id": "hologram-plugins",
+      "plugins": ["HolographicDisplays", "DecentHolograms", "CMI"],
+      "severity": "info",
+      "type": "overlap",
+      "description": "Multiple hologram plugins can compete for display resources.",
+      "resolution": "Use one hologram solution. DecentHolograms is actively maintained."
+    },
+    {
+      "id": "worldedit-fawe",
+      "plugins": ["WorldEdit", "FastAsyncWorldEdit"],
+      "severity": "warning",
+      "type": "overlap",
+      "description": "FAWE is a fork of WorldEdit. They should not run together.",
+      "resolution": "Use either WorldEdit or FAWE, not both."
+    },
+    {
+      "id": "bossbar-plugins",
+      "plugins": ["BossBarPlus", "ActionBarHealth", "TAB"],
+      "severity": "info",
+      "type": "resource",
+      "description": "Multiple plugins trying to control the boss bar can cause flickering.",
+      "resolution": "Configure each plugin to use different display elements or disable overlapping features."
+    }
+  ],
+  "categories": {
+    "permissions": {
+      "description": "Permission management plugins",
+      "mutualExclusive": true,
+      "plugins": ["LuckPerms", "PermissionsEx", "GroupManager", "UltraPermissions", "zPermissions"]
+    },
+    "economy": {
+      "description": "Economy system plugins",
+      "mutualExclusive": false,
+      "plugins": ["Vault", "Reserve", "EssentialsX", "CMI"]
+    },
+    "anticheat": {
+      "description": "Anti-cheat plugins",
+      "mutualExclusive": true,
+      "plugins": ["AAC", "Spartan", "Matrix", "Vulcan", "NoCheatPlus", "Grim"]
+    },
+    "world-management": {
+      "description": "World management plugins",
+      "mutualExclusive": true,
+      "plugins": ["Multiverse-Core", "MyWorlds", "Hyperverse"]
+    },
+    "chat": {
+      "description": "Chat formatting plugins",
+      "mutualExclusive": true,
+      "plugins": ["EssentialsXChat", "ChatControl", "HeroChat", "VentureChat", "ChatManager"]
+    },
+    "worldedit": {
+      "description": "World editing plugins",
+      "mutualExclusive": true,
+      "plugins": ["WorldEdit", "FastAsyncWorldEdit"]
+    }
+  }
+}

package/data/defaults/plugin-registry/_metadata.json

@@ -0,0 +1,22 @@
+{
+  "version": "2.0.1",
+  "lastUpdated": "2026-02-06",
+  "description": "Curated plugin registry for Pluginator CLI - Directory-based structure",
+  "format": "directory",
+  "pluginCount": 101,
+  "categories": [
+    "admin",
+    "chat",
+    "cosmetic",
+    "economy",
+    "gameplay",
+    "library",
+    "minigames",
+    "performance",
+    "permissions",
+    "protection",
+    "social",
+    "utility",
+    "world"
+  ]
+}

package/data/defaults/plugin-registry/advancedban.json

@@ -0,0 +1,33 @@
+{
+  "id": "advancedban",
+  "name": "AdvancedBan",
+  "description": "Ban, mute, warn, and kick management",
+  "authors": [
+    "Leoko"
+  ],
+  "website": "https://github.com/DevLeoko/AdvancedBan",
+  "category": "admin",
+  "tags": [
+    "ban",
+    "mute",
+    "warn",
+    "kick",
+    "punishment"
+  ],
+  "sources": [
+    {
+      "type": "spigot",
+      "resourceId": 8695,
+      "preferred": true
+    },
+    {
+      "type": "github",
+      "repoSlug": "DevLeoko/AdvancedBan"
+    }
+  ],
+  "minecraftVersions": {
+    "min": "1.8",
+    "max": "1.21"
+  },
+  "verified": true
+}

package/data/defaults/plugin-registry/ajleaderboards.json

@@ -0,0 +1,35 @@
+{
+  "id": "ajleaderboards",
+  "name": "ajLeaderboards",
+  "description": "Configurable leaderboard system",
+  "authors": [
+    "ajgeiss0702"
+  ],
+  "website": "https://wiki.ajg0702.us/ajleaderboards/",
+  "category": "utility",
+  "tags": [
+    "leaderboards",
+    "stats",
+    "ranking",
+    "scoreboard"
+  ],
+  "sources": [
+    {
+      "type": "modrinth",
+      "projectSlug": "ajleaderboards",
+      "preferred": true
+    },
+    {
+      "type": "spigot",
+      "resourceId": 85548
+    }
+  ],
+  "minecraftVersions": {
+    "min": "1.8",
+    "max": "1.21"
+  },
+  "dependencies": [
+    "placeholderapi"
+  ],
+  "verified": true
+}

package/data/defaults/plugin-registry/auctionhouse.json

@@ -0,0 +1,22 @@
+{
+  "id": "auctionhouse",
+  "name": "AuctionHouse",
+  "description": "Player auction system with GUI for buying and selling items",
+  "authors": ["klugemonkey"],
+  "website": "https://www.spigotmc.org/resources/auctionhouse.61836/",
+  "category": "economy",
+  "tags": ["auction", "economy", "trading", "gui", "marketplace"],
+  "sources": [
+    {
+      "type": "spigot",
+      "resourceId": 61836,
+      "preferred": true
+    }
+  ],
+  "minecraftVersions": {
+    "min": "1.13",
+    "max": "1.21"
+  },
+  "popular": true,
+  "verified": true
+}

package/data/defaults/plugin-registry/auraskills.json

@@ -0,0 +1,30 @@
+{
+  "id": "auraskills",
+  "name": "AuraSkills",
+  "description": "RPG skills and stats system with leveling, abilities, and mana",
+  "authors": ["Archy-X"],
+  "website": "https://www.spigotmc.org/resources/auraskills.81069/",
+  "category": "gameplay",
+  "tags": ["rpg", "skills", "leveling", "abilities", "stats"],
+  "sources": [
+    {
+      "type": "spigot",
+      "resourceId": 81069,
+      "preferred": true
+    },
+    {
+      "type": "modrinth",
+      "projectSlug": "auraskills"
+    },
+    {
+      "type": "github",
+      "repoSlug": "Archy-X/AuraSkills"
+    }
+  ],
+  "minecraftVersions": {
+    "min": "1.17",
+    "max": "1.21"
+  },
+  "popular": true,
+  "verified": true
+}

package/data/defaults/plugin-registry/authme.json

@@ -0,0 +1,34 @@
+{
+  "id": "authme",
+  "name": "AuthMe Reloaded",
+  "description": "Server authentication plugin",
+  "authors": [
+    "Xephi",
+    "sgdc3"
+  ],
+  "website": "https://github.com/AuthMe/AuthMeReloaded",
+  "category": "admin",
+  "tags": [
+    "auth",
+    "login",
+    "register",
+    "security",
+    "password"
+  ],
+  "sources": [
+    {
+      "type": "spigot",
+      "resourceId": 6269,
+      "preferred": true
+    },
+    {
+      "type": "github",
+      "repoSlug": "AuthMe/AuthMeReloaded"
+    }
+  ],
+  "minecraftVersions": {
+    "min": "1.8",
+    "max": "1.21"
+  },
+  "verified": true
+}

package/data/defaults/plugin-registry/axiom-paper-plugin.json

@@ -0,0 +1,26 @@
+{
+  "id": "axiom-paper-plugin",
+  "name": "Axiom Paper Plugin",
+  "description": "Server-side companion for the Axiom world editing client mod",
+  "authors": ["Moulberry"],
+  "website": "https://modrinth.com/plugin/axiom-paper-plugin",
+  "category": "world",
+  "tags": ["building", "editing", "worldedit", "creative", "tools"],
+  "sources": [
+    {
+      "type": "modrinth",
+      "projectSlug": "axiom-paper-plugin",
+      "preferred": true
+    },
+    {
+      "type": "github",
+      "repoSlug": "Moulberry/AxiomPaperPlugin"
+    }
+  ],
+  "minecraftVersions": {
+    "min": "1.19",
+    "max": "1.21"
+  },
+  "popular": true,
+  "verified": true
+}