MANCOS 世界入门套件

🌍 Mancos World 新手礼包模组

厌倦了从零开始，必须徒手敲树的苦日子？这个模组就是为你（以及你那些"手残"朋友们）准备的！

**Mancos World 新手礼包**（Mancos World Starter Kit）是一个服务端模组（*server-side*），旨在玩家一进入世界时就发放一套基础装备。它既能完美适配单人游戏，也能用于**公共和私有专用服务器**。此外，它还配备了智能重试系统，即使服务器出现延迟或角色（*Pawn*）加载缓慢，也能确保玩家收到物品。

---

## ⚠️ 前置要求

要让此模组运行，**必须**在服务器或游戏中安装 **UE4SS**（虚幻引擎 4/5 脚本系统）。

---

## ✨ 主要特点

* **保证送达：** 模组会在尝试发放礼包前等待初始的 5 秒（5000 毫秒）。如果玩家尚未完全加载，它将每 2 秒（2000 毫秒）重试一次发放，最多重试 15 次。
* **防错误系统：** 在系统确认至少成功发放一件物品之前，`claimed_players.txt` 文件不会被标记为已完成。确保没有人会错过他们的初始战利品！
* **100% 可配置：** 你可以轻松地通过配置文件更改等待时间、重试次数以及完整的物品列表。

---

## 🎒 初始礼包内容（默认）

首次进入时，你将自动收到以下装备：
* 30x 帕鲁球（PalSphere）
* 100x 箭矢（Arrow）
* 1x Axe_Tier_00（斧头）
* 1x Pickaxe_Tier_00（镐子）
* 1x Sword_4（剑）
* 1x WeakerBow_4（弓）
* 1x ClothArmor_4（布甲）
* 1x Torch（火把）

---

## 🛠️ 安装方法

1. 确保你的服务器/游戏已安装 **UE4SS**。
2. 下载模组文件。
3. 解压内容并复制 `MancosWorldStarterKit` 文件夹。
4. 将该文件夹粘贴到你的 UE4SS 安装目录的 mods 文件夹中（服务器上的路径通常为：`Pal\Binaries\Win64\Mods`）。
5. 确保模组文件夹内存在 `enabled.txt` 文件，以便 UE4SS 正确加载它。
6. 启动服务器，尽情享受吧！

---

## ⚙️ 配置说明（添加或移除物品）

如果你想自定义自己的礼包，或调整加载时间以适应你的服务器，你可以通过编辑位于 `Scripts` 文件夹内的 `config.lua` 文件轻松实现。

* 你可以使用任何基础文本编辑器（如 Notepad++、Visual Studio Code 或 Windows 记事本）打开此文件。
* 该文件本身包含详细的分步说明，教你如何修改数量、调整时间或使用内部 ID 添加新物品，所有这些都不会有损坏模组的风险。

版本 1.1 - 关键稳定性更新（告别崩溃！）
已修复崩溃：修复了向刚连接的玩家发放礼包可能导致专用服务器随机崩溃的问题。

分批发货：现在物品会一个一个地发放，中间有短暂的时间间隔，让服务器能够处理而不至于过载。

库存检查：脚本现在会耐心等待并验证（3 次）玩家背包是否 100% 加载到内存中，然后才给予任何物品。

性能改进：移除了后台的繁重扫描，使模组更加轻量化和优化。

重要提示：更新时，请同时替换 `main.lua` 和 `config.lua`。你的 `claimed_players.txt` 文件是安全的，因此已经获得礼包的玩家不会重复领取！