Verse è il linguaggio di programmazione di UEFN. Questa pagina presenta le nozioni di base per integrare rapidamente Verse nei tuoi progetti, offrendo una base solida sia per chi è alle prime armi sia per sviluppatori più esperti, così da comprendere le potenzialità del linguaggio.
I Bersagli che hai creato nelle fasi precedenti del tutorial al momento possono essere abbattuti con un solo colpo: ora imparerai come usare Verse per far sì che si comportino esattamente in questo modo!
Crea un nuovo dispositivo Verse
In questa sezione imparerai a creare un dispositivo Verse e a posizionarlo sulla tua isola.
Pensalo come un dispositivo che comunica agli altri cosa devono fare, seguendo le tue istruzioni. In altre parole, realizzerai un programma Verse che riprogramma un dispositivo esistente all’interno di UEFN!
Nella Barra del menu, seleziona Verse > Verse Explorer.
In Verse Explorer, fai clic con il pulsante destro del mouse sul tuo progetto e seleziona Aggiungi nuovo file Verse al progetto.
Si apre la finestra Crea script Verse.
Nella finestra Crea script Verse, seleziona il modello dispositivo Verse.
Rinomina il dispositivo shooting_range_manager_device nella parte inferiore della finestra, quindi fai clic su Crea.
Troverai shooting_range_manager_device in Esplora contenuti cercando il nome del tuo progetto oppure utilizzando la casella di ricerca per i dispositivi.
Nella Barra del menu, seleziona Verse > Compila codice Verse.
Quando lavori con il codice di un dispositivo Verse, devi eseguire la sua build (operazione definita anche compilazione) prima di poterlo utilizzare nel tuo progetto. In altre parole, ciò significa permettere a Verse di convertire il codice in un formato eseguibile, utilizzabile come gioco o come parte di esso. Il dispositivo Verse non viene visualizzato in Esplora contenuti o nell'Outliner fino a quando non è stato creato.
Troverai shooting_range_manager_device in Esplora contenuti cercando il nome del tuo progetto oppure utilizzando la casella di ricerca per i dispositivi.
Trascinalo nella viewport.
Nel pannello Dettagli, sotto Opzioni utente, deseleziona l'opzione Visibile in gioco per nascondere il dispositivo mentre il gioco è in esecuzione.
Imposta i bersagli corretti
Ricorda i Bersagli corretti costruiti nella sezione 3. Creazione di un poligono di tiro?
Modificherai questi bersagli utilizzando il tuo dispositivo Verse, in modo che possano essere abbattuti tutti contemporaneamente con un colpo solo.
In Verse Explorer, fai due volte clic su
shooting_range_manager_device.verseper aprire il file Verse.Elimina tutto il codice presente nel file, quindi copia e incolla il codice seguente al posto di quello precedente.
Verseusing { /Fortnite.com/Devices } using { /Verse.org/Simulation } # A device that manages shooting range gameplay. shooting_range_manager_device := class(creative_device): @editable GoodTarget1:shooting_range_target_track_device = shooting_range_target_track_device{} @editableIn Verse, una variabile è un'informazione del programma che può cambiare mentre esso è in esecuzione.
Quando una variabile è modificabile, significa che è esposta in UEFN: in altre parole, può essere modificata direttamente dall'interfaccia di UEFN senza dover ricompilare il codice Verse ogni volta.
Il codice appena aggiunto al dispositivo Verse definisce tre variabili (GoodTarget1, GoodTarget2 e GoodTarget3) del tipo
shooting_range_track_device. Queste ultime rappresenteranno i Bersagli che il giocatore dovrà colpire per guadagnare punti. Una volta rese queste variabili@editable, potrai impostare i loro valori nel pannello Dettagli come preferisci senza dover continuare a modificare il codice Verse. Questo codice dovrà comunque essere compilato, poiché è la prima volta che viene aggiunto al progetto.Con il pannello Dettagli del tuo shooting_range_manager_device aperto, dalla viewport seleziona shooting_range_manager_device.
Compila il tuo codice.
Nel pannello Dettagli , Imposta il valore di ogni Bersaglio valido su un dispositivo Binario del manichino bersaglio diverso.
A partire da
<# --- New Code Start --- #>nel blocco di codice qui sotto, copia e incolla il codice successivo all’interno del tuo file Verse.Compila il tuo codice dopo averlo incollato.
Aggiungi il codice seguente per far sì che ogni Bersaglio corretto venga abbattuto una volta colpito.
Le sottoscrizioni di eventi collegano l'HitEvent del Bersaglio e il suo relativo callback.
Verseusing { /Fortnite.com/Devices } using { /Verse.org/Simulation } # A device that manages shooting range gameplay. shooting_range_manager_device := class(creative_device): @editable GoodTarget1:shooting_range_target_track_device = shooting_range_target_track_device{} @editable
Ogni volta che vedi una riga in un blocco di codice che inizia con # o <# e termina con #>, considera che si tratta di commenti sul codice.
I commenti relativi al codice non fanno parte del programma. Si tratta di considerazioni scritte dagli sviluppatori per fornire spiegazioni ad altri colleghi, oppure come promemoria personale per ricordare il motivo di una determinata scelta o implementazione.
Per maggiori informazioni sui commenti sul codice, consulta la sezione Commenti sul codice del Riferimento rapido al linguaggio Verse.
Imposta i bersagli errati
I Bersagli errati corrispondono ai dispositivi Manichino bersaglio, personalizzati come ad esempio gli Orsacchiotti. Questa volta, aggiungerai i bersagli al tuo dispositivo Verse in modo che vengano abbattuti con un solo colpo, ma invece di far guadagnare punti al giocatore, ogni colpo gli farà perdere punti.
Aggiungi il codice seguente per creare tre variabili
shooting_range_target_deviceper memorizzare i riferimenti ai Bersagli errati.Verseusing { /Fortnite.com/Devices } using { /Verse.org/Simulation } # A device that manages shooting range gameplay. shooting_range_manager_device := class(creative_device): @editable GoodTarget1:shooting_range_target_track_device = shooting_range_target_track_device{} @editableCompila il tuo codice.
Seleziona shooting_range_manager_device nella viewport.
Nel pannello Dettagli, imposta il valore di ogni Bersaglio errato su un dispositivo Manichino bersaglio diverso.
Aggiungi il codice seguente per visualizzare i Bersagli errati quando vengono colpiti.
Verseusing { /Fortnite.com/Devices } using { /Verse.org/Simulation } # A device that manages shooting range gameplay. shooting_range_manager_device := class(creative_device): @editable GoodTarget1:shooting_range_target_track_device = shooting_range_target_track_device{} @editable
Imposta il punteggio
Prima di utilizzare Verse per personalizzare un dispositivo, devi aggiungere quello che vuoi personalizzare.
Anche se teoricamente puoi impostare il punteggio anche con i dispositivi Fortnite, con Verse risulta tutto più semplice e richiede la configurazione di meno dispositivi.
Aggiungi un dispositivo Punteggio
Anche se imposterai sia l’aggiunta che la sottrazione di punti, con Verse ti basterà un solo dispositivo di punteggio per gestirli entrambi.
In Esplora contenuti, digita Gestione punteggio nella barra di ricerca per trovare il dispositivo corrispondente.
Trascina il dispositivo Gestione punteggio nella viewport. Apri le opzioni utente di Gestione punteggio nel pannello Dettagli.
Nel pannello Dettagli, modifica le seguenti opzioni:
Opzione e valore Abilita durante la fase = Solo durante gameplay
Mostra aggiornamento punteggio su HUD = Seleziona opzione
Personalizza il dispositivo Punteggio con Verse
Ora puoi aggiungere Gestione punteggio al tuo dispositivo Verse per definire i punti del giocatore in base ai Bersagli colpiti.
Aggiungi il codice seguente per creare le variabili che memorizzano un riferimento al dispositivo Gestione punteggio e i relativi valori di punteggio. Puoi modificare i valori predefiniti direttamente nel codice o eseguirne l’override modificandoli dal pannello Dettagli.
Verseusing { /Fortnite.com/Devices } using { /Verse.org/Simulation } # A device that manages shooting range gameplay. shooting_range_manager_device := class(creative_device): <# --- New Code Start --- #> @editable ScoreManager:score_manager_device = score_manager_device{}Compila il tuo codice.
Seleziona shooting_range_manager_device nella viewport.
Nel pannello Dettagli di shooting_range_manager_device, imposta ScoreManager sul dispositivo Gestione punteggio.
Aggiungi il codice seguente per aggiornare il punteggio del giocatore quando colpisce i Bersagli corretti o errati.
Verseusing { /Fortnite.com/Devices } using { /Verse.org/Simulation } # A device that manages shooting range gameplay. shooting_range_manager_device := class(creative_device): @editable ScoreManager:score_manager_device = score_manager_device{} @editableCompila il tuo codice.
Seleziona Verse > Compila codice Verse dalla Barra del menu.
Con la sessione di Fortnite aperta, fai clic su Invia modifiche per applicare in tempo reale gli aggiornamenti effettuati con Verse. Potresti dover anche terminare e riavviare il gioco per vedere le modifiche apportate correttamente.
Esegui il playtest delle modifiche apportate nella sessione di Fortnite per assicurarti che:
Il punteggio giocatore aumenta quando viene colpito un Bersaglio corretto. (Apri la classifica durante la riproduzione premendo il tasto M.)
Il punteggio giocatore diminuisce quando viene colpito un Bersaglio errato.
Chi gioca può abbattere i Bersagli in un colpo solo.