允许牌手兑换预制物品包

特征​

• 易于使用的 UI 菜单，用于创建和领取套件。
• 设置兑换限制以及最大使用次数、冷却时间和购买成本
• 创建需要自定义权限的 VIP 工具包
• 创建使用 Rusts 身份验证级系统的管理员工具包
• 通过在配置中指定套件列表，在死亡时提供自动套件，并使用优先级系统授予
• 与 HumanNPC 配合使用，拥有只能通过 NPC 交互获得的套件
• 通过允许套件粘贴预先创建的结构来支持 CopyPaste
• 在配置中自定义 UI 配色方案

权限​

此插件使用权限系统。要分配权限，请使用 。要删除权限，请使用 。oxide.grant <user or group> <name or steam id> <permission>oxide.revoke <user or group> <name or steam id> <permission>

• kits.admin具有此权限的玩家可以使用 admin 命令功能

命令​

此插件使用相同的语法提供聊天和控制台命令。在聊天中使用命令时，请为其添加正斜杠前缀： '/'。

玩家聊天命令​

• /kit打开套件菜单
• /kit <name>玩家用于领取指定的套件
• /kit autokit允许玩家切换是否在生成时接收幼崽。必须在配置中启用此选项

管理员聊天命令​

• /kit help显示包含所有可用命令的帮助菜单
• /kit list显示套件名称的完整列表
• /kit add/kit new开始创建新套件
• /kit edit <kitname>开始编辑以前创建的套件
• /kit remove <kitname>/kit delete <name>删除指定的套件
• /kit give <player name | player id> <kitname>给指定的玩家指定的套件
• /kit givenpc <kitname>将指定的工具包交给您当前正在查看的 NPC
• /kit reset重置所有玩家套件使用数据
• /kit resetuses <player name | player id> <kitname>重置指定套件和播放器的用途

Admin Console 命令​

• kit list列出所有套件
• kit remove <kitname>kit delete <kitname>删除指定的套件
• kit give <player name | player id> <kitname>给指定的玩家指定的套件
• kit reset重置所有玩家套件使用数据
• kit resetuses <player name | player id> <kitname>重置指定套件和播放器的用途

如何创建套件​

在开始之前，请清除您的库存并使用管理员菜单为自己提供套件中所需的所有物品。

完成后，在聊天中输入“/kit new”，或按 UI 右上角的“Create New”按钮。

您将看到以下屏幕

所有套件选项都位于左侧，项目视图位于右侧。

首先按下右下角的 “Copy From Inventory” 按钮。这会将您库存中的所有物品添加到套件中。

然后，您可以继续填写左侧的信息。

套件详细信息

• Name是套件的名称
• Description是套件描述。这不是必需参数
• Icon URL是 UI 网格中显示的工具包图像的 URL。这不是必需参数

使用权限

• Permission用于限制仅具有指定权限的玩家使用此工具包。权限应以“kits”为前缀。（例如 'kits.awesomekit'）。
• Auth Level用于限制至少具有指定身份验证级别（0 为玩家，1 为版主，2 为管理员）的玩家使用此工具包
• Is Hidden是一个切换字段。启用后，普通玩家将无法在套件网格中看到此套件

使用情况详细信息

• Maximum Uses用于指定玩家在每个擦除周期中可以领取此套件的最大次数
• Cooldown是玩家在能够再次领取此套件之前必须等待的时间（以秒为单位）
• Purchase Cost用于强制玩家付费领取套件。货币类型在配置中定义

CopyPaste 支持

• File Name是所需 CopyPaste 文件的文件名。如果提供，当玩家领取此工具包时，它将尝试生成指定的 copypaste 文件

完成后，单击屏幕左下角的“保存套件”按钮以保存套件

自动套件​

Autokit 是玩家死亡后重生时给予他们的工具包。

包含的套件将在配置文件中的“Autokit ordered by priority”下使用套件名称指定

该插件将遍历配置中指定的每个工具包，直到它可以为玩家提供一个工具包。

这些自动套件遵循与手动领取相同的兑换规则，因此它们将受到诸如时间和时间之类的事情的影响Maximum UsesCooldown

以下是配置中使用的格式示例

"Autokits ordered by priority": [
"example1",
"example2",
"example3"
],

点击展开...

NPC 工具包​

该插件支持通过 NPC 供应商从 HumanNPC 插件中领取工具包。

每个 NPC 都可以配置不同的工具包，当玩家与 NPC 互动时，工具包菜单会呈现给他们，其中包含配置中指定的工具包

config 中的示例显示了如何进行设置。

您可以指定哪些套件可通过 NPC 获得，并在与它们交互时指定基于聊天的响应

第一个参数是 NPC 用户 ID

"Kit menu items when opened via HumanNPC (NPC user ID | Items)": {
"0": {
"The list of kits that can be claimed from this NPC": [
"ExampleKitName",
"OtherKitName"
],
"The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
},
"1111": {
"The list of kits that can be claimed from this NPC": [
"ExampleKitName",
"OtherKitName"
],
"The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
}
},

点击展开...

套件日志记录​

配置中有一个标题为“Log kits given”的选项。当玩家兑换套件时，它会被记录到 /oxide/log/Kits/Kits_Received

点击展开...

配置​

设置和选项可以在目录下的文件中进行配置。建议使用编辑器和验证器，以避免格式问题和语法错误。Kitsconfig
{
"Kit chat command": "kit",
"Currency used for purchase costs (Scrap, Economics, ServerRewards)": "Scrap",
"Log kits given": false,
"Wipe player data when the server is wiped": false,
"Use the Kits UI menu": true,
"Allow players to toggle auto-kits on spawn": false,
"Show kits with permissions assigned to players without the permission": false,
"Players with the admin permission ignore usage restrictions": false,
"Autokits ordered by priority": [
"ExampleKitName",
"OtherKitName"
],
"Post wipe cooldowns (kit name | seconds)": {
"ExampleKitName": 3600,
"OtherKitName": 600
},
"Parameters used when pasting a building via CopyPaste": [
"deployables",
"true",
"inventories",
"true"
],
"UI Options": {
"Panel Color": {
"Hex": "#232323",
"Alpha": 1.0
},
"Disabled Color": {
"Hex": "#3e3e42",
"Alpha": 1.0
},
"Color 1": {
"Hex": "#007acc",
"Alpha": 1.0
},
"Color 2": {
"Hex": "#6a8b38",
"Alpha": 1.0
},
"Color 3": {
"Hex": "#d85540",
"Alpha": 1.0
},
"Color 4": {
"Hex": "#d08822",
"Alpha": 1.0
},
"Default kit image URL": "https://chaoscode.io/oxide/Images/kiticon.png",
"View kit icon URL": "https://chaoscode.io/oxide/Images/magnifyingglass.png"
},
"Kit menu items when opened via HumanNPC (NPC user ID | Items)": {
"0": {
"The list of kits that can be claimed from this NPC": [
"ExampleKitName",
"OtherKitName"
],
"The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
},
"1111": {
"The list of kits that can be claimed from this NPC": [
"ExampleKitName",
"OtherKitName"
],
"The NPC's response to opening their kit menu": "Welcome to this server! Here are some free kits you can claim"
}
},
"Version": {
"Major": 4,
"Minor": 0,
"Patch": 15
}
}

点击展开...

对于开发人员​

钩​

// Return any non-null value to abort redeeming of kit.
// Player notification as to why it was aborted should be handled
// from the plugin that is cancelling it
object CanRedeemKit( BasePlayer player )
// Return any non-null value to abort redeeming of a auto kit.
object CanRedeemAutoKit( BasePlayer player )
// Called when a player claims a kit
void OnKitRedeemed(BasePlayer player, string kitName)

应用程序接口​

点击展开...

// Give a kit to the target player.
// Returns a (string) message if unsuccessful, or (bool) true if successful
object GiveKit(BasePlayer player, string name)
// Returns true if the specified kit exists, otherwise returns false
bool IsKit(string name)
// Add all available kit names to the provided list
void GetKitNames(List<string> list)
// Returns the kit image URL if specified in the kit data
// else returns a empty string
string GetKitImage(string name)
// Returns the kit description if specified in the kit data
// else returns a empty string
string GetKitDescription(string name)
// Returns the kit maximum uses per player if specified in the kit data
// else returns 0
int GetKitMaxUses(string name)
// Returns the kit cooldown time (seconds) if specified in the kit data
// else returns 0
int GetKitCooldown(string name)
// Returns the number of time the specified player has used the specified kit
int GetPlayerKitUses(ulong playerId, string name)
// Allows you to set the specified players number of uses of the specified kit
void SetPlayerKitUses(ulong playerId, string name, int amount)
// Returns the remaining cooldown time (seconds) of the
// specified kit for the specified player
double GetPlayerKitCooldown(ulong playerId, string name)
// Allows you to set the remaining cooldown time of the specified kit
// for the specified player
void SetPlayerCooldown(ulong playerId, string name, double seconds)
// Returns a JObject of the kits data.
// Look at the implementation in the plugin to see the data structure
JObject GetKitObject(string name)

Copy
// Returns an enumerator that creates the items in the specified kit
IEnumerable<Item> CreateKitItems(string name)

点击展开...