Visibility & Range
MasuHolograms controls hologram visibility per-player based on distance, permissions, and enabled state.
Display Range
The maximum distance (in blocks) at which a player can see a hologram.
- Default: 48 blocks (configurable in
config.json) - Range: 1-256 blocks
- Uses squared distance for efficient checking
When a player moves beyond the display range, the hologram's fake entities are removed from their client. When they move back within range, the entities are re-spawned.
Update Range
The maximum distance at which placeholders and animations update for a player.
- Default: 48 blocks (configurable in
config.json) - Range: 1-256 blocks
Info
Setting update range lower than display range means distant players see the hologram but with static content. This can reduce server processing for holograms with many placeholders.
Update Interval
How often (in ticks) placeholders refresh for this hologram.
- Default: 20 ticks (1 second)
- Range: 1-1200 ticks
- Animations always update every tick regardless of this setting
| Interval | Frequency | Use Case |
|---|---|---|
| 1 | Every tick (50ms) | Real-time data (not recommended for most cases) |
| 20 | Every second | Standard — good for most placeholders |
| 100 | Every 5 seconds | Low-priority info (reduces load) |
| 1200 | Every minute | Very static data that rarely changes |
Visibility Checks
The server performs visibility checks every 20 ticks (1 second) for each player and hologram combination. The check evaluates:
- Is the hologram enabled? — disabled holograms are invisible
- Does the player have permission? — if a permission is set, the player must have it
- Is the player in range? — must be within display range
- Show/hide state — if the player should see it but doesn't, spawn the entities; if they shouldn't see it but do, remove the entities
Permission-Based Visibility
Hologram Permission
Only players with my.server.vip see the hologram. Permission changes are detected within the update interval (default 1 second).
Line Permission
Only line 3 is hidden — other lines on the page remain visible.
Clearing Permissions
Omit the permission argument to make it visible to everyone again.
Enable/Disable
Disabled holograms retain all their data but are completely invisible. Use this for maintenance or seasonal holograms.
Teleport Visibility Update
By default, teleporting does not trigger an immediate visibility recheck. Enable this in config.json:
When enabled, holograms near the destination are shown immediately instead of waiting for the next visibility check cycle.