Maak een muntverzameling mechaniek

De volgende secties beschrijven hoe het script in meer detail werkt.

Initialiseer services en variabelen

Net als bij veel van de code die je waarschijnlijk in andere talen hebt geschreven, definieer je variabelen die je later nodig hebt aan de bovenkant van het script. Onze code doet het volgende:

• Verkrijg service-instanties - Roblox-services bieden ingebouwde functionaliteit voor veelvoorkomende functies. Het script verkrijgt eerst instanties van de Workspace service, die elk object in de 3D-wereld bevat, en de Player service, die alle spelers beheert en bevat die verbonden zijn met je spel.
• Verkrijg referenties naar alle munten - Het script vraagt vervolgens de 3D-werkruimte op naar alle referenties naar muntobjecten met de GetChildren() methode. Deze methode retourneert een array die alles bevat wat aan het object is gekoppeld, wat in dit geval de Workspace.World.Coins map is die je eerder hebt gemaakt.
• Definieert een globale variabele - De COOLDOWN variabele wordt later gebruikt om te definiëren hoe lang een munt moet worden uitgeschakeld nadat deze is verzameld.

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

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

   local COOLDOWN = 10
   ...

Definieer de event handler

De Roblox Engine simuleert fysiek de 3D-wereld en behandelt veel van de logica om gebeurtenissen met betrekking tot rendering, fysica en netwerken te verwerken. Wanneer je geïnteresseerd bent in het scripten van je eigen logica tijdens enkele van deze gebeurtenissen, kun je luisteren naar en ze verwerken, terwijl je de engine de rest laat doen. In dit geval luister je naar en verwerk je gebeurtenissen met betrekking tot het aanraken van munten. Het script definieert de logica voor het verwerken van deze gebeurtenis in de onCoinTouched() methode, die het volgende doet:

• Detecteert of de munt is ingeschakeld - Elke Instance heeft een Enabled boolean attribuut dat definieert of het object al dan niet bestaat in de 3D-wereld. Je kunt instantie-attributen ophalen met de GetAttribute() methode.
• Detecteert of een speler de munt heeft aangeraakt - Als een munt is ingeschakeld, gebruikt de methode de spelerservice om te controleren of het object dat de munt aanraakte inderdaad een speler was. Wanneer een aanraking plaatsvindt, geeft de Roblox Engine het object dat de munt aanraakte door als een otherPart parameter. Het script controleert of de ouder van otherPart tot een speler behoort.
• Schakelt de munt uit als een speler deze aanraakt, en schakelt deze weer in na 10 seconden - Ten slotte, als een speler de munt aanraakt, schakelt de methode de munt uit, wacht 10 seconden en schakelt de munt weer in voor verzameling. task.wait() wordt gebruikt in plaats van wait() omdat het betere prestaties biedt door de code-uitvoering niet volledig te pauzeren, waardoor taken in andere threads gelijktijdig kunnen worden uitgevoerd.

local function onCoinTouched(otherPart, coin)
      if coin:GetAttribute("Enabled") then
         local character = otherPart.Parent
         local player = Players:GetPlayerFromCharacter(character)
         if player then
            -- Speler heeft een munt aangeraakt
            coin.Transparency = 1
            coin:SetAttribute("Enabled", false)
            print("Speler verzamelde munt")
            task.wait(COOLDOWN)
            coin.Transparency = 0
            coin:SetAttribute("Enabled", true)
         end
      end
   end

Verbind de event handler

Alle gesimuleerde 3D-objecten erven van BasePart en hebben daarom een Touched() evenement. De volgende lus verbindt de onTouchedEvent() handler aan het aanraken van elke munt door het volgende te doen:

• Loop door alle munten - Loop door elke munt met behulp van algemene iteratie.
• Verbind de handler met het evenement - In elke iteratie van de lus wordt de munt standaard ingeschakeld, zodat deze zichtbaar is in de 3D-wereld tijdens de initiële start van het spel. De onCoinTouched() handler methode wordt ook verbonden met het Touched evenement van de munt, zodat deze elke keer wordt uitgevoerd wanneer het evenement plaatsvindt. Wanneer de engine een aanraking detecteert, geeft deze ook het object door dat het object aanraakte, otherPart.

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