Fonctions & Organisation

1. Les Fonctions (Blocs Réutilisables)

Une fonction est un bloc de code qui a un nom. Tu peux l'appeler (l'exécuter) autant de fois que tu veux, sans réécrire le code.

1.1 Créer une Fonction

On utilise le mot-clé function suivi du nom qu'on veut lui donner :

local function direBonjour()
    print("Bonjour, bienvenue dans le jeu !")
end

1.2 Appeler une Fonction

Créer une fonction ne l'exécute PAS automatiquement. Il faut l'appeler :

local function direBonjour()
    print("Bonjour, bienvenue dans le jeu !")
end

-- Rien ne se passe encore...

direBonjour()  -- Appel 1 : "Bonjour, bienvenue dans le jeu !"
direBonjour()  -- Appel 2 : "Bonjour, bienvenue dans le jeu !"
direBonjour()  -- Appel 3 : "Bonjour, bienvenue dans le jeu !"

1.3 Exemple Concret : Effet Visuel

Voici une fonction qui fait clignoter une Part :

local maPart = script.Parent

local function faireClignoter()
    maPart.Transparency = 1    -- Invisible
    task.wait(0.5)
    maPart.Transparency = 0    -- Visible
    task.wait(0.5)
end

-- Faire clignoter 3 fois
faireClignoter()
faireClignoter()
faireClignoter()

print("Clignotement terminé !")

2. Les Paramètres (Personnaliser les Fonctions)

Et si tu voulais que ta fonction de clignotement puisse clignoter n'importe quelle Part ? C'est là qu'interviennent les paramètres.

2.1 Qu'est-ce qu'un Paramètre ?

C'est une variable "placeholder" que tu définis entre les parenthèses. Elle sera remplacée par une vraie valeur quand tu appelleras la fonction.

local function saluer(prenom)
    print("Salut " .. prenom .. " ! Bienvenue !")
end

saluer("Alex")    -- "Salut Alex ! Bienvenue !"
saluer("Jordan")  -- "Salut Jordan ! Bienvenue !"
saluer("Sam")     -- "Salut Sam ! Bienvenue !"

2.2 Plusieurs Paramètres

Tu peux avoir autant de paramètres que tu veux, séparés par des virgules :

local function afficherStats(pseudo, niveau, xp)
    print("=== Profil Joueur ===")
    print("Pseudo : " .. pseudo)
    print("Niveau : " .. niveau)
    print("XP : " .. xp)
end

afficherStats("LearnBloxer", 42, 15000)
afficherStats("ProGamer99", 100, 999999)

2.3 La Valeur de Retour (return)

Une fonction peut aussi renvoyer un résultat avec return :

local function calculerDegats(force, arme)
    local degats = force * arme
    return degats  -- On renvoie le résultat
end

local degatsCoup = calculerDegats(10, 5)
print("Tu infliges " .. degatsCoup .. " dégâts !") -- 50 dégâts

2.4 Exemple Avancé : Système de Dégâts

local function attaquer(attaquant, cible, degatsBase)
    local degatsFinaux = degatsBase * 1.5  -- Bonus de 50%
    
    print(attaquant .. " attaque " .. cible .. " !")
    print("Dégâts infligés : " .. degatsFinaux)
    
    return degatsFinaux
end

local degats = attaquer("Guerrier", "Goblin", 20)
-- "Guerrier attaque Goblin !"
-- "Dégâts infligés : 30"

3. Scope & DRY (Organiser son Code)

Maintenant que tu sais créer des fonctions, apprenons les bonnes pratiques pour garder un code propre et maintenable.

3.1 Le Scope (Portée des Variables)

Le scope, c'est "où" une variable existe. Une variable créée dans une fonction n'existe QUE dans cette fonction :

local function maFonction()
    local variableLocale = "Je suis locale"
    print(variableLocale)  -- ? Fonctionne
end

maFonction()
print(variableLocale)  -- ? ERREUR ! La variable n'existe plus ici

3.2 Le Principe DRY

DRY = Don't Repeat Yourself (Ne te répète pas). C'est LA règle d'or du développeur.

print("Joueur 1 gagne 10 XP")
xp1 = xp1 + 10
print("Joueur 2 gagne 10 XP")
xp2 = xp2 + 10
print("Joueur 3 gagne 10 XP")
xp3 = xp3 + 10

local function gagnerXP(joueur, xp)
    print(joueur .. " gagne " .. xp .. " XP")
    return xp
end

gagnerXP("Joueur 1", 10)
gagnerXP("Joueur 2", 10)
gagnerXP("Joueur 3", 10)

3.3 Nommer ses Fonctions

Un bon nom de fonction doit être clair et descriptif. Utilise des verbes d'action :

• ✅ calculerDegats() - On sait ce que ça fait
• ✅ ouvrirPorte() - Action claire
• ✅ estVivant() - Pour les fonctions qui retournent un boolean
• ❌ fonction1() - Trop vague
• ❌ x() - Incompréhensible