特征​

• GUI 奖励商店
• 购买项目、工具包和命令
• 使用内置货币兑换器（需要 Economics）将奖励积分 （RP） 兑换成 Economics 货币（反之亦然）
• 为您的套件/命令添加描述
• 将图片添加到您的项目
• 向 1 次购买添加多个命令（数据文件布局见下文）
• 项目商店每页可以容纳 21 个项目，也可以根据需要添加任意数量的页面
• 定价仅使用 RP;添加了经济货币作为兑换积分以用于 GUI Shop 的手段
• 可选择停用任何类别的奖励
• 创建自定义权限，为 VIP 提供更多游戏时间积分
• 记录所有添加和花费的积分以打击骗子
• NPC 奖励经销商
• 将单个商店列表分配给 NPC

玩家可以使用奖励积分 （RP） 通过奖励商店购买工具包/物品或命令。

添加套件​

要将套件添加到奖励商店，您必须首先使用 Kits 插件创建套件。完成此操作后，就像编写聊天命令一样简单。

前任。 - 是商店的名称，是套件的名称，是 RP 中的价格/rewards add kit <name> <kitname> <cost><name><kitname><cost>

这也可以通过使用具有相同语法的 console 命令来实现：完成该步骤后，您还可以添加描述（如果需要）。这可以通过提供的 “edit” 聊天或控制台命令来完成（见下文）。或者，您可以通过在配置的 UIOption 部分中启用“Display kit contents as the description”来使用工具包的内容生成描述。

添加项​

将商品添加到奖励商店很简单。生成您要使用的物品，将其放在您的手中，然后键入聊天命令。

前任。 - 这会将您手中的物品以 RP 价格 添加到奖励商店中。它还将节省商品的数量和皮肤，因此在添加价格时请记住这一点/rewards add item <cost><cost>

- 通过控制台命令通过控制台命令添加项目的语法如下;如果我想添加一把 10RP 的突击步枪，我会像这样输入 - “rewards add item rifle.ak 0 1 10”*注意 - 物品将自动排序到适当的类别中！rewards add item <shortname> <skinId> <amount> <cost>

添加命令​

要添加命令，请使用 chat 命令添加带有变量的控制台命令。

前任。 - 是商店中的名称，是您要运行的聊天命令，是 RP 中的价格。/rewards add command <name> <command> <cost><name><command><cost>

这也可以通过使用具有相同语法的 console 命令来实现。完成后，您可以使用提供的命令添加描述（请参阅下文）

命令的一个示例是 “say RockOn！， $player.name！”，它将使玩家说 RockOn！

您可以在命令中使用的当前变量包括：

$player.name - Player display name
$player.id - Player Steam ID
$player.x, $player.y, $player.z - Vector3 coordinates
要在此购买中添加或删除命令，您可以使用提供的命令（见下文）。确保输入的所有命令都在引号内！

为您的商店商品添加描述和图片要添加描述和图像（仅对套件和命令），您必须使用提供的命令

如何添加/删除 NPC 奖励经销商

• 站在您要添加或删除的 NPC 面前
• 键入“/srnpc add”进行添加，或键入“/srnpc remove”进行删除
• 然后系统会提示您“使用”NPC（默认为 E）
• 您“使用”的下一个 NPC 将是受影响的 NPC

如何将自定义战利品表添加到 NPC 奖励经销商

• 站在你想要添加的 NPC 面前
• 键入 '/srnpc loot'
• 在您要编辑的 NPC 上按“使用”键。
• 将弹出一个 GUI，只需选择您希望此 NPC 出售的物品/工具包/命令，然后按保存即可

如何激活待售商品（需要编辑数据文件）

• 加载时，您的服务器将生成一个数据文件。它可以在“oxide/data/ServerRewards/”文件夹中找到，并被命名为“sale_data.json”
• 在此文件中，您将看到游戏内每个物品和皮肤的条目。此列表将随着新项目或皮肤的添加而自动更新
• 下面是一个示例。销售价格是每单位的价格！所以 1 个木头、1 个石头、1 把突击步枪等。该价格乘以用户希望出售的金额
• 只需将商品的 “price” 调整到您想要的数量，并将 “enabled” 设置为 true

"rifle.ak": { // This is the items shortname. Below this you will find all recorded skin ID's for this item with their own sale price, name, and status
"0": { // This is the skin ID of this item
"price": 0.0, // The price per unit it sells for
"displayName": "Assault Rifle", // The name displayed in the sell menu
"enabled": false // Whether or not this item can be sold in the sell menu
},
"10135": {
"price": 0.0,
"displayName": "Digital Camo AK47",
"enabled": false
},
"10137": {
"price": 0.0,
"displayName": "Military Camo AK47",
"enabled": false
},
"10138": {
"price": 0.0,
"displayName": "Tempered AK47",
"enabled": false
}
},

点击展开...

Lusty 地图图标​

支持通过 LustyMap 在此经销商位置添加地图图标。要添加图标，只需在添加新 NPC 之前将图标图像放在文件夹中即可。此文件必须是 name 。该图标将自动加载到 LustyMap 中。这是一个可以使用的简单图标，或者您可以创建自己的图标。data/LustyMap/customrewarddealer.png

伐木​

点日志可以在 下找到。它显示所有已添加和花费的积分，它将记录玩家姓名（如果在线）和 Steam ID、时间和添加/减去的积分数量logs/ServerRewards_RP_Log.txt

聊天命令​

• /rewards check- 显示当前奖励积分和在服务器上玩的总时间
• /s- 打开奖励商店

管理员命令​

• /rewards add kit <name> <kitname> <cost>- 将新套件添加到奖励商店。
• /rewards add item <cost> <opt:bp>- 将新物品添加到奖励商店（在命令末尾添加“bp”以使该物品成为蓝图）。
• /rewards add command <name> <command> <cost>- 向奖励商店添加新命令。
• /rewards edit kit <ID> <cost|description|name|icon|cooldown>- 编辑指定奖励工具包的信息
• /rewards edit item<ID> <cost|amount|icon|cooldown>- 编辑指定奖励工具包的信息
• /rewards edit command<ID> <cost|description|name|icon|add|remove|cooldown>- 编辑指定奖励工具包的信息
• /rewards remove kit <name>- 从奖励商店中删除套件。
• /rewards remove item <name>- 从奖励商店中删除套件。
• /rewards remove command <name>- 从奖励商店中删除套件。
• /rewards list <items|commands|kits>- 列出指定类型的所有奖励，以及它们在控制台中的特定 ID。

手动 RP 添加、扣除、检查

• /sr add <playername> <amount>- 向玩家个人资料添加积分
• /sr take <playername> <amount>- 从玩家个人资料中减去分数
• /sr clear <playername>- 删除玩家奖励资料
• /sr check<playername>- 显示玩家积分

---- NPC 经销商 ----

• /srnpc add- 将您正在查看的 NPC 添加到奖励经销商列表中
• /srnpc remove- 从 Reward Dealer 列表中删除您正在查看的 NPC
• /srnpc loot- 为 NPC 创建或替换自定义战利品列表

控制台命令​

• sr add <playername> <amount>- 见上文^
• sr take <playername> <amount> ^^
• sr clear <playername> ^^
• sr check <playername> ^^
• rewards add kit <name> <kitname> <cost>- 将新套件添加到奖励商店。
• rewards add item <shortname> <skinId> <amount> <cost> <opt:bp>- 将新物品添加到奖励商店（在命令末尾添加“bp”以使该物品成为蓝图）。
• rewards add command "name" "command" <cost>- 向奖励商店添加新命令。
• rewards edit kit <ID> <cost|description|name|icon|cooldown>- 编辑指定奖励工具包的信息
• rewards edit item<ID> <cost|amount|icon|cooldown>- 编辑指定奖励工具包的信息
• rewards edit command<ID> <cost|description|name|icon|add|remove|cooldown>- 编辑指定奖励工具包的信息
• rewards remove kit <name>- 从奖励商店中删除套件。
• rewards remove item <name>- 从奖励商店中删除套件。
• rewards remove command <name>- 从奖励商店中删除套件。
• /rewards list <items|commands|kits>- 列出指定类型的所有奖励，以及它们在控制台中的特定 ID。

配置​

设置和选项可以在目录下的文件中进行配置。建议使用编辑器和验证器，以避免格式问题和语法错误。ServerRewardsconfig
{
"Active categories (global)": { // Enable or disable tabs from being displayed
"Show commands tab": true,
"Show exchange tab": true,
"Show items tab": true,
"Show kits tab": true,
"Show seller tab": true,
"Show transfer tab": true
},
"Coloring": { // Change text and UI coloring
"Background color": {
"Hex color": "#2a2a2a",
"Transparency (0 - 1)": 0.98
},
"Button color - accept": {
"Hex color": "#00cd00",
"Transparency (0 - 1)": 0.9
},
"Button color - inactive": {
"Hex color": "#a8a8a8",
"Transparency (0 - 1)": 0.9
},
"Button color - standard": {
"Hex color": "#2a2a2a",
"Transparency (0 - 1)": 0.9
},
"Primary panel color": {
"Hex color": "#696969",
"Transparency (0 - 1)": 0.3
},
"Primary text color": "#ce422b",
"Secondary panel color": {
"Hex color": "#373737",
"Transparency (0 - 1)": 0.98
},
"Secondary text color": "#939393"
},
"Currency exchange rates": { // Currency exchange rates
"Value of Economics": 100,
"Value of RP": 1
},
"Options": {
"Data save interval": 600,
"Log all transactions": true,
"Use NPC dealers only": false
},
"UI Options": {
"Disable fade in effect": true,
"Display kit contents as the description": true,
"Display user playtime": true
}
}

点击展开...

地方化​

默认消息位于目录下的文件中。要添加对其他语言的支持，请创建一个新的语言文件夹（例如 对于德语），请将默认语言文件复制到新文件夹，然后自定义消息。ServerRewardslang/ende

点击展开...

开发人员 API​

object AddPoints(ulong playerID, int amount) // Returns true if successful, otherwise returns null
object TakePoints(ulong playerID, int amount) // Returns true if successful, otherwise returns null
object object CheckPoints(ulong ID) // Returns int, or null if no data is saved

点击展开...

API 示例​

[PluginReference]
private Plugin ServerRewards;

private void ExampleFunction(BasePlayer player)
{
ServerRewards?.Call("AddPoints", player.userID, 5);
ServerRewards?.Call("TakePoints", player.userID, 5);
}

点击展开...