tw.player

Cote : Client | Alias : tw.pl

Informations du joueur mises a jour automatiquement, rafraichies toutes les 100ms. Fournit un acces rapide au ped, aux coordonnees et a l'identite du joueur local.

Proprietes

Propriete	Type	Description
tw.player.ped	integer	Handle du ped actuel du joueur
tw.player.coords	vector3	Coordonnees monde actuelles du joueur
tw.player.player_id	integer	ID du joueur local
tw.player.server_id	integer	ID du joueur cote serveur (source)
tw.player.is_male	boolean	Si le modele du joueur est masculin

Callable

tw.player() peut etre appele directement comme une fonction. Il retourne tw.player.ped.

local ped = tw.player()
-- equivalent a tw.player.ped

Fonctions

tw.player.force_update()

Force un rafraichissement immediat de toutes les proprietes du joueur. Declenche l'evenement twinded_libs:player:update apres la mise a jour.

tw.player.force_update()
-- tw.player.coords est maintenant garanti a jour

---

tw.player.move(callback, interval?)

Enregistre un callback qui se declenche quand le joueur se deplace. Le callback est appele immediatement lors du premier enregistrement avec la position actuelle. Plusieurs callbacks peuvent etre enregistres.

Parametre	Type	Defaut	Description
callback	function	—	Appelee avec les donnees du joueur mises a jour lors d'un deplacement
interval	integer?	—	Intervalle de poll personnalise en ms

tw.player.move(function()
    print("Player moved to", tw.player.coords)
end)

---

tw.player.did_move_since(id) -> boolean

Verifie si le joueur s'est deplace depuis le dernier appel de cette fonction avec l'id donne. Chaque id suit sa propre position independamment.

Parametre	Type	Description
id	string	Identifiant unique pour cette verification de mouvement

Retour : boolean — true si le joueur s'est deplace depuis le dernier appel avec cet id.

if tw.player.did_move_since("my_feature") then
    print("Player moved since last check")
end

Exemples

Acceder aux informations du joueur

tw.ready(function()
    print("Server ID:", tw.player.server_id)
    print("Position:", tw.player.coords)
    print("Is male:", tw.player.is_male)
end)

Reagir au deplacement du joueur

tw.player.move(function()
    -- Mettre a jour les marqueurs proches, rafraichir l'UI, etc.
    local pos = tw.player.coords
    -- ...
end)

Utiliser comme raccourci de fonction

local ped = tw.player()
SetEntityHeading(ped, 180.0)

Evenements

Evenement	Description
twinded_libs:player:update	Declenche apres la completion de force_update()

Notes

• Les proprietes sont mises a jour automatiquement toutes les 100ms dans un thread en arriere-plan.
• tw.player() est un raccourci pour tw.player.ped et peut etre utilise partout ou un handle de ped est attendu.
• did_move_since est utile pour limiter les operations couteuses qui ne doivent s'executer que lorsque le joueur change de position.