Back to documentation
⛏️

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 TypeCompatibility
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_KEY

The 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 version

6. Verify installation

1.Restart your Minecraft server
2.Check the console for [Flitt] messages
3.Run /flitt to see the plugin status
4.Check your Flitt dashboard for server stats and logs
⚠️

Need help?

If you run into issues, check the Troubleshooting section or open a support ticket.