betterlocatorbar

### Optimized Waypoint Style Documentation

#### 1. Optimization Background
I felt the default waypoint style was insufficiently intuitive, so I’ve made multi-faceted adjustments. This optimization requires both a **Resource Pack** and a **Data Pack** to function. Below is a detailed breakdown of the improvements:

#### 2. New Features
1. **Creature Avatar Icons**:
Custom mini waypoint icons for all native game creatures have been designed. When the Data Pack is enabled, it automatically tracks nearby creatures, enabling quick visual identification.

2. **Distance-Based Transparency**:
Added a dynamic transparency system where waypoints become more transparent as the distance increases, helping players intuitively gauge their proximity to tracked creatures.

3. **Player Avatar Personalization**:
Support for custom player ID avatars (submit your ID in the comments to be added to the Resource Pack). Friends will see your unique icon in the positioning bar.

4. **Custom Creature Tracking**:
Use configuration files or commands to choose which creatures to track (e.g., hostile mobs, neutral mobs, or specific species only).

5. **Adjustable Tracking Limit**:
Set a maximum number of tracked creatures per type to avoid interface clutter (e.g., limit Creeper tracking to 10 at once).

6. **Multilingual Foundation**:
The current version uses Chinese by default. Future updates will gradually add English, Japanese, and other international language support.

🌟 **Important Notes**:
- **Current Language Setting**: This Data Pack and Resource Pack are currently in Chinese. A **bilingual version** (Chinese + English) will be released in the next update! 🌍
- **Issue with Unavailable Data Pack**: If the data pack isn’t working, **unzip the compressed file** first! 📁 → Right-click to extract → Place it in the game’s designated directory
- **Version Compatibility**: This pack requires **Minecraft 1.21.6 latest snapshot 25w18a**. Make sure your game client is updated! ⚙️

#### 3. Activation Steps
1. **Enable Cheats** in your world (required during world creation or via `/op [player name]`).
2. After joining the game, wait for an auto-popup prompt to load the **配套 Resource Pack and Data Pack** (companion Resource Pack and Data Pack).
3. OR Activate full functionality with the command `/function betterwaypoint:first` (auto-loops after the first execution).

#### 4. Future Plans
Thank you for downloading and supporting! Here’s our upcoming feature roadmap (✅ = Implemented, ⚒️ = In Development):
1. ✅ **Custom Tracking Range**: Define the effective distance for creature tracking (e.g., activate within 100 blocks).
2. ✅ **Selective Creature Tracking**: Already supported via configuration file filters.
3. ✅ **Tracked Creature Limit**: Adjust the maximum number of displayed creatures per type.
4. ✅ **Compass Direction Guidance**: New directional arrows on waypoints to show real-time target **direction** (like coordinate navigation).
5. ⚒️ **Dynamic Waypoint Styles**: In development – icons will change with creature states (e.g., red borders for injured mobs).
6. 📌 **Custom Mineral Tracking**: Planned – add exclusive waypoints for resources like diamond ore and redstone ore.
7. 🤝 **Your Ideas Welcome**: Leave special feature requests (e.g., boss alerts, item tracking) in the comments – your suggestion might shape the next update!

Dive into the game now and experience the smarter waypoint system! 🗺️✨

————————————————————————————————————————————————


### 优化路点样式文档

#### 一、优化背景
我认为默认的路点样式不够直观，因此进行了多方面调整。本次优化需要同时使用 **资源包** 和 **数据包** 才能生效。以下是具体改进说明：

#### 二、新功能特性
1. **生物头像图标**：
为游戏内所有原生生物设计了定制化迷你路点图标。启用数据包后，系统会自动追踪附近生物，实现视觉化快速识别。

2. **距离动态透明度**：
新增动态透明度系统，路点会随距离增加而逐渐透明，帮助玩家直观判断与追踪生物的远近。

3. **玩家头像个性化**：
支持自定义玩家ID头像（在评论区提交ID即可加入资源包）。好友将在定位栏看到你的专属图标。

4. **生物自定义追踪**：
可通过配置文件或命令选择追踪的生物类型（如仅追踪敌对生物、中立生物或特定物种）。

5. **追踪数量限制**：
可设置每种生物的最大追踪数量，避免界面杂乱（例如限制苦力怕同时追踪10只）。

6. **多语言基础支持**：
当前版本默认中文，未来更新将逐步加入英文、日文等多语言支持。

🌟 **重要提示**：
- **当前语言环境**：本数据包与资源包目前仅支持中文，下次更新将推出 **双语版本**（中/英）！🌍
- **数据包异常处理**：若无法使用，请先解压压缩包！📁 → 右键解压 → 放入游戏指定目录
- **版本适配要求**：需运行在 **Minecraft 1.21.6 最新快照 25w18a**，请提前更新游戏客户端！⚙️

#### 三、激活步骤
1. 在世界中 **启用作弊**（创建世界时开启，或通过 `/op [玩家名称]` 命令授权）。
2. 进入游戏后，等待自动弹窗提示加载 **配套资源包** 和 **数据包**。
3. 或通过命令 `/function betterwaypoint:first` 激活全部功能（首次执行后自动循环运行）。

#### 四、未来计划
感谢下载支持！以下是功能路线图（✅ 已实现，⚒️ 开发中）：
1. ✅ **自定义追踪范围**：可设置生物追踪有效距离（如100格内激活）。
2. ✅ **生物筛选追踪**：已支持通过配置文件过滤追踪类型。
3. ✅ **追踪数量限制**：可调整每种生物的最大显示数量。
4. ✅ **指南针方向引导**：路点新增方向箭头，实时显示目标 **方位**（类似坐标导航）。
5. ⚒️ **动态路点样式**：开发中——图标将随生物状态变化（如受伤生物显示红色边框）。
6. 📌 **自定义矿物追踪**：规划中——新增钻石矿、红石矿等专属路点。
7. 🤝 **期待你的创意**：在评论区留下特殊功能需求（如BOSS警报、物品追踪），你的建议可能成为下次更新的灵感！

立即进入游戏，体验更智能的路点系统吧！🗺️✨