ItemDurability is a high-performance PocketMine-MP plugin that displays item durability information in real-time within the item's lore (description). This plugin helps players see the remaining durability of weapons, tools, and armor, allowing them to know when to repair or replace them before they break.
Informational
Mechanics
Economy
Vanilla Mechanics
Armor
Durability
HUD
Item Lore
PocketMine-MP@latest
Tools
Weapons
In-game, the durability text will automatically change colors based on the item's condition:
| Color | Sample | Durability Example | Condition |
|---|---|---|---|
 |
Green | Durability: [180/200] (90%) | Very Good Condition |
 |
Dark Green | Durability: [140/200] (70%) | Good Condition |
 |
Yellow | Durability: [100/200] (50%) | Medium Condition |
 |
Gold | Durability: [60/200] (30%) | Low Condition |
 |
Red | Durability: [30/200] (15%) | Very Low Condition |
 |
Dark Red | Durability: [10/200] (5%) | Critical Condition |
- ✅ Real-time Durability Display: Shows durability in customizable format within item lore
- ✅ Automatic Color Gradation: Color changes based on condition (Green → Red scale)
- ✅ Universal Compatibility: Supports all PocketMine-MP items with durability
- ✅ Smart Update System: Only updates when necessary to prevent spam
- ✅ No Duplicate Lore: Automatically removes old durability lines
- ✅ Low Durability Warnings: Configurable alerts for items needing attention
- 🚀 Batch Processing: Efficient batch update system for large servers
- 🚀 Smart Throttling: Per-player throttling prevents unnecessary updates
- 🚀 Memory Management: Automatic cleanup of offline player data
- 🚀 Configurable Performance: Tunable settings for different server sizes
- 🚀 Exception Handling: Robust error handling prevents crashes
- ⚙️ Comprehensive Config Validation: Automatic validation and correction of settings
- ⚙️ Flexible Format System: Support for current, max, and percentage placeholders
- ⚙️ Plugin Compatibility: Works seamlessly with enchantment and repair plugins
- ⚙️ Server Scalability: Optimized for servers from 1 to 1000+ players
- Download the latest version from GitHub Releases
- Place the
.pharfile in thepluginsfolder of your PocketMine-MP server - Restart the server
- Edit the configuration file in
plugins/ItemDurability/config.ymlas needed
# ItemDurability Configuration
# Durability display format
# %current% = current durability
# %max% = maximum durability
# %percent% = durability percentage
durability_format: "Durability: [%current%/%max%] (%percent%%)"
# Durability text color (default value: GREEN)
# Note: This color is only used as fallback if not using automatic color gradation
# The durability text color will automatically change based on durability percentage:
# 80-100% = GREEN (very good)
# 60-79% = DARK_GREEN (good)
# 40-59% = YELLOW (medium)
# 20-39% = GOLD (low)
# 10-19% = RED (very low)
# 0-9% = DARK_RED (critical)
durability_color: "GREEN"
# Show warning when durability is low
# Enable/disable low durability notifications
enable_low_durability_warning: true
# Percentage of durability considered low (%)
low_durability_percentage: 10
# Low durability warning color
low_durability_color: "RED"
# Performance Settings
# How often to process durability updates (in server ticks, 20 ticks = 1 second)
# Lower values = more responsive but higher CPU usage
# Higher values = less responsive but better performance
update_interval_ticks: 10
# Minimum time between durability updates for the same player (in seconds)
# This prevents spam updates when players rapidly interact with items
throttle_seconds: 0.2
# Maximum number of players to process durability updates for per batch
# Adjust based on your server's performance and player count
max_batch_size: 50| Players Server Size | update_interval_ticks |
throttle_seconds |
max_batch_size |
|---|---|---|---|
| Small (1–50) | 5 | 0.1 | 20 |
| Medium (50–200) | 10 | 0.2 | 50 |
| Large (200+) | 20 | 0.5 | 100 |
The plugin uses an advanced batch processing system that:
- Queues durability updates instead of processing them immediately
- Processes updates in configurable batches to maintain performance
- Uses smart throttling to prevent spam updates
- Automatically cleans up data for offline players
The plugin automatically validates all configuration values:
- Format Strings: Ensures durability format is not empty
- Color Names: Validates against supported TextFormat colors
- Numeric Ranges: Checks percentages (0-100) and positive integers
- Performance Settings: Validates update intervals and batch sizes
- Auto-Correction: Invalid values are replaced with defaults and logged
Valid color names for configuration:
BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE
- PocketMine-MP: 5.0.0 or latest
- Plugin Compatibility: Works with enchantment, repair, and custom item plugins
- Server Types: Compatible with survival, creative, and custom game modes
- Performance: Optimized for servers of all sizes (1-1000+ players)
Q: How does the new batch system improve performance?
A: Instead of creating individual tasks for each update, the plugin queues updates and processes them in batches. This reduces CPU overhead and prevents lag spikes on busy servers.
Q: What happens if I have invalid configuration values?
A: The plugin automatically validates your config on startup. Invalid values are replaced with defaults and warnings are logged to help you fix them.
Q: Can I customize the update frequency?
A: Yes! Use update_interval_ticks to control how often updates are processed, and throttle_seconds to control per-player update frequency.
Q: Does this plugin affect server performance?
A: The plugin is heavily optimized for performance with batch processing, smart throttling, and configurable settings. It's designed to handle large servers efficiently.
Q: Is this plugin compatible with other plugins?
A: Yes, it's designed to work seamlessly with other plugins without conflicts, especially enchantment and repair plugins.
Q: How can I request new features?
A: Submit a feature request on GitHub Issues or contact us through the links below.
- 🚀 New: Batch processing system for improved performance
- 🚀 New: Comprehensive configuration validation
- 🚀 New: Configurable performance settings
- 🚀 New: Smart per-player throttling
- 🚀 New: Automatic memory cleanup
- 🛠️ Fixed: Constructor parameter mismatch in UpdateDurabilityTask
- 🛠️ Improved: Better error handling and logging
- 🛠️ Improved: Code organization and documentation
- Initial release with basic durability display functionality
Licensed under MIT License
- 🧩 Custom Format: Customize the display format to show exactly what you want.
For example, to show only the percentage:
durability_format: "Durability: %percent%%" - 🌈 Color Customization: The automatic gradient provides intuitive feedback, but you can override it with custom warning colors.
- 🔣 Format Placeholders: Use
%current%,%max%, and%percent%in any combination to design your ideal display.
- 📈 Large Servers: Increase
update_interval_ticksandthrottle_secondsto reduce CPU load. - ⚡ Small Servers: Decrease these values for more responsive updates.
- 🧮 Batch Size: Adjust
max_batch_sizebased on your server’s performance capacity. - 🪵 Monitor Logs: Always monitor server logs for configuration warnings or optimization hints.
- 🛠️ Repair Plugins: Fully compatible with enchantment and item-repair plugins.
- 🧪 Custom Items: Supports plugins that register custom durable items.
- 💰 Economy Plugins: Great for item-based economy servers where durability matters.
- ⚔️ PvP Servers: Essential for competitive servers to show equipment condition in real-time.
- 📸 Take screenshots showing different durability levels to showcase the color system.
- 🧾 Document your custom format strings for staff reference or future tweaking.
- 📤 Share performance settings that work best for your server size and player count.
Made with ❤️ by ImmoDevs
Copyright © 2025 ImmoDevs. All rights reserved.