PteroStats - Real-time Server Stats BossBars
Version: 1.0
Compatible with: Minecraft 1.20+ / Paper & Spigot
Spoiler: Overview
PteroStats is a lightweight Minecraft plugin that displays your server's resource usage directly in-game using
dynamic BossBars. Monitor your server
RAM, CPU, Disk, and Network usage in real-time!
Perfect for server admins or staff members who want to quickly check server performance without leaving the game.
Perfect for server admins or staff members who want to quickly check server performance without leaving the game.
Spoiler: Features
✨ Features
- Real-time stats: Shows current usage and maximum values.
- Multiple BossBars:
- RAM Bar (/rambar)
- CPU Bar (/cpubar)
- Disk Bar (/diskbar)
- Network Bar (/netbar) – shows IN/OUT traffic
- Customizable colors and thresholds in config.yml
- Green = OK
- Yellow = Warning
- Red = Critical
- Toggleable BossBars per player
- Permission-based access
- Configurable refresh interval (default 5 seconds)
- Dynamic text placeholders:
- {used_gb}, {max_gb}, {used_percent}, {in_mb}, {out_mb}, etc.
Spoiler: Commands
Commands
Tip: Run the command again to toggle off the BossBar.
| Command | Description | Permission |
| /rambar | Shows a BossBar with RAM usage | pterostats.rambar |
| /cpubar | Shows a BossBar with CPU usage | pterostats.cpubar |
| /diskbar | Shows a BossBar with Disk usage | pterostats.diskbar |
| /netbar | Shows a BossBar with Network IN/OUT usage | pterostats.networkbar |
Tip: Run the command again to toggle off the BossBar.
Spoiler: Configuration
⚙️ Configuration (config.yml)
pterodactyl:
url: "https://panel.example.com"
api_key: "PT-API-KEY-ID"
server_id: "abcd1234"
refresh_interval: 5
# ---------------------------
# Network Bossbar Settings
# ---------------------------
ram_bossbar:
enabled: true
text: "Ram: {used_gb}GB ({used_percent}%) / {max_gb}GB ({max_percent}%)"
color_thresholds:
green: 0
yellow: 50
red: 70
# ---------------------------
# CPU Bossbar Settings
# ---------------------------
cpu_bossbar:
enabled: true
text: "CPU: {used_percent}% / {max_percent}%"
color_thresholds:
yellow: 50
red: 70
# ---------------------------
# Disk Bossbar Settings
# ---------------------------
disk_bossbar:
enabled: true
text: "Disk: {used_gb}GB ({used_percent}%) / {max_gb}GB"
color_thresholds:
yellow: 50
red: 70
# ---------------------------
# Network Bossbar Settings
# ---------------------------
network_bossbar:
enabled: true
text: "Network: IN {in_mb}MB / OUT {out_mb}MB"
color: 'BLUE'
messages:
has-permission: "&cYou dont have permission for this!"
player-only: "&cThis command only allowed for members. (You cant use it in console)"
Code (Text):
pterodactyl:
url: "https://panel.example.com"
api_key: "PT-API-KEY-ID"
server_id: "abcd1234"
refresh_interval: 5
# ---------------------------
# Network Bossbar Settings
# ---------------------------
ram_bossbar:
enabled: true
text: "Ram: {used_gb}GB ({used_percent}%) / {max_gb}GB ({max_percent}%)"
color_thresholds:
green: 0
yellow: 50
red: 70
# ---------------------------
# CPU Bossbar Settings
# ---------------------------
cpu_bossbar:
enabled: true
text: "CPU: {used_percent}% / {max_percent}%"
color_thresholds:
yellow: 50
red: 70
# ---------------------------
# Disk Bossbar Settings
# ---------------------------
disk_bossbar:
enabled: true
text: "Disk: {used_gb}GB ({used_percent}%) / {max_gb}GB"
color_thresholds:
yellow: 50
red: 70
# ---------------------------
# Network Bossbar Settings
# ---------------------------
network_bossbar:
enabled: true
text: "Network: IN {in_mb}MB / OUT {out_mb}MB"
color: 'BLUE'
messages:
has-permission: "&cYou dont have permission for this!"
player-only: "&cThis command only allowed for members. (You cant use it in console)"
Spoiler: Images
Spoiler: Notes
Notes
- Requires a Pterodactyl panel API key with read access.
- Works best with Paper for optimal BossBar performance.
- BossBars are per player and will automatically disappear if the player leaves.
Spoiler: Installation
Installation
- Download the plugin [.jar] file.
- Place it in your server's plugins folder.
- Restart or reload the server.
- Configure config.yml with your Pterodactyl API details.
- Use the commands in-game to display your server stats.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.18, 1.19, 1.20
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PteroStats is a free Minecraft Java mod. Compatible with Minecraft 1.18, 1.19, 1.20, 1.20.6 and newer. Downloaded 23 times (via Spigot). Download it and open it directly in the game.