随机地牢Boss标记

随机地下城首领标记 是一个客户端的 UE4SS Lua 模组，用于《幻兽帕鲁》，它能将 随机生成的 dungeons 显示在世界地图上。游戏本身会标记固定的地下城首领，但临时生成的程序化地下城在世界各地出现时却没有图标——这个模组会找到它们并添加图标，同时显示实时倒计时，提示每个地下城消失前还有多长时间。

每个标记位于地下城入口处，并在下方显示剩余时间。该模组会随着地下城出现和消失而重新扫描，因此新生成的地下城会出现标记，地下城消失或首领被击败后标记也会消失。倒计时直接从游戏自身的地下城数据中读取，因此与实际使用的数据一致。

为何是通用地下城图标，而非首领头像： 随机地下城的首领并非固定不变。游戏仅存储地下城从哪个首领池（基于区域和等级）抽取，实际的首领是在你进入时从加权池中随机选出的。在你进入之前，地图无法读取任何确定的首领，因此该模组无法可靠地显示特定首领帕鲁。这就是为什么每个标记都使用一个统一的地下城图标——它告诉你那里有一个随机地下城，而不是你会在里面找到哪个首领。

请注意： 此模组尚未经过广泛测试。如果你遇到任何错误、缺少标记或倒计时不准确，请在“Bug”标签或“帖子”部分报告。提供单人或专用服务器等详细信息以及截图会非常有帮助。谢谢！

---

安装位置

• Linux: 需要 Windows 客户端。 这是一个客户端模组，UE4SS 依赖于仅限 Windows 的 DLL 注入，因此它需要在 Windows 游戏客户端上加载（原生版本，或通过实验性 RE-UE4SS Linux 分支在 Proton 下运行）。Linux 专用服务器既不运行也不需要它。
• 仅客户端：是。 安装在每个希望看到地下城标记的玩家电脑上。
• 仅服务器：否。 专用服务器没有世界地图 UI，因此仅安装在服务器上不会向玩家显示任何内容。
• 客户端和服务器均需安装：否。 服务器不需要此显示模组。

这是一个客户端 UI 模组。在多人游戏中，每个希望看到标记的玩家都必须单独安装；没有安装的玩家仍然可以正常加入并游玩。

---

主要功能

• 在世界地图上标记随机生成的地下城（游戏通常不标记这些地下城）
• 使用游戏原生的地下城图标，将每个标记放置在地下城入口处
• 在每个标记下方显示每个地下城的实时剩余时间倒计时（每秒更新）
• 在地下城生成、消失或首领被击败时自动添加和移除标记
• 使用快捷键切换所有标记的显示（默认为 F8）
• 可配置图标类型、大小、亮度以及倒计时文本颜色、大小和位置
• 可选的调试日志记录

---

配置

打开 RandomDungeonBossMarker/Scripts/config.lua：

return {
    -- 将诊断信息打印到 UE4SS.log
    Debug = false,

    -- 切换世界地图标记的按键
    MapToggleKey = "F8",

    -- 每个标记使用一个固定图标。IconLocationType 是传递给 "Setup Icon" 的 EPalLocationType
    -- 类型；9 = PointDungeonPortal（地下城/洞穴图标）
    IconLocationType = 9,
    NativeIconSize = 30,
    IconBrightness = 1.0,

    -- 将每个地下城的剩余时间显示为倒计时标签。字体大小和
    -- 相对于图标的像素偏移用于放置文本。TimeColor 接受 0..1 或 0..255 范围。
    ShowRemainingTime = true,
    TimeFontSize = 10,
    TimeOffsetX = 4.0,
    TimeOffsetY = 40.0,
    TimeColor = { R = 1.0, G = 1.0, B = 1.0, A = 1.0 },

    -- 重新扫描随机地下城集合的频率（毫秒）
    DungeonScanIntervalMs = 5000,

    -- 常规地图更新频率和原生图标创建批次
    ScanIntervalMs = 1000,
    NativeIconBatchSize = 10,
    NativeIconIntervalMs = 250,

    -- 诊断：0 = 禁用
    DiagLogIntervalMs = 0,
}

MapToggleKey 是一个 UE4SS 按键名称（例如 "F8"、"M" 或 "NUM_ZERO"）；将其设置为 false 可禁用快捷键。

IconLocationType 选择图标样式。9 是地下城/洞穴图标；如果在你的版本中无法渲染，模组会自动回退到其他地下城和首领图标类型。你可以尝试的其他值：20（地下城目标）、11（首领塔）、16（野外首领）、19（补给标记）。

ShowRemainingTime 开启或关闭倒计时。TimeFontSize 设置其大小，TimeOffsetX/Y 设置其相对于图标的偏移量（增加 X 向右移动，增加 Y 向下移动），TimeColor 设置其颜色（0-255 或 0-1，A 为透明度）。

更改配置后，重新打开地图以查看新值。

---

安装

Vortex

1. 安装或更新 Palworld Vortex 扩展 至 0.2.1 或更新版本，然后让 Vortex 管理 Palworld。
2. 使用 Mod Manager 下载 此文件，然后点击 安装、启用 和 部署模组。
3. 如果需要，Vortex 会安装其兼容的 UE4SS 依赖项，并自动注册此 Lua 模组。部署后完全重启 Palworld。

手动安装

1. 安装 Palworld 实验版 UE4SS。
2. 下载并解压模组压缩包。
3. 将 RandomDungeonBossMarker 文件夹复制到：

Palworld/Pal/Binaries/Win64/ue4ss/Mods/

安装后的文件结构应如下所示：

Palworld/Pal/Binaries/Win64/ue4ss/Mods/RandomDungeonBossMarker/enabled.txt
Palworld/Pal/Binaries/Win64/ue4ss/Mods/RandomDungeonBossMarker/Scripts/main.lua
Palworld/Pal/Binaries/Win64/ue4ss/Mods/RandomDungeonBossMarker/Scripts/config.lua
Palworld/Pal/Binaries/Win64/ue4ss/Mods/RandomDungeonBossMarker/Scripts/common.lua

common.lua 是模组压缩包中包含的必要支持文件。请将其与 main.lua 放在同一 Scripts 文件夹中；无需单独的库模组或额外下载。

附带的 enabled.txt 会在当前的 UE4SS 布局中启用此模组。如果你的 UE4SS 安装使用 mods.txt，请添加以下行：

RandomDungeonBossMarker : 1

安装后完全重启 Palworld。

---

需求

• Palworld（Steam）
• UE4SS for Palworld

---

范围

• 为随机生成的地下城添加地图标记和生命周期倒计时
• 从游戏自身数据中读取地下城位置和计时器
• 不会更改生成率、地下城生命周期、首领战利品或任何游戏数值
• 不会修改或直接编辑存档文件

---

多人游戏

这是一个客户端显示模组，因此每个希望看到标记的玩家都应安装它。在单人游戏和监听（主机）游戏中，所有当前存在的地下城都可用并获得标记。在 专用服务器客户端 上，只有距离足够近并被同步给你的地下城才会被标记，因此远处的地下城可能需要你靠近后才会出现。它不会更改任何服务器端数值。

---

性能

在关闭地图行走时，几乎不运行任何内容。只有在地图打开时才会重新扫描地下城集合（每隔几秒），而在地图显示时倒计时标签每秒更新一次。扫描避免了对主机进行昂贵的引擎扫描，因此即使有很多地下城也能保持轻量。

---

调试

将 config.lua 中的 Debug = true 设置为 true，以在 UE4SS 日志中记录地下城扫描摘要和生成的图标类型。这在报告错误时很有帮助。将其设置为 false 可保持安静运行。

---

兼容性

专为发布时当前的 Steam 版 Palworld 和 UE4SS 设计。未来的游戏更新可能会更改地图或地下城系统，并需要模组更新。

---

卸载

从 UE4SS Mods 目录中移除 RandomDungeonBossMarker 文件夹，并从 mods.txt 中移除其条目（如果你添加过的话）。

---

💜 支持我的工作

如果你喜欢我的模组并希望支持未来的开发，你可以在这里支持我：

https://ko-fi.com/burdock12