
  Agent de Gestion Urbaine (AGU)
==================================

L'AGU est un outil plutt rcent ajout au client GTK+ de Freeciv
version 1.12.1. Il est conu pour vous aider  grer vos cits c'est 
dire dployer les travailleurs sur les cases environnantes disponibles
(ou bien en faire des scientifiques, des percepteurs ou des artistes)
pour obtenir le meilleur de la cit. Vous pouvez activer ou dsactiver
l'AGU  tout moment pour n'importe quelle cit, mais il y a des
handicaps (expliqus plus loin) si vous avez des cits gres et
d'autres non gres par AGU proches les unes des autres. Dans tous les
cas vous avez besoin de la version serveur 1.12.1 ou suivantes ; l'AGU
ne fonctionne pas sur les versions 1.12.0 et prcdentes.

Le coeur de AGU est un algorithme optimis, qui essaye de dployer les
travailleurs d'une cit de telle manire que le but dfini par
l'utilisateur soit atteint autant que possible. Vous savez
probablement qu'il y a dj quelques optimisations, lorsque vous
ouvrez une cit, et cliquez sur la case centrale (symbole de la cit)
de la mini carte. Cette optimisation essaye de maximiser le taux de
science ; mais il ne se proccupe pas des dsordres civils.

Le nouvel Agent de Gestion Urbaine (CMA=City Management Agent) va plus
loin que cette ancienne forme d'optimisation. En premier lieu, il
assure sa tche  chaque fois que quelque chose change dans la
cit. Si la cit grandit ou diminue, des troupes quittent ou arrivent,
des cases sont irrigues, ont une mine ou bien sont occupes par des
ennemis, l'AGU devient actif. En second lieu, il supporte toutes
sortes d'optimisations comme la production (boucliers), l'or, la
science, ou le luxe. En troisime lieu, il donne au joueur un contrle
trs fin sur ceci, avec la possibilit de poser des contraintes sur
n'importe quel rendement de la cit. Ceci inclut une contrainte de
clbration, qui rend trs facile de faire grandir votre cit, mme en
des temps difficiles. En quatrime lieu, et probablement est-ce la
facult la plus intressante en temps de guerre, il garde vos cits en
tat de contentement prvenant ainsi les rvoltes.

  Usage
=========

Vous pouvez rgler l'AGU pour une cit en ouvrant la fentre de la
cit et cliquez sur l'onglet AGU. Sur le cot gauche, vous pouvez
slectionner un pr-rglage dans la liste, sur le cot droit vous
pouvez rgler des buts plus complexes en changeant les barres de
dfilement (glisseurs). Vous pouvez slectionner un pr-rglage
d'abord, et ensuite le modifier. Une fois cr un nouveau rglage,
vous pouvez lui dfinir un nom. Ce n'est pas ncessaire mais trs
utile  l'usage dans la mesure o, si un nom est dfini, vous pouvez
voir et mme changer les rglages  partir du rapport des
cits. N'oubliez pas d'enregistrer la configuration (dans le menu
"jeu") lorsque vous avez cr de nouveaux pr-rglages.

Les glisseurs sont de deux sortes : les glisseurs les plus  droites
sont des facteurs, qui mesurent la valeur d'un rendement par rapport
aux autres (par exemple combien de production vaudra le coup en tenant
compte de l'ensemble des facteurs) Les glisseurs les plus  gauche
sont les contraintes : vous pouvez dcider par exemple que la cit ne
perde pas de nourriture en rglant la contrainte de surplus  zro,
vous pouvez permettre que la cit perde de l'argent en rglant la
contrainte de surplus de l'or  -3 et presser la cit de gnrer au
moins une production de 5 par tour en rglant le surplus de production
 5. La contrainte la plus puissante, pourtant, est la contrainte de
Clbration qui fait clbrer dans la cit en une fois (ce qui
habituellement prend effet le tour suivant aprs l'avoir modifi).

Il est vident que l'AGU ne peut respecter toutes ces contraintes dans
tous les cas. Chaque fois que les contraintes ne peuvent tre
atteintes l'AGU quitte son service pour cette cit et affiche un
message : "l'agent ne peut pas remplir les pr-requis pour Paris et
redonne le contrle." Vous avez alors le choix de grer la cit par
vous mme (ce qui a des inconvnients, voir plus loin) ou d'ouvrir la
cit et de changer les exigences de surplus se sorte qu'elles puissent
tre atteintes.

Lorsque vous avez fait un rglage pour une cit, vous devez cliquer
sur le bouton "Contrles" pour activer l'AGU. Si ce bouton est en
gris, l'AGU est dj actif ou bien l'action est impossible. Dans ce
dernier cas vous pouvez voir des tirets  la place des nombres dans
les blocs de rsultat. Si vous voulez dlibrment dsactiver l'AGU
cliquez sur le bouton "Librer la ville".


  Usage avanc
==================

Nous n'avons pas encore beaucoup d'exprience sur l'utilisation de
l'AGU, mais quelques remarques basiques peuvent aider. Habituellement
le but de vos cits dpend de la phase du jeu dans laquelle vous tes,
selon que vous voulez vous tendre largement, grossir rapidement,
rechercher des avancs technologiques ou faire la guerre. Vous pouvez
vouloir rgler un haut facteur de recherche pour la science, ou bien
un haut facteur de production pour produire des units. Le plus haut
facteur est 25, ce qui veut dire que, si le facteur de production est
rgl  25 et les autres  1, l'AGU prfre un rendement de 1
production  25 Or (ou commerce). C'est vraiment beaucoup parce ce que
l'argent permet d'acheter des units aussi. Ceci veut dire galement
que l'AGU est indiffrent au fait de produire de l'or, de la science,
du luxe ou de la nourriture ; mais lorsque vous faites la guerre vous
prfrez habituellement de l'or ou du luxe.  Donc c'est probablement
une bonne ide de dfinir une deuxime (voire mme une troisime)
prfrence pour le rendement de la cit, par exemple un facteur de 5
pour l'or. Ceci donne encore la prfrence  1 production sur 5 or (et
1 or sur 5 nourriture ou n'importe quoi d'autre).

Les contraintes ne sont pas utiles dans tous les cas. Si vous voulez
un haut revenu, il est probablement prfrable de rgler un facteur or
 25, plutt que de rgler un surplus minimal de 5 ou plus. Parce
qu'une grosse cit peut faire plus d'argent qu'une petite, vous
finiriez par rgler des surplus diffrents pour chaque cit.

Cependant si le surplus de production d'une cit est en dessous de
zro, elle ne peut plus supporter toutes ses units. Vous perdrez des
units supportes par la cit. Si le surplus de nourriture est
ngatif, la cit sera en famine et ventuellement (lorsque le grenier
est vide) descendra d'une taille. Ceci peut tre intentionnel, mais
attention au fait que si une cit supporte des colons vous les perdrez
avant que la cit ne soit rduite. Les contraintes peuvent aussi avoir
une fonction d'alarme.

Quelles contraintes peuvent tre atteintes dpend largement des taux
globaux de sciences, taxes, et luxe. Par exemple, un surplus d'or >=0
est plus facile  atteindre avec un taux de taxe lev plutt que
l'inverse. Vous devez toujours penser  changer ces taux quand vous
allez changer les rglages de l'AGU pour la plupart de vos cits.

Conseil : Pour viter de librer accidentellement vos cits lorsque
vous changez les taux, il est mieux de le faire dans la bote de
dialogue des taxes plutt que dans l'affichage des taux sur la fentre
principale.


 Inconvnients (Handicaps)
==========================

L'AGU est un outil trs puissant, qui peut non seulement vous librer
de la micro gestion de vos cits mais vous donne aussi les meilleures
performances que vous n'avez jamais vues (enfin pour la plupart des
joueurs :).

Il existe certains inconvnients cependant. Une fois que vous activez
l'AGU, il se saisit de toutes les bonnes cases qu'il trouve. Aussi il
est trs difficile parfois de grer soi-mme une cit situe prs
d'une autre contrle par AGU.  Ceci est vrai pour la fentre d'une
cit et galement pour l'interface des travailleurs de la carte
principale. Si vous voulez disposer de cits contrles par AGU et de
cits "manuelles", vous devriez probablement les placer sur des les
diffrentes.

Il existe plusieurs cas o l'AGU ne peut remplir son objectif
temporairement par exemple, quand vous dplacez un bateau d'une cit 
une autre, ou quand un ennemi traverse votre pays. L'AGU rend le
contrle dans ces cas, et vous devez le ractiver manuellement. Une
approche globale pour prvenir ceci peut tre de rgler le surplus
minimal aussi bas que possible (-20). Bien entendu vous devez tre
attentif aux surplus de nourriture et production.

Alors que l'AGU fait un bon boulot pour une ville unique, aucune case
ne sera libre pour le bien d'une autre cit. Aussi les cits
contrles par AGU sont calcules dans un ordre alatoire ; le
rsultat peut dpendre de celui-ci et changer quand un recalcul est
fait (lorsque le taux de taxes change par exemple). Par consquent
aucune garantie n'est donne que le rsultat final soit toujours
optimal.


  Configurer le fichier
========================

Le client permet  l'utilisateur d'enregistrer et de charger des
paramtres prdfinis pour les agents. Choisir "Enregistrer la
configuration"  partir du menu "Jeu" sauvegardera non seulement vos
options gnrales et les options des messages, mais sauvegardera aussi
tous les changement effectus dans les rglages d'AGU.

Le format pour le fichier d'options (normalement ~/.civclientrc) est
comme suit (dans le cas ou voudriez changer les rglages manuellement,
c'est  dire avec un diteur de texte).

Aprs l'entte [cma], il y a un "number_of_presets" (nombre de
pr-rglages).  Sa valeur doit tre fixe au nombre de pr-rglages
prsents dans le fichier.  Si vous ajoutez ou enlevez un pr-rglage
manuellement, vous devez ajuster ce nombre.

Aprs cela, il y a un tableau qui contient les pr-rglages. Voici
l'entte :
 
preset={ "name","minsurp0","factor0","minsurp1","factor1","minsurp2",
"factor2","minsurp3","factor3","minsurp4","factor4","minsurp5",
"factor5","reqhappy","factortarget","happyfactor"

Donc l'ordre des pr-rglages devrait tre comme ceci :

nom du pr-rglage, minimal surplus 0, facteur 0, ... , 
ncessite que la cit soit heureuse, la cible facteur de bonheur 
doit tre [0,1], 

Actuellement il y a 6 surplus et facteurs. Ce sont :
0 = nourriture, 1 = production, 2 = commerce, 3 = or, 4 = luxe,
5 = science

Toujours actuellement, "factortarget" n'est pas modifiable depuis le
client, voir le source "client/agents/cma_core.h" pour plus
d'information.

Le tableau doit toujours se terminer par un '}'.

Voici 21 pr-rglages que vous pouvez utiliser si vous n'y arrivez pas
avec les vtres :

"Max nourriture",0,10,0,1,0,1,0,1,0,1,0,1,0,0,1
"Max production",0,1,0,10,0,1,0,1,0,1,0,1,0,0,1
"Max commerce",0,1,0,1,0,10,0,1,0,1,0,1,0,0,1
"Max taxes",0,1,0,1,0,1,0,10,0,1,0,1,0,0,1
"Max luxe",0,1,0,1,0,1,0,1,0,10,0,1,0,0,1
"Max science",0,1,0,1,0,1,0,1,0,1,0,10,0,0,1
"+2 nourriture",2,1,0,1,0,1,0,1,0,1,0,1,0,0,1
"+2 production",0,1,2,1,0,1,0,1,0,1,0,1,0,0,1
"+2 commerce",0,1,0,1,2,1,0,1,0,1,0,1,0,0,1
"+2 or",0,1,0,1,0,1,2,1,0,1,0,1,0,0,1
"+2 luxe",0,1,0,1,0,1,0,1,2,1,0,1,0,0,1
"+2 science",0,1,0,1,0,1,0,1,0,1,2,1,0,0,1
"Max nourriture pas de limite pour l'or",0,10,0,1,0,1,-20,1,0,1,0,1,0,0,1
"Max production pas de limite pour l'or",0,1,0,10,0,1,-20,1,0,1,0,1,0,0,1
"Max commerce pas de limite pour l'or",0,1,0,1,0,10,-20,1,0,1,0,1,0,0,1
"Max or pas de limite pour l'or",0,1,0,1,0,1,-20,10,0,1,0,1,0,0,1
"Max luxe pas de limite pour l'or",0,1,0,1,0,1,-20,1,0,10,0,1,0,0,1
"Max science pas de limite pour l'or",0,1,0,1,0,1,-20,1,0,1,0,10,0,0,1
"Max nourriture+prod. pas de limite pour l'or",0,10,0,10,0,1,-20,1,0,1,0,1,0,0,1
"Max nourriture+prod.+commerce",0,10,0,10,0,10,0,1,0,1,0,1,0,0,1
"Max tout",0,1,0,1,0,1,0,1,0,1,0,1,0,0,1

En voici 6 de plus ajouts aprs-coup :

"+1 nourriture, max prod. pas de limite pour l'or",1,1,0,10,0,1,-20,1,0,1,0,1,0,0,1
"+2 nourriture, max prod. pas de limite pour l'or",2,1,0,10,0,1,-20,1,0,1,0,1,0,0,1
"+3 nourriture, max prod. pas de limite pour l'or",3,1,0,10,0,1,-20,1,0,1,0,1,0,0,1
"+4 nourriture, max prod. pas de limite pour l'or",4,1,0,10,0,1,-20,1,0,1,0,1,0,0,1
"+5 nourriture, max prod. pas de limite pour l'or",5,1,0,10,0,1,-20,1,0,1,0,1,0,0,1
"+6 nourriture, max prod. pas de limite pour l'or",6,1,0,10,0,1,-20,1,0,1,0,1,0,0,1

Et encore d'autres avec des buts multiples :

"recherche  tout prix",0,1,0,5,-20,1,-20,1,-20,1,-20,25,0,0,1
"clbration et croissance",1,1,0,25,-20,1,-20,12,-20,1,-20,1,1,0,1
"croissance  tout prix",1,25,0,5,-20,1,-20,1,-20,1,-20,5,0,0,1
"recherche et de la production",0,1,0,8,0,1,-3,1,0,1,0,25,0,0,1
"production et un peu d'argent",0,1,0,25,0,1,-3,3,0,1,0,1,0,0,1
"beaucoup de production et de l'argent",0,1,0,25,0,1,0,9,0,1,0,1,0,0,1
"production et de la recherche",0,1,0,25,0,1,-2,1,0,1,0,8,0,0,1
"clbration et croissance en un coup",1,1,0,25,-20,1,-20,1,-20,1,-20,8,1,0,1


traduction sitro@nerim.net


Last updated: 9 Jan 2002
