👁️ Better Player Visibility

Better Player Visibility is a fully client-side Minecraft mod designed to give you complete control over how players and entities are rendered and displayed.
It focuses on visibility, clarity, and information without affecting gameplay or server behavior.

All features are visual or informational only.

---

👥 Player Visibility

The Player Visibility system allows you to selectively hide or show players using multiple rules and lists.

🔹 Show All Players

When enabled, all players are always visible and all other visibility options are ignored.
This must be disabled for any visibility filtering to work.

🔹 Visibility Modes

You can choose between multiple visibility modes:

• ALL – show all players
• NONE – hide all players
• WHITELIST_1 to WHITELIST_5 – only show players in selected lists
• STAFF – custom staff list
• ALLIES – custom allies list
• ENEMIES – custom enemies list
• HIGHLIGHT_1 to HIGHLIGHT_5 – special highlight lists

All lists start empty and can be edited through the config UI or commands.

🔹 Visibility Cycle

A keybind allows cycling through selected visibility modes.
You can choose which modes are included in the cycle.

🔹 Reverse Visibility

Inverts the current visibility result (visible becomes hidden, hidden becomes visible).

🔹 Invisible Main Player

When enabled, your own player model is hidden in third-person (F5).
This does not affect first-person view.

🔹 Visibility Radius

When enabled, only players within the configured radius are affected by visibility rules.
Players outside the radius are always visible.

🔹 Visibility Size

Instead of hiding players, affected players are rendered very small.

🔹 Name Tags & Cosmetics

Additional options control whether affected players still show:

• Name tags
• Sprinting particles
• Fire effects
• Shadows

These settings only apply to players affected by visibility rules.

🔹 NPC Detection

Optional NPC detection can identify fake players based on:

• Invalid or unusual usernames
• Usernames shorter than 3 characters (optional)
• Players not present in the tab list (optional)

This can help detect server-created NPCs.
Some Bedrock players may be incorrectly detected as NPCs on certain servers (known limitation).

---

🧱 Entity Visibility

Entity Visibility applies the same visibility logic to all entities.

🔹 Show All Entities

When enabled, all entities are always visible and no filtering is applied.

🔹 Visibility Modes & Cycle

Supports the same modes and cycling system as Player Visibility, but uses separate lists.

🔹 Visibility Radius

Only entities inside the radius are affected.
Entities outside the radius are always visible.

🔹 Affected Entities

Every entity type can be affected, including:

• Mobs (passive & hostile)
• Armor stands
• Items & projectiles
• Vehicles (boats, minecarts)
• Players (excluding the main player)

Hidden entities are fully invisible.

---

⭐ Highlight Players

The Highlight system visually marks selected players so they stand out.

Players can be highlighted using:

• TAG – adds a custom tag above the player
• NAME – modifies the name tag appearance
• BOTH – uses both methods

Each highlight list supports custom tag text and color.

⚠️ Lunar Client blocks name tag rendering changes.
Highlight features relying on name tags do not work on Lunar.

---

📡 Ping Display

Displays player ping above name tags using colors and text.

• Ping is read from the server tab list
• Ping is never calculated client-side
• NPCs usually appear as No Ping

🔹 Ping Categories

Ping is grouped into multiple categories:
Excellent, Very Good, Good, Decent, Average, Poor, Bad, Worse, Worst, No Ping

Each category has configurable:

• Color
• Text
• Ping range

🔹 Default Ping Text

When enabled, one global text format is used for all categories.
When disabled, each category uses its own text.

Leaving text empty hides the text entirely.
You can use emojis for color-only display.

⚠️ Lunar Client blocks name tag modifications.
A command-based alternative is provided.

---

🏆 Priority (Pickup Priority)

Shows item pickup priority information in chat.

• Lower number = higher pickup priority
• Displayed as a list or via search
• Informational only, does not affect gameplay

🔹 Cached Players

Players who leave render distance but stay on the server are cached.
Their priority remains stable.

🔹 Search Support

You can search for a specific player’s pickup priority instead of listing everyone.

🔹 Customization

Fully customizable text formatting including:

• Prefix text
• Separators
• Cached player text
• Main player text
• Group text
• Search output
• Placeholders

---

🌙 Full Bright

Forces maximum brightness client-side.

• Simple toggle
• No night vision effects
• Does not affect server behavior

---

🚧 Visible Barriers

Makes barrier blocks visible at all times.

• Optional particle rendering
• Client-side only
• No interaction changes

---

⌨️ Commands & Aliases

Client-side commands are provided for:

• Player Visibility
• Entity Visibility
• Ping
• Priority

Each command supports custom aliases.

⚠️ Client commands have higher priority than server commands.
Choose aliases that do not conflict with server-side commands.

After changing aliases, reconnect or switch servers to apply changes.

---

📦 Requirements

• Cloth Config API is required
  This mod depends on Cloth Config for its in-game configuration menu.
  Make sure Cloth Config is installed, or the mod will not load.

---

ℹ️ General Notes

• Fully client-side
• No server interaction
• No gameplay advantage
• Highly configurable