From 7680915ddfc354919f39f8692dfb3f6fc2aec4cb Mon Sep 17 00:00:00 2001 From: Marko Lindqvist Date: Fri, 23 Jun 2023 09:22:20 +0300 Subject: [PATCH 9/9] README.AI: Update want values documentation See osdn #47796 Signed-off-by: Marko Lindqvist --- doc/README.AI | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/doc/README.AI b/doc/README.AI index 10e4976d94..2c719d457e 100644 --- a/doc/README.AI +++ b/doc/README.AI @@ -70,21 +70,22 @@ The long-term goals for Freeciv AI development are WANT CALCULATIONS ================= -Build calculations are expressed through a structure called adv_choice. -This has a variable called "want", which determines how much the AI +Build calculations are expressed through a structure called adv_choice. +This has a variable called "want", which determines how much the AI wants whatever item is pointed to by choice->type. choice->want is - -199 get_a_boat - < 0 an error - == 0 no want, nothing to do - <= 100 normal want - > 100 critical want, used to requisition emergency needs - > ??? probably an error (1024 is a reasonable upper bound) - > 200 Frequently used as a cap. When want exceeds this value, - it is reduced to a lower number. - -These are ideal numbers, your mileage while travelling through the -code may vary considerably. Technology and diplomats, in particular, + < 0 Get a boat instead, + absolute value of the want correct + == 0 No want, nothing to do + <= DAI_WANT_BELOW_MIL_EMERGENCY Normal want + > DAI_WANT_MILITARY_EMERGENCY Critical want, + used to requisition emergency needs + > DAI_WANT_DOMESTIC_MAX Frequently used as a cap. + When want exceeds this value, + it is reduced to a lower number. + +These are ideal numbers, your mileage while travelling through the +code may vary considerably. Technology and diplomats, in particular, seem to violate these standards. -- 2.40.1