Outils pour utilisateurs

Outils du site


fr:suckerserv:functions

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

fr:suckerserv:functions [2014/05/31 00:27] (Version actuelle)
Ligne 1: Ligne 1:
 +====== 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 <code lua>​.player_frags(cn)</​code>​ est juste : <code lua>:​frags()</​code>​ pour le joueur objet. Pour construire un nouvel appel d'​objet joueur <code lua>​server.new_player_object(cn)</​code>​
 +
 +Exemple:
 +<code lua>
 +for player in server.gplayers() do
 +  player:​spec()
 +end
 +</​code>​
 +
 +===== 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)