### 【模组详细说明与实操指南】
# 保留项目插槽核心
**所有ReservedItemSlot mods的核心mod。**<br><br>
我的 ReserveItemSlot 模组(例如 ReserveFlashlightSlot 和 ReserveWalkieSlot)需要此模组才能工作。<br>
这些模组将为您提供各自物品的免费专用库存槽位。这些插槽将显示在屏幕右侧,垂直堆叠。<br>
您无法通过滚动手动切换到这些插槽。相反,切换到这些项目的方法是按住 Alt(默认热键),然后上下滚动以在它们之间切换。<br>
这样,您就可以交换这些物品来放下它们,以及其他操作,例如充电、存储等。<br>
抓取保留项目,以及在主热栏和保留热栏插槽之间切换应该在使用此模组的客户端之间同步。<br>
如果相关的话,这些模组将有专用的按键绑定来激活这些项目,而无需当前选择它们。<br>
<strong>运行此核心模组的所有客户端都将与主机同步,并具有与它们相同的保留项目插槽,无论他们安装了哪个保留项目插槽模组。</strong><br>
使用主机上的保留项目插槽来安装您没有的模组不会导致问题,但您不会从它们的额外模组功能中受益,例如保留项目的特定热键,并且当玩家当前未持有这些保留项目时,您不会在玩家身上看到这些保留项目。<br>
这可能会改变,或者在将来进行调整,但目前它是为了尝试使每个人的库存保持相同的大小以帮助同步。<br>
如果我最终添加了在配置中创建自定义保留项目插槽的功能,或者如果我最终创建了一个ReservedCustomItemSlot mod(这将是一个服务器端mod),这也可以帮助从主机向其他客户端发送自定义保留项目插槽。<br>
**~在主机没有该模组的情况下使用该模组已被重新允许,但预计会出现错误和不同步问题。谨慎使用!~**<br>
**如果主机由于各种原因没有此模组,则该模组将再次对非主机客户端禁用。**<br>
**对于那些足够顽固的人,可以在配置中强制允许这一点。您已收到警告!**<br><br>
## 购买预留物品槽位(2.0.0 中的新增功能)
+ 预留的物品槽位可以在终端购买。截至目前,购买预留的物品槽位将为每个玩家解锁该槽位。目前没有选项可以将其设置为按个人解锁。<br>
+ 您可以在终端中输入“reserved”来查看有关如何购买预留物品栏的提示。
+ 对于支持此功能的预留物品插槽模组,可以在配置中调整价格。 *我*制作的所有保留物品槽位都有这些配置。
+ 购买的物品槽位将保存到您的游戏存档中。退出并重新加载保存*应该*重新加载所有先前解锁的项目插槽。解锁的插槽将在开始新游戏时重置。
+ 可以在配置中禁用购买物品槽。<br><br>
## 可配置
+ **以下每个配置都需要得到每个预留物品槽模组的支持。**
+ 添加支持以允许保留物品栏模组在配置中调整其物品栏的**价格**。
+ 添加支持以允许保留物品栏模组调整配置中物品栏的**优先级**。<br>
优先级越高,它们在屏幕右侧的顺序越靠后。<br>
负优先级将强制项目槽出现在屏幕的右侧,除非在配置中禁用此功能。
+ 添加了对向配置中的保留插槽添加额外项目的支持。
+ 添加了对从配置中的保留槽中删除现有项目的支持。<br><br>
## 支持输入实用程序
+ 该模组的任何相关热键都可以在游戏内的按键绑定菜单中进行管理。
+ InputUtils不是依赖项,但推荐使用!<br><br>
## 兼容 LCVR
+ Players running the LCVR mod AND are in VR mode will be able to scroll to the reserved item slots hotbar by scrolling.
+ 这些玩家将禁用所有用于与保留物品槽交换的按键绑定。
+ 出于技术原因,如果 LCVR 已启用,则在保留的物品槽中的物品之间交换不会像通常那样跳过空槽。这适用于*所有*玩家,而不仅仅是那些处于 VR 模式的玩家。
+ 如果此兼容有任何问题,例如不同步,请在 mod 的 github 页面上告诉我。谢谢你!
## API 支持(示例如下)
+ 添加 API 功能,供开发人员用来轻松创建自己的预留物品栏 mod,或将其物品添加到现有的预留物品栏。
+ 为特定项目创建预留项目数据时,开发人员可以选择指定目标骨骼以将项目放置在玩家(和蒙面敌人)上,以及设置位置/旋转偏移。<br><br>
## 我的预留物品槽模组
+ Thunderstore 上的其他人可能存在更多保留项目插槽模组!
<br><br>
## 模组兼容性
+ HotbarPlus 兼容!
+ LethalThings 实用腰带是(或应该)兼容的! (希望保持这种状态)
+ 已知 LethalProgression 会在客户端之间同步项目槽时导致一些问题和错误。 (然而,并不总是发生。不确定为什么会发生这种情况)
+ <strong>此模组可能无法与 Advanced Company 配合使用。使用风险自负!</strong>
+ 其他可以添加热栏插槽的模组不保证正常工作。
+ 其他可能重新排列热栏插槽(HUD)的模组不能保证与这些模组很好地配合,但*可能*在技术上可行。
<br><br>
## 如果您读到这里并且喜欢我的模组
请考虑支持我[这里]()!<br>
绝对不需要,但我们将不胜感激! =)<br>
<br><br>
## API 示例
#### 首先,确保将最新的 ReserveItemSlotCore.dll 添加到 VS 项目的引用中。
#### 笔记
+ 将不存在的项目(无论是错误的还是未加载的 mod 中的项目)添加到 ReserveItemSlotData 不会破坏任何内容。<br>
+ 将项目添加到现有的 ReserveItemSlotData(从未加载的 mod 创建的)中不会破坏任何内容。
<br><br>
### 将 mod 的物品添加到现有的预留物品栏
这将用于将您的 mod 中的项目添加到由另一个 mod 创建的现有保留项目插槽,并且如果启用了 ReserveItemSlotCore。<br>
**在单独的文件中创建与此类似的类。**
``csharp
使用ReservedItemSlotCore.Data;
公共静态类ReservedItemSlotsCompat
{
公共静态无效 AddItemsToReservedItemSlots()
{
// 游戏中出现的物品名称
ReserveItemData myReservedItemData = new ReserveItemData("ItemDisplayName");
// 如果客户端上未启用创建此项目槽的 mod,也没关系。没有什么会破坏的
ReserveItemSlotData.TryAddItemDataToReservedItemSlot(myReservedItemData, "nameOfItemSlot");
}
}
````
<br>
**或者允许您的物品在装在皮套中时被看到:**
<br>
```csharp
using ReservedItemSlotCore.Data;
公共静态类ReservedItemSlotsCompat
{
公共静态无效 AddItemsToReservedItemSlots()
{
// 参数:ItemDisplayName、ParentBone(枚举)、PositionOffset、RotationOffset
ReserveItemData myReservedItemData = new ReserveItemData("ItemDisplayName", PlayerBone.Spine3, new Vector3(0.2f, 0.25f, 0), new Vector3(90, 0, 0));
// 如果客户端上未启用创建此项目槽的 mod,也没关系。没有什么会破坏的
ReserveItemSlotData.TryAddItemDataToReservedItemSlot(myReservedItemData, "nameOfItemSlot");
}
}
````
<br>
**并在插件类的 Awake(或 Start)方法中添加以下内容:(最好在绑定配置之后)**<br>
**如果您的mod不依赖于ReservedItemSlotCore,并且仅可选择将您的物品添加到保留物品槽(如果存在),那么检查此mod是否启用非常重要!**
``csharp
if (BepInEx.Bootstrap.Chainloader.PluginInfos.ContainsKey("FlipMods.ReservedItemSlotCore"))
ReserveItemSlotsCompat.AddItemsToReservedItemSlots(); // 这将是对您的函数的调用
````
<br>
**最后但并非最不重要的一点是,将此 SoftDependency 标头添加到您的插件类定义上方**<br>
如果您的 mod *确实* 依赖于 ReserveItemSlotCore,那么您可以将 `BepInDependency.DependencyFlags.SoftDependency` 更改为 `BepInDependency.DependencyFlags.HardDependency`。
``csharp
[BepInDependency("FlipMods.ReservedItemSlotCore", BepInDependency.DependencyFlags.SoftDependency)] // 添加这一行
[BepInPlugin("EXAMPLE_MOD_GUID", "EXAMPLE_MOD_NAME", "1.0.0")] // 您的插件类定义上方应该已经有此行。
公共类插件:BaseUnityPlugin
{
...
}
````
<br>
### 创建您自己的ReservedItemSlot
**创建您自己的 ReserveItemSlotData 并将 mod 的物品(或游戏中的现有物品)添加到您的物品槽的示例。**<br>
将此代码包含在插件类的 Awake(或 Start)方法中。添加此代码时,您*不需要*创建单独的文件或类。
``csharp
使用ReservedItemSlotCore.Data;
// 确保将此标头放在您的插件类之上
[BepInDependency("FlipMods.ReservedItemSlotCore", BepInDependency.DependencyFlags.HardDependency)]
[BepInPlugin("EXAMPLE_MOD_GUID", "EXAMPLE_MOD_NAME", "1.0.0")] // 您的插件类定义上方应该已经有此行。
公共类插件:BaseUnityPlugin
{
私有无效唤醒()
{
// 您现有的代码...
//这将注册您的ReservedItemSlotData,并且如果主机正在运行mod,则会将其添加到游戏中
// 参数:ItemSlotName(格式不太重要)、ItemSlotPriority、ItemSlotPrice
ReserveItemSlotData myReservedItemSlot = ReserveItemSlotData.CreateReservedItemSlotData("my_item_slot_name", 20, 100);
// 为您的商品创建预留商品数据
// 您还可以添加额外的参数,以允许该物品在玩家被套在皮套上时显示。 (参考前面的例子)
ReserveItemData myReservedItemData = new ReserveItemData("ItemDisplayName");
// 将ReservedItemData 添加到您的ReservedItemSlotData 中,就完成了!
myReservedItemSlot.AddItemToReservedItemSlot(myReservedItemData);
}
}
````
<br>
### 更多API函数
这些是有关如何获取和管理玩家持有的保留物品的一些示例。
``csharp
PlayerControllerB localPlayerController = StartOfRound.Instance.localPlayerController;
for (int i = 0; i < SessionManager.numReservedItemSlotsUnlocked; i++)
{
ReserveItemSlotData itemSlotData = SessionManager.GetUnlockedReservedItemSlot(i);
if (itemSlotData != null)
{
// 获取该物品栏在玩家物品栏中的索引
int indexInPlayerInventory = itemSlotData.GetIndexInInventory(localPlayerController); // 可以传入任何玩家控制器
// 获取指定玩家当前在该槽中持有的对象,否则返回 null
GrabbableObjectheldObjectInSlot = itemSlotData.GetHeldObjectInSlot(localPlayerController);
// 获取该项目槽的项目槽框架(HUD 中的图像组件)。只适用于本地玩家
图像 itemSlotFrameHUD = itemSlotData.GetItemSlotFrameHUD();
// 用于检查预留的物品栏是否接受特定物品(游戏中出现的物品名称)
// 你也可以传入一个 GrabbableObject 引用
if (itemSlotData.ContainsItem("手电筒"))
Plugin.Log("该插槽包含手电筒");
}
}
````
<br>
如果创建您自己的 ReserveItemSlotData,请务必将此行包含在您的 manifest.json 文件的依赖项列表中。<br>
`“FlipMods-ReservedItemSlotCore-2.0.7”`<br><br>
如果您想查看更多示例,请随时查看我的 github 上现有的 ReserveItemSlot mods!<br>
如果您觉得我错过了什么,或者遇到任何问题,请告诉我!我在 Lethal Company Modding 不和谐中相当活跃,所以来找我吧!<br>
您也可以在 github 上发布此 mod 的任何问题!<br>
### 【联机规则与注意事项】
* **联机兼容性**:【开黑全员需装】(涉及联机机制、地图或实体同步,建议房间内所有开黑好友安装同版本)
* **前置依赖需求**:BepInEx-BepInExPack-5.4.2100
* **当前模组版本**:`2.0.55`
* **适配版本**:针对《致命公司》2026 最新稳定版(v68+)整理适配