Simple Nametag

A comprehensive nametag system for Minecraft Bedrock Edition that displays AFK status, health, XP, coordinates, and more!

File Details

Simple_Nametag.mcaddon

  • R
  • Jan 27, 2026
  • 224.63 KB
  • 1.4K
  • 1.21.132+7

File Name

Simple_Nametag.mcaddon

Supported Versions

  • 1.21.132
  • 1.21.131
  • 1.21.130
  • 1.21.124
  • 1.21.123
  • 1.21.122
  • 1.21.121
  • 1.21.120
# Changelog

## Version 1.0.0 (Initial Release)

### Features
✨ **AFK Detection System**
- Automatic idle player detection
- Configurable threshold (default: 60 seconds)
- Instant status update on movement
- Customizable AFK tag text and color

✨ **Health Display**
- Real-time health monitoring
- Heart symbol (❤) support
- Percentage or raw value display
- Color-coded display

✨ **XP Level Display**
- Shows current player level
- Customizable color
- Updates in real-time

✨ **Optional Features**
- Coordinate display (short/full format)
- Dimension indicator
- Gamemode display
- Simulated ping indicator

✨ **Configuration System**
- Fully customizable via CONFIG object
- Easy enable/disable toggles
- Color customization for all elements
- Performance tuning options

### Technical
- Built on @minecraft/server v1.9.0
- Supports Minecraft Bedrock 1.20.0+
- Efficient update system with configurable intervals
- Automatic memory cleanup for disconnected players
- Robust error handling

### Edge Cases Handled
✅ Player join/leave events
✅ Dimension changes
✅ Respawn/death events
✅ Gamemode changes
✅ Health updates
✅ Memory leak prevention

---

## Known Limitations

1. **Real Ping**: Cannot access actual network ping in Bedrock scripting API (using simulated values)
2. **Nametag Visibility**: Vanilla render distance limitations apply
3. **Unicode Support**: Some emoji may not render on all platforms
4. **Performance**: With 50+ players, consider increasing update intervals

---

## Compatibility

### Minecraft Versions
- ✅ 1.20.0 and above
- ⚠️ 1.19.x (may work but untested)
- ❌ Below 1.19.0 (not supported)

### Other Addons
- ✅ Compatible with most behavior packs
- ✅ Works alongside resource packs
- ⚠️ May conflict with other nametag addons
- ⚠️ Scripting API addons should be tested for compatibility

### Platforms
- ✅ Windows 10/11
- ✅ Xbox
- ✅ PlayStation
- ✅ iOS
- ✅ Android
- ✅ Nintendo Switch
- ✅ Dedicated servers (Bedrock)

---

**Last Updated**: January 2026
**Current Version**: 1.0.0
**License**: All Rights Reserved