Minecraft installation
Complete guide to install the Flitt plugin on your Minecraft server. Supports Bukkit, Paper, Spigot, Folia, BungeeCord, Velocity, Sponge, and Nukkit.
1. Download the plugin
Download the Flitt.jar from your Flitt dashboard.
The universal JAR works on all supported platforms. Just drop it in your plugins/ folder.
2. Which JAR for which server?
The universal JAR automatically detects your server type. Here's the compatibility matrix:
| Server Type | Compatibility |
|---|---|
| Bukkit / Spigot / Paper | ✅ Flitt.jar |
| Folia | ✅ Flitt.jar (auto-detects Folia) |
| BungeeCord / Waterfall | ✅ Flitt.jar |
| Velocity 3.x | ✅ Flitt.jar |
| Sponge API 8+ | ✅ Flitt.jar |
| Nukkit (Bedrock) | ✅ Flitt.jar |
The plugin requires Java 8+ for Bukkit/BungeeCord/Nukkit and Java 17+ for Velocity/Sponge.
3. Configure credentials
After the first start, a config.properties file is created in plugins/Flitt/. If you downloaded the plugin from the dashboard, it is automatically configured.
If you need to change credentials, edit the file with your dashboard values:
# Flitt Configuration
# Server ID (from your Flitt panel)
server-id=YOUR_SERVER_ID
# Server Key / API Key (from your Flitt panel)
server-key=YOUR_API_KEYThe API endpoint is managed automatically: it uses api.flitt.me by default and switches to the Edge SDK ingest URL if detected. Restart the server after editing.
4. Supported platforms
Bukkit / Spigot / Paper
Java 8+Full support with PlaceholderAPI integration
Folia
Java 17+Optimized for multi-threaded servers
BungeeCord / Waterfall
Java 8+Proxy support for network-wide monitoring
Velocity 3.x
Java 17+Modern proxy with native plugin API
Sponge API 8+
Java 17+Alternative server implementation support
Nukkit
Java 8+Bedrock Edition server support
5. PlaceholderAPI integration
On Bukkit/Spigot/Paper servers with PlaceholderAPI installed, Flitt registers these placeholders:
%flitt_connected%Connection status (true/false)%flitt_server_id%Configured server ID%flitt_heartbeat_interval%Heartbeat interval in seconds%flitt_version%Plugin version6. Verify installation
[Flitt] messages/flitt to see the plugin statusNeed help?
If you run into issues, check the Troubleshooting section or open a support ticket.