New Feature: Flexible Nametag Display System
Previously, you only had two options:
- Show nametags for ALL animals (cluttered screen)
- Show nametags ONLY for renamed animals (lose level/hunger info)
Now you have a
middle ground with level-based visibility!
Configuration
New Config Option: min_level_to_show
Add this to your config.yml under the entity_display section:
yaml
entity_display:
enabled: true
show_level: true
show_bond: false
# OLD OPTION (still works for compatibility)
show_only_after_rename: false
# NEW OPTION - Minimum level required to show nametag
# Set to 0 to show all animals
# Set to 2+ to show only upgraded animals
min_level_to_show: 2
bar:
enabled: true
length: 10
hunger_color: "&c"
full_color: "&a"
format: "{name} {level} {bar}"
How It Works
The Logic:
The nametag will be
shown if
ANY of these conditions are met:
- Animal has a custom name (renamed by player) → Always visible regardless of level
- Animal level ≥ min_level_to_show → Visible once upgraded
- min_level_to_show is set to 0 → All animals visible
The nametag will be
hidden if:
- Animal is NOT renamed AND level < min_level_to_show
- show_only_after_rename: true is enabled (old system overrides)
Usage Examples
Example 1: Show Only Upgraded Animals (Level 2+)
yaml
entity_display:
enabled: true
show_only_after_rename: false
min_level_to_show: 2
Result:
- Wild Cow (Level 1, no name) → Hidden
- Upgraded Cow (Level 2, no name) → "Cow [Lvl 2] [██████░░░░]"
- Named Cow (Level 1, named "Bessie") → "Bessie [Lvl 1] [████░░░░░░]"
Why use this?
- Reduces visual clutter in the world
- Creates a sense of progression ("wild" → "tamed")
- Still shows important info for animals you've invested in
Example 2: Show Only High-Level Animals (Level 4+)
yaml
entity_display:
enabled: true
show_only_after_rename: false
min_level_to_show: 4
Result:
- Level 1-3 animals (unnamed) → Hidden
- Level 4+ animals (unnamed) → Visible
- Any renamed animal → Always visible
Why use this?
- Perfect for servers with many animals
- Only your "elite" animals show their status
- Keeps the screen clean while showing progress
Example 3: Show All Animals (Default Behavior)
yaml
entity_display:
enabled: true
show_only_after_rename: false
min_level_to_show: 0 # Set to 0 to disable level requirement
Result:
- ALL animals show their nametags, regardless of level or name
Why use this?
- Classic behavior (like before this update)
- Good for small servers or farms
- See all animal stats at a glance
Example 4: Show ONLY Renamed Animals (Old System)
yaml
entity_display:
enabled: true
show_only_after_rename: true # Old option overrides everything
min_level_to_show: 2 # This will be ignored
Result:
- Only renamed animals show nametags
- All unnamed animals are hidden (even if Level 5)
Why use this?
- Backward compatibility with old configs
- If you prefer the strictest visibility rules
Migration Guide
If you're upgrading from an older version:
Option A: Keep old behavior (show all animals)
yaml
min_level_to_show: 0
show_only_after_rename: false
Option B: Use new smart system (recommended)
yaml
min_level_to_show: 2 # Or 3, 4, etc.
show_only_after_rename: false
Option C: Use strictest mode (only renamed)
yaml
show_only_after_rename: true
# min_level_to_show is ignored