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

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.
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.
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.
Custom Creature Tracking: Use configuration files or commands to choose which creatures to track (e.g., hostile mobs, neutral mobs, or specific species only).
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).
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

Enable Cheats in your world (required during world creation or via /op [player name]).
After joining the game, wait for an auto-popup prompt to load the 配套 Resource Pack and Data Pack (companion Resource Pack and Data Pack).
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):

✅ Custom Tracking Range: Define the effective distance for creature tracking (e.g., activate within 100 blocks).
✅ Selective Creature Tracking: Already supported via configuration file filters.
✅ Tracked Creature Limit: Adjust the maximum number of displayed creatures per type.
✅ Compass Direction Guidance: New directional arrows on waypoints to show real-time target direction (like coordinate navigation).
⚒️ Dynamic Waypoint Styles: In development – icons will change with creature states (e.g., red borders for injured mobs).
📌 Custom Mineral Tracking: Planned – add exclusive waypoints for resources like diamond ore and redstone ore.
🤝 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! 🗺️✨

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

优化路点样式文档

一、优化背景

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

二、新功能特性

生物头像图标：为游戏内所有原生生物设计了定制化迷你路点图标。启用数据包后，系统会自动追踪附近生物，实现视觉化快速识别。
距离动态透明度：新增动态透明度系统，路点会随距离增加而逐渐透明，帮助玩家直观判断与追踪生物的远近。
玩家头像个性化：支持自定义玩家ID头像（在评论区提交ID即可加入资源包）。好友将在定位栏看到你的专属图标。
生物自定义追踪：可通过配置文件或命令选择追踪的生物类型（如仅追踪敌对生物、中立生物或特定物种）。
追踪数量限制：可设置每种生物的最大追踪数量，避免界面杂乱（例如限制苦力怕同时追踪10只）。
多语言基础支持：当前版本默认中文，未来更新将逐步加入英文、日文等多语言支持。

🌟 重要提示：

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

三、激活步骤

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

四、未来计划

感谢下载支持！以下是功能路线图（✅ 已实现，⚒️ 开发中）：

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

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