# OhTabListPing<\/p>\n
\n
\n<\/p>\n
A high-performance Minecraft server plugin that displays each player’s ping (latency) in the tab list with color-coded formatting.<\/p>\n
\n_*Brownies featured*_
\n## Features<\/p>\n
**Real-time Ping Display** – Shows ping values next to player names in the tab list
\n**Color-Coded Indicators** – Visual feedback for connection quality
\n**In-Game Commands** – View and modify configuration without editing files
\n**High Performance** – Async updates with intelligent caching
\n**Fully Configurable** – Customize format, colors, thresholds, and update intervals
\n**Plugin Compatibility** – Works alongside nickname and permission plugins
\n**Optimized Updates** – Only updates when ping changes significantly <\/p>\n
## Requirements<\/p>\n
– **Minecraft Version**: 1.21.1+ (Spigot or Paper)
\n– **Java Version**: 21 or higher
\n– **Server Software**: Spigot, Paper, or compatible forks<\/p>\n
## Installation<\/p>\n
1. **Download** the latest release (`OhTabListPing-x.x.xx.jar`) from Releases
\n2. **Place** the JAR file in your server’s `plugins\/` folder
\n3. **Restart** your server or load the plugin with a plugin manager
\n4. **Configure** (optional) – Edit `plugins\/OhTabListPing\/config.yml` to customize settings
\n5. **Reload** the plugin if you changed the config: `\/otlp reload`<\/p>\n
## Commands<\/p>\n
Manage the plugin configuration in-game with intuitive commands:<\/p>\n
### Main Command
\n“`
\n\/ohtablistping [subcommand] [args…]
\nAliases: \/otlp, \/ping-config
\n“`<\/p>\n
### Subcommands<\/p>\n
#### View Help
\n“`
\n\/otlp help
\n“`
\nDisplays all available commands and usage examples.<\/p>\n
#### List All Config Values
\n“`
\n\/otlp list
\n“`
\nShows all current configuration values in a formatted display.<\/p>\n
#### Get Specific Value Examples: #### Set Configuration Value Examples: #### Reload Configuration ### Permissions<\/p>\n – `ohtablistping.admin` – Full admin access (default: op) ## Configuration<\/p>\n The plugin automatically creates a `config.yml` file on first run. Here’s what you can customize:<\/p>\n “`yaml # Minimum ping change to trigger update (avoids unnecessary updates) # Display format # Color coding # Performance settings ### Format Placeholders<\/p>\n – `{player}` – Player’s username ### Color Codes<\/p>\n Standard Minecraft color codes are supported: ## How It Works<\/p>\n 1. **Scheduled Updates**: The plugin runs a repeating task every `update-interval` ticks ## Performance<\/p>\n – **Async Execution**: Updates run asynchronously to prevent server lag **Benchmarks** (tested with 100 players): High-performance Minecraft Tab List Ping Display Plugin compatible with Spigot\/Paper 1.21.1+<\/p>\n","protected":false},"featured_media":115293,"template":"","meta":{"_minecraft_slug":"ohtablistping","_minecraft_project_id":"awKT8PFt","_minecraft_author":"anaspui","_minecraft_license":"MIT","_minecraft_downloads":83,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ohtablistping.zip","_minecraft_size_bytes":33624,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:13:23.947394Z","_minecraft_date_created":"2026-01-31T20:47:17.917114Z","_minecraft_date_modified":"2026-02-01T12:33:04.632738Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ohtablistping","_minecraft_icon_attachment_id":115293,"_minecraft_imported_at":"2026-06-06T19:01:06+00:00","_minecraft_import_hash":"b9d806d5db423abcee8741e05a2b5767","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-115292","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`
\n\/otlp get
\n \/otlp get update-interval
\n \/otlp get debug
\n \/otlp get color-coding.thresholds.excellent
\n“`<\/p>\n
\n“`
\n\/otlp set
\n \/otlp set update-interval 60
\n \/otlp set debug true
\n \/otlp set ping-format “{player} [{color}{ping}ms]”
\n \/otlp set color-coding.colors.excellent \u00a7a
\n“`<\/p>\n
\n“`
\n\/otlp reload
\n“`
\nReloads config.yml from disk and restarts the update task with new settings.<\/p>\n
\n– `ohtablistping.reload` – Reload configuration only
\n– `ohtablistping.view` – View config values only
\n– `ohtablistping.set` – Modify config values only<\/p>\n
\n# Update interval in ticks (20 ticks = 1 second)
\nupdate-interval: 40 # Recommended: 40 (2 seconds)<\/p>\n
\nupdate-threshold: 5 # Only update if ping changed by 5+ ms<\/p>\n
\nping-format: “{player} \u00a77[{color}{ping}ms\u00a77]”<\/p>\n
\ncolor-coding:
\n enabled: true
\n colors:
\n excellent: “\u00a7a” # Green (0-50ms)
\n good: “\u00a7e” # Yellow (51-100ms)
\n acceptable: “\u00a76” # Gold (101-150ms)
\n poor: “\u00a7c” # Red (151+ms)
\n thresholds:
\n excellent: 50
\n good: 100
\n acceptable: 150<\/p>\n
\nasync-updates: true # Run updates asynchronously (recommended)
\ndebug: false # Enable debug logging
\n“`<\/p>\n
\n– `{ping}` – Current ping value
\n– `{color}` – Automatically determined color code<\/p>\n
\n– `\u00a7a` – Green
\n– `\u00a7e` – Yellow
\n– `\u00a76` – Gold
\n– `\u00a7c` – Red
\n– `\u00a77` – Gray
\n– `\u00a7f` – White<\/p>\n
\n2. **Ping Retrieval**: Gets each player’s ping using `Player.getPing()` API
\n3. **Smart Caching**: Only updates display if ping changed by more than `update-threshold`
\n4. **Color Coding**: Applies color based on ping quality thresholds
\n5. **Display Update**: Updates the tab list player name with formatted ping<\/p>\n
\n– **Intelligent Caching**: Avoids unnecessary updates using threshold system
\n– **Optimized String Operations**: Pre-formatted color codes and efficient formatting
\n– **Low Memory Footprint**: Minimal cache size (only UUID \u2192 ping map)<\/p>\n
\n– CPU Impact: < 0.1% per update cycle\n- Memory Usage: ~5KB additional RAM\n- TPS Impact: None (async operations)\n\n## Compatibility\n\n### Compatible With:\nLuckPerms (permission prefixes) \nEssentialsX (nicknames) \nVault (permission integration) \nMost tab-modifying plugins (soft dependencies)\n\n### Server Software:\nSpigot 1.21.1\nPaper 1.21.1 \nPurpur 1.21.1\nOther Spigot-based forks\n\n## Troubleshooting\n\n### Ping not showing in tab list\n\n1. Check that the plugin is enabled: `\/plugins`\n2. Verify no errors in console during plugin startup\n3. Check `config.yml` is valid YAML syntax\n4. Try reloading the plugin: `\/reload confirm`\n5. Ensure no conflicting plugins are overriding tab list\n\n### Display names appear truncated\n\n- Shorten the `ping-format` string in config\n- Tab list has character limits, keep format concise\n\n### Plugin conflicts with nickname plugins\n\n- OhTabListPing uses soft dependencies and MONITOR priority\n- It should work alongside most nickname plugins\n- If conflicts occur, try adjusting plugin load order\n\n### Performance issues\n\n- Increase `update-interval` (default: 40 ticks)\n- Increase `update-threshold` (default: 5ms)\n- Ensure `async-updates` is enabled (default: true)\n- Enable `debug` to check for errors\n\n## Building from Source\n\n```bash\n# Clone the repository\ngit clone https:\/\/github.com\/anaspui\/ohtablistping.git\ncd ohtablistping\n\n# Build with Maven\nmvn clean package\n\n# Output JAR will be in target\/OhTabListPing-x.x.x.jar\n```\n\n## Development\n\n### Project Structure\n\n```\nohtablistping\/\n\u251c\u2500\u2500 src\/main\/java\/com\/anaspui\/ohtablistping\/\n\u2502 \u251c\u2500\u2500 OhTabListPing.java # Main plugin class\n\u2502 \u251c\u2500\u2500 ConfigManager.java # Configuration handler\n\u2502 \u251c\u2500\u2500 TabListUpdater.java # Ping update logic\n\u2502 \u251c\u2500\u2500 PlayerEventListener.java # Event handlers\n\u2502 \u2514\u2500\u2500 ConfigCommand.java # Command executor\n\u251c\u2500\u2500 src\/main\/resources\/\n\u2502 \u251c\u2500\u2500 plugin.yml # Plugin descriptor\n\u2502 \u2514\u2500\u2500 config.yml # Default configuration\n\u2514\u2500\u2500 pom.xml # Maven build file\n```\n\n### Technologies Used\n\n- **Java 21** - Core language\n- **Spigot API 1.21.1** - Minecraft server API\n- **Maven** - Build management\n- **Bukkit Scheduler** - Async task execution\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature\/xyz-feature`)\n3. Commit your changes (`git commit -m 'Add xyz feature'`)\n4. Push to the branch (`git push origin feature\/xyz-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n\n## Credits\n\n**Author**: anaspui\n\nBuilt with LOVE! for the Minecraft community\n\n---\n\n**\u2b50 If you find this plugin useful, please star the repository!**\n<\/p>\n","protected":false},"excerpt":{"rendered":"