# ----------------------------------------------------------------- # Message groups – reusable blocks that can be referenced later. # ----------------------------------------------------------------- messages: header: - "&6=== &eServer Info &6===" footer: - "&6=== &eEnd of Info &6==="

After compiling and dropping the JAR in plugins/ , run /papi reload and you can now use uptime in any format line. You can define static placeholders that map to other placeholders or text:

# ----------------------------------------------------------------- # Commands – define which messages are shown for each sub‑command. # ----------------------------------------------------------------- commands: # /serverinfo (default alias) default: permission: "4serverinfo.use" format: - "<header>" - "&aOnline: &fonline&7/&fmax" - "&aTPS: &ftps" - "&aRAM: &fram_usedMB / ram_maxMB &7(ram_percent%)" - "&aCPU: &fcpu%" - "<footer>" # Whether the command is visible in /help description: "Shows basic server statistics."

# Choose whether the plugin runs in "proxy mode" (BungeeCord). # In proxy mode, stats are aggregated from all connected servers. proxy-mode: false

# ----------------------------------------------------------------- # Placeholders – built‑in tokens you can use in messages. # ----------------------------------------------------------------- placeholders: # Player counts online: "<online>" # players currently online max: "<max>" # server's max player capacity total: "<total>" # total across network (proxy mode)

# /serverinfo players players: permission: "4serverinfo.players" format: - "<header>" - "&eOnline Players (&fonline&e/&fmax&e):" - " &7- player_list" - "<footer>" description: "List of online players." | Section | What It Does | Important Keys | |---------|--------------|----------------| | enabled | Turns the whole plugin on/off. | true / false | | proxy-mode | Switches between local‑only stats and network‑wide aggregation (requires BungeeCord). | true / false | | placeholders | Built‑in tokens you can embed in any message. Use placeholder syntax inside format strings. | online , tps , ram-used , etc. | | messages | Reusable snippets (header/footer, titles) to avoid duplication. Use <header> style in format list. | | commands | All sub‑commands (including the default one) and their output format. Each command can have its own permission node. | | format | An ordered list of lines (ChatComponent strings). Supports color codes ( & ), placeholders, and MiniMessage syntax ( <hover:...> ). | | description | Text shown in /help 4serverinfo (or any help plugin). | | player_list | Special placeholder that expands to a comma‑separated list of online player names (auto‑wrapped if the list is long). | 5. Permissions | Permission Node | Default | Description | |-----------------|---------|-------------| | 4serverinfo.use | true (OP) | Base permission for /serverinfo . | | 4serverinfo.performance | false | Allows /serverinfo performance . | | 4serverinfo.players | false | Allows /serverinfo players . | | 4serverinfo.reload | false | Allows /4si reload . | | 4serverinfo.toggle | false | Allows players to toggle a personal scoreboard/tab display ( /4si toggle ). | | 4serverinfo.webhook | false | Allows use of /4si webhook <url> (if webhook feature enabled). | Tip: Use a permission manager (e.g., LuckPerms) to grant these nodes to groups like staff or vip . 6. Using the Plugin 6.1 Base Command /serverinfo → shows the default “basic” info /serverinfo perf → shows the “performance” group (if defined) /serverinfo players → lists online players All commands are tab‑completable . If you omit a sub‑command, the default block is used. 6.2 Toggle Live Display (Optional) If you enabled the scoreboard or tab integration in config.yml (see the Advanced Features section below), players can enable/disable it:

public class UptimeExpansion extends PlaceholderExpansion @Override public String getIdentifier() return "4si"; @Override public String getAuthor() return "YourName"; @Override public String getVersion() return "1.0";

/4si toggle The plugin stores the toggle state per‑UUID, so it persists across restarts. /4si reload No server restart needed. The command reloads the config, re‑registers placeholders, and re‑initializes async tasks. 6.4 Sending a Webhook (Optional) If you turned on webhook.enabled: true in the config:

The “new” version (v2.x, released 2025) adds:

(Works on Spigot, Paper, and BungeeCord networks – the same jar can be used for both server‑side and proxy‑side setups.) 1. What Is 4ServerInfo? 4ServerInfo is a lightweight, placeholder‑driven plugin that lets you display live server statistics (players online, TPS, memory, ping, etc.) in chat, on the scoreboard, in the tab list, or via the /serverinfo command.

placeholders: welcome: "Welcome to &bserver_name&r!" Then use welcome wherever you like. This is handy for server‑branding messages. 8.1 Scoreboard & Tab List Integration Add a display: section to config.yml :

# /serverinfo performance performance: permission: "4serverinfo.performance" format: - "<header>" - "&bTPS: &ftps" - "&bMSPT: &fmspt" - "&bCPU: &fcpu%" - "&bRAM Used: &fram_usedMB (ram_percent%)" - "<footer>" description: "Detailed performance metrics."

# Performance tps: "<tps>" cpu: "<cpu>" ram-used: "<ram_used>" ram-max: "<ram_max>" ram-percent: "<ram_percent>"

format: - "<hover:show_text:'Current TPS'><click:run_command:'/serverinfo perf'>TPS: tps</click>" Result: The “TPS: X” line is clickable (runs /serverinfo perf ) and shows a tooltip on hover. webhook: enabled: true url: "https://discord.com/api/webhooks/xxxx" interval: 600 # seconds (10 minutes) embed: title: "Server Status – server_name" description: | **Online:** online/max **TPS:** tps **RAM:** ram_used/ram_max MB (ram_percent%) color: 0x00FF00 The plugin will automatically POST this embed at the defined interval. 9. Troubleshooting & FAQ | Problem | Likely Cause | Fix | |---------|--------------|-----| | No placeholders show up (they appear as online etc.) | PlaceholderAPI not installed or expansion not loaded. | Install PlaceholderAPI, restart the server, then run /papi reload . | | /serverinfo crashes or prints errors | Out‑of‑date Java or incompatible server version. | Ensure you run Java 17+ and a supported Spigot/Paper build. | | Scoreboard doesn’t update | display.scoreboard.update-interval

# ------------------------------------------------- # 4ServerInfo – Main Config (v2.x) # ------------------------------------------------- # Enable/disable the plugin on this server instance. enabled: true