欢迎套件（多人游戏）

描述

首次加入服务器的玩家将获得一次私人的欢迎和一份初始物资包，每个玩家仅限一次。回归玩家则会收到问候。谁获得物资包由一个权限节点控制，默认允许。

“首次”指的是在这台服务器上的第一次，而不是本次会话的第一次——Palladium 的玩家注册表会跨越重启持续存在，所以服务器重启绝不会发放第二份物资包。中途崩溃也不会：领取标记是玩家身上的一个标志，只有每件物品真正发放到位后才会写入。

安装说明

将压缩包中的 WelcomeKit 文件夹放到 Palladium 旁边——即放入服务器的 UE4SS Mods 目录，或者如果你运行 pal-up，则放入 ./mods 目录——然后重启服务器。

这就是全部安装步骤。无需配置任何东西，无需创建令牌，无需额外进程。

要更改物资包的内容，请编辑 WelcomeKit/mod.lua 顶部的 settings：

settings = {
items = {
{ item = "PalSphere", count = 10 },
{ item = "Pan", count = 5 },
},
announce = true,
},

• items — 物资包内容。物品 ID 是游戏内部名称，而非游戏内显示名称：面包是 Pan，医疗用品是 Medicines，金币是 Money。
• announce — 设置为 false 可跳过“X 首次加入服务器”的公告。

如果不想删除模组而想停用它，在文件夹中创建一个名为 .disabled 的空文件并重启即可。

主要特性

• 仅一次，而非每次会话一次。 领取标记是玩家身上的一个标签，跨重启持续存在，因此重启、崩溃或模组的第二份副本都不会产生第二份物资包。
• 未实际到达的物资包不会被标记为已发放。 游戏会接受未知物品 ID 的授予并静默地不添加任何东西，因此每件物品在发放前后都会被计数。如果任何物品未能发放，玩家会收到提示，失败的 ID 会被写入日志，并且领取标记不会被写入——这样物品列表中的拼写错误会以投诉的形式显现，而不是静默丢失。
• 一个权限节点。 welcomekit.kit，默认允许。在 permissions.config 中为默认组拒绝该节点，并授予给某个组，即可将物资包变为一项特权。没有该节点的首次玩家仍会受到欢迎和公告——只是不会获得物品。
• 回归玩家会收到问候，而不是沉默，他们的加入次数会记录在服务器日志中。
• 一次即可读完。 整个模组只是一个简短的 Lua 文件，同时它也是编写自己的 Palladium 模组的实例教程：事件、权限、标签、设置和已验证的物品发放，全部内容约 80 行。

环境要求

Palladium — 模组框架，来自同一项目：https://github.com/s-kiu/pal-up/releases

没有其他要求。这是一个 Palladium 模组：它在游戏内运行，因此适用于任何运行 Palladium 的服务器——无需控制面板、无需 Node、无需构建步骤。如果你确实运行了 pal-up，模组和其权限节点也会显示在面板中，但面板是可选的。

GoldStreak，来自同一项目，是另一个实例教程——每第五次重生获得 50 金币。

鸣谢

感谢原生 Linux UE4SS 移植版的维护者——BlackBookOfficial，以及 Qiiks 提供的包含当前游戏版本修复的构建。没有这项工作，Linux 上的服务端模组就不存在，这里的一切都建立在其之上。

感谢 Pocketpair，制作了一款值得为其构建工具的游戏。