Outils pour utilisateurs

Outils du site


fr:suckerserv:functions

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.
fr/suckerserv/functions.txt · Dernière modification: 2014/05/31 00:27 (modification externe)