武器套件

为了协助创建竞争性战斗体验，提供了若干经过认可的武器，可用于任何体验。核心系统特色是具有肩上视角的投射型武器，当投射速度设置得足够高时，可以模拟激光枪等光线投射武器。

在您的体验中使用经过认可的武器：

1. 从下面选择一种武器，导航到资产库链接。

1. 在武器的物品页面上，点击绿色的 获取 按钮并确认交易。

2. 在Studio中，打开工具箱。

3. 选择工具箱的 库存 部分。

4. 找到武器并点击它将其添加到游戏中。当系统提示是否将工具放入起始包时，如果您希望玩家在背包中开始时就拥有该武器，请点击 是，如果仅希望将武器放入3D世界中作为可拾取物品，请点击 否。

5. 如果这是 第一次 导入经过认可的武器，请将其 WeaponsSystem 文件夹移动到 ServerScriptService 中，以便作为体验中所有经过认可的武器的统一系统文件夹。

   

系统文件夹结构

WeaponsSystem 文件夹是一个统一的文件夹，包含资产、配置和用于驱动体验中所有经过认可的武器的脚本。如果该文件夹位于 ServerScriptService 中，将覆盖可能存在于各个武器内的任何等效 WeaponsSystem 文件夹。

WeaponsSystem 文件夹包含以下实例：

• Assets (Folder)

  • Animations (Folder) – 用于武器系统的动画存储。
  • Effects (Folder) - Casings (Folder) – 所有子弹壳资产的存储。 - HitMarks (Folder) – 所有击中标记效果的存储。 - Shots (Folder) – 所有射击效果的存储。
  • WeaponsSystemGui (ScreenGui) – 武器系统 GUI 的设置。
• Configuration (Folder) – 武器系统的配置值。

  • SlowZoomWalkEnabled (BoolValue) – 冲刺控制 的设置。
  • SprintEnabled (BoolValue) – 冲刺控制 的设置。
• Libraries (Folder) – 存储武器系统中使用的所有其他 ModuleScripts。
• WeaponTypes (Folder) – 指定所有武器类型。
• ServerWeaponsScript (Script)
• Version (IntValue)
• ClientWeaponScript (LocalScript)
• NetworkingCallbacks (ModuleScript)
• WeaponData (RemoteEvent)
• WeaponsSystem (ModuleScript)

在 WeaponsSystem 文件夹中，以下 ModuleScripts 控制不同的方面：

武器结构

经过认可的武器是 Tools，其命名方式与玩家背包中显示的方式相同。每个武器的结构具有相似的层级。

武器类型

WeaponType StringValue 与 WeaponsSystem/WeaponTypes 文件夹中该武器的 ModuleScript 关联。两个基本值是 BulletWeapon 和 BowWeapon。

武器模型

每个武器包含一个由一个或多个 BaseParts 组成的 Model，形成物理武器。其中一个应设置为模型的 PrimaryPart。

模型还包括以下重要子代，可以作为模型的 BaseParts 的子项：

• TipAttachment – Attachment，其在父 BasePart 上的位置决定了子弹/投射物的发出位置。
• HandleAttachment – Attachment，其在父 BasePart 上的位置决定了 Handle 连接的位置。
• Fired

  optional

  – Sound 在武器开火时播放。
• Reload

  optional

  – Sound 在武器重新装填时播放。
• 额外的子代用于任何专用选项。

武器手柄

Handle 部件决定玩家角色持有武器的位置。它必须是一个 Part，必须命名为 Handle，并且必须是武器（工具）的直接子项。

配置文件夹

Configuration 文件夹包含特定的"值"类型，以影响武器行为。除了默认值，您还可以在适用时添加额外的配置项，用于专用选项。

以下是基本配置及其默认值：

专用选项

您可以为任何武器添加/修改以下选项。这些自定义需要修改武器的 Model、武器的 Configuration 或两者。有些配置依赖于其他配置，例如 枪口粒子需要必要的子项，以实现 投射物/击中效果和声音。

决定和声音

武器的 bolt 是在每次射击时来回移动的部分。

• 武器的武器模型的子代

• 武器的配置文件夹的子项

弹壳弹出

武器可以包括物理弹壳，在射击时弹出并掉落到地面。

• 武器的武器模型的子代

• 武器的配置文件夹的子项

• 在系统文件夹的 Assets/Effects/Casings 中的弹壳 BasePart 的子项

投射物/击中效果和声音

您可以为任何武器配置物理投射物，以及用于击中效果和其他特殊效果的 Sounds、Beams 和 ParticleEmitters。

• 武器的配置文件夹的子项

ShotEffect 子代

在之前部分指定的 ShotEffect 的子代

枪口粒子

此选项在武器的 TipAttachment Attachment 处发射粒子。

配置子代：

• ShotEffect (StringValue) — 存储在 WeaponsSystem/Assets/Effects/Shots 中的射击效果名称。
• NumMuzzleParticles (IntValue)（可选） — 将发射的枪口粒子数量；默认值为 50。

对于指定的射击效果，请在 WeaponsSystem/Assets/Effects/Shots 中添加一个名为 MuzzleParticles 的 ParticleEmitter 资产。

枪口闪光

此选项在武器发射时创建 Beam 闪光效果。

模型子代：

• MuzzleFlash0 (Attachment) — 用于指定枪口闪光的一侧。位置无关紧要。
• MuzzleFlash1 (Attachment) — 用于指定枪口闪光的另一侧。位置无关紧要。
• MuzzleFlash (Beam) — 确保将 Attachment0 设置为 MuzzleFlash0，将 Attachment1 设置为 MuzzleFlash1。

配置子代：

• MuzzleFlashTime (NumberValue)（可选） — 枪口闪光将显示的时间长度；默认值为 0.03。
• MuzzleFlashRotation0 (NumberValue)（可选） — 枪口闪光的最小旋转；默认值为 -math.pi。
• MuzzleFlashRotation1 (NumberValue)（可选） — 枪口闪光的最大旋转；默认值为 math.pi。
• MuzzleFlashSize0 (NumberValue)（可选） — 枪口闪光的最小大小；默认值为 1。
• MuzzleFlashSize1 (NumberValue)（可选） — 枪口闪光的最大大小；默认值为 1。

粒子拖尾

此选项创建从武器到投射物碰撞点的可变长度拖尾。

配置子代：

• TrailLength (NumberValue)（可选） — 子弹/投射物后面的拖尾长度；默认值为 nil，这意味着拖尾长度将根据 TrailLengthFactor 计算。
• TrailLengthFactor (NumberValue)（可选） — 拖尾长度将设置为该值乘以在上一个帧中子弹/投射物移动的距离；默认值为 1。请注意，如果包含 TrailLength，则将覆盖此项。
• ShowEntireTrailUntilHit (BoolValue)（可选） — 设置为 true 以从武器尖端一直显示拖尾，直到投射物命中某物；这将覆盖 TrailLength 和 TrailLengthFactor，拖尾将在投射物击中某物之前不会消失。设置为 false 以使用上述两个选项之一来计算拖尾长度。默认值为 false。

击中标记

此视觉效果出现在投射物击中表面上，并且对于箭矢、子弹孔、烧焦痕迹等非常有用。

配置子代：

• HitMarkEffect (StringValue)（可选） — 存储在 WeaponsSystem/Assets/Effects/HitMarks 中的击中标记效果名称；默认值为 BulletHole。
• AlignHitMarkToNormal (BoolValue)（可选） — 设置为 true 如果击中标记应该始终平整地对齐在表面上，如子弹孔；设置为 false 如果击中标记应该显得从投射物来的方向被插入在表面上（如箭矢）。默认值为 true。

您可以在 WeaponsSystem/Assets/Effects/HitMarks 中添加以下可选资产：

• Glow (Decal)（可选） — 显示在击中表面上完全不透明，然后迅速变得更加透明，有点像在表面上发光的效果，可以快速消失。适用于显示爆炸物命中时出现的红色光点。
• BulletHole (Decal)（可选） — 显示在击中表面上完全不透明，4秒后逐渐淡出到透明，持续1秒。
• ImpactBillboard (BillboardGui)（可选） — 显示在击中表面上，始终朝向相机方向。

  • Impact (ImageLabel)（可选） — ImpactBillboard 的直接子项；这是完全不透明的，0.1秒内增长至 ImpactBillboard 的全尺寸，然后缩小至一半的大小，再在0.1秒内淡出到完全透明。
• 任何希望作为物理投射物出现的 Part/MeshPart/SpecialMesh（可选）。例如，包含一个箭矢 MeshPart 并将上述 AlignHitMarkToNormal 设置为 false 将使箭矢从您发射的方向插入到表面中。

爆炸投射物

投射物可以包括一个爆炸对象，以在碰撞点周围伤害玩家角色。

配置子代：

• ExplodeOnImpact (BoolValue)（可选） — 设置为 true 如果希望武器的子弹/投射物在碰撞时爆炸，设置为 false 则不爆炸。默认值为 false。
• BlastRadius (NumberValue)（可选） — 爆炸的冲击半径；默认值为 8。
• BlastPressure (NumberValue)（可选） — 爆炸的冲击压力；默认值为 10000。
• BlastDamage (NumberValue)（可选） — 爆炸中心部位受到伤害的数量。请注意，爆炸造成的伤害会随着击中物体距离爆炸中心的远近而减小。默认值为 100。

充能武器

像磁轨炮这样的充能武器，必须在射击之间充能才能再次开火。

模型子代：

• Charging (Sound)（可选） — 在武器充能时播放。
• Discharging (Sound)（可选） — 在武器放电时播放，例如如果您仅部分充能然后释放射击按钮。
• ChargeComplete (Sound)（可选） — 在武器达到完全充能时播放。
• DischargeComplete (Sound)（可选） — 在武器完全放电时播放。
• ChargeGlow (BasePart)（可选） — 该对象将在武器充能时变得不透明100％，充能时将透明度减少。
• ChargeCompleteParticles (ParticleEmitter)（可选） — 在武器完成充能时发射。此发射器可以是任何模型 BasePart 的子项或在 BasePart 中的某个 Attachment 的子项。
• DischargeCompleteParticles (ParticleEmitter)（可选） — 在武器完全放电时发射。此发射器可以是任何模型 BasePart 的子项或在 BasePart 中的某个 Attachment 的子项。
• ChargingParticles (ParticleEmitter)（可选） — 在武器充能时发射。您可以包含多个此名称的发射器，每个发射器在充能时将发射。此发射器可以是任何模型 BasePart 的子项或在 BasePart 中的某个 Attachment 的子项。

配置子代：

• ChargeRate (NumberValue) — 武器充能的速率。必须指定此值以指示武器使用充能。
• DischargeRate (NumberValue)（可选） — 武器放电的速率；默认值是 0，意味着武器将不会放电。
• ChargePassively (BoolValue)（可选） — 设置为 true 如果希望武器被动充能，以便在单击时立即开火；设置为 false 如果希望点击/触摸以充能武器并在充能完成后开火。默认值为 false。
• ChargingParticlesRatePerCharge (IntValue)（可选） — 将根据武器的当前充能量，所有 ChargingParticles 发射器将发射的粒子数量 默认值为 20，意味着，如果武器的充能量为10％，每个ChargingParticles发射器将发射2个粒子（20×0.1）；如果武器的充能量为90％，每个发射器将发射18个粒子（20×0.9）。
• FireDischarge (NumberValue)（可选） — 发射全额充能射击后，武器损失的充能量；默认值为 1。
• NumChargeCompleteParticles (IntValue)（可选） — 当武器完全充能时，ChargeCompleteParticles 发射器将发射的粒子数量。默认值为 25。
• NumDischargeCompleteParticles (IntValue)（可选） — 当武器完全放电时， DischargeCompleteParticles 发射器将发射的粒子数量。默认值为 25。

弓力武器

像弩这样的弓力武器可以包含真实的弓弦和手臂结构，以及可视化箭矢卡在弓弦上。

除了添加模型子代外，您需要应用以下内容：

• 将武器设置为充能武器。例如，添加武器的 Configuration 中所需的 ChargeRate，指定弓弦拉动的快速程度。此外，考虑向武器的 Model 添加可选子代，例如拉动弓弦的 Charging 音效。
• 将 WeaponType 设置为 BowWeapon，如武器结构所示。

模型子代：

• LeftString (Beam)（可选） — 视觉左半边弓弦。
• RightString (Beam)（可选） — 视觉右半边弓弦。
• Arrow (BasePart)（可选） — 当弓拉满时出现的箭。请注意，这仅用于弓上的视觉外观（实际发射的箭将是 ShotEffect，如投射物/击中效果和声音所述）。
• String1 (Attachment)（可选） — 弓弦的中心点。
• StringLoose (Attachment)（可选） — 弓放松时 String1 应在的位置。
• StringTight (Attachment)（可选） — 弓完全拉紧时 String1 应在的位置。
• Arms (Part)（可选） — 仅用作内部指示器的部件，以表明弓的手臂将被动画化。此对象可能包含以下直接子项：
• LeftString0 (Attachment)（可选） — 弓的左侧弓弦要附着的点。
• RightString0 (Attachment)（可选） — 弓的右侧弓弦要附着的点。
• LeftLoose (Attachment)（可选） — 弓放松时 LeftString0 应在的位置。
• RightLoose (Attachment)（可选） — 弓放松时 RightString0 应在的位置。
• LeftTight (Attachment)（可选） — 弓完全拉紧时 LeftString0 应在的位置。
• RightTight (Attachment)（可选） — 弓完全拉紧时 RightString0 应在的位置。
• [SpecialMesh] (SpecialMesh)（可选） — 弓的部分，拉紧时将实际弯曲。请注意，您必须指定以下四个 Vector3Value 对象以使其动画化。
• LooseOffset (Vector3Value)（可选） — 弓放松时的 SpecialMesh 的偏移。
• TightOffset (Vector3Value)（可选） — 弓完全拉紧时的 SpecialMesh 的偏移。
• LooseScale (Vector3Value)（可选） — 弓放松时的 SpecialMesh 的缩放。
• TightScale (Vector3Value)（可选） — 弓完全拉紧时的 SpecialMesh 的缩放。

武器系统 GUI

核心武器系统通过此系统与 GUI 接口，基于枪支的散布、您被击中或击中的指示器等内容来更新 GUI。

WeaponsSystemGui 是 WeaponsSystem/Assets 中的一个 ScreenGui 对象，在体验开始时附加到 PlayerGui。WeaponSystemGui 有 4 个子代：

• ScalingElements - 存储在屏幕元素文件夹的 Folder。
• LargeTouchscreen - 用于大型触摸屏的 Frame。
• Scope - 用于将使用瞄准镜的武器放大显示的 Frame。
• SmallTouchscreen - 用于小型触摸屏的 Frame。

缩放元素

ScalingElements 是 WeaponsSystemGui 下的 Folder，具有以下子代：

LargeTouchscreen

LargeTouchscreen 是一个 Frame，包含在大型触摸屏上显示的按钮。LargeTouchscreen 具有以下子代：

• AimButton (ImageButton)
• FireButton (ImageButton)

Scope

Scope 是包含 ScopeImage (ImageLabel) 的 Frame，在使用启用 HasScope 的武器时进行缩放显示（参见武器结构）。

Scope 具有以下子代：

SmallTouchscreen

SmallTouchScreen 是一个 Frame，包含在小型触摸屏上显示的按钮。SmallTouchscreen 具有以下子代：

• AimButton (ImageButton)
• FireButton (ImageButton)

创建方向指示器

方向指示器用于显示玩家十字准心周围事物的方向。例如，如果有人向您开火，则可以在您的十字准心周围出现一个红色半圆形以指示枪火的来向。其他示例包括显示脚步声、间接枪火或环境物体（如箱子）的方向。

要创建新的方向指示器，请在 WeaponsSystemGui/ScalingElements/DirectionalIndicators 中添加一个新的 Indicator Frame，结构如下：

创建后，您可以通过在 WeaponsSystem/Libraries/WeaponsGui 内执行以下命令来激活指示器，其中 indicatorName 是要激活的指示器的字符串名称，worldPos 是指示器应指向的世界位置：

self.DirectionalIndicatorGuiManager:ActivateDirectionalIndicator(indicatorName, worldPos)

指示器配置

DirectionalIndicators 可以通过调整 [Indicator] 下的 Configuration 对象进一步修改。所有这些设置都有一个默认值，因此如果不修改设置，则无需设置配置。

可以设置以下配置：

显示伤害公告板

伤害公告板用于在角色受伤时显示头顶上方的小数字。这些只会显示给损害另一个玩家角色的玩家，而不会显示给旁观的玩家。

伤害公告板在 WeaponsSystem/Libraries/DamageBillboardHandler 中处理，可以通过以下方式从任何客户端代码激活，其中 damage 是造成的伤害量，adornmentPart 是将装饰公告板的部分，例如受害者的头部：

DamageBillboardHandler:ShowDamageBillboard(damage, adornmentPart)

肩上摄像头

肩上摄像头是一个第三人称摄像头，位于玩家角色的右肩上方。要自定义肩上摄像头，请修改 WeaponsSystem/Libraries/ShoulderCamera 中 ShoulderCamera.new() 函数下的 -- Configuration parameters (constants) 注释中的变量。您可以修改视场、角色的偏移、冲刺或缩放时的行走速度等内容（参见 冲刺和缩放控制）。

冲刺和缩放控制

默认情况下，武器系统增加了“冲刺”功能，玩家可以通过按住 Shift 键、在动态触摸杆（移动设备）上完全向上推或在左摇杆（游戏手柄）上完全向上推来冲刺。如果您想禁用冲刺，将 WeaponsSystem/Configuration 中的 SprintEnabled 的值设置为 false。

系统还会在瞄准/缩放时降低玩家速度，但您可以通过将 SlowZoomWalkEnabled 的值设置为 false 来禁用此行为。