Crea una meccanica di raccolta monete

Le seguenti sezioni descrivono come funziona lo script in modo più dettagliato.

Inizializza servizi e variabili

Come con gran parte del codice che probabilmente hai scritto in altre lingue, definisci le variabili di cui hai bisogno più tardi nella parte superiore dello script. Il nostro codice fa quanto segue:

• Ottieni istanze di servizio - I servizi di Roblox forniscono funzionalità integrate per funzionalità comuni. Lo script prima ottiene istanze del servizio Workspace, che contiene ogni oggetto nel mondo 3D, e del servizio Player, che gestisce e contiene tutti i giocatori connessi al tuo gioco.
• Ottieni riferimenti a tutte le monete - Lo script quindi interroga lo spazio di lavoro 3D per tutti i riferimenti agli oggetti moneta con il metodo GetChildren(). Questo metodo restituisce un array contenente tutto ciò che è genitore dell'oggetto a cui è associato, che in questo caso è la cartella Workspace.World.Coins che hai creato in precedenza.
• Definisce una variabile globale - La variabile COOLDOWN viene utilizzata in seguito per definire quanto tempo disabilitare una moneta dopo che è stata raccolta.

local Workspace = game:GetService("Workspace")
   local Players = game:GetService("Players")

   local coinsFolder = Workspace.World.Coins
   local coins = coinsFolder:GetChildren()

   local COOLDOWN = 10
   ...

Definisci il gestore dell'evento

Il motore di Roblox simula fisicamente il mondo 3D e gestisce gran parte della logica per gestire eventi relativi al rendering, alla fisica e al networking. Quando sei interessato a scrivere la tua logica durante alcuni di questi eventi, puoi ascoltarli e gestirli, lasciando che il motore faccia il resto. In questo caso, ascolti e gestisci eventi relativi alle monete toccate. Lo script definisce la logica per gestire questo evento nel metodo onCoinTouched(), che fa quanto segue:

• Rileva se la moneta è abilitata - Ogni Instance ha un attributo booleano Enabled che definisce se l'oggetto esiste o meno nel mondo 3D. Puoi ottenere gli attributi delle istanze con il metodo GetAttribute().
• Rileva se un giocatore ha toccato la moneta - Se una moneta è abilitata, il metodo utilizza il servizio dei giocatori per controllare se l'oggetto che ha toccato la moneta era effettivamente un giocatore. Quando si verifica un evento di tocco, il motore di Roblox passa l'oggetto che ha toccato la moneta come parametro otherPart. Lo script controlla se il genitore di otherPart appartiene a un giocatore.
• Disabilita la moneta se un giocatore l'ha toccata e la riabilita dopo 10 secondi - Infine, se un giocatore ha toccato la moneta, il metodo disabilita la moneta, attende 10 secondi e poi riabilita la moneta per la raccolta. task.wait() viene utilizzato invece di wait() perché fornisce prestazioni migliori non interrompendo completamente l'esecuzione del codice, consentendo ai compiti in altri thread di essere eseguiti in modo concorrente.

local function onCoinTouched(otherPart, coin)
      if coin:GetAttribute("Enabled") then
         local character = otherPart.Parent
         local player = Players:GetPlayerFromCharacter(character)
         if player then
            -- Il giocatore ha toccato una moneta
            coin.Transparency = 1
            coin:SetAttribute("Enabled", false)
            print("Il giocatore ha raccolto la moneta")
            task.wait(COOLDOWN)
            coin.Transparency = 0
            coin:SetAttribute("Enabled", true)
         end
      end
   end

Collega il gestore dell'evento

Tutti gli oggetti 3D simulati ereditano da BasePart e quindi hanno un evento Touched(). Il seguente ciclo collega il gestore onTouchedEvent() a ogni evento di tocco delle monete facendo quanto segue:

• Ciclo attraverso tutte le monete - Cicla attraverso ciascuna delle monete utilizzando un'iterazione generale.
• Collega il gestore all'evento - In ogni iterazione del ciclo, la moneta è abilitata per impostazione predefinita, quindi è visibile nel mondo 3D durante l'avvio iniziale del gioco. Il metodo del gestore onCoinTouched() è anche collegato all'evento Touched della moneta in modo che venga eseguito ogni volta che si verifica l'evento. Quando il motore rileva un tocco, passa anche l'oggetto che ha toccato l'oggetto, otherPart.

for _, coin in coins do
      coin:SetAttribute("Enabled", true)
      coin.Touched:Connect(function(otherPart)
         onCoinTouched(otherPart, coin)
      end)
   end