promotional bannermobile promotional banner

Simple Nametag

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

Simple_Nametag.mcaddon

Download
File nameSimple_Nametag.mcaddon
Uploader
lostsharkofficiallostsharkofficial
Uploaded
Jan 27, 2026
Downloads
1.8K
Size
224.6 KB
File ID
7538181
Type
R
Release
Supported game 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

What's new

# 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

All Relations

  • All Relations
  • Embedded Library
  • Optional Dependency
  • Required Dependency
  • Tool
  • Incompatible
  • Include

This mod has no related projects