🧑Classe PlayerInstance

Représente un joueur connecté ou un profil sauvegardé. Cette classe vous permet de lire et modifier toutes les propriétés du personnage.

📂 Propriétés (getters/setters)

Toutes ces méthodes agissent comme getter/setter : si vous passez une valeur, elle est mise à jour ; sinon, elle est retournée.

player:id(id?)

Paramètres

• id (number, optionnel) : Nouvel identifiant

Retour

• number : Identifiant actuel

player:firstname(firstname?)

Paramètres

• firstname (string, optionnel) : Nouveau prénom

Retour

• string : Prénom actuel

player:lastname(lastname?)

Paramètres

• lastname (string, optionnel) : Nouveau nom

Retour

• string : Nom actuel

player:birthdate(birthdate?)

Paramètres

• birthdate (string, optionnel) : Nouvelle date de naissance

Retour

• string : Date actuelle

player:height(height?)

Paramètres

• height (number, optionnel) : Nouvelle taille

Retour

• number : Taille actuelle

player:weight(weight?)

Paramètres

• weight (number, optionnel) : Nouveau poids

Retour

• number : Poids actuel

player:nationality(nationality?)

Paramètres

• nationality (string, optionnel) : Nouvelle nationalité

Retour

• string : Nationalité actuelle

player:sex(sex?)

Paramètres

• sex (string, optionnel) : Sexe

Retour

• string : Sexe actuel

player:hunger(hunger?)

Paramètres

• hunger (number, optionnel) : Nouveau niveau de faim

Retour

• number : Niveau actuel

player:thirst(thirst?)

Paramètres

• thirst (number, optionnel) : Nouveau niveau de soif

Retour

• number : Niveau actuel

player:alcohol(alcohol?)

Paramètres

• alcohol (number, optionnel) : Nouveau niveau d’alcool

Retour

• number : Niveau actuel

player:drugs(drugs?)

Paramètres

• drugs (number, optionnel) : Nouveau niveau de drogues

Retour

• number : Niveau actuel

player:armor(armor?)

Paramètres

• armor (number, optionnel) : Nouveau niveau d’armure

Retour

• number : Niveau actuel

player:health(health?)

Paramètres

• health (number, optionnel) : Nouvelle santé

Retour

• number : Santé actuelle

player:position(position?, updateEntityCoords?)

Paramètres

• position (vector3 | vector4, optionnel) : Nouvelle position

• updateEntityCoords (boolean, optionnel) : Mettre à jour la position entité

Retour

• vector3 | vector4 : Position actuelle

player:heading(heading?, updateEntityCoords?)

Paramètres

• heading (number, optionnel) : Nouveau heading

• updateEntityCoords (boolean, optionnel) : Mettre à jour la rotation entité

Retour

• number : Heading actuel

player:job(job?)

Paramètres

• job (table, optionnel) : Nouveau job

Retour

• table : Métier actuel

player:job_grade(job_grade?)

Paramètres

• job_grade (table, optionnel) : Nouveau grade

Retour

• table : Grade actuel

player:permissions(permissions?)

Paramètres

• permissions (number, optionnel) : Droits

Retour

• number : Permissions actuelles

player:skin(skin?)

Paramètres

• skin (Skin | table, optionnel) : Nouvelle apparence

Retour

• Skin | table : Apparence actuelle

player:inventory(inventory?)

Paramètres

• inventory (Inventory | table, optionnel) : Inventaire

Retour

• Inventory | table : Inventaire actuel

player:inventory_id(inventory_id?)

Paramètres

• inventory_id (number, optionnel) : ID inventaire

Retour

• number : ID actuel

player:bank_account_id(bank_account_id?)

Paramètres

• bank_account_id (number, optionnel) : ID compte bancaire

Retour

• number : ID actuel

player:identifiers(identifiers?)

Paramètres

• identifiers (table, optionnel) : Identifiants

Retour

• table : Identifiants actuels

player:source(source?)

Paramètres

• source (number, optionnel) : Source GTA

Retour

• number : Source actuel

player:fullname()

Retour

• string : Nom complet

player:loaded(loaded?)

Paramètres

• loaded (boolean, optionnel) : Chargé

Retour

• boolean : État actuel

player:hate(hate?)

Paramètres

• hate (0 | 1 | 2, optionnel) : Niveau de haine

Retour

• 0 | 1 | 2 : Niveau actuel

player:slots(slots?)

Paramètres

• slots (integer, optionnel) : Nombre de slots

Retour

• integer : Slots actuel

player:locked(locked?)

Paramètres

• locked (0 | 1, optionnel) : Joueur bloqué

Retour

• 0 | 1 : État actuel

player:group(group?)

Paramètres

• group (integer, optionnel) : Groupe

Retour

• integer : Groupe actuel

player:metadata(metadata?)

Paramètres

• metadata (table, optionnel) : Métadonnées

Retour

• table : Métadonnées actuelles

player:score(score?)

Paramètres

• score (string, optionnel) : Score

Retour

• string : Score actuel

player:spawned(spawned?)

Paramètres

• spawned (boolean, optionnel) : Joueur spawn

Retour

• boolean : État actuel

player:dead(dead?)

Paramètres

• dead (boolean, optionnel) : Mort

Retour

• boolean : État actuel

player:ko(ko?)

Paramètres

• ko (boolean, optionnel) : K.O.

Retour

• boolean : État actuel

---

⚙️ Méthodes

player:remove()

Supprime le joueur et libère les ressources

---

🛠️ Exemple d’utilisation

-- Récupérer le nom complet
print(player:fullname())

-- Modifier le job
player:job({ name = "mechanic" })

-- Changer la position et heading
player:position(vector3(200.0, -1000.0, 30.0), true)
player:heading(180.0, true)

-- Vérifier l’état
if player:dead() then
    print("Le joueur est mort.")
end

-- Supprimer le joueur
player:remove()

---

⚠️ Notes

• La plupart des setters synchronisent les données côté serveur.

• remove() détruit l’instance et invalide l’accès.

• fullname() combine prénom et nom automatiquement.