搬运 Spawn Modular CarSpawn模块化车 v2.3.0

SpawnModularCar允许玩家生成模块化汽车。每个玩家一次只能拥有一辆汽车。

指令
该插件使用相同的语法提供聊天和控制台命令。在聊天中使用命令时，请在命令前加上一个斜杠“ /”。
生成命令

• mycar -如果保存，则使用“默认”预设来生成模块化车，否则根据您的许可生成具有最大允许插槽数的随机车。
• mycar <2|3|4> -使用指定数量的插座生成随机的模块化汽车。
• mycar <name>-从指定的个人预设生成模块化汽车。有关更多详细信息，请参见个人预设部分。
• mycar common <name>-从特权管理员管理的通用预设中生成模块化汽车。有关更多详细信息，请参见“通用预设”部分。
• givecar <player> <preset>-使用指定的服务器范围内的预设为目标玩家生成一辆汽车。有关详细信息，请参见服务器预设配置部分。

当生成模块化汽车时，它将处于完全健康状态。此外，取决于您授予的权限和个人设置：

• 可能会加油（量是可配置的）。
• 它可能会自动具有密码锁。
• 它可能会自动具有钥匙锁，并向您的库存添加匹配的钥匙。
• 所有加油机模块可能会自动充满淡水（数量可配置）。
• 所有引擎模块可能会自动填充您所允许的最高质量的引擎组件。

其他命令

• mycar fix-修理你的车。这将恢复其原来的状态，就像你刚刚产生了它，不同之处在于它不会将您的添加或删除锁定，不管AutoCodeLock或AutoKeyLock设置。发动机部件也将被维修。如果被授予任何spawnmodularcar.engineparts.*权限，则会添加缺少的引擎组件，并以允许的最高质量替换质量较低的组件。注意：如果汽车“已死”（每个模块的健康状况为0），此命令将无法恢复。
• mycar fetch -将汽车以直立的姿势传送给您。
• mycar destroy -销毁您的汽车，让您产生新的汽车。
  • 非空存储模块会将装有其物品的行李放在汽车所在的位置附近。
  • 如果汽车的发动机模块包含的质量比您spawnmodularcar.engineparts.*允许的质量高，那么如果有空间，这些部件将添加到您的库存中，否则将掉落在您面前。
• mycar help-打印可用命令及其用法的列表。仅显示您的权限允许的命令。

个人预设
拥有spawnmodularcar.presets权限的玩家可以保存自定义模块配置，允许他们生成汽车或使用已保存的预设就地更改汽车。

• mycar list -列出您保存的模块配置预设。
• mycar save <name> -使用指定的预设名称保存汽车的当前模块配置。
• mycar update <name> -用汽车的当前模块配置覆盖现有预设。
• mycar load <name>-将指定的预设（支持部分名称匹配）加载到现有汽车上，替换与该预设不匹配的所有模块。如果您当前的汽车已被占用，或者插座的数量与预设不同，则不允许加载预设。
  • 汽车将按照与相同的规则进行固定mycar fix。
  • 如果汽车不再具有至少一个驾驶舱模块，则将取消汽车的锁。
  • 更换后的非空存储模块会将带有其物品的袋子放到汽车旁边。
  • 质量超出您spawnmodularcar.engineparts.*许可权限的任何引擎组件都将在已加载的预设中重新分布到整个引擎模块中，其中质量最高的部分将分配到最前面的引擎模块。如果有任何引擎组件遗留，那么如果有空间，这些组件将被添加到您的库存中，否则将被丢弃在您面前。
• mycar rename <name> <new name> -重命名预设。
• mycar delete <name> -删除指定的预设。

注意：如果未指定预设名称save，则update，load和delete命令将使用“默认”预设。

常用预设
获得spawnmodularcar.presets.common.manage许可的玩家可以选择将自己的汽车另存为通用的预设，以供服务器其余部分使用。任何获得spawnmodularcar.presets.common许可的玩家都可以列出通用预设，并可以从通用预设中生成汽车，只要玩家的spawnmodularcar.spawn.*许可允许预设中的插槽数量即可。

• mycar common list-根据您的spawnmodularcar.spawn.*许可列出您有权生成的所有常见预设。
• mycar common load <name>-将指定的通用预设加载到现有汽车上。有关加载方式的详细信息，请参见个人预设部分。
• mycar common save <name> -使用指定的通用预设名称保存汽车的当前模块配置。
• mycar common update <name> -用汽车的当前模块配置覆盖现有的通用预设。
• mycar common rename <name> <new name> -重命名通用预设。
• mycar delete <name> -删除指定的通用预设。

个人设定

• mycar autocodelock-切换自动密码锁。启用时，生成汽车会自动创建一个密码锁，并将其添加到最前面的驾驶舱模块（如果有的话）。需要spawnmodularcar.autocodelock许可。
• mycar autokeylock-切换自动键锁。启用后，只要汽车至少具有一个座舱模块，生成汽车就会自动创建钥匙锁并将匹配的钥匙添加到库存中。需要spawnmodularcar.autokeylock许可。
• mycar autofilltankers-切换AutoFillTankers。启用后，生成，修复或加载预设的汽车会自动用淡水填充所有油轮模块至允许的容量（可配置），并替换其中的盐水。需要spawnmodularcar.autofilltankers许可。

权限
该插件使用Oxide的权限系统。要分配权限，请使用oxide.grant <user or group> <name or steam id> <permission>。要删除权限，请使用oxide.revoke <user or group> <name or steam id> <permission>。
以下权限控制允许玩家在其汽车上拥有的模块插槽的最大数量。如果这些都不被允许，则玩家即使从预设中也无法生成汽车。

• spawnmodularcar.spawn.2 -允许生成带有2个插槽的汽车。
• spawnmodularcar.spawn.3 -允许生成带有2-3个插槽的汽车。
• spawnmodularcar.spawn.4 -允许生成带有2-4个插槽的汽车。

授予以下权限将使玩家的汽车自动生成每个引擎模块中具有相应质量的引擎组件。如果不授予这些权限，则该车将在没有任何引擎组件的情况下生成，因此只有在玩家添加它们后才能驱动。

• spawnmodularcar.engineparts.tier1 -用低质量的发动机零件来制造汽车。
• spawnmodularcar.engineparts.tier2 -用中等质量的发动机零件来制造汽车。
• spawnmodularcar.engineparts.tier3 -使用高质量的发动机零部件为您的汽车增添动力。

预设：

• spawnmodularcar.presets-允许您根据个人预设生成汽车。还可以使save，update，rename和delete预先设定的命令。
• spawnmodularcar.presets.load-需要使用mycar load <preset>和mycar common load <preset>。
• spawnmodularcar.presets.common-需要使用mycar common <preset>和mycar common load <preset>。
• spawnmodularcar.presets.common.manage -需要管理常见预设。
• spawnmodularcar.givecar-需要使用givecar命令。

其他：

• spawnmodularcar.fix–需要使用mycar fix。
• spawnmodularcar.fetch–需要使用mycar fetch。
• spawnmodularcar.despawn–需要使用mycar destroy。
• spawnmodularcar.autofuel -自动为您的汽车加油。
• spawnmodularcar.autocodelock-需要使用自动密码锁定功能（即mycar autocodelock）。
• spawnmodularcar.autokeylock-需要使用自动按键锁定功能（即mycar autokeylock）。
• spawnmodularcar.autofilltankers-需要使用自动加油机模块（即mycar autofilltankers）填充。
• spawnmodularcar.underwater-允许您的汽车在水下行驶（建议使用潜水装备）。注意：水下驾驶明显比在陆地上慢。
• spawnmodularcar.autostartengine -上车时立即启动汽车的引擎。

组态
可以SpawnModularCar.json在oxide/config目录下的文件中配置此插件的设置和选项。建议使用JSON编辑器或验证站点（例如jsonlint.com），以避免格式问题和语法错误。
{
"CanDespawnWhileOccupied": false,
"CanFetchWhileBuildingBlocked": false,
"CanFetchWhileOccupied": false,
"CanSpawnWhileBuildingBlocked": false,
"Cooldowns": {
"FetchCarSeconds": 10.0,
"FixCarSeconds": 60.0,
"LoadPresetSeconds": 10.0,
"SpawnCarSeconds": 10.0
},
"DeleteMatchingKeysFromPlayerInventoryOnDespawn": true,
"DisableSpawnLimitEnforcement": false,
"DismountPlayersOnFetch": true,
"EnableEffects": true,
"FreshWaterAmount": -1,
"FuelAmount": -1,
"MaxPresetsPerPlayer": 10,
"Presets": [],
"PreventEditingWhileCodeLockedOut": false
}

• CanDespawnWhileOccupied（true或false）-是否允许玩家mycar destroy在自己的汽车被占用时使用。如果为true，则生成汽车会安全地从座椅和平板模块中弹出播放器。
• CanFetchWhileOccupied（true或false）-是否允许玩家在乘车时取车。如果true，fetchinig汽车将从休息和平板模块安全弹出播放器，如果DismountPlayersOnFetch是true，否则这些球员将与汽车远距传物。
• CanFetchWhileBuildingBlocked（true或false）-是否允许玩家在建筑物被堵时取车。建议设置为false避免人们乘坐汽车穿过墙壁的攻击。
• CanSpawnWhileBuildingBlocked（true或false）-是否允许玩家在建筑被阻塞时生成自己的汽车。建议设置为false避免人们乘坐汽车穿过墙壁的攻击。
• Cooldowns-各种冷却时间以保持平衡。这些主要是为了防止垃圾邮件而实现的，因此当前在插件重新加载或服务器重新启动时无法跟踪它们，因此将它们设置得很高（例如，数小时或数天）可能并不总是可以按预期进行。
• DeleteMatchingKeysFromPlayerInventoryOnDespawn（true或false）-使用所有者播放器时，是否从所有者播放器的清单中删除所有匹配的键mycar destroy。也适用于使用mycar load和取消锁定的情况，因为预设不包含驾驶舱模块。我建议将此设置为true，尤其是在允许玩家使用自动按键锁定功能的情况下，因为它会产生按键，否则可能会干扰玩家的库存。
• DisableSpawnLimitEnforcement（true或false）-设置为true在服务器重新启动之间保留所有模块化汽车。否则，游戏将删除服务器配置的模块化汽车数量之外的多余汽车，这可能会根据玩家的生成时间来删除玩家汽车。
• DismountPlayersOnFetch（true或false）-取车时是否从汽车上卸下所有玩家。除非CanFetchWhileOccupied也没有作用true。
• EnableEffects（true或false）-使用mycar fix或从预设中生成汽车时启用音频和视觉效果mycar load。
• FreshWaterAmount-产生时要添加到汽车每个加油机模块中的淡水量。仅在播放器具有spawnmodularcar.autofilltankers许可且启用了“自动填充Tankers”设置的情况下适用。默认值-1表示最大堆栈大小。注意：如果由于某种原因该车有多个加油机（即没有其他模块），则此金额将添加到每个加油机中。
• FuelAmount-产卵时添加到燃油箱中的低级燃油量。仅在获得播放器spawnmodularcar.autofuel许可的情况下适用。修理汽车或加载预设时，将仅添加缺少的数量以达到此最小目标值。默认值-1表示最大堆栈大小。
• MaxPresetsPerPlayer -允许每个播放器保存的模块配置预设的最大数量。
• PreventEditingWhileCodeLockedOut（true或false）-是否在未经授权使用密码锁的情况下阻止玩家在升降机上编辑车辆。无论如何，授权玩家仍然可以编辑载具。

服务器预设
服务器预设必须在插件的配置文件中手动定义。可以使用通过givecar <player> <preset>命令预设的服务器为玩家生成汽车。以这种方式生成的汽车将使用预设中提供的设置，而不是使用常规插件配置，播放器权限和播放器设置。这些汽车不计入一辆汽车的玩家限制，也不能通过使用产生或互动mycar。

这是一个示例列表，可以帮助您入门。

"Presets": [
{
"Name": "LongChassis",
"Options": {
"ModuleIDs": [0, 0, 0, 0]
}
},
{
"Name": "TourBus",
"Options": {
"ModuleIDs": [170758448, 895374329, 1376065505],
"EnginePartsTier": 2,
"FuelAmount": 100,
"CodeLock": true
}
},
{
"Name": "ArmoredCar",
"Options": {
"ModuleIDs": [1559779253, 1874610722, 1874610722],
"EnginePartsTier": 3,
"FuelAmount": 500,
"KeyLock": true
}
},
{
"Name": "DoubleTanker",
"Options": {
"ModuleIDs": [1186655046, 1186655046],
"FreshWaterAmount": 50000
}
}
],
这是您可以为每个预设定义的所有可用选项。最默认为0或false。

• ModuleIDs-将自动添加到汽车中的模块项目ID的列表。这些ID可以在rustlabs.com的项目页面上找到。该数字0表示一个空的套接字。
• CodeLock（true或false）-是否将密码锁部署到汽车上。
• KeyLock（true或false）-是否在汽车上创建钥匙锁并将匹配的钥匙添加到玩家的清单中。
• EnginePartsTier（0- 3）-自动添加到所有引擎模块的引擎组件的质量。选择0不会添加任何引擎组件。
• FuelAmount -放入油箱的燃油量。
• FreshWaterAmount -添加到每个油轮模块中的淡水量（如果适用）。

本土化
默认消息在SpawnModularCar.json目录下的oxide/lang/en文件中。要增加对另一种语言的支持，请创建一个新的语言文件夹（例如de德语）（如果尚未创建），将默认语言文件复制到新文件夹中，然后自定义消息。

复制
{
"Generic.Setting.On": "<color=yellow>ON</color>",
"Generic.Setting.Off": "<color=#bbb>OFF</color>",
"Generic.Error.NoPermission": "You don't have permission to use this command.",
"Generic.Error.BuildingBlocked": "Error: Cannot do that while building blocked.",
"Generic.Error.NoPresets": "You don't have any saved presets.",
"Generic.Error.NoCommonPresets": "There are no common presets.",
"Generic.Error.CarNotFound": "Error: You need a car to do that.",
"Generic.Error.CarOccupied": "Error: Cannot do that while your car is occupied.",
"Generic.Error.CarDead": "Error: Your car is dead.",
"Generic.Error.Cooldown": "Please wait <color=yellow>{0}s</color> and try again.",
"Generic.Error.NoPermissionToPresetSocketCount": "Error: You don't have permission to use preset <color=yellow>{0}</color> because it requires <color=yellow>{1}</color> sockets.",
"Generic.Error.PresetNotFound": "Error: Preset <color=yellow>{0}</color> not found.",
"Generic.Error.PresetMultipleMatches": "Error: Multiple presets found matching <color=yellow>{0}</color>. Use <color=yellow>mycar list</color> to view your presets.",
"Generic.Error.PresetAlreadyTaken": "Error: Preset <color=yellow>{0}</color> is already taken.",
"Generic.Error.PresetNameLength": "Error: Preset name may not be longer than {0} characters.",
"Generic.Error.CarLocked": "That vehicle is locked.",
"Generic.Info.CarDestroyed": "Your modular car was destroyed.",
"Generic.Info.PartsRecovered": "Recovered engine components were added to your inventory or dropped in front of you.",
"Command.Spawn.Error.SocketSyntax": "Syntax: <color=yellow>mycar <2|3|4></color>",
"Command.Spawn.Error.CarAlreadyExists": "Error: You already have a car.",
"Command.Spawn.Error.CarAlreadyExists.Help": "Try <color=yellow>mycar fetch</color> or <color=yellow>mycar help</color>.",
"Command.Spawn.Success": "Here is your modular car.",
"Command.Spawn.Success.Locked": "A matching key was added to your inventory.",
"Command.Spawn.Success.Preset": "Here is your modular car from preset <color=yellow>{0}</color>.",
"Command.Fix.Success": "Your car was fixed.",
"Command.Fetch.Error.StuckOnLift": "Error: Unable to fetch your car from its lift.",
"Command.Fetch.Error.StuckOnLift.Help": "You can use <color=yellow>mycar destroy</color> to destroy it.",
"Command.Fetch.Success": "Here is your modular car.",
"Command.SavePreset.Error.TooManyPresets": "Error: You may not have more than <color=yellow>{0}</color> presets. You may delete another preset and try again. See <color=yellow>mycar help</color>.",
"Command.SavePreset.Error.PresetAlreadyExists": "Error: Preset <color=yellow>{0}</color> already exists. Use <color=yellow>mycar update {0}</color> to update it.",
"Command.SavePreset.Success": "Saved car as <color=yellow>{0}</color> preset.",
"Command.UpdatePreset.Success": "Updated <color=yellow>{0}</color> preset with current module configuration.",
"Command.LoadPreset.Error.SocketCount": "Error: Unable to load <color=yellow>{0}</color> preset (<color=yellow>{1}</color> sockets) because your car has <color=yellow>{2}</color> sockets.",
"Command.LoadPreset.Success": "Loaded <color=yellow>{0}</color> preset onto your car.",
"Command.DeletePreset.Success": "Deleted <color=yellow>{0}</color> preset.",
"Command.RenamePreset.Error.Syntax": "Syntax: <color=yellow>mycar rename <name> <new_name></color>",
"Command.RenamePreset.Success": "Renamed <color=yellow>{0}</color> preset to <color=yellow>{1}</color>",
"Command.List": "Your saved modular car presets:",
"Command.List.Item": "<color=yellow>{0}</color> ({1} sockets)",
"Command.Common.List": "Common modular car presets:",
"Command.Common.Error.Syntax": "Try <color=yellow>mycar help</color>",
"Command.Common.LoadPreset.Error.Syntax": "Syntax: <color=yellow>mycar common load <name></color>",
"Command.Common.SavePreset.Error.Syntax": "Syntax: <color=yellow>mycar common save <name></color>",
"Command.Common.SavePreset.Error.PresetAlreadyExists": "Error: Common preset <color=yellow>{0}</color> already exists. Use <color=yellow>mycar common update {0}</color> to update it.",
"Command.Common.UpdatePreset.Error.Syntax": "Syntax: <color=yellow>mycar common update <name></color>",
"Command.Common.RenamePreset.Error.Syntax": "Syntax: <color=yellow>mycar common rename <name> <new_name></color>",
"Command.Common.DeletePreset.Error.Syntax": "Syntax: <color=yellow>mycar common delete <name></color>",
"Command.ToggleAutoCodeLock.Success": "<color=yellow>AutoCodeLock</color> set to {0}",
"Command.ToggleAutoKeyLock.Success": "<color=yellow>AutoKeyLock</color> set to {0}",
"Command.ToggleAutoFillTankers.Success": "<color=yellow>AutoFillTankers</color> set to {0}",
"Command.Give.Error.Syntax": "Syntax: <color=yellow>givecar <player> <preset></color>",
"Command.Give.Error.PlayerNotFound": "Error: Player <color=yellow>{0}</color> not found.",
"Command.Give.Error.PresetTooFewModules": "Error: Preset <color=yellow>{0}</color> has too few modules ({1}).",
"Command.Give.Error.PresetTooManyModules": "Error: Preset <color=yellow>{0}</color> has too many modules ({1}).",
"Command.Give.Success": "Modular car given to <color=yellow>{0}</color> from preset <color=yellow>{1}</color>.",
"Command.Help": "<color=orange>SpawnModularCar Command Usages</color>",
"Command.Help.Spawn.Basic": "<color=yellow>mycar</color> - Spawn a random car with max allowed sockets",
"Command.Help.Spawn.Basic.PresetsAllowed": "<color=yellow>mycar</color> - Spawn a car using your <color=yellow>default</color> preset if saved, else spawn a random car with max allowed sockets",
"Command.Help.Spawn.Sockets": "<color=yellow>mycar <2|3|4></color> - Spawn a random car of desired length",
"Command.Help.Fetch": "<color=yellow>mycar fetch</color> - Fetch your car",
"Command.Help.Fix": "<color=yellow>mycar fix</color> - Fix your car",
"Command.Help.Destroy": "<color=yellow>mycar destroy</color> - Destroy your car",
"Command.Help.Section.PersonalPresets": "<color=orange>--- Personal presets ---</color>",
"Command.Help.ListPresets": "<color=yellow>mycar list</color> - List your saved presets",
"Command.Help.Spawn.Preset": "<color=yellow>mycar <name></color> - Spawn a car from a saved preset",
"Command.Help.LoadPreset": "<color=yellow>mycar load <name></color> - Load a preset onto your car",
"Command.Help.SavePreset": "<color=yellow>mycar save <name></color> - Save your car as a preset",
"Command.Help.UpdatePreset": "<color=yellow>mycar update <name></color> - Overwrite a preset",
"Command.Help.RenamePreset": "<color=yellow>mycar rename <name> <new_name></color> - Rename a preset",
"Command.Help.DeletePreset": "<color=yellow>mycar delete <name></color> - Delete a preset",
"Command.Help.Section.CommonPresets": "<color=orange>--- Common presets ---</color>",
"Command.Help.Common.ListPresets": "<color=yellow>mycar common list</color> - List common presets",
"Command.Help.Common.Spawn": "<color=yellow>mycar common <name></color> - Spawn a car from a common preset",
"Command.Help.Common.LoadPreset": "<color=yellow>mycar common load <name></color> - Load a common preset onto your car",
"Command.Help.Common.SavePreset": "<color=yellow>mycar common save <name></color> - Save your car as a common preset",
"Command.Help.Common.UpdatePreset": "<color=yellow>mycar common update <name></color> - Overwrite a common preset",
"Command.Help.Common.RenamePreset": "<color=yellow>mycar common rename <name> <new_name></color> - Rename a common preset",
"Command.Help.Common.DeletePreset": "<color=yellow>mycar common delete <name></color> - Delete a common preset",
"Command.Help.Section.PersonalSettings": "<color=orange>--- Personal settings ---</color>",
"Command.Help.ToggleAutoCodeLock": "<color=yellow>mycar autocodelock</color> - Toggle AutoCodeLock: {0}",
"Command.Help.ToggleAutoKeyLock": "<color=yellow>mycar autokeylock</color> - Toggle AutoKeyLock: {0}",
"Command.Help.ToggleAutoFillTankers": "<color=yellow>mycar autofilltankers</color> - Toggle automatic filling of tankers with fresh water: {0}",
"Command.Help.Section.OtherCommands": "<color=orange>--- Other commands ---</color>",
"Command.Help.Give": "<color=yellow>givecar <player> <preset></color> - Spawn a car for the target player from the specified server preset"
}