PluginPilot

PluginPilot

A comprehensive plugin manager for Minecraft servers that supports multiple plugin repositories and provides advanced features for plugin management.

Features

Core Features

- Database Storage: Install plugins from Modrinth, Hangar, SpigotMC, Polymart, and custom sources - Database Storage: Real-time plugin search with caching and intelligent tab completion - Database Storage: Install specific versions, update plugins, and automatic updates - Database Storage: Dynamic tab completion with live API searching and "loading..." feedback - Database Storage: Automatic backups before updates with rollback capability - Database Storage: Malware scanning integration (Under development) - Database Storage: SQLite-based persistent storage for plugin metadata

Command System

All commands support extensive tab completion:

Plugin Installation & Management

- `/pp install <plugin> [version]` - Download and enable a plugin - `/pp download <plugin> [version]` - Download a plugin without enabling it - `/pp show <plugin>` - Preview plugin information - `/pp update <plugin>` - Update individual plugins - `/pp updateall` - Update all managed plugins - `/pp remove <plugin>` - Uninstall plugins - `/pp delete <plugin>` - Delete plugin files

Plugin Loading & Unloading

- `/pp load <plugin>` - Load a plugin from the plugins directory - `/pp unload <plugin>` - Unload a plugin - `/pp reload <plugin>` - Reload a specific plugin

Backup & Security

- `/pp backup <plugin>` - Create plugin backups - `/pp restore <plugin> [version]` - Restore from backups - `/pp scan <plugin>` - Security scan plugins

Information & Discovery

- `/pp list` - List all managed plugins - `/pp detect` - Find unmanaged plugins - `/pp discover` - Discover popular plugins - `/pp info` - Show plugin information

System & Configuration

- `/pp logs` - View, export or clear plugin logs - `/pp sources` - Manage plugin repositories - `/pp refreshconfig` - Reload PluginPilot configuration - `/pp clearcache` - Clear plugin search cache - `/pp debug` - Toggle debug mode - `/pp import` - Import plugins from other managers

Advanced Tab Completion

The plugin features intelligent async tab completion that: - Shows "Loading..." while searching APIs - Caches results to reduce API calls - Provides real-time plugin name suggestions - Supports version completion for selected plugins - Rate limits searches to prevent API spam

Technical Details

Requirements

- API Version: 1.21.4 (compatible up to 1.21.8) - API Version: 17+ - API Version: 1.21

Architecture

- Plugin Sources: Clean separation of concerns with dedicated packages - Plugin Sources: Non-blocking API calls and downloads - Plugin Sources: Intelligent caching with TTL for performance - Plugin Sources: SQLite for reliable data persistence - Plugin Sources: Extensible source system supporting multiple APIs

Supported Sources

- ✅ Custom Sources: Full API integration with search, versions, and downloads - ✅ Custom Sources: PaperMC's plugin repository with complete support - ⚠️ Custom Sources: Limited (no public API for automated downloads) - 🚧 Custom Sources: Planned implementation - 🚧 Custom Sources: GitHub, Jenkins, direct URLs (planned)

Installation

1. Download the PluginPilot JAR file 2. Place it in your server's `plugins` folder 3. Start/restart your server 4. Configure the plugin in `plugins/PluginPilot/config.yml` 5. Use `/pp help` to see available commands

Configuration

The plugin is highly configurable through `config.yml`: - Enable/disable specific plugin sources - Configure auto-update intervals - Set cache TTL values - Configure security scanning - Customize tab completion behavior

Permissions

- `pluginpilot.*` - All permissions - `pluginpilot.use` - Basic usage permission - `pluginpilot.install` - Install and download plugins - `pluginpilot.update` - Update plugins - `pluginpilot.uninstall` - Remove plugins - `pluginpilot.load` - Load/unload/reload plugins - `pluginpilot.backup` - Backup/restore plugins - `pluginpilot.security` - Security scanning - `pluginpilot.sources` - Manage sources - `pluginpilot.debug` - Access logs and debug info - `pluginpilot.discover` - Discover popular plugins - `pluginpilot.import` - Import plugins from other managers - `pluginpilot.clearcache` - Clear plugin search cache - `pluginpilot.refreshconfig` - Reload plugin configuration

Development

Built with Maven using modern Java 17 features: - Async/CompletableFuture for non-blocking operations - Stream API for efficient data processing - Modern HTTP client (OkHttp) for API calls - GSON for JSON processing - SQLite for data persistence

Contributing

This plugin uses a modular architecture making it easy to: - Add new plugin sources - Extend command functionality - Improve the caching system - Add new security features