Friend Locator - Guild Compass

Friend Locator - Guild Compass / 公会队友罗盘

不想为了找队友反复打开地图？ Friend Locator 会把在线同公会成员直接显示在游戏原版顶部罗盘上，让你随时看到队友的方向、姓名和距离。

功能

• 显示在线同公会成员的方向、姓名和距离
• 根据玩家 UID 稳定分配不同图标与高对比颜色
• 支持显示预设、最大显示距离和性能模式
• 支持 4 个 UID 自定义槽位，可覆盖昵称、图标和颜色
• F7 开关 100 米测试标记，单人也能确认 Mod 是否正常加载
• F8 打开或关闭游戏内设置页
• 针对联机性能优化：低频刷新成员名单，无目标时自动降低更新频率

依赖与安装

必需：官方 UE4SS Experimental (Palworld) 工坊项目。

可选：F8 游戏内设置页需要另行安装 DekModConfigMenu。没有安装时，队友定位、图标、姓名、距离和配置文件功能仍会正常工作。本项目不会打包或重新分发第三方 Mod。

使用方法

进入联机世界后无需操作，在线同公会成员会自动出现在顶部罗盘。

• F7：开关测试标记
• F8：开关设置页（需要 DekModConfigMenu）

隐私与公平性

本 Mod 只读取游戏客户端已经同步的数据，不发送外部网络请求、不上传玩家信息、不修改存档。它只显示在线同公会成员，不会定位其他公会或全服务器玩家。

兼容性

• 当前版本：0.4.0
• 类型：客户端 UE4SS Lua Mod
• 多人游戏：支持
• 专用服务器：玩家客户端安装即可，服务器规则仍然适用

游戏更新可能导致接口变化。如遇失效，请提供游戏版本、复现步骤和 UE4SS 日志中的 [FriendLocator] 行。

[hr][/hr]

English

Tired of opening the map every time you need to find a teammate? Friend Locator shows online members of your current guild directly on Palworld's built-in top compass, including their direction, name, and distance.

Features

• Shows each online guild member's direction, name, and distance
• Assigns stable icons and high-contrast colors based on player UID
• Configurable display presets, maximum distance, and performance mode
• Four UID override slots for custom names, icons, and colors
• F7 toggles a 100 m test marker so the installation can be checked while playing alone
• F8 opens or closes the in-game settings page
• Multiplayer-friendly optimizations with low-frequency roster refresh and idle throttling

Requirements

Required: the official UE4SS Experimental (Palworld) Workshop item.

Optional: the F8 settings page additionally requires DekModConfigMenu. All core compass markers continue to work without it. This item does not bundle or redistribute third-party mods.

Controls

• F7: toggle the test marker
• F8: open or close settings (requires DekModConfigMenu)

Privacy and Scope

This client-side mod only reads player state already replicated by the game. It makes no external network requests, uploads no player data, and does not modify save files. Only online members of your own guild are displayed; it is not a server-wide player tracker.

Compatibility

• Version: 0.4.0
• Type: client-side UE4SS Lua mod
• Multiplayer: supported
• Dedicated servers: install on the player client; server rules still apply

If a game update breaks compatibility, please report the game version, reproduction steps, and [FriendLocator] lines from the UE4SS log.