PteroStats icon

PteroStats -----

View your minecraft server resource usage if you use pterodactyl



PteroStats - Real-time Server Stats BossBars
Version: 1.0
Compatible with: Minecraft 1.20+ / Paper & Spigot
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.
✨ 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.
Commands
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.
⚙️ Configuration (config.yml)
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)"
 
upload_2025-10-18_23-16-43.png
upload_2025-10-18_23-17-1.png
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.
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.
Keep your Minecraft server under control in style with PteroStats!
BStats
Resource Information
Author:
----------
Total Downloads: 5
First Release: Oct 18, 2025
Last Update: Oct 18, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings