Créer un mécanisme de collecte de pièces

Les sections suivantes décrivent plus en détail le fonctionnement du script.

Initialiser les services et les variables

Comme avec beaucoup de code que vous avez probablement écrit dans d'autres langages, vous définissez des variables dont vous avez besoin plus tard en haut du script. Notre code fait ce qui suit :

• Obtenir des instances de services - Les services Roblox offrent une fonctionnalité intégrée pour des fonctionnalités courantes. Le script obtient d'abord des instances du service Workspace, qui contient chaque objet dans le monde 3D, et du service Player, qui gère et contient tous les joueurs connectés à votre jeu.
• Obtenir des références à toutes les pièces - Le script interroge ensuite l'espace de travail 3D pour toutes les références aux objets pièces avec la méthode GetChildren(). Cette méthode renvoie un tableau contenant tout ce qui est enfanté à l'objet avec lequel elle est associée, qui dans ce cas est le dossier Workspace.World.Coins que vous avez créé précédemment.
• Définit une variable globale - La variable COOLDOWN est utilisée plus tard pour définir combien de temps désactiver une pièce après qu'elle a été collectée.

Initialisation des services et des variables
local Workspace = game:GetService("Workspace")
   local Players = game:GetService("Players")

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

   local COOLDOWN = 10
   ...

Définir la fonction de gestion des événements

Le moteur Roblox simule physiquement le monde 3D et gère une grande partie de la logique pour traiter les événements liés au rendu, à la physique et au réseau. Lorsque vous souhaitez écrire votre propre logique lors de certains de ces événements, vous pouvez les écouter et les gérer tout en laissant le moteur faire le reste. Dans ce cas, vous écoutez et gérez les événements liés aux pièces touchées. Le script définit la logique pour traiter cet événement dans la méthode onCoinTouched(), qui fait ce qui suit :

• Détecte si la pièce est activée - Chaque Instance a un attribut booléen Enabled qui définit si l'objet existe ou non dans le monde 3D. Vous pouvez obtenir les attributs d'instance avec la méthode GetAttribute().
• Détecte si un joueur a touché la pièce - Si une pièce est activée, la méthode utilise le service joueur pour vérifier si l'objet qui a touché la pièce était effectivement un joueur. Lorsqu'un événement de toucher se produit, le moteur Roblox passe l'objet qui a touché la pièce en tant que paramètre otherPart. Le script vérifie si le parent de otherPart appartient à un joueur.
• Désactive la pièce si un joueur l'a touchée et la réactive après 10 secondes - Enfin, si un joueur a touché la pièce, la méthode désactive la pièce, attend 10 secondes, puis réactive la pièce pour la collecte. task.wait() est utilisé à la place de wait() car il offre de meilleures performances en ne suspendant pas complètement l'exécution du code, permettant aux tâches dans d'autres threads de s'exécuter en parallèle.

Définition de la fonction de gestion des événements
local function onCoinTouched(otherPart, coin)
      if coin:GetAttribute("Enabled") then
         local character = otherPart.Parent
         local player = Players:GetPlayerFromCharacter(character)
         if player then
            -- Le joueur a touché une pièce
            coin.Transparency = 1
            coin:SetAttribute("Enabled", false)
            print("Le joueur a collecté une pièce")
            task.wait(COOLDOWN)
            coin.Transparency = 0
            coin:SetAttribute("Enabled", true)
         end
      end
   end

Connecter la fonction de gestion des événements

Tous les objets 3D simulés héritent de BasePart et ont donc un événement Touched(). La boucle suivante connecte le gestionnaire onTouchedEvent() à l'événement de toucher de chaque pièce en effectuant ce qui suit :

• Parcourir toutes les pièces - Parcourez chacune des pièces en utilisant une itération générale.
• Connecter le gestionnaire à l'événement - À chaque itération de la boucle, la pièce est activée par défaut, de sorte qu'elle soit visible dans le monde 3D pendant le début initial du jeu. La méthode de gestionnaire onCoinTouched() est également connectée à l'événement Touched de la pièce afin qu'elle s'exécute chaque fois que l'événement se produit. Lorsque le moteur détecte un toucher, il passe également l'objet qui a touché l'objet, otherPart.

Connexion de la fonction de gestion des événements
for _, coin in coins do
      coin:SetAttribute("Enabled", true)
      coin.Touched:Connect(function(otherPart)
         onCoinTouched(otherPart, coin)
      end)
   end