武器套件

為了協助創建競技性戰鬥經驗，可以使用幾種經過授權的武器。核心系統具有基於發射物的武器，並使用肩膀上方的攝像機，將發射物速度設置得足夠高可以模擬射線武器，如激光槍。

在你的經驗中使用經過授權的武器：

1. 從下面選擇一個武器，導航到資產庫鏈接。

1. 在武器的物品頁面，點擊綠色的 獲取 按鈕並確認交易。

2. 在工作室打開 工具箱。

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 的後代

口徑粒子

此選項在武器的 TipAttachment Attachment 開火時發出來自指定的 ParticleEmitter 的粒子。

配置子項：

• 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)（可選） — 爆炸的 BlastRadius；默認為 8。
• BlastPressure (NumberValue)（可選） — 爆炸的 BlastPressure；默認為 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 中添加可選的後代，例如用於弦/手臂被拉回的充能音效。
• 將 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。

WeaponsSystemGui 是一個 ScreenGui 物件，位於 WeaponsSystem/Assets 中，當經驗開始時作為 PlayerGui 的父項。WeaponSystemGui 擁有 4 個後代：

• ScalingElements - 存儲在螢幕上的元素的 Folder。
• LargeTouchscreen - 用於大型觸控螢幕的按鈕的 Frame。
• Scope - 用於使用瞄準鏡的武器進行縮放的 Frame。
• SmallTouchscreen - 用於小型觸控螢幕的按鈕的 Frame。

縮放元素

ScalingElements 是一個 Folder，作為 WeaponsSystemGui 的父項，擁有以下後代：

LargeTouchscreen

LargeTouchscreen 是一個包含顯示在大型觸控螢幕上的按鈕的 Frame。LargeTouchscreen 有以下後代：

• AimButton (ImageButton)
• FireButton (ImageButton)

瞄準鏡

Scope 是一個 Frame，包含 ScopeImage (ImageLabel)，當用 HasScope 啟用的武器進行縮放時顯示（請參見 武器結構）。

Scope 具有以下後代：

SmallTouchscreen

SmallTouchScreen 是一個包含顯示在小型觸控螢幕上的按鈕的 Frame。SmallTouchscreen 具有以下後代：

• AimButton (ImageButton)
• FireButton (ImageButton)

創建方向指示器

方向指示器用於顯示玩家十字準星周圍的某個事物的方向。例如，如果有人向您開槍，可以用紅色半圓圈在您的十字準星周圍顯示出射擊的方向。其他示例包括顯示腳步聲、間接槍火或環境物件如寶箱的方向的指示器。

要創建新的指示器，請在 WeaponsSystemGui/ScalingElements/DirectionalIndicators 中添加一個新的指示器 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() 函數的 -- 配置參數 (常量) 註釋下的變數。您可以修改字段，例如視場，與角色的偏移量，在 衝刺或縮放 時的行走速度等。

衝刺和縮放控制

默認情況下，武器系統添加了“衝刺”功能，因此玩家可以通過按住 Shift 鍵、在動態搖杆上完全上推（手機）或在左搖杆上完全上推（遊戲手柄）來衝刺。如果您想禁用衝刺，請將 SprintEnabled 的值設置為 false，位於 WeaponsSystem/Configuration 中。

系統還在精準/縮放時降低玩家的速度，但您可以通過將 SlowZoomWalkEnabled 的值設置為 false 來禁用此行為。