무기 킷

경쟁 기반 전투 경험을 만드는 데 도움을 주기 위해 여러 지원 무기를 사용할 수 있습니다. 핵심 시스템은 어깨 너머 카메라가 있는 발사체 기반 무기를 특징으로 하며, 발사체 속도를 충분히 높게 설정하면 레이캐스팅 무기와 같은 레이저 총기를 시뮬레이션할 수 있습니다.

경험에서 승인된 무기를 사용하려면:

1. 아래에서 무기를 선택하고 자산 라이브러리 링크로 이동합니다.

1. 무기의 아이템 페이지에서 녹색 가져오기 버튼을 클릭하고 거래를 확인합니다.

2. 스튜디오에서 도구 상자를 엽니다.

3. 도구 상자의 인벤토리 섹션을 선택합니다.

4. 무기를 찾아 클릭하여 장소에 추가합니다. 도구를 스타터 팩에 넣을 것인지 묻는 메시지가 표시되면, 플레이어가 배낭에서 무기를 시작하도록 원하는 경우 예를 클릭하거나, 무기를 3D 세계에 단순히 픽업으로 놓으려면 아니오를 클릭합니다.

5. 승인된 무기를 처음 가져오는 경우, 그 WeaponsSystem 폴더를 ServerScriptService로 이동하여 경험 내 모든 승인된 무기를 위한 통합 시스템 폴더로 사용합니다.

   

시스템 폴더 구조

WeaponsSystem 폴더는 경험 내 모든 승인된 무기를 위한 자산, 구성 및 스크립트를 포함하는 통합 폴더입니다. ServerScriptService에 위치하는 경우, 개별 무기 내에서 존재할 수 있는 동등한 WeaponsSystem 폴더를 덮어씁니다.

WeaponsSystem 폴더는 다음과 같은 인스턴스를 포함합니다:

• 자산 (Folder)

  • 애니메이션 (Folder) – 무기 시스템에서 사용되는 애니메이션의 저장소입니다.
  • 효과 (Folder)

    • 탄피 (Folder) – 모든 탄피 자산의 저장소입니다.
    • 히트 마크 (Folder) – 모든 히트 마크 효과의 저장소입니다.
    • 샷 (Folder) – 모든 샷 효과의 저장소입니다.
  • WeaponsSystemGui (ScreenGui) – 무기 시스템 GUI의 설정입니다.
• 구성 (Folder) – 무기 시스템의 구성 값입니다.

  • SlowZoomWalkEnabled (BoolValue) – 스프린트 제어의 설정입니다.
  • SprintEnabled (BoolValue) – 스프린트 제어의 설정입니다.
• 라이브러리 (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 또는 두 가지를 수정해야 합니다. 일부 구성은 구멍 입자와 같은 다른 구성에 따라 다릅니다. 이는 발사체/타격 효과 및 소리와 같은 필수 자식을 요구합니다.

볼트 애니메이션 및 소리

무기의 볼트는 발사될 때마다 앞뒤로 움직이는 부분입니다.

• 무기의 무기 모델 후손

• 무기의 구성 폴더의 자식

탄피 배출

무기는 발사 시 배출되며, 지면에 떨어지는 물리적인 탄피를 포함할 수 있습니다.

• 무기의 무기 모델 후손

• 무기의 구성 폴더의 자식

• 시스템 폴더의 Assets/Effects/Casings에 있는 탄피 BasePart의 자식

발사체/타격 효과 및 소리

모든 무기에서 물리적 발사체를 구성할 수 있으며, 타격 효과 및 기타 특수 효과를 위한 Sounds, Beams, ParticleEmitters를 포함합니다.

• 무기의 구성 폴더의 자식

ShotEffect 후손

이전 섹션에서 지정된 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의 전체 크기로 성장한 후 반으로 줄어들고 완전히 투명해집니다.
• 물리적 발사체로 나타나기를 원하는 Part/MeshPart/SpecialMesh (선택 사항). 예를 들어, 화살 MeshPart를 포함하고, 위에서 언급한 AlignHitMarkToNormal을 false로 설정하면 화살이 발사한 방향에서 표면 밖으로 튀어나오게 됩니다.

폭발 입자

발사체는 충돌 지점 주변의 플레이어 캐릭터에 피해를 입히기 위해 Explosion 객체를 포함할 수 있습니다.

구성 후손:

• ExplodeOnImpact (BoolValue) (선택 사항) — 총알/발사체가 충돌 시 폭발하기를 원하면 true로 설정하고, 그렇지 않으면 false로 설정합니다. 기본값은 false입니다.
• BlastRadius (NumberValue) (선택 사항) — 폭발의 폭발 반경; 기본값은 8입니다.
• BlastPressure (NumberValue) (선택 사항) — 폭발 압력; 기본값은 10000입니다.
• BlastDamage (NumberValue) (선택 사항) — 폭발의 중심에 있는 물체에 피해를 입힙니다. 폭발로 인한 피해는 폭발 중심에서 멀어질수록 줄어듭니다. 기본값은 100입니다.

충전 무기

레일건과 같은 충전 무기는 발사할 준비가 될 때까지 발사 간 충전이 필요합니다.

모델 후손:

• 충전 (Sound) (선택 사항) — 무기가 충전되는 동안 재생됩니다.
• 방전 (Sound) (선택 사항) — 무기가 방전되는 동안 재생되며, 예를 들어 무기를 부분적으로 충전한 후 발사 버튼을 놓은 경우입니다.
• 충전 완료 (Sound) (선택 사항) — 무기가 완전히 충전되었을 때 재생됩니다.
• 방전 완료 (Sound) (선택 사항) — 무기가 완전히 방전되었을 때 재생됩니다.
• ChargeGlow (BasePart) (선택 사항) — 이 객체는 무기가 충전됨에 따라 덜 투명해지며, 100% 충전 시 완전히 불투명하게 됩니다.
• ChargeCompleteParticles (ParticleEmitter) (선택 사항) — 무기 충전이 완료되면 방출됩니다. 이 방출기는 모든 모델 BasePart의 자식이거나 BasePart 내의 Attachment의 자식이 될 수 있습니다.
• DischargeCompleteParticles (ParticleEmitter) (선택 사항) — 무기가 완전히 방전되었을 때 방출됩니다. 이 방출기는 모든 모델 BasePart의 자식이거나 BasePart 내의 Attachment의 자식이 될 수 있습니다.
• 충전 입자 (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입니다.

활 무기

크로스보우와 같은 활 무기는 사실적인 줄 및 팔 구조를 포함할 수 있으며, 줄에 고정된 시각적 화살도 포함할 수 있습니다.

모델 후손을 추가하는 것 외에도, 다음을 적용해야 합니다:

• 무기를 충전 무기으로 만듭니다. 예를 들어, 줄이 당기는 속도를 지정하는 ChargeRate를 무기 Configuration에 추가해야 합니다. 또한, 줄이 당겨지는 소리/팔이 당겨지는 소리와 같은 선택적 후손을 무기의 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는 경험이 시작될 때 PlayerGui에 부모로 달린 WeaponsSystem/Assets 내의 ScreenGui 객체입니다. WeaponSystemGui는 4개의 자식을 갖습니다:

• ScalingElements - 화면 요소의 Folder.
• LargeTouchscreen - 큰 터치스크린에 대한 버튼 Frame.
• Scope - 조준경을 사용할 때 확대하기 위한 Frame.
• SmallTouchscreen - 작은 터치스크린에 대한 버튼 Frame.

스케일링 요소

ScalingElements는 WeaponsSystemGui 아래의 Folder로 다음 자식을 포함합니다:

대형 터치스크린

LargeTouchscreen은 대형 터치스크린에 표시되는 버튼이 포함된 Frame입니다. LargeTouchscreen은 다음 자식을 포함합니다:

• AimButton (ImageButton)
• FireButton (ImageButton)

조준경

Scope는 ScopeImage (ImageLabel)를 포함하는 Frame로, HasScope가 활성화된 무기를 확대할 때 표시됩니다 (참고: 무기 구조).

Scope는 다음 자식을 포함합니다:

소형 터치스크린

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)

어깨 카메라

어깨 카메라는 플레이어 캐릭터의 오른쪽 어깨를 넘어 바라보는 3인칭 카메라입니다. 어깨 카메라를 사용자 정의하려면, WeaponsSystem/Libraries/ShoulderCamera의 ShoulderCamera.new() 함수에서 -- 구성 매개변수 (상수) 주석 아래에 있는 변수들을 수정하십시오. 시야각, 캐릭터로부터의 오프셋, 스프린트 또는 확대 중의 이동 속도 등을 수정할 수 있습니다.

스프린트 및 확대 제어

기본적으로 무기 시스템은 "스프린트" 기능을 추가하여 플레이어가 Shift 키를 눌르거나, 동적 조이스틱(모바일)에서 완전히 위로 밀거나, 게임패드에서 왼쪽 조이스틱을 완전히 위로 밀면 스프린트할 수 있게 합니다. 스프린트를 비활성화하고 싶다면, WeaponsSystem/Configuration 내의 SprintEnabled 값을 false로 설정하세요.

이 시스템은 또한 플레이어가 조준/확대하는 동안 속도를 줄이지만, 이 동작을 비활성화하려면 SlowZoomWalkEnabled 값을 false로 설정하면 됩니다.