1

#ifndef AI_H

     2

#define AI_H

     3

     4

#include "../functions.h"

     5

#include "../network.h"

     6

#include "../player.h"

     7

     8

/* How DoCommands look like for an AI */

     9

typedef struct AICommand {

    10

	uint32 tile;

    11

	uint32 p1;

    12

	uint32 p2;

    13

	uint32 procc;

    14

	CommandCallback* callback;

    15

    16

	char *text;

    17

	uint uid;

    18

    19

	struct AICommand *next;

    20

} AICommand;

    21

    22

/* The struct for an AIScript Player */

    23

typedef struct AIPlayer {

    24

	bool active;            ///< Is this AI active?

    25

	AICommand *queue;       ///< The commands that he has in his queue

    26

	AICommand *queue_tail;  ///< The tail of this queue

    27

} AIPlayer;

    28

    29

/* The struct to keep some data about the AI in general */

    30

typedef struct AIStruct {

    31

	/* General */

    32

	bool enabled;           ///< Is AI enabled?

    33

	uint tick;              ///< The current tick (something like _frame_counter, only for AIs)

    34

    35

	/* For network-clients (a OpenTTD client who acts as an AI connected to a server) */

    36

	bool network_client;    ///< Are we a network_client?

    37

	uint8 network_playas;   ///< The current network player we are connected as

    38

} AIStruct;

    39

    40

VARDEF AIStruct _ai;

    41

VARDEF AIPlayer _ai_player[MAX_PLAYERS];

    42

    43

// ai.c

    44

void AI_StartNewAI(PlayerID player);

    45

void AI_PlayerDied(PlayerID player);

    46

void AI_RunGameLoop(void);

    47

void AI_Initialize(void);

    48

void AI_Uninitialize(void);

    49

int32 AI_DoCommand(TileIndex tile, uint32 p1, uint32 p2, uint32 flags, uint procc);

    50

int32 AI_DoCommandCc(TileIndex tile, uint32 p1, uint32 p2, uint32 flags, uint procc, CommandCallback* callback);

    51

    52

/** Is it allowed to start a new AI.

    53

 * This function checks some boundries to see if we should launch a new AI.

    54

 * @return True if we can start a new AI.

    55

 */

    56

static inline bool AI_AllowNewAI(void)

    57

{

    58

	/* If disabled, no AI */

    59

	if (!_ai.enabled)

    60

		return false;

    61

    62

	/* If in network, but no server, no AI */

    63

	if (_networking && !_network_server)

    64

		return false;

    65

    66

	/* If in network, and server, possible AI */

    67

	if (_networking && _network_server) {

    68

		/* Do we want AIs in multiplayer? */

    69

		if (!_patches.ai_in_multiplayer)

    70

			return false;

    71

    72

		/* Only the NewAI is allowed... sadly enough the old AI just doesn't support this

    73

		 *  system, because all commands are delayed by at least 1 tick, which causes

    74

		 *  a big problem, because it uses variables that are only set AFTER the command

    75

		 *  is really executed... */

    76

		if (!_patches.ainew_active)

    77

			return false;

    78

	}

    79

    80

	return true;

    81

}

    82

    83

#define AI_CHANCE16(a,b)    ((uint16)     AI_Random()  <= (uint16)((65536 * a) / b))

    84

#define AI_CHANCE16R(a,b,r) ((uint16)(r = AI_Random()) <= (uint16)((65536 * a) / b))

    85

    86

/**

    87

 * The random-function that should be used by ALL AIs.

    88

 */

    89

static inline uint AI_RandomRange(uint max)

    90

{

    91

	/* We pick RandomRange if we are in SP (so when saved, we do the same over and over)

    92

	 *   but we pick InteractiveRandomRange if we are a network_server or network-client.

    93

	 */

    94

	if (_networking)

    95

		return InteractiveRandomRange(max);

    96

	else

    97

		return RandomRange(max);

    98

}

    99

   100

/**

   101

 * The random-function that should be used by ALL AIs.

   102

 */

   103

static inline uint32 AI_Random(void)

   104

{

   105

/* We pick RandomRange if we are in SP (so when saved, we do the same over and over)

   106

	 *   but we pick InteractiveRandomRange if we are a network_server or network-client.

   107

	 */

   108

	if (_networking)

   109

		return InteractiveRandom();

   110

	else

   111

		return Random();

   112

}

   113

   114

#endif /* AI_H */