Kit armi

Per assistere nella creazione di esperienze competitive basate sul combattimento, sono disponibili diverse armi approvate per l'uso in qualsiasi esperienza. Il sistema principale presenta armi basate su proiettili con una telecamera sopra la spalla e impostando la velocità del proiettile sufficientemente alta è possibile simulare armi raycasting come le pistole laser.

Per utilizzare un'arma approvata nella tua esperienza:

1. Seleziona un'arma qui sotto, navigando al link della libreria degli asset.

1. Nella pagina dell'oggetto dell'arma, fai clic sul pulsante verde Ottieni e conferma la transazione.

2. In Studio, apri il Toolbox.

3. Seleziona la sezione Inventario del tuo toolbox.

4. Individua l'arma e fai clic su di essa per aggiungerla nel posto. Quando viene chiesto se inserire lo strumento nel pack iniziale, fai clic su Sì se desideri che i giocatori inizino con l'arma nel loro zaino, oppure fai clic su No per semplicemente collocare l'arma nel mondo 3D come pickup.

5. Se questa è la prima volta che porti dentro un'arma approvata, sposta la sua cartella WeaponsSystem in ServerScriptService per fungere da cartella unificata sistema per tutte le armi approvate nell'esperienza.

   

Struttura della cartella di sistema

La cartella WeaponsSystem è una cartella unificata che contiene asset, configurazioni e script che alimentano tutte le armi approvate nell'esperienza. Se collocata in ServerScriptService, sovrascrive eventuali cartelle WeaponsSystem equivalenti che potrebbero risiedere all'interno delle singole armi.

La cartella WeaponsSystem contiene le seguenti istanze:

• Assets (Folder)

  • Animations (Folder) – Magazzino per le animazioni utilizzate nei sistemi delle armi.
  • Effects (Folder) - Casings (Folder) – Magazzino per tutti gli asset di gusci di proiettili. - HitMarks (Folder) – Magazzino per tutti gli effetti di colpo. - Shots (Folder) – Magazzino per tutti gli effetti di colpo.
  • WeaponsSystemGui (ScreenGui) – Impostazioni per il GUI del sistema armi.
• Configuration (Folder) – Valori di configurazione per il sistema delle armi.

  • SlowZoomWalkEnabled (BoolValue) – Impostazione per il controllo dello sprint.
  • SprintEnabled (BoolValue) – Impostazione per il controllo dello sprint.
• Libraries (Folder) – Memorizza tutti gli altri ModuleScripts utilizzati nel sistema delle armi.
• WeaponTypes (Folder) – Specifica tutti i tipi di armi.
• ServerWeaponsScript (Script)
• Version (IntValue)
• ClientWeaponScript (LocalScript)
• NetworkingCallbacks (ModuleScript)
• WeaponData (RemoteEvent)
• WeaponsSystem (ModuleScript)

All'interno della cartella WeaponsSystem, diversi aspetti sono controllati dai seguenti ModuleScripts:

Struttura dell'arma

Le armi approvate sono Tools e sono nominate come appariranno nello zaino del giocatore. Ogni arma è strutturata con una gerarchia simile.

Tipo di arma

Il WeaponType StringValue corrisponde al ModuleScript per l'arma nella cartella WeaponsSystem/WeaponTypes. I due valori base sono BulletWeapon e BowWeapon.

Modello dell'arma

Ogni arma contiene un Model composto da uno o più BaseParts per formare l'arma fisica. Uno di questi dovrebbe essere impostato come PrimaryPart del modello.

Il modello include anche i seguenti discendenti importanti che possono essere genitori di uno dei BaseParts del modello:

• TipAttachment – Attachment la cui posizione sul BasePart padre determina dove escono i proiettili/proiettili.
• HandleAttachment – Attachment la cui posizione sul BasePart padre determina dove è saldata la Maniglia.
• Fired

  opzionale

  – Sound che viene riprodotto quando l'arma viene sparata.
• Reload

  opzionale

  – Sound che viene riprodotto quando l'arma viene ricaricata.
• Discendenti aggiuntivi per eventuali opzioni specializzate.

Maniglia dell'arma

La parte Handle determina dove un personaggio del giocatore tiene l'arma. Questo deve essere un Part, deve essere nominato Handle e deve essere un figlio diretto dell'arma (strumento).

Cartella di configurazione

La cartella Configuration contiene tipi di "valore" specifici per il comportamento dell'arma. Oltre ai valori predefiniti, puoi aggiungere ulteriori elementi di configurazione per opzioni specializzate quando applicabile.

Di seguito sono riportate le configurazioni di base e i loro valori predefiniti:

Opzioni specializzate

Puoi aggiungere/modificare le seguenti opzioni per qualsiasi arma. Queste personalizzazioni richiedono di modificare il Model dell'arma, la Configuration dell'arma, o entrambi. Alcune configurazioni dipendono da altre, come le Particelle della bocca che richiedono i discendenti necessari per Effetti e suoni dei proiettili/impatto.

Animazioni e suoni delle chiavette

La chiavetta di un'arma è la parte che si muove avanti e indietro ogni volta che viene sparata.

• Discendenti del Modello dell'arma

• Figli della cartella di Configurazione dell'arma

Eiettare gusci di proiettili

Le armi possono includere gusci di proiettili fisici che si eiettano al momento dello sparo e cadono a terra.

• Discendenti del Modello dell'arma

• Figli della cartella di Configurazione dell'arma

• Figlio della parte di guscio BasePart in Assets/Effects/Casings della cartella di sistema

Effetti e suoni dei proiettili/impatto

Puoi configurare proiettili fisici per qualsiasi arma, insieme a Sounds, Beams e ParticleEmitters per effetti di impatto e altri effetti speciali.

• Figli della cartella di Configurazione dell'arma

Discendenti di ShotEffect

Discendenti dell'ShotEffect specificato nella sezione precedente

Particelle della bocca

Questa opzione emette particelle dall'emettitore di particelle specificato dall'Attachment della TipAttachment quando viene sparata l'arma.

Discendenti della configurazione:

• ShotEffect (StringValue) — Nome di un effetto di colpo memorizzato in WeaponsSystem/Assets/Effects/Shots.
• NumMuzzleParticles (IntValue) (opzionale) — Numero di particelle della bocca che verranno emesse; il predefinito è 50.

Per l'effetto di colpo specificato, aggiungi un asset ParticleEmitter all'interno di WeaponsSystem/Assets/Effects/Shots nominato MuzzleParticles.

Lampi della bocca

Questa opzione crea un effetto di flash Beam quando l'arma viene sparata.

Discendenti del modello:

• MuzzleFlash0 (Attachment) — Utilizzato per specificare un lato del flash della bocca. La posizione non ha importanza.
• MuzzleFlash1 (Attachment) — Utilizzato per specificare il lato opposto del flash della bocca. La posizione non ha importanza.
• MuzzleFlash (Beam) — Assicurati di impostare Attachment0 su MuzzleFlash0 e Attachment1 su MuzzleFlash1.

Discendenti della configurazione:

• MuzzleFlashTime (NumberValue) (opzionale) — Durata del flash della bocca; il predefinito è 0.03.
• MuzzleFlashRotation0 (NumberValue) (opzionale) — Rotazione minima del flash della bocca; il predefinito è -math.pi.
• MuzzleFlashRotation1 (NumberValue) (opzionale) — Rotazione massima del flash della bocca; il predefinito è math.pi.
• MuzzleFlashSize0 (NumberValue) (opzionale) — Dimensione minima del flash della bocca; il predefinito è 1.
• MuzzleFlashSize1 (NumberValue) (opzionale) — Dimensione massima del flash della bocca; il predefinito è 1.

Sentieri di particelle

Questa opzione crea un sentiero di lunghezza variabile dall'arma al punto di impatto del proiettile.

Discendenti della configurazione:

• TrailLength (NumberValue) (opzionale) — Lunghezza del sentiero dietro al proiettile; il predefinito è nil, il che significa che la lunghezza del sentiero verrà calcolata utilizzando TrailLengthFactor.
• TrailLengthFactor (NumberValue) (opzionale) — La lunghezza del sentiero sarà impostata su questo valore moltiplicato per la distanza percorsa dal proiettile nella scorsa cornice; il predefinito è 1. Nota che questo verrà sovrascritto se includi TrailLength.
• ShowEntireTrailUntilHit (BoolValue) (opzionale) — Imposta su true per rendere visibile il sentiero dalla punta dell'arma fino a dove si trova il proiettile; questo sovrascriverà sia TrailLength che TrailLengthFactor, e il sentiero scomparirà solo una volta che il proiettile colpisce qualcosa. Imposta su false per utilizzare una delle due opzioni sopra per calcolare la lunghezza del sentiero. Il predefinito è false.

Segni di colpo

Questa aggiunta visiva appare sulla superficie dove i proiettili colpiscono e è utile per frecce, fori di proiettile, segni di bruciore, ecc.

Discendenti della configurazione:

• HitMarkEffect (StringValue) (opzionale) — Nome dell'effetto di segno di colpo memorizzato in WeaponsSystem/Assets/Effects/HitMarks; il predefinito è BulletHole.
• AlignHitMarkToNormal (BoolValue) (opzionale) — Imposta su true se il segno di colpo dovrebbe sempre allinearsi piatto contro la superficie come un foro di proiettile, o false se il segno di colpo dovrebbe apparire conficcato nella superficie dalla direzione da cui è arrivato il proiettile (come una freccia). Il predefinito è true.

Puoi aggiungere il seguente asset opzionale all'interno di WeaponsSystem/Assets/Effects/HitMarks:

• Glow (Decal) (opzionale) — Appare sulla superficie colpita completamente opaca, poi rapidamente diventa più trasparente, come un effetto luminoso sulla superficie che svanisce rapidamente. Utile per mostrare un segno rosso luminoso dove sono esplosi gli esplosivi.
• BulletHole (Decal) (opzionale) — Appare sulla superficie colpita completamente opaca e, dopo 4 secondi, svanisce in trasparente in 1 secondo.
• ImpactBillboard (BillboardGui) (opzionale) — Visualizza sulla superficie colpita, sempre rivolto verso la telecamera.

  • Impact (ImageLabel) (opzionale) — Figlio diretto di ImpactBillboard; inizia completamente opaco, cresce fino alla dimensione completa di ImpactBillboard in 0.1 secondi, poi si riduce alla metà della sua dimensione e svanisce fino alla trasparenza completa in 0.1 secondi.
• Qualsiasi Part/MeshPart/SpecialMesh che desideri apparire come un proiettile fisico (opzionale). Ad esempio, includendo un MeshPart per una freccia e impostando AlignHitMarkToNormal notato sopra su false farà sì che la freccia sporga dalla superficie nella direzione dalla quale è stata sparata.

Proiettili esplosivi

I proiettili possono includere un oggetto Explosione per danneggiare i personaggi giocatore in un'area intorno al punto di impatto.

Discendenti della configurazione:

• ExplodeOnImpact (BoolValue) (opzionale) — Imposta su true se desideri che i proiettili dell'arma esplodano all'impatto, false altrimenti. Il predefinito è false.
• BlastRadius (NumberValue) (opzionale) — Raggio d'esplosione dell'esplosione; il predefinito è 8.
• BlastPressure (NumberValue) (opzionale) — Pressione di esplosione dell'esplosione; il predefinito è 10000.
• BlastDamage (NumberValue) (opzionale) — Danno inflitto a cose nel centro dell'esplosione. Nota che l'esplosione infligge meno danni man mano che gli oggetti colpiti si allontanano dal centro dell'esplosione. Il predefinito è 100.

Arma di carica

Un'arma di carica come il Railgun deve essere caricata tra i colpi prima di poter sparare di nuovo.

Discendenti del modello:

• Charging (Sound) (opzionale) — Viene riprodotto mentre l'arma si sta caricando.
• Discharging (Sound) (opzionale) — Viene riprodotto mentre l'arma si sta scaricando, ad esempio se carichi parzialmente l'arma e rilasci il pulsante di sparo.
• ChargeComplete (Sound) (opzionale) — Viene riprodotto quando l'arma ha raggiunto la carica completa.
• DischargeComplete (Sound) (opzionale) — Viene riprodotto quando l'arma è stata completamente scaricata.
• ChargeGlow (BasePart) (opzionale) — Questo oggetto diventerà meno trasparente man mano che l'arma si carica, in modo che sia completamente opaco al 100% di carica.
• ChargeCompleteParticles (ParticleEmitter) (opzionale) — Emesso quando l'arma ha terminato la carica. Questo emettitore può essere un figlio di qualsiasi parte BasePart del modello o un figlio di un Attachment all'interno del BasePart.
• DischargeCompleteParticles (ParticleEmitter) (opzionale) — Emesso quando l'arma è stata completamente scaricata. Questo emettitore può essere un figlio di qualsiasi parte BasePart del modello o un figlio di un Attachment all'interno del BasePart.
• ChargingParticles (ParticleEmitter) (opzionale) — Emesso mentre l'arma si sta caricando. Puoi includere più emettitori di questo nome e ognuno emetterà durante la fase di carica. Questo emettitore può essere un figlio di qualsiasi parte BasePart del modello o un figlio di un Attachment all'interno del BasePart.

Discendenti della configurazione:

• ChargeRate (NumberValue) — Tasso di caricamento dell'arma. Questo valore deve essere specificato per indicare che l'arma utilizza la carica.
• DischargeRate (NumberValue) (opzionale) — Tasso al quale l'arma si scaricherà; il predefinito è 0, il che significa che l'arma non si scaricherà affatto.
• ChargePassively (BoolValue) (opzionale) — Imposta su true se desideri che l'arma si carichi in modo passivo per sparare istantaneamente quando clicchi, o false se desideri cliccare/toccare per caricare l'arma e farla sparare una volta raggiunta la carica completa. Il predefinito è false.
• ChargingParticlesRatePerCharge (IntValue) (opzionale) — Numero di particelle che emetteranno tutti i ChargingParticles emettitori moltiplicato per la carica attuale dell'arma. Il predefinito è 20, il che significa che se la carica dell'arma è al 10%, ciascun emettitore di ChargingParticles emetterà 2 particelle (20×0.1), e se la carica dell'arma è al 90%, ciascun emettitore emetterà 18 particelle (20×0.9).
• FireDischarge (NumberValue) (opzionale) — Quantità di carica che l'arma perderà dopo aver sparato un colpo completamente carico; il predefinito è 1.
• NumChargeCompleteParticles (IntValue) (opzionale) — Numero di particelle che l'emettitore di ChargeCompleteParticles emetterà una volta che l'arma è completamente carica. Il predefinito è 25.
• NumDischargeCompleteParticles (IntValue) (opzionale) — Numero di particelle che l'emettitore di DischargeCompleteParticles emetterà quando l'arma è completamente scaricata. Il predefinito è 25.

Arma arco

Un'arma arco come l'Arco incrociato può includere una costruzione realistica di corda e braccia, così come una freccia visiva incoccata sulla corda.

Oltre ad aggiungere discendenti del modello, devi applicare i seguenti:

• Trasforma l'arma in un' arma di carica. Ad esempio, aggiungi il necessario ChargeRate all'interno della Configuration dell'arma che specifica quanto velocemente viene tesa la corda. Inoltre, considera di aggiungere discendenti opzionali al modello dell'arma come un suono Charging per la corda/braccia tirate indietro.
• Imposta il WeaponType su BowWeapon come indicato nella Struttura dell'arma.

Discendenti del modello:

• LeftString (Beam) (opzionale) — La metà sinistra visiva della corda.
• RightString (Beam) (opzionale) — La metà destra visiva della corda.
• Arrow (BasePart) (opzionale) — La freccia che appare quando l'arco è completamente teso. Nota che questo è solo per l'aspetto visivo dell'arco (la freccia effettivamente sparata sarà un ShotEffect come delineato in Effetti di proiettile/impatto e suoni).
• String1 (Attachment) (opzionale) — Il punto centrale della corda.
• StringLoose (Attachment) (opzionale) — Punto in cui String1 dovrebbe trovarsi quando l'arco è a riposo.
• StringTight (Attachment) (opzionale) — Punto in cui String1 dovrebbe trovarsi quando l'arco è completamente teso.
• Arms (Part) (opzionale) — Una parte che funge solo da indicatore interno che le braccia dell'arco saranno animate. Questo può contenere i seguenti figli diretti:
• LeftString0 (Attachment) (opzionale) — Punto in cui il lato sinistro della corda è attaccato all'arco.
• RightString0 (Attachment) (opzionale) — Punto in cui il lato destro della corda è attaccato all'arco.
• LeftLoose (Attachment) (opzionale) — Punto in cui LeftString0 dovrebbe trovarsi quando l'arco è a riposo.
• RightLoose (Attachment) (opzionale) — Punto in cui RightString0 dovrebbe trovarsi quando l'arco è a riposo.
• LeftTight (Attachment) (opzionale) — Punto in cui LeftString0 dovrebbe trovarsi quando l'arco è completamente teso.
• RightTight (Attachment) (opzionale) — Punto in cui RightString0 dovrebbe trovarsi quando l'arco è completamente teso.
• [SpecialMesh] (SpecialMesh) (opzionale) — La parte dell'arco che effettivamente si piega quando l'arco viene teso. Nota che devi specificare i seguenti quattro oggetti Vector3Value affinché questo si animati.
• LooseOffset (Vector3Value) (opzionale) — Offset del SpecialMesh quando l'arco è a riposo.
• TightOffset (Vector3Value) (opzionale) — Offset del SpecialMesh quando l'arco è completamente teso.
• LooseScale (Vector3Value) (opzionale) — Scala del SpecialMesh quando l'arco è a riposo.
• TightScale (Vector3Value) (opzionale) — Scala del SpecialMesh quando l'arco è completamente teso.

GUI del sistema armi

Il sistema armi principale interagisce con questo sistema per aggiornare la GUI in base a variabili come la dispersione dell'arma, indicatori per quando vieni colpito o colpisci altri, ecc.

Il WeaponsSystemGui è un oggetto ScreenGui in WeaponsSystem/Assets che è genitore di PlayerGui all'avvio dell'esperienza. WeaponSystemGui ha 4 discendenti:

• ScalingElements - Una Folder di elementi sullo schermo.
• LargeTouchscreen - Un Frame per i pulsanti sugli schermi touch grandi.
• Scope - Un Frame per lo zoom con armi che utilizzano un mirino.
• SmallTouchscreen - Un Frame per i pulsanti sugli schermi touch piccoli.

Elementi scalabili

ScalingElements è una Folder genitore sotto WeaponsSystemGui con i seguenti discendenti:

LargeTouchscreen

LargeTouchscreen è un Frame contenente pulsanti che vengono visualizzati sugli schermi touch grandi. LargeTouchscreen ha i seguenti discendenti:

• AimButton (ImageButton)
• FireButton (ImageButton)

Scope

Scope è un Frame che contiene ScopeImage (ImageLabel) che appare quando si zooma su un'arma con HasScope abilitato (vedi Struttura dell'arma).

Scope ha i seguenti discendenti:

SmallTouchscreen

SmallTouchScreen è un Frame contenente pulsanti che vengono visualizzati sugli schermi touch piccoli. SmallTouchscreen ha i seguenti discendenti:

• AimButton (ImageButton)
• FireButton (ImageButton)

Creare un indicatore direzionale

Gli indicatori direzionali sono utilizzati per mostrare la direzione di qualcosa intorno al mirino del giocatore. Ad esempio, se qualcuno ti spara, un semicerchio rosso può apparire intorno al mirino nella direzione da cui proviene il colpo. Altri esempi includono indicatori per mostrare la direzione dei passi, il fuoco indiretto o anche oggetti ambientali come forzieri.

Per creare un nuovo indicatore, aggiungi un nuovo indicatore Frame in WeaponsSystemGui/ScalingElements/DirectionalIndicators con la seguente struttura:

Una volta creato, puoi attivare un indicatore tramite il comando seguente all'interno di WeaponsSystem/Libraries/WeaponsGui dove indicatorName è il nome della stringa dell'indicatore da attivare e worldPos è la posizione del mondo a cui l'indicatore direzionale dovrebbe puntare:

self.DirectionalIndicatorGuiManager:ActivateDirectionalIndicator(indicatorName, worldPos)

Configurazione dell'indicatore

Gli indicatori direzionali possono essere ulteriormente modificati regolando l'oggetto Configuration genitore sotto il [Indicatore]. Tutte queste impostazioni hanno un valore predefinito, quindi non è necessario impostare configurazioni quando non si modifica un'impostazione.

Le seguenti configurazioni possono essere impostate:

Mostra cartellone danni

Il cartellone danni viene utilizzato per mostrare piccoli numeri sopra la testa di un personaggio quando subiscono danni. Questi verranno mostrati solo per il giocatore che ha danneggiato il personaggio di un altro giocatore, non per i giocatori spettatori.

I cartelloni danni sono gestiti in WeaponsSystem/Libraries/DamageBillboardHandler e possono essere attivati da qualsiasi codice lato client come segue, dove il danno è l'ammontare di danno inflitto e adornmentPart è la parte su cui decorare il cartellone, come la testa della vittima:

DamageBillboardHandler:ShowDamageBillboard(damage, adornmentPart)

Telecamera sopra la spalla

La telecamera sopra la spalla è una telecamera in terza persona che guarda sopra la spalla destra del personaggio del giocatore. Per personalizzare la telecamera sopra la spalla, modifica le variabili sotto il commento -- Parametri di configurazione (costanti) nella funzione ShoulderCamera.new() di WeaponsSystem/Libraries/ShoulderCamera. Puoi modificare cose come il campo visivo, lo spostamento dal personaggio, la velocità di camminata durante lo sprint o lo zoom, ecc.

Controllo sprint e zoom

Per impostazione predefinita, il sistema delle armi aggiunge la capacità di "sprint", quindi i giocatori possono sprintare tenendo premuto il tasto Shift, premendo completamente il joystick dinamico (mobile), o premendo completamente il joystick sinistro (gamepad). Se desideri disabilitare lo sprint, imposta il valore di SprintEnabled all'interno di WeaponsSystem/Configuration su false.

Il sistema riduce anche la velocità del giocatore mentre sta mirando/zoomando, ma puoi disabilitare questo comportamento impostando il valore di SlowZoomWalkEnabled su false.