zHideAllPlayers - Minecraft Plugin
A powerful Minecraft server plugin that allows players to toggle the visibility of other players using intuitive dye items. Perfect for reducing visual clutter in busy servers, creative building, or focused gameplay.
Features
Easy-to-Use Interface
- Right-click Toggle: Use green dye (show players) or gray dye (hide players) in hotbar slot 9
- Individual Player Control: Look at a specific player and right-click to hide/show only that player
- Visual Feedback: Dye items change appearance to reflect current state
- Sound Effects: Configurable audio feedback for all toggles
⚡ Performance Optimized
- Client-side Rendering: Reduces lag by hiding player models on client
- Memory Efficient: Minimal server resource usage
- Async Processing: Non-blocking operations for smooth gameplay
Persistent Settings
- Session Memory: Player preferences saved between disconnects
- YAML Storage: Lightweight file-based data persistence
- Auto-cleanup: Removes outdated player data automatically
Fully Customizable
- Item Names & Lore: Customize dye item appearance
- Messages: Personalize all player-facing text
- Sounds: Configure audio feedback
- Hotbar Slot: Choose which slot holds the dye item
Installation
- Download the latest
Code (Text):
zHideAllPlayers-1.0.0.jar
from the releases
- Place the JAR file in your server's
directory
- Restart your Minecraft server
- The plugin will auto-generate
on first run
Usage
For Players
- Toggle All Players: Right-click the dye in slot 9 to hide/show all players
- Toggle Specific Player: Look at a player and right-click the dye to hide/show just that player
- Check Status: Green dye = players visible, Gray dye = players hidden
For Administrators
-
Code (Text):
/zhideallplayers
- Show plugin information
-
Code (Text):
/zhideallplayers reload
- Reload configuration
-
Code (Text):
/zhideallplayers help
- Display command help
Configuration
The plugin creates a
file with extensive customization options:
Code (Text):
# Plugin Settings
settings:
auto-give-dye: true # Give dye item on player join
persistent-settings: true # Save player preferences
dye-slot: 9 # Hotbar slot (1-9)
# Item Customization
items:
visible-dye:
name: "&a&lShow Players"
lore: "&7Right-click to hide all players"
hidden-dye:
name: "&7&lHide Players"
lore: "&7Right-click to show all players"
# Sound Effects
sounds:
toggle: "BLOCK_NOTE_BLOCK_PLING"
# Messages
messages:
all-players-hidden: "&7All players are now &chidden&7!"
all-players-shown: "&7All players are now &avisible&7!"
player-hidden: "&7Player &c{player} &7is now hidden!"
player-shown: "&7Player &a{player} &7is now visible!"
Permissions
-
Code (Text):
zhideallplayers.use
- Allow player to use visibility toggle (default: true)
-
Code (Text):
zhideallplayers.admin
- Administrative commands (default: op)
Compatibility
- Minecraft Versions: 1.16.5 to 1.21.5+
- Server Software: Spigot, Paper, and forks
- Java Version: Java 8+
Commands
Code (Text):
/zhideallplayers
|
Show plugin info |
Code (Text):
zhideallplayers.admin
|
Code (Text):
/zhideallplayers reload
|
Reload config |
Code (Text):
zhideallplayers.admin
|
Code (Text):
/zhideallplayers help
|
Show command help |
Code (Text):
zhideallplayers.admin
|
Aliases:
,
Technical Details
Architecture
- Event-driven: Uses Bukkit's listener system for efficient event handling
- Modular Design: Separated managers for configuration, visibility, and data
- Thread-safe: Concurrent data structures for multi-threaded server environments
Data Storage
- Player preferences stored in
Code (Text):
plugins/zHideAllPlayers/playerdata/
- YAML format for human-readable configuration
- Automatic cleanup of outdated player data
Performance
- Minimal server impact through client-side visibility manipulation
- Efficient data structures (HashSet, ConcurrentHashMap)
- Lazy loading of player data
Support
For issues, feature requests, or contributions, please visit the project repository.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Author: GamingHuzai
Version: 1.0.0
Build System: Maven