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)