伴途 1.0.0 更新说明 / Companion Locator 1.0.0 Changelog

正式版首发 / Initial Stable Release

• 中文：首个正式发布版本，为十个 Minecraft 版本分别提供 Fabric 与 Forge 独立构建，共计 20 个正式包。
  English: Initial stable release with separate Fabric and Forge builds for ten Minecraft versions, totaling 20 release files.

• 中文：在经验条上显示平滑移动、按距离缩放的队友头像，同时提供距离档位、高度箭头和视野边缘方向提示。
  English: Adds smoothly moving, distance-scaled teammate heads to the experience bar, together with distance tiers, elevation arrows, and edge-of-view direction cues.

• 中文：2–3 位队友自动展开；人数更多时显示最近三位玩家和 +N，并修复小屏或边缘聚类时数量文字越界的问题。
  English: Automatically spreads out groups of two or three teammates; larger groups show the nearest three players plus +N, with fixes preventing the count from escaping the bar on small screens or edge clusters.

• 中文：加入主世界、下界、末地及其他维度的像素徽记，不再为异维度队友显示错误或容易误解的方向。
  English: Adds pixel badges for the Overworld, Nether, End, and other dimensions instead of displaying incorrect or misleading directions for cross-dimension teammates.

• 中文：支持定位条、持续轮廓发光、两者同时或完全关闭四种模式，并提供可配置颜色、五秒预览与发光自检。
  English: Supports locator-only, persistent outlines, both features, or fully disabled modes, with configurable colors, a five-second preview, and outline diagnostics.

• 中文：加入服务器权威配置与自动同步；普通玩家可以独立控制自己是否允许被其他玩家定位。
  English: Adds server-authoritative configuration with automatic synchronization, while allowing every regular player to control whether others may locate them.

• 中文：房主和管理员可以生成五分钟后自动销毁的测试假人，用于验证方位、距离缩放、布局与轮廓发光。
  English: Hosts and administrators can spawn a test dummy that disappears after five minutes for checking direction, distance scaling, layout, and glowing outlines.

• 中文：设置界面加入实时预览、恢复默认值、颜色预览色块、完整悬浮说明、响应式双列和小屏滚动布局。
  English: The settings screen now includes live previews, restore-default controls, color swatches, complete tooltips, responsive two-column layouts, and scrolling on small screens.

• 中文：设置、提示、权限信息、诊断和错误文本全部提供简体中文与英文，并自动跟随客户端游戏语言。
  English: Settings, prompts, permission messages, diagnostics, and errors are fully available in Simplified Chinese and English and automatically follow the client's game language.

平滑度与 HUD / Smoothing and HUD

• 中文：移动玩家使用 10 Hz 服务端快照与客户端逐帧插值，静止状态使用去重、心跳和稳定帧，减少方向移动时的抽帧和过冲。
  English: Moving players use 10 Hz server snapshots with per-frame client interpolation, while stationary states use deduplication, heartbeats, and stable frames to reduce stutter and overshoot.

• 中文：视野边缘渐隐渐显改用平滑曲线和逐帧透明度处理，使 120°、180°等显示范围边缘的过渡更加自然。
  English: Edge fading uses smooth curves and per-frame opacity handling for more natural transitions around view limits such as 120° and 180°.

• 中文：头像允许连续经过经验条中央，并在上层重新绘制原版经验等级数字，避免跳过中间区域且保持等级清晰可见。
  English: Head icons can travel continuously across the center of the experience bar, while the vanilla level number is redrawn above them to remain clearly visible.

• 中文：骑乘跳跃条出现时自动调整定位条；创造模式和旁观模式使用独立底线，不再错误假设原版经验条始终存在。
  English: The locator automatically adjusts for mount jump bars, while Creative and Spectator modes use a dedicated baseline instead of assuming the vanilla experience bar is always present.

• 中文：修正 Minecraft 1.20.6 及以上版本的渐隐透明度，并在 1.21.3 及以上版本使用逐顶点 ARGB，减少不同渲染管线下的突兀消失。
  English: Fixes fade opacity on Minecraft 1.20.6 and newer and uses per-vertex ARGB on 1.21.3 and newer, reducing abrupt disappearance across different rendering pipelines.

• 中文：Fabric 1.21.4/1.21.5 使用分层 HUD 注册，定位头像在原版经验条之后、经验等级文字之前渲染。
  English: Fabric 1.21.4/1.21.5 use layered HUD registration so locator icons render after the vanilla experience bar but before the experience level text.

• 中文：修复 Forge 1.20.6–1.21.5 HUD 层参数顺序和嵌套栈定位问题，并修复 Forge 1.21.4 发光颜色方法映射造成的启动崩溃。
  English: Fixes HUD layer argument ordering and nested stack positioning on Forge 1.20.6–1.21.5, plus the Forge 1.21.4 startup crash caused by glowing-color method mappings.

网络与稳定性 / Networking and Stability

• 中文：正式版网络代际升级为 Fabric v3 / Forge 6，客户端与服务器版本不一致时会明确拒绝连接，不能与 Alpha/Beta 包混用。
  English: The stable network generation is now Fabric v3 / Forge 6. Mismatched client and server versions are explicitly rejected, and stable builds cannot connect to Alpha or Beta builds.

• 中文：网络快照加入单调序列号、过期包过滤、字段范围检查和尾随数据拒绝；现代 Fabric 自定义负载限制为 32 KiB。
  English: Network snapshots now include monotonic sequence numbers, stale-packet filtering, field-range validation, and trailing-data rejection; modern Fabric custom payloads are limited to 32 KiB.

• 中文：全局设置、个人隐私与测试假人请求使用独立限流，配置只有在原子写入成功后才生效；损坏配置会先保存 .broken 备份。
  English: Global settings, privacy changes, and test-dummy requests use independent rate limits. Configuration changes apply only after a successful atomic write, and damaged configuration files are preserved as .broken backups.

• 中文：断开服务器时会清除上一服务器的显示模式与权限状态，避免加入新服务器后沿用旧数据。
  English: Display modes and permission state from the previous server are cleared on disconnect, preventing stale data from carrying into a new server.

• 中文：发光自检只检查客户端实际加载的实体，避免把未加载队友误报为轮廓钩子失效。
  English: Outline diagnostics inspect only entities actually loaded by the client, preventing unloaded teammates from being misreported as outline-hook failures.

• 中文：测试假人的生命周期和请求限流改用单调时钟，生成过程使用安全清理，避免系统时间变化、实体添加异常或服务器退出留下残余状态。
  English: Test-dummy lifetime and request limits use a monotonic clock, with safe cleanup during spawning to prevent residual state after system-time changes, entity-addition failures, or server shutdown.

版本与依赖 / Versions and Dependencies

• 中文：正式支持 Minecraft 1.19.2、1.19.4、1.20.1、1.20.2、1.20.4、1.20.6、1.21.1、1.21.3、1.21.4 和 1.21.5。
  English: Officially supports Minecraft 1.19.2, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, and 1.21.5.

• 中文：上述每个 Minecraft 版本都分别提供 Fabric 与 Forge JAR；请下载与游戏版本及加载器完全一致的文件。
  English: Every listed Minecraft version has separate Fabric and Forge JARs. Download the file matching your exact game version and loader.

• 中文：Fabric 每个目标包声明经过验证的 Fabric API 基线和 Java 版本；修正 1.21.4 的最低依赖为 0.119.3+1.21.4。
  English: Every Fabric target declares its verified Fabric API baseline and Java version; the minimum dependency for 1.21.4 is correctly set to 0.119.3+1.21.4.

• 中文：Minecraft 1.19.2–1.20.4 使用 Java 17；Minecraft 1.20.6–1.21.5 使用 Java 21。
  English: Minecraft 1.19.2–1.20.4 use Java 17, while Minecraft 1.20.6–1.21.5 use Java 21.

• 中文：Minecraft Java Edition 1.21.6 已提供原生定位条，因此本模组有意将兼容上限设为 1.21.5。
  English: Minecraft: Java Edition 1.21.6 includes the vanilla Locator Bar, so this mod intentionally sets its compatibility ceiling at 1.21.5.