# Cool Nametag Addon for Minecraft Bedrock

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

## Features

### 🎯 AFK Detection

- Automatically detects when players are idle

- Configurable threshold (default: 60 seconds)

- Visual indicator with customizable tag text

- Instant removal when player moves

### ❤️ Health Display

- Shows current health above player names

- Option to display as hearts (❤) or percentage

- Color-coded for easy visibility

### ⭐ XP Level Display

- Shows player's current XP level

- Customizable color and format

### 📍 Coordinates Display (Optional)

- Show player coordinates in nametag

- Short format (X: 10 Y: 64 Z: -20) or full format with decimals

- Useful for multiplayer coordination

### 🌍 Dimension Display (Optional)

- Shows which dimension the player is in

- Short names (Overworld, Nether, The End) or full IDs

### 🎮 Gamemode Display (Optional)

- Shows current gamemode

- Short format (S, C, A) or full names

### 📶 Ping Display (Optional)

- Simulated ping/latency indicator

- Note: Real ping data not available in Bedrock scripting API

## Performance Tips

1. **Update Interval**: Higher values (e.g., 20 ticks) reduce lag but update less frequently

2. **Disable Unused Features**: Turn off coordinates, dimension, etc. if not needed

3. **AFK Check Interval**: Increase this if you have many players

## Troubleshooting

### Script errors

- Ensure you're using Minecraft Bedrock 1.20.0 or higher

- Check the content log for specific errors

### Players not marked as AFK

- Check the `thresholdSeconds` setting

- Ensure `afk.enabled` is set to `true`

- Very small movements (like head rotation) don't count as movement

## Technical Details

- **Module**: `@minecraft/server` v1.9.0

- **Format Version**: 2

- **Min Engine**: 1.20.0

- **Update Method**: Scheduled intervals using `system.runInterval()`

## Edge Cases Handled

✅ Players joining/leaving - Data is properly initialized and cleaned up

✅ Dimension changes - Nametags update correctly

✅ Death/respawn - Nametag maintained through respawn

✅ Gamemode changes - Detected and updated

✅ Health changes - Updates in real-time

✅ Memory management - Stale player data cleaned every 5 minutes

## Credits

Created by AAAmiBotok for the Minecraft Bedrock community!

## License

Simple Nametag