OhTabListPing

# OhTabListPing (https://img.shields.io/badge/Minecraft-1.21.1+-brightgreen.svg)](https://www.spigotmc.org/) (https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) (https://img.shields.io/badge/GitHub-anaspui%2Fohtablistping-blue)](https://github.com/anaspui/ohtablistping) A high-performance Minecraft server plugin that displays each player's ping (latency) in the tab list with color-coded formatting. !(https://cdn.modrinth.com/data/cached_images/74ece34aa37ccbd20a50494d76f8be78fd159295_0.webp) _*Brownies featured*_ ## Features **Real-time Ping Display** - Shows ping values next to player names in the tab list **Color-Coded Indicators** - Visual feedback for connection quality **In-Game Commands** - View and modify configuration without editing files **High Performance** - Async updates with intelligent caching **Fully Configurable** - Customize format, colors, thresholds, and update intervals **Plugin Compatibility** - Works alongside nickname and permission plugins **Optimized Updates** - Only updates when ping changes significantly ## Requirements - **Minecraft Version**: 1.21.1+ (Spigot or Paper) - **Java Version**: 21 or higher - **Server Software**: Spigot, Paper, or compatible forks ## Installation 1. **Download** the latest release (`OhTabListPing-x.x.xx.jar`) from (https://github.com/anaspui/ohtablistping/releases) 2. **Place** the JAR file in your server's `plugins/` folder 3. **Restart** your server or load the plugin with a plugin manager 4. **Configure** (optional) - Edit `plugins/OhTabListPing/config.yml` to customize settings 5. **Reload** the plugin if you changed the config: `/otlp reload` ## Commands Manage the plugin configuration in-game with intuitive commands: ### Main Command ``` /ohtablistping Aliases: /otlp, /ping-config ``` ### Subcommands #### View Help ``` /otlp help ``` Displays all available commands and usage examples. #### List All Config Values ``` /otlp list ``` Shows all current configuration values in a formatted display. #### Get Specific Value ``` /otlp get <key> Examples: /otlp get update-interval /otlp get debug /otlp get color-coding.thresholds.excellent ``` #### Set Configuration Value ``` /otlp set <key> <value> Examples: /otlp set update-interval 60 /otlp set debug true /otlp set ping-format "{player} " /otlp set color-coding.colors.excellent §a ``` #### Reload Configuration ``` /otlp reload ``` Reloads config.yml from disk and restarts the update task with new settings. ### Permissions - `ohtablistping.admin` - Full admin access (default: op) - `ohtablistping.reload` - Reload configuration only - `ohtablistping.view` - View config values only - `ohtablistping.set` - Modify config values only ## Configuration The plugin automatically creates a `config.yml` file on first run. Here's what you can customize: ```yaml # Update interval in ticks (20 ticks = 1 second) update-interval: 40 # Recommended: 40 (2 seconds) # Minimum ping change to trigger update (avoids unnecessary updates) update-threshold: 5 # Only update if ping changed by 5+ ms # Display format ping-format: "{player} §7" # Color coding color-coding: enabled: true colors: excellent: "§a" # Green (0-50ms) good: "§e" # Yellow (51-100ms) acceptable: "§6" # Gold (101-150ms) poor: "§c" # Red (151+ms) thresholds: excellent: 50 good: 100 acceptable: 150 # Performance settings async-updates: true # Run updates asynchronously (recommended) debug: false # Enable debug logging ``` ### Format Placeholders - `{player}` - Player's username - `{ping}` - Current ping value - `{color}` - Automatically determined color code ### Color Codes Standard Minecraft color codes are supported: - `§a` - Green - `§e` - Yellow - `§6` - Gold - `§c` - Red - `§7` - Gray - `§f` - White ## How It Works 1. **Scheduled Updates**: The plugin runs a repeating task every `update-interval` ticks 2. **Ping Retrieval**: Gets each player's ping using `Player.getPing()` API 3. **Smart Caching**: Only updates display if ping changed by more than `update-threshold` 4. **Color Coding**: Applies color based on ping quality thresholds 5. **Display Update**: Updates the tab list player name with formatted ping ## Performance - **Async Execution**: Updates run asynchronously to prevent server lag - **Intelligent Caching**: Avoids unnecessary updates using threshold system - **Optimized String Operations**: Pre-formatted color codes and efficient formatting - **Low Memory Footprint**: Minimal cache size (only UUID → ping map) **Benchmarks** (tested with 100 players): - CPU Impact: < 0.1% per update cycle - Memory Usage: ~5KB additional RAM - TPS Impact: None (async operations) ## Compatibility ### Compatible With: LuckPerms (permission prefixes) EssentialsX (nicknames) Vault (permission integration) Most