Fonctions

Fonctions liés aux joueurs

Identification

Nom et Paramètres	Valeur retour	Description
server.player_id(cn)	nombre	Obtenez l'ID unique pour le nom du joueur et l'adresse IP.
server.player_sessionid(cn)	nombre	Obtenez l'ID unique pour la connexion du joueur.
server.player_name(cn)	string	Obtenir le nom du joueur.
server.player_displayname(cn)	string	Obtenir le nom du joueur pour l'affichage du nom. Si le nom n'est pas unique, alors CN est annexé.
server.player_team(cn)	string	Obtenir le nom de l'équipe du joueur.
server.player_ip(cn)	string	Obtenez l'adresse IP du joueur.
server.player_iplong(cn)	nombre	Obtenez l'adresse IP du joueur sous forme de nombre de long.

Stats du jeu

Nom et Paramètres	Valeur de retour	Description
server.player_frags(cn)	nombre	Note: affectée par le suicide et le teamkilling
server.player_deaths(cn)	nombre
server.player_teamkills(cn)	nombre
server.player_suicides(cn)	nombre
server.player_damage(cn)	nombre
server.player_damagewasted(cn)	nombre
server.player_hits(cn)	nombre
server.player_misses(cn)	nombre
server.player_shots(cn)	nombre
server.player_accuracy(cn)	nombre	Calculé à partir des coups et ratés. Note: client du jeu utilise une méthode différente de calcul qui peut être perceptible dans les modes de jeu tels que la FFA et l'efficiency.
server.player_accuracy2(cn)	nombre	Calculé à partir des dommages et damagewasted. Méthode de calcul du client, utilisée dans les meilleures récompensses/stats et les modules de stats.
server.player_timeplayed(cn)	nombre	Nombre de secondes jouées dans la partie en cours.
server.player_win(cn)	nombre	Retourne 1 ou 0 pour victoire ou defaite, respectivement. En mode simple, un gagnant est le joueur avec le plus de frags. En mode équipe, les gagnants sont les joueurs de l'équipe gagnante.
server.player_rank(cn)	nombre	Le classement du joueur calculé à la fin de la partie. Pour les jeux de l'équipe, le rang est relatif aux membres de l'équipe.
server.player_armour(cn)	nombre
server.player_armour_type(cn)	nombre

Stats de connexion

Nom et Paramètres	Valeur Retour	Description
server.player_connection_time(cn)	nombre	Nombre de secondes connectés au serveur.
server.player_ping(cn)	nombre	Retourne la dernière valeur de ping signalé.
server.player_lag(cn)	nombre	Obtenir la valeur de décalage du lecteur mesuré comme le temps de retard entre la réception de mises à jour de position (LAG).

Statut actuel

Nom et Paramètres	Valeur Retour	Description
server.player_status(cn)	string	Statut de jeu: mort, vivant, édition, etc
server.player_status_code(cn)	nombre	Constants: `server.ALIVE`, `server.DEAD`, `server.SPAWNING`, `server.LAGGED`, `server.SPECTATOR`, `server.EDITING`
server.player_pos(cn)	nombre, nombre, nombre	Dernière position reçue
server.player_gun(cn)	string	Arme courants tenus
server.player_health(cn)	nombre
server.player_maxhealth(cn)	nombre
server.player_priv(cn)	string	Le statut de Master: aucun, master ou admin
server.player_priv_code(cn)	nombre	Constants: `server.PRIV_NONE`, `server.PRIV_MASTER` and `server.PRIV_ADMIN`
server.player_mapcrc(cn)	string	La valeur map CRC envoyé par le client.
server.player_isbot(cn)	boolean	Retourne 'true' si le joueur est un bot.

Contrôles

Nom et Paramètres	Valeur Retour	Description
server.player_msg(cn, text)	nil	Envoyer un message du serveur à un joueur.
server.player_slay(cn)	nil	Tue un joueur; leurs stats ne sont pas affectés.
server.player_suicide(cn)	nil	Forcer un joueur à un suicide, ce qui aura une incidence sur leurs statistiques de jeu.
server.changeteam(cn, team)	boolean	Déplacer un joueur à une autre équipe.
server.kick(cn,[bantime],[admin],[reason])	nil	Kick et banni un joueur du serveur. Arguments par défaut: bantime=4 hours, admin=“server”, reason=“”.
server.permban(ip)	nil	Régler l'adresses IP comme définitivement banni du serveur.
server.unsetban(ip)	boolean	Retirer adresse IP de liste des adresses banni.
server.spec(cn)	nombre	Forcer un joueur à rejoindre le mode spectateurs.
server.unspec(cn)	nil	Forcer un joueur à rejoindre le jeu.
server.mute(cn)	nil	Bloquer les messages de chat du joueur dès qu'ils sont reçus.
server.unmute(cn)	nil	Ne plus bloquer les messages de chat du joueur.
server.setmaster(cn)	nil	Donnez un privilège de master à un joueur.
server.setadmin(cn)	nil	Donnez un privilège d'admin à un joueur.
server.unsetmaster()	nil	Retirer le privilège de master du master actuel.
server.set_invisible_admin(cn)	nil	Donnez au joueur le statut d'admin, mais il est invisible pour les autres joueurs.
server.set_invisible_master(cn)	nil	Donnez au joueur le statut de master, mais il est invisible pour les autres joueurs.
server.unsetpriv(cn)	nil	Retirer le privilege d'un joueur. Cette fonction fonctionne sur tous les privilèges.

Itération du joueur

Nom et Paramètres	Valeur Retour	Description
server.players()	table	Retourne un liste de CN pour tous les joueurs.
server.gplayers(option)		Fonction iterator, retourne un objet de joueur pour chaque itération. Argument option peut être nulle, «joueurs», «spectateurs» ou «tous».
server.spectators()	table	Retourne un liste de CN pour tous les spectateurs .
server.bots	table	Retourne un liste de CN pour tous les bots.

Object Wrapper

L'objet wrapper transforme les fonctions du joueur sur les méthodes d'objet joueur, vous trouverez peut-être que c'est plus rapide ou pense que c'est plus agréable d'utiliser le wrapper de l'objet. Les noms des fonctions sont les mêmes, sauf qu'ils n'ont pas le préfixe de joueur, donc par exemple le

.player_frags(cn)

est juste :

:frags()

pour le joueur objet. Pour construire un nouvel appel d'objet joueur

server.new_player_object(cn)

Exemple:

for player in server.gplayers() do
  player:spec()
end

Fonctions d'équipe

Nom et Paramètres	Valeur Retour	Description
server.teams()	table	Retourne une liste de noms d'équipe.
server.team_players(team)	table	Retourne une liste de CN pour tous les joueurs de l'équipe spécifié.
server.team_score(team)	nombre
server.team_win(team)	boolean	A le score le plus élevé de toutes les équipes.
server.team_draw(team)	boolean	Le score est égal aux scores de toutes les autres équipes. TODO: supprimer argument.

Fonctions de jeu

Nom et Paramètres	Description
pausegame(pause)	Pause ou reprend le jeu. La valeur d'argument doit être 1 ou 0
changetime(milliseconds)	Change le temps restant
changemap(map,[mode],[time])	change la map
delbot(cn)	Supprimer un bot du jeu appartenant à un joueur

Functions du serveur

Nom et Paramètres	Description
restart()	Redémarrez le processus du serveur à la fin du jeu ou immédiatement si le serveur est vide.
restart_now()	Redémarrez le serveur immédiatement
shutdown()	Arrêtez le processus du serveur (qui va également mettre fin au processus du bot IRC)
reloadscripts()	Recharger tous les scripts sans avoir à redémarrer le serveur
msg(text)	Diffuser un message sur le serveur
clearbans()	Effacer toutes les bannissement temporaires
loadbanlist(filename)
writebanlist(filename)
permban(ip)
unsetban(ip)
recorddemo(filename)	Démarrer immédiatement l'enregistrement du jeu (pas de message de serveur est diffusé)
stopdemo()	Arrêtez l'enregistrement du jeu

Fonctions utilitaires

Nom et Paramètres	Description
ip_to_country(ip)	Résoudre les adresses IP par pays
ip_to_country_code(ip)	Résoudre l'adresse IP d'un code de pays à deux lettres
load_geoip_database(filename)	Résoudre l'adresse IP à un code de pays à deux lettres
gethostbyname(name)	Résoudre FQDN à l'adresse IP.