 ###############################################################################
#
# Duck Hunt v2.11  2015-2016 Menz Agitat
# Documentation
#
 ###############################################################################


########  DESCRIPTION

Duck Hunt est un FPS pour IRC.

De temps en temps, un canard s'envole et les joueurs doivent l'abattre le plus
rapidement possible.



########  FONCTIONNALITS

- Support multilingue (packs de langue franais et anglais fournis).
- Trs nombreux paramtres de configuration.
- Possibilit de spcifier des heures durant lesquelles les canards dorment.
- Les canards s'chappent au bout d'un moment ou lorsqu'ils sont effrays.
- Les canards peuvent tre gnrs alatoiement afin de djouer la dtection par
	les HL et les scripts.
- Super-canards plus difficiles  tuer et rapportant beaucoup d'xp  celui qui
	parvient  les avoir.
- Gestion des munitions et du nombre de chargeurs, le joueur doit penser 
	recharger son fusil.
- Accidents de chasse mettant en jeu la vie des autres chasseurs.
- Les risques d'accident augmentent s'il y plus de monde sur le chan.
- Les fusils peuvent tre confisqus automatiquement lorsque le chasseur commet
	une erreur.
- Les balles peuvent ricocher.
- Gain et perte de points d'xp, pnalits croissantes avec le niveau.
- 40 niveaux de progression bass sur l'xp, auxquels sont associs 40 titres.
- Karma (parce qu'il y a les bons chasseurs et les mauvais chasseurs).
- Statistiques amliorables (prcision, armure, dflexion, risque d'enrayement,
	nombre et taille des chargeurs).
- Possibilit de modifier facilement la table de progression et mme d'ajouter
	de nouveaux niveaux.
- Magasin proposant un choix de 23 objets spciaux  acheter contre de l'xp.
- Vous pourrez parfois trouver des choses intressantes en fouillant les
	buissons autour d'un canard que vous avez abattu.
- La restitution des armes confisques et le rapprovisionnement en munitions
	sont automatiss.
- Possibilit de dsarmer un joueur de faon temporaire ou permanente.
- Suivi des changements de nick, gestion des conflits, protection de niveau 1
	contre les tentatives de vol de scores.
- Cration de logs dats afin de suivre avec prcision l'activit des chasseurs.
- Exportation des donnes et des statistiques des joueurs dans un tableau,
	possibilit de tri selon 34 critres diffrents.
- Nombreuses commandes d'administration.
- Backup quotidien de la base de donnes.
- Antiflood individuel / global.

... et plus encore !



########  ACTIVATION

Pour activer Duck Hunt sur un chan, vous devez taper ceci en partyline de
l'Eggdrop :
	.chanset #NomDuChan +DuckHunt
et ceci pour le dsactiver :
	.chanset #NomDuChan -DuckHunt
Attention aux majuscules !



########  COMMANDES ET SYNTAXE

### COMMANDES DES JOUEURS

!bang
Tire un coup de fusil.

!reload
Recharge ou dcoince le fusil s'il est enray.

!lastduck
Affiche le temps coul depuis le dernier envol de canard.

!duckstats [nick]
Affiche les statistiques d'un utilisateur.

!shop [id [cible]]
Affiche une liste des objets qu'il est possible d'acheter ou effectue un achat
si "id" est spcifi.
Certains objets ncessitent qu'un joueur cible soit aussi spcifi.


### COMMANDES D'ADMINISTRATION

lastduck <chan>
Affiche le temps coul depuis le dernier envol de canard.
(Commande par message priv  l'Eggdrop)

ducklaunch <chan> [golden_duck]
Dclenche l'envol d'un canard sur le chan spcifi.
"golden_duck" dtermine s'il s'agit d'un super-canard ou d'un canard normal et
peut valoir 0 (normal) ou 1 (super-canard).
Si "golden_duck" est omis, il vaudra 0 par dfaut.
(Commande par message priv  l'Eggdrop)

duckplanning <chan>
Affiche la planification des envols de canards pour la journe en cours sur le
chan spcifi.
(Commande par message priv  l'Eggdrop)

duckreplanning <chan>
Recalcule une planification diffrente pour la journe en cours sur le chan
spcifi.
(Commande par message priv  l'Eggdrop)

ducklist <chan> [argument de recherche]
Affiche la liste des profils utilisateur sur le chan spcifi ou effectue une
recherche dans celle-ci.
(Commande par message priv  l'Eggdrop)

duckrename <chan> <ancien nick> <nouveau nick>
Renomme le profil de statistiques d'un utilisateur.
(Commande par message priv  l'Eggdrop)

duckfusion <chan> <nick destination> <nick source 1> [nick source 2] [...]
Fusionne les statistiques de plusieurs profils utilisateur.
Les statistiques de tous les nicks source seront fusionnes dans le nick
destination.
(Commande par message priv  l'Eggdrop)

duckdelete <chan> <nick>
Supprime le profil de statistiques d'un utilisateur.
(Commande par message priv  l'Eggdrop)

!unarm [-static] <nick>
Dsarme un joueur.
Le paramtre -static permet de s'assurer qu'il ne sera pas rarm lors de la
prochaine restitution automatique des armes.

!rearm <nick>
Rend son fusil  un joueur qui a t dsarm automatiquement ou manuellement.

duckexport [critre de tri]
Exporte les donnes des joueurs sous forme de tableau dans un fichier texte.
Le critre de tri peut valoir nick, last_activity, xp, level, xp_lvl_up, gun,
ammo, max_ammo, ammo_clips, max_clips, accuracy, effective_accuracy, deflection,
defense, jamming, jammed, jammed_nbr, confisc, ducks, golden_ducks, missed,
empty, accidents, wild_shots, total_ammo, shot_at, neutralized, deflected,
deaths, best_time, average_reflex_time, karma, rank ou items.
Si aucun critre de tri n'est spcifi, le tableau sera tri par nick.
(Commande par message priv  l'Eggdrop)
