新手加速

StarterBoost 是一个可配置的初始礼包系统，适用于运行 UE4SS 的 [b]Palworld 专用服务器[/b]。
它会自动向新玩家发放一组预定义物品和可选的初始帕鲁，同时持久记录哪些玩家已经领取过礼包。
目标很简单：提供可控的前期加速，而无需管理员手动给每个新玩家发放物品或帕鲁。
[line]
[heading]主要功能[/heading]
[list]
[]自动发放初始礼包[/]
[]服务端执行[/]
[]按玩家持久化记录发放状态[/]
[]可配置物品 ID[/]
[]可配置物品数量[/]
[]多个初始帕鲁[/]
[]每个帕鲁可单独配置等级[/]
[]最多 5 个初始帕鲁[/]
[]帕鲁会直接加入玩家的队伍[/]
[]防止重连时重复发放[/]
[]防止服务器重启后重复发放[/]
[]物品与帕鲁独立持久化[/]
[]简单的 Lua 配置[/]
[/list][line]
[heading]工作原理[/heading]
当玩家加入时：
[code]玩家加入
↓ StarterBoost 读取玩家 UID
↓ 检查持久化发放状态
↓ 物品是否已发放？
↓ 否 → 发放配置的物品
↓ 帕鲁是否已发放？
↓ 否 → 发放配置的帕鲁
↓ 保存发放状态[/code]之后的登录：
[code]玩家 UID 已注册
↓ 跳过已完成的初始礼包部分[/code]这同样意味着，如果物品发放成功但帕鲁发放失败，StarterBoost 可以只重试缺失的帕鲁部分，而不会再次发放物品。
[line]
[heading]需求[/heading]
[list]
[]Palworld 专用服务器[/]
[]UE4SS[/]
[/list]StarterBoost 设计为在 [b]服务端[/b] 运行。
[line]
[heading]安装[/heading]
将模组解压到你的 UE4SS 模组目录。
示例：
[code]PalServer/
└── Mods/
└── NativeMods/
└── UE4SS/
└── Mods/
└── StarterBoost/
├── enabled.txt
└── Scripts/
├── main.lua
├── config.lua
├── give_starter_pal.lua
└── starter_state.lua[/code]安装模组后，启动或重启专用服务器。
[line]
[heading]配置[/heading]
所有常规配置位于：
[code]StarterBoost/Scripts/config.lua[/code]物品
[code]Config.Items = {
{ ItemID = "Wood", Amount = 15 },
{ ItemID = "Stone", Amount = 15 },
{ ItemID = "PalSphere", Amount = 15 }
}[/code]格式：
[code]{
ItemID = "InternalItemID",
Amount = 1
}[/code]你可以添加任意数量的物品条目，不过在创建非常庞大的礼包时，仍应考虑背包空间和正常游戏行为。
[line]
[heading]初始帕鲁[/heading]
[code]Config.StarterPal = {
{ PalID = "PinkCat", Level = 5 },
{ PalID = "Garm", Level = 5 }
}[/code]格式：
[code]{
PalID = "InternalPalID",
Level = 5
}[/code]StarterBoost 最多支持 [b]5 个初始帕鲁[/b]。
该限制是有意设计的，以防止过大的初始奖励，并保持与正常出战队伍规模兼容。
[line]
[heading]帕鲁选项[/heading]
[code]Config.StarterPalOptions = {
Enabled = true,
MaxPals = 5,
FirstCheckDelayMs = 150,
BetweenPalsDelayMs = 100,
UidRetryDelayMs = 100,
UidMaxAttempts = 20
}[/code][code]MaxPals[/code] 可以设置为低于 5，如果你想要更小的初始队伍。
高于 5 的数值会自动限制为 5。
[line]
[heading]持久化[/heading]
StarterBoost 会创建一个持久化文件，例如：
[code]starterboost_delivered.txt[/code]该文件记录与每个玩家 UID 关联的发放状态。
示例概念：
[code]PlayerUID|items=1|pals=PinkCat@5#1,Garm@5#1[/code]这使 StarterBoost 能够确定初始礼包中哪些部分已经成功发放。
不要在生产服务器上删除此文件，除非你有意让玩家再次有资格领取初始礼包。
[line]
[heading]更新初始礼包[/heading]
更改配置不会自动重置现有玩家。
已记录为收到初始礼包特定部分的玩家仍会保持记录。
对于全新的服务器，只需在向玩家开放服务器之前配置好你想要的初始礼包即可。
[line]
[heading]注意事项[/heading]
[list]
[]使用有效的 Palworld 内部 ID。[/]
[]无效的物品 ID 可能无法生成预期的物品。[/]
[]无效的帕鲁 ID 可能导致该帕鲁无法创建。[/]
[]StarterBoost 最多发放 5 个帕鲁。[/]
[]在部署到线上服务器之前，先测试重大配置更改。[/]
[]在安装或更新任何服务端模组之前，备份你的服务器。[/]
[/list]

[center][b][i]代码在 AI 协助下创建。 [/i][/b][/center]