Freeciv-3.3: /fast/freeciv/nightly/main/common/player.h File Reference

Freeciv-3.3

Loading...
Searching...
No Matches
Data Structures | Macros | Enumerations | Functions
player.h File Reference
`#include "bitvector.h"`
`#include "connection.h"`
`#include "effects.h"`
`#include "fc_types.h"`
`#include "multipliers.h"`
`#include "shared.h"`
`#include "spaceship.h"`
`#include "style.h"`
`#include "tech.h"`
`#include "unitlist.h"`
`#include "vision.h"`
`#include "specenum_gen.h"`
`#include "speclist.h"`

Go to the source code of this file.

## Data Structures

struct | player_economic
struct | player_score
struct | player_ai
struct | player_diplstate
struct | attribute_block_s
struct | multiplier_value
struct | player

## Macros

#define | PLAYER_DEFAULT_TAX_RATE 0
#define | PLAYER_DEFAULT_SCIENCE_RATE 100
#define | PLAYER_DEFAULT_LUXURY_RATE 0
#define | ANON_PLAYER_NAME "noname"
#define | ANON_USER_NAME N_("Unassigned")
#define | OWNER_NONE (-1)
#define | SPECENUM_NAME player_status
#define | SPECENUM_VALUE0 PSTATUS_NORMAL
#define | SPECENUM_VALUE1 PSTATUS_DYING
#define | SPECENUM_VALUE2 PSTATUS_WINNER
#define | SPECENUM_VALUE3 PSTATUS_SURRENDER
#define | SPECENUM_COUNT PSTATUS_COUNT
#define | SPECENUM_NAME diplstate_type
#define | SPECENUM_VALUE0 DS_ARMISTICE
#define | SPECENUM_VALUE0NAME N_("?diplomatic_state:Armistice")
#define | SPECENUM_VALUE1 DS_WAR
#define | SPECENUM_VALUE1NAME N_("?diplomatic_state:War")
#define | SPECENUM_VALUE2 DS_CEASEFIRE
#define | SPECENUM_VALUE2NAME N_("?diplomatic_state:Cease-fire")
#define | SPECENUM_VALUE3 DS_PEACE
#define | SPECENUM_VALUE3NAME N_("?diplomatic_state:Peace")
#define | SPECENUM_VALUE4 DS_ALLIANCE
#define | SPECENUM_VALUE4NAME N_("?diplomatic_state:Alliance")
#define | SPECENUM_VALUE5 DS_NO_CONTACT
#define | SPECENUM_VALUE5NAME N_("?diplomatic_state:Never met")
#define | SPECENUM_VALUE6 DS_TEAM
#define | SPECENUM_VALUE6NAME N_("?diplomatic_state:Team")
#define | SPECENUM_COUNT DS_LAST /* leave this last */
#define | SPECENUM_NAME diplrel_other
#define | SPECENUM_VALUE7 DRO_GIVES_SHARED_VISION
#define | SPECENUM_VALUE7NAME N_("Gives shared vision")
#define | SPECENUM_VALUE8 DRO_RECEIVES_SHARED_VISION
#define | SPECENUM_VALUE8NAME N_("Receives shared vision")
#define | SPECENUM_VALUE9 DRO_HOSTS_EMBASSY
#define | SPECENUM_VALUE9NAME N_("Hosts embassy")
#define | SPECENUM_VALUE10 DRO_HAS_EMBASSY
#define | SPECENUM_VALUE10NAME N_("Has embassy")
#define | SPECENUM_VALUE11 DRO_HOSTS_REAL_EMBASSY
#define | SPECENUM_VALUE11NAME N_("Hosts real embassy")
#define | SPECENUM_VALUE12 DRO_HAS_REAL_EMBASSY
#define | SPECENUM_VALUE12NAME N_("Has real embassy")
#define | SPECENUM_VALUE13 DRO_HAS_CASUS_BELLI
#define | SPECENUM_VALUE13NAME N_("Has Casus Belli")
#define | SPECENUM_VALUE14 DRO_PROVIDED_CASUS_BELLI
#define | SPECENUM_VALUE14NAME N_("Provided Casus Belli")
#define | SPECENUM_VALUE15 DRO_FOREIGN
#define | SPECENUM_VALUE15NAME N_("Foreign")
#define | SPECENUM_VALUE16 DRO_HAS_TEAM_EMBASSY
#define | SPECENUM_VALUE16NAME N_("Has team embassy")
#define | SPECENUM_VALUE17 DRO_HOSTS_TEAM_EMBASSY
#define | SPECENUM_VALUE17NAME N_("Hosts team embassy")
#define | SPECENUM_COUNT DRO_LAST
#define | MAX_ATTRIBUTE_BLOCK (256*1024) /* largest attribute block */
#define | is_human(plr) !player_has_flag((plr), PLRF_AI)
#define | is_ai(plr) player_has_flag((plr), PLRF_AI)
#define | set_as_human(plr) BV_CLR((plr)->flags, PLRF_AI)
#define | set_as_ai(plr) BV_SET((plr)->flags, PLRF_AI)
#define | player_nation(_plr_) (_plr_)->nation
#define | player_slots_iterate(_pslot)
#define | player_slots_iterate_end
#define | players_iterate(_pplayer)
#define | players_iterate_end
#define | players_iterate_alive(_pplayer)
#define | players_iterate_alive_end } players_iterate_end;
#define | SPECLIST_TAG player
#define | SPECLIST_TYPE struct player
#define | player_list_iterate(playerlist, pplayer) TYPED_LIST_ITERATE(struct player, playerlist, pplayer)
#define | player_list_iterate_end LIST_ITERATE_END
#define | MAX_AI_LOVE 1000
#define | ai_level_cmd(_level_) ai_level_name(_level_)

## Enumerations

enum | plrcolor_mode { PLRCOL_PLR_ORDER , PLRCOL_PLR_RANDOM , PLRCOL_PLR_SET , PLRCOL_TEAM_ORDER , PLRCOL_NATION_ORDER }
enum | dipl_reason { DIPL_OK , DIPL_ERROR , DIPL_SENATE_BLOCKING , DIPL_ALLIANCE_PROBLEM_US , DIPL_ALLIANCE_PROBLEM_THEM }
enum | player_debug_types { PLAYER_DEBUG_DIPLOMACY , PLAYER_DEBUG_TECH , PLAYER_DEBUG_LAST }

## Functions

| BV_DEFINE (bv_pstatus, PSTATUS_COUNT)
| BV_DEFINE (bv_diplrel_all_reqs,((DRO_LAST - 1) *2) *REQ_RANGE_COUNT)
| BV_DEFINE (bv_debug, PLAYER_DEBUG_LAST)
bool | player_has_flag (const struct player *pplayer, enum plr_flag_id flag)
bool | player_has_state (const struct player *pplayer, enum plrstate_type state)
void | player_slots_init (void)
bool | player_slots_initialised (void)
void | player_slots_free (void)
struct player_slot * | player_slot_first (void)
struct player_slot * | player_slot_next (struct player_slot *pslot)
int | player_slot_count (void)
int | player_slot_index (const struct player_slot *pslot)
struct player * | player_slot_get_player (const struct player_slot *pslot)
bool | player_slot_is_used (const struct player_slot *pslot)
struct player_slot * | player_slot_by_number (int player_id)
int | player_slot_max_used_number (void)
struct player * | player_new (struct player_slot *pslot)
void | player_set_color (struct player *pplayer, const struct rgbcolor *prgbcolor)
void | player_clear (struct player *pplayer, bool full)
void | player_ruleset_close (struct player *pplayer)
void | player_destroy (struct player *pplayer)
int | player_count (void)
int | player_index (const struct player *pplayer)
int | player_number (const struct player *pplayer)
struct player * | player_by_number (const int player_id)
const char * | player_name (const struct player *pplayer)
struct player * | player_by_name (const char *name)
struct player * | player_by_name_prefix (const char *name, enum m_pre_result *result)
struct player * | player_by_user (const char *name)
bool | player_set_nation (struct player *pplayer, struct nation_type *pnation)
bool | player_has_embassy (const struct player *pplayer, const struct player *pplayer2)
bool | player_has_real_embassy (const struct player *pplayer, const struct player *pplayer2)
bool | player_has_embassy_from_effect (const struct player *pplayer, const struct player *pplayer2)
bool | team_has_embassy (const struct team *pteam, const struct player *tgt_player)
int | player_age (const struct player *pplayer)
bool | player_can_trust_tile_has_no_units (const struct player *pplayer, const struct tile *ptile)
bool | can_player_see_hypotetic_units_at (const struct player *pplayer, const struct tile *ptile)
bool | can_player_see_unit (const struct player *pplayer, const struct unit *punit)
bool | can_player_see_unit_at (const struct player *pplayer, const struct unit *punit, const struct tile *ptile, bool is_transported)
bool | can_player_see_tile (const struct player *plr, const struct tile *ptile)
bool | can_player_see_units_in_city (const struct player *pplayer, const struct city *pcity)
bool | can_player_see_city_internals (const struct player *pplayer, const struct city *pcity)
bool | player_can_see_city_externals (const struct player *pow_player, const struct city *target_city)
bool | player_owns_city (const struct player *pplayer, const struct city *pcity)
bool | player_can_invade_tile (const struct player *pplayer, const struct tile *ptile)
struct city * | player_city_by_number (const struct player *pplayer, int city_id)
struct unit * | player_unit_by_number (const struct player *pplayer, int unit_id)
bool | player_in_city_map (const struct player *pplayer, const struct tile *ptile)
bool | player_knows_techs_with_flag (const struct player *pplayer, enum tech_flag_id flag)
int | num_known_tech_with_flag (const struct player *pplayer, enum tech_flag_id flag)
int | player_get_expected_income (const struct player *pplayer)
struct city * | player_primary_capital (const struct player *pplayer)
const char * | love_text (const int love)
enum diplstate_type | cancel_pact_result (enum diplstate_type oldstate)
struct player_diplstate * | player_diplstate_get (const struct player *plr1, const struct player *plr2)
bool | are_diplstates_equal (const struct player_diplstate *pds1, const struct player_diplstate *pds2)
enum dipl_reason | pplayer_can_make_treaty (const struct player *p1, const struct player *p2, enum diplstate_type treaty)
enum dipl_reason | pplayer_can_cancel_treaty (const struct player *p1, const struct player *p2)
bool | pplayers_at_war (const struct player *pplayer, const struct player *pplayer2)
bool | pplayers_allied (const struct player *pplayer, const struct player *pplayer2)
bool | pplayers_in_peace (const struct player *pplayer, const struct player *pplayer2)
bool | players_non_invade (const struct player *pplayer1, const struct player *pplayer2)
bool | pplayers_non_attack (const struct player *pplayer, const struct player *pplayer2)
bool | players_on_same_team (const struct player *pplayer1, const struct player *pplayer2)
int | player_in_territory (const struct player *pplayer, const struct player *pplayer2)
static bool | is_barbarian (const struct player *pplayer)
bool | gives_shared_vision (const struct player *me, const struct player *them)
bool | gives_shared_tiles (const struct player *me, const struct player *them)
void | diplrel_mess_close (void)
bool | is_diplrel_between (const struct player *player1, const struct player *player2, int diplrel)
bool | is_diplrel_to_other (const struct player *pplayer, int diplrel)
int | diplrel_by_rule_name (const char *value)
const char * | diplrel_rule_name (int value)
const char * | diplrel_name_translation (int value)
enum casus_belli_range | casus_belli_range_for (const struct player *offender, const struct unit_type *off_ut, const struct player *tgt_plr, const enum effect_type outcome, const struct action *paction, const struct tile *tgt_tile)
bv_diplrel_all_reqs | diplrel_req_contradicts (const struct requirement *req)
int | player_multiplier_value (const struct player *pplayer, const struct multiplier *pmul)
int | player_multiplier_effect_value (const struct player *pplayer, const struct multiplier *pmul)
int | player_multiplier_target_value (const struct player *pplayer, const struct multiplier *pmul)
bool | is_valid_username (const char *name)
bool | is_settable_ai_level (enum ai_level level)
int | number_of_ai_levels (void)
void * | player_ai_data (const struct player *pplayer, const struct ai_type *ai)
void | player_set_ai_data (struct player *pplayer, const struct ai_type *ai, void *data)
static bool | player_is_cpuhog (const struct player *pplayer)

## Macro Definition Documentation

## ◆ ai_level_cmd

#define ai_level_cmd | ( |  | _level_ | ) | ai_level_name(_level_)

Definition at line 569 of file player.h.

## ◆ ANON_PLAYER_NAME

#define ANON_PLAYER_NAME "noname"

Definition at line 43 of file player.h.

## ◆ ANON_USER_NAME

#define ANON_USER_NAME N_("Unassigned")

Definition at line 48 of file player.h.

## ◆ is_ai

#define is_ai | ( |  | plr | ) | player_has_flag((plr), PLRF_AI)

Definition at line 232 of file player.h.

## ◆ is_human

#define is_human | ( |  | plr | ) | !player_has_flag((plr), PLRF_AI)

Definition at line 231 of file player.h.

## ◆ MAX_AI_LOVE

#define MAX_AI_LOVE 1000

Definition at line 563 of file player.h.

## ◆ MAX_ATTRIBUTE_BLOCK

#define MAX_ATTRIBUTE_BLOCK (256*1024) /* largest attribute block */

Definition at line 223 of file player.h.

## ◆ OWNER_NONE

#define OWNER_NONE (-1)

Definition at line 50 of file player.h.

## ◆ PLAYER_DEFAULT_LUXURY_RATE

#define PLAYER_DEFAULT_LUXURY_RATE 0

Definition at line 41 of file player.h.

## ◆ PLAYER_DEFAULT_SCIENCE_RATE

#define PLAYER_DEFAULT_SCIENCE_RATE 100

Definition at line 40 of file player.h.

## ◆ PLAYER_DEFAULT_TAX_RATE

#define PLAYER_DEFAULT_TAX_RATE 0

Definition at line 39 of file player.h.

## ◆ player_list_iterate

#define player_list_iterate | ( |  | playerlist,
|  |  | pplayer
| ) |  | TYPED_LIST_ITERATE(struct player, playerlist, pplayer)

Definition at line 557 of file player.h.

## ◆ player_list_iterate_end

#define player_list_iterate_end LIST_ITERATE_END

Definition at line 559 of file player.h.

## ◆ player_nation

#define player_nation | ( |  | _plr_ | ) | (_plr_)->nation

Definition at line 408 of file player.h.

## ◆ player_slots_iterate

#define player_slots_iterate | ( |  | _pslot | ) |

Value:
if (player_slots_initialised()) { \
struct player_slot *_pslot = player_slot_first(); \
for (; NULL != _pslot; _pslot = player_slot_next(_pslot)) {
incite_cost
char * incite_cost
Definition comments.c:74
player_slot_next
struct player_slot * player_slot_next(struct player_slot *pslot)
Definition player.c:407
player_slots_initialised
bool player_slots_initialised(void)
Definition player.c:378
player_slot_first
struct player_slot * player_slot_first(void)
Definition player.c:399
player_slot
Definition player.c:46

Definition at line 525 of file player.h.

## ◆ player_slots_iterate_end

#define player_slots_iterate_end

Value:
} \
}

Definition at line 529 of file player.h.

## ◆ players_iterate

#define players_iterate | ( |  | _pplayer | ) |

Value:
player_slots_iterate(_pslot##_pplayer) { \
struct player *_pplayer = player_slot_get_player(_pslot##_pplayer); \
if (_pplayer != NULL) {
player_slots_iterate
#define player_slots_iterate(_pslot)
Definition player.h:525
player_slot_get_player
struct player * player_slot_get_player(const struct player_slot *pslot)
Definition player.c:437
player
Definition player.h:249

Definition at line 534 of file player.h.

## ◆ players_iterate_alive

#define players_iterate_alive | ( |  | _pplayer | ) |

Value:
players_iterate(_pplayer) { \
if (!_pplayer->is_alive) { \
continue; \
}
players_iterate
#define players_iterate(_pplayer)
Definition player.h:534

Definition at line 544 of file player.h.

## ◆ players_iterate_alive_end

#define players_iterate_alive_end } players_iterate_end;

Definition at line 549 of file player.h.

## ◆ players_iterate_end

#define players_iterate_end

Value:
} \
} player_slots_iterate_end;
player_slots_iterate_end
#define player_slots_iterate_end
Definition player.h:529

Definition at line 539 of file player.h.

## ◆ set_as_ai

#define set_as_ai | ( |  | plr | ) | BV_SET((plr)->flags, PLRF_AI)

Definition at line 234 of file player.h.

## ◆ set_as_human

#define set_as_human | ( |  | plr | ) | BV_CLR((plr)->flags, PLRF_AI)

Definition at line 233 of file player.h.

## ◆ SPECENUM_COUNT [1/3]

#define SPECENUM_COUNT PSTATUS_COUNT

Definition at line 80 of file player.h.

## ◆ SPECENUM_COUNT [2/3]

#define SPECENUM_COUNT DS_LAST /* leave this last */

Definition at line 80 of file player.h.

## ◆ SPECENUM_COUNT [3/3]

#define SPECENUM_COUNT DRO_LAST

Definition at line 80 of file player.h.

## ◆ SPECENUM_NAME [1/3]

#define SPECENUM_NAME player_status

Definition at line 70 of file player.h.

## ◆ SPECENUM_NAME [2/3]

#define SPECENUM_NAME diplstate_type

Definition at line 70 of file player.h.

## ◆ SPECENUM_NAME [3/3]

#define SPECENUM_NAME diplrel_other

Definition at line 70 of file player.h.

## ◆ SPECENUM_VALUE0 [1/2]

#define SPECENUM_VALUE0 PSTATUS_NORMAL

Definition at line 72 of file player.h.

## ◆ SPECENUM_VALUE0 [2/2]

#define SPECENUM_VALUE0 DS_ARMISTICE

Definition at line 72 of file player.h.

## ◆ SPECENUM_VALUE0NAME

#define SPECENUM_VALUE0NAME N_("?diplomatic_state:Armistice")

Definition at line 138 of file player.h.

## ◆ SPECENUM_VALUE1 [1/2]

#define SPECENUM_VALUE1 PSTATUS_DYING

Definition at line 74 of file player.h.

## ◆ SPECENUM_VALUE1 [2/2]

#define SPECENUM_VALUE1 DS_WAR

Definition at line 74 of file player.h.

## ◆ SPECENUM_VALUE10

#define SPECENUM_VALUE10 DRO_HAS_EMBASSY

Definition at line 169 of file player.h.

## ◆ SPECENUM_VALUE10NAME

#define SPECENUM_VALUE10NAME N_("Has embassy")

Definition at line 170 of file player.h.

## ◆ SPECENUM_VALUE11

#define SPECENUM_VALUE11 DRO_HOSTS_REAL_EMBASSY

Definition at line 171 of file player.h.

## ◆ SPECENUM_VALUE11NAME

#define SPECENUM_VALUE11NAME N_("Hosts real embassy")

Definition at line 172 of file player.h.

## ◆ SPECENUM_VALUE12

#define SPECENUM_VALUE12 DRO_HAS_REAL_EMBASSY

Definition at line 173 of file player.h.

## ◆ SPECENUM_VALUE12NAME

#define SPECENUM_VALUE12NAME N_("Has real embassy")

Definition at line 174 of file player.h.

## ◆ SPECENUM_VALUE13

#define SPECENUM_VALUE13 DRO_HAS_CASUS_BELLI

Definition at line 175 of file player.h.

## ◆ SPECENUM_VALUE13NAME

#define SPECENUM_VALUE13NAME N_("Has Casus Belli")

Definition at line 176 of file player.h.

## ◆ SPECENUM_VALUE14

#define SPECENUM_VALUE14 DRO_PROVIDED_CASUS_BELLI

Definition at line 177 of file player.h.

## ◆ SPECENUM_VALUE14NAME

#define SPECENUM_VALUE14NAME N_("Provided Casus Belli")

Definition at line 178 of file player.h.

## ◆ SPECENUM_VALUE15

#define SPECENUM_VALUE15 DRO_FOREIGN

Definition at line 179 of file player.h.

## ◆ SPECENUM_VALUE15NAME

#define SPECENUM_VALUE15NAME N_("Foreign")

Definition at line 180 of file player.h.

## ◆ SPECENUM_VALUE16

#define SPECENUM_VALUE16 DRO_HAS_TEAM_EMBASSY

Definition at line 181 of file player.h.

## ◆ SPECENUM_VALUE16NAME

#define SPECENUM_VALUE16NAME N_("Has team embassy")

Definition at line 182 of file player.h.

## ◆ SPECENUM_VALUE17

#define SPECENUM_VALUE17 DRO_HOSTS_TEAM_EMBASSY

Definition at line 183 of file player.h.

## ◆ SPECENUM_VALUE17NAME

#define SPECENUM_VALUE17NAME N_("Hosts team embassy")

Definition at line 184 of file player.h.

## ◆ SPECENUM_VALUE1NAME

#define SPECENUM_VALUE1NAME N_("?diplomatic_state:War")

Definition at line 140 of file player.h.

## ◆ SPECENUM_VALUE2 [1/2]

#define SPECENUM_VALUE2 PSTATUS_WINNER

Definition at line 76 of file player.h.

## ◆ SPECENUM_VALUE2 [2/2]

#define SPECENUM_VALUE2 DS_CEASEFIRE

Definition at line 76 of file player.h.

## ◆ SPECENUM_VALUE2NAME

#define SPECENUM_VALUE2NAME N_("?diplomatic_state:Cease-fire")

Definition at line 142 of file player.h.

## ◆ SPECENUM_VALUE3 [1/2]

#define SPECENUM_VALUE3 PSTATUS_SURRENDER

Definition at line 78 of file player.h.

## ◆ SPECENUM_VALUE3 [2/2]

#define SPECENUM_VALUE3 DS_PEACE

Definition at line 78 of file player.h.

## ◆ SPECENUM_VALUE3NAME

#define SPECENUM_VALUE3NAME N_("?diplomatic_state:Peace")

Definition at line 144 of file player.h.

## ◆ SPECENUM_VALUE4

#define SPECENUM_VALUE4 DS_ALLIANCE

Definition at line 145 of file player.h.

## ◆ SPECENUM_VALUE4NAME

#define SPECENUM_VALUE4NAME N_("?diplomatic_state:Alliance")

Definition at line 146 of file player.h.

## ◆ SPECENUM_VALUE5

#define SPECENUM_VALUE5 DS_NO_CONTACT

Definition at line 147 of file player.h.

## ◆ SPECENUM_VALUE5NAME

#define SPECENUM_VALUE5NAME N_("?diplomatic_state:Never met")

Definition at line 148 of file player.h.

## ◆ SPECENUM_VALUE6

#define SPECENUM_VALUE6 DS_TEAM

Definition at line 149 of file player.h.

## ◆ SPECENUM_VALUE6NAME

#define SPECENUM_VALUE6NAME N_("?diplomatic_state:Team")

Definition at line 150 of file player.h.

## ◆ SPECENUM_VALUE7

#define SPECENUM_VALUE7 DRO_GIVES_SHARED_VISION

Definition at line 163 of file player.h.

## ◆ SPECENUM_VALUE7NAME

#define SPECENUM_VALUE7NAME N_("Gives shared vision")

Definition at line 164 of file player.h.

## ◆ SPECENUM_VALUE8

#define SPECENUM_VALUE8 DRO_RECEIVES_SHARED_VISION

Definition at line 165 of file player.h.

## ◆ SPECENUM_VALUE8NAME

#define SPECENUM_VALUE8NAME N_("Receives shared vision")

Definition at line 166 of file player.h.

## ◆ SPECENUM_VALUE9

#define SPECENUM_VALUE9 DRO_HOSTS_EMBASSY

Definition at line 167 of file player.h.

## ◆ SPECENUM_VALUE9NAME

#define SPECENUM_VALUE9NAME N_("Hosts embassy")

Definition at line 168 of file player.h.

## ◆ SPECLIST_TAG

#define SPECLIST_TAG player

Definition at line 553 of file player.h.

## ◆ SPECLIST_TYPE

#define SPECLIST_TYPE struct player

Definition at line 554 of file player.h.

## Enumeration Type Documentation

## ◆ dipl_reason

enum dipl_reason

Enumerator
DIPL_OK |
DIPL_ERROR |
DIPL_SENATE_BLOCKING |
DIPL_ALLIANCE_PROBLEM_US |
DIPL_ALLIANCE_PROBLEM_THEM |

Definition at line 192 of file player.h.

## ◆ player_debug_types

enum player_debug_types

Enumerator
PLAYER_DEBUG_DIPLOMACY |
PLAYER_DEBUG_TECH |
PLAYER_DEBUG_LAST |

Definition at line 214 of file player.h.

## ◆ plrcolor_mode

enum plrcolor_mode

Enumerator
PLRCOL_PLR_ORDER |
PLRCOL_PLR_RANDOM |
PLRCOL_PLR_SET |
PLRCOL_TEAM_ORDER |
PLRCOL_NATION_ORDER |

Definition at line 52 of file player.h.

## Function Documentation

## ◆ are_diplstates_equal()

bool are_diplstates_equal | ( | const struct player_diplstate * | pds1,
|  | const struct player_diplstate * | pds2
| ) |  |

Return TRUE iff the two diplstates are equal.

Definition at line 1505 of file player.c.

## ◆ BV_DEFINE() [1/3]

BV_DEFINE | ( | bv_debug | ,
|  | PLAYER_DEBUG_LAST |
| ) |  |

## ◆ BV_DEFINE() [2/3]

BV_DEFINE | ( | bv_diplrel_all_reqs | ,
|  | ((DRO_LAST - 1) *2) * | REQ_RANGE_COUNT
| ) |  |

## ◆ BV_DEFINE() [3/3]

BV_DEFINE | ( | bv_pstatus | ,
|  | PSTATUS_COUNT |
| ) |  |

## ◆ can_player_see_city_internals()

bool can_player_see_city_internals | ( | const struct player * | pplayer,
|  | const struct city * | pcity
| ) |  |

Return TRUE iff the player can see the city's internals. This means the full city packet is sent to the client, who should then be able to popup a dialog for it.

Returns TRUE if given a NULL player. This is used by the client when in observer mode.

Definition at line 1149 of file player.c.

Referenced by actres_possible(), broadcast_city_info(), can_player_see_units_in_city(), city_packet_common(), control_mouse_cursor(), do_map_click(), is_req_knowable(), is_tile_seen_city(), is_tile_seen_trade_route(), meswin_add(), num_supported_units_in_city(), and player_can_see_city_externals().

## ◆ can_player_see_hypotetic_units_at()

bool can_player_see_hypotetic_units_at | ( | const struct player * | pplayer,
|  | const struct tile * | ptile
| ) |  |

Check if pplayer could see all units on ptile if it had units.

See can_player_see_unit_at() for rules about when an unit is visible.

Definition at line 993 of file player.c.

Referenced by action_prob_vs_stack_full(), actres_possible(), ap_diplomat_battle(), and is_req_knowable().

## ◆ can_player_see_tile()

bool can_player_see_tile | ( | const struct player * | plr,
|  | const struct tile * | ptile
| ) |  |

Returns TRUE iff the specified player can see the specified tile.

Definition at line 1091 of file player.c.

Referenced by actres_possible(), and is_action_possible().

## ◆ can_player_see_unit()

bool can_player_see_unit | ( | const struct player * | pplayer,
|  | const struct unit * | punit
| ) |  |

Checks if a unit can be seen by pplayer at its current location.

See can_player_see_unit_at.

Definition at line 1104 of file player.c.

Referenced by action_prob(), action_prob_vs_stack_full(), actres_possible(), create_city(), create_extra(), destroy_extra(), find_best_tile_to_paradrop_to(), get_units_seen_via_ally(), give_allied_visibility(), is_action_possible(), is_req_knowable(), is_square_threatened(), map_change_seen(), map_claim_base(), maybe_cancel_patrol_due_to_enemy(), player_in_territory(), remove_allied_visibility(), remove_city(), send_combat(), send_unit_info(), tile_has_units_not_allied_to_but_seen_by(), transfer_city(), unit_move(), unit_transport_load_send(), and wakeup_neighbor_sentries().

## ◆ can_player_see_unit_at()

bool can_player_see_unit_at | ( | const struct player * | pplayer,
|  | const struct unit * | punit,
|  | const struct tile * | ptile,
|  | bool | is_transported
| ) |  |

Checks if a unit can be seen by pplayer at (x,y). A player can see a unit if they: (a) can see the tile AND (b) can see the unit at the tile (i.e. unit not invisible at this tile) AND (c) the unit is outside a city OR in an allied city AND (d) the unit isn't in a transporter, or we are allied AND (e) the unit isn't in a transporter, or we can see the transporter

Definition at line 1034 of file player.c.

Referenced by can_player_see_unit(), construct_move_data_list(), and server_remove_unit_full().

## ◆ can_player_see_units_in_city()

bool can_player_see_units_in_city | ( | const struct player * | pplayer,
|  | const struct city * | pcity
| ) |  |

Return TRUE iff the player can see units in the city. Either they can see all units or none.

If the player can see units in the city, then the server sends the unit info for units in the city to the client. The client uses the tile's unitlist to determine whether to show the city occupied flag. Of course the units will be visible to the player as well, if they click on them.

If the player can't see units in the city, then the server doesn't send the unit info for these units. The client therefore uses the "occupied" flag sent in the short city packet to determine whether to show the city occupied flag.

Note that can_player_see_city_internals => can_player_see_units_in_city. Otherwise the player would not know anything about the city's units at all, since the full city packet has no "occupied" flag.

Returns TRUE if given a NULL player. This is used by the client when in observer mode.

Definition at line 1133 of file player.c.

Referenced by can_player_see_hypotetic_units_at(), can_player_see_unit_at(), client_remove_unit(), create_city(), do_move_unit(), handle_city_info(), handle_unit_packet_common(), meswin_popup_city(), num_present_units_in_city(), popup_info_text(), remove_city(), show_full_citybar(), and unit_change_homecity_handling().

## ◆ cancel_pact_result()

enum diplstate_type cancel_pact_result | ( | enum diplstate_type | oldstate | ) |

Return the diplomatic state that cancelling a pact will end up in.

Definition at line 68 of file player.c.

Referenced by handle_diplomacy_cancel_pact(), players_war_callback(), and players_war_callback().

## ◆ casus_belli_range_for()

enum casus_belli_range casus_belli_range_for | ( | const struct player * | offender,
|  | const struct unit_type * | off_ut,
|  | const struct player * | tgt_plr,
|  | const enum effect_type | outcome,
|  | const struct action * | paction,
|  | const struct tile * | tgt_tile
| ) |  |

Definition at line 1644 of file player.c.

Referenced by action_consequence_common(), and dai_action_value_unit_vs_city().

## ◆ diplrel_by_rule_name()

int diplrel_by_rule_name | ( | const char * | value | ) |

Return the diplomatic relation that has the given (untranslated) rule name.

Definition at line 1585 of file player.c.

Referenced by universal_value_from_str().

## ◆ diplrel_mess_close()

void diplrel_mess_close | ( | void |  | ) |

Free diplrel_mess

Definition at line 1814 of file player.c.

Referenced by libfreeciv_free().

## ◆ diplrel_name_translation()

const char * diplrel_name_translation | ( | int | value | ) |

Return the translated name of the given diplomatic relation.

Definition at line 1631 of file player.c.

Referenced by helptext_unit(), req_text_insert(), universal_name_translation(), and worklist_item_postpone_req_vec().

## ◆ diplrel_req_contradicts()

bv_diplrel_all_reqs diplrel_req_contradicts | ( | const struct requirement * | req | ) |

Get the DiplRel requirements that are known to contradict the specified DiplRel requirement.

The known contratictions have their position in the enumeration of all possible DiplRel requirements set in the returned bitvector.

Definition at line 1829 of file player.c.

Referenced by are_requirements_contradictions().

## ◆ diplrel_rule_name()

const char * diplrel_rule_name | ( | int | value | ) |

Return the (untranslated) rule name of the given diplomatic relation.

Definition at line 1619 of file player.c.

Referenced by universal_rule_name().

## ◆ gives_shared_tiles()

bool gives_shared_tiles | ( | const struct player * | me,
|  | const struct player * | them
| ) |  |

Return TRUE iff the player me gives shared tiles to player them.

Definition at line 1497 of file player.c.

Referenced by base_city_can_work_tile(), handle_diplomacy_cancel_pact(), package_player_info(), receive_packet_player_info_100(), and sg_save_player_main().

## ◆ gives_shared_vision()

bool gives_shared_vision | ( | const struct player * | me,
|  | const struct player * | them
| ) |  |

Return TRUE iff the player me gives shared vision to player them.

Definition at line 1489 of file player.c.

Referenced by create_clause_menu(), dai_declare_war(), dai_diplomacy_actions(), dai_go_to_war(), dai_share(), get_vision_status(), give_shared_vision(), handle_diplomacy_cancel_pact(), is_diplrel_between(), kill_player(), plr_widget::nation_selected(), package_player_info(), popup_add_menu(), popup_diplomacy_dialog(), popup_diplomatic_objects(), receive_packet_player_info_100(), remove_shared_vision(), server_remove_player(), sg_save_player_main(), shared_vision_is_safe(), diplo_wdg::show_menu(), update_players_menu(), and plr_report::update_report().

## ◆ is_barbarian()

static bool is_barbarian | ( | const struct player * | pplayer | ) |

inlinestatic

Definition at line 491 of file player.h.

Referenced by calc_civ_score(), can_player_build_unit_direct(), check_for_game_over(), city_build_unit(), dai_city_choose_build(), dai_data_phase_begin(), dai_diplomacy_actions(), dai_fill_unit_param(), dai_gothere_bodyguard(), dai_hunter_choice(), dai_hunter_manage(), dai_hunter_qualify(), dai_military_attack(), dai_military_findjob(), dai_rampage_want(), dai_unit_move(), diplomat_incite(), end_turn(), explorer_desirable(), find_a_unit_type(), find_city_to_diplomat(), handle_diplomacy_accept_treaty_req(), handle_edit_player(), is_allowed_to_take(), kill_player(), plr_sorter::lessThan(), plr_widget::nation_selected(), player_has_embassy_from_effect(), player_has_state(), player_leading_spacerace(), player_loot_player(), player_should_be_shown(), plr_model::populate(), popup_players_dialog(), popup_players_nations_dialog(), rank_users(), report_final_scores(), research_total_bulbs_required(), server_remove_player(), sg_load_player_main(), sg_load_player_main(), show_players(), take_command(), team_command(), unit_conquer_city(), plr_report::update_report(), and fc_client::update_start_page().

## ◆ is_diplrel_between()

bool is_diplrel_between | ( | const struct player * | player1,
|  | const struct player * | player2,
|  | int | diplrel
| ) |  |

Return TRUE iff player1 has the diplomatic relation to player2

Definition at line 1516 of file player.c.

Referenced by is_diplrel_in_range(), and is_diplrel_to_other().

## ◆ is_diplrel_to_other()

bool is_diplrel_to_other | ( | const struct player * | pplayer,
|  | int | diplrel
| ) |  |

Return TRUE iff pplayer has the diplomatic relation to any living player

Definition at line 1566 of file player.c.

Referenced by is_diplrel_in_range().

## ◆ is_settable_ai_level()

bool is_settable_ai_level | ( | enum ai_level | level | ) |

Return is AI can be set to given level

Definition at line 1925 of file player.c.

Referenced by create_ai_menu(), create_conn_menu(), create_players_dialog(), create_start_page(), pregame_options::init(), real_conn_list_dialog_update(), server_ai_level(), fc_client::start_page_menu(), and plr_report::toggle_ai_mode().

## ◆ is_valid_username()

bool is_valid_username | ( | const char * | name | ) |

Returns whether this is a valid username. This is used by the server to validate usernames and should be used by the client to avoid invalid ones.

Definition at line 1914 of file player.c.

Referenced by client_main(), and handle_login_request().

## ◆ love_text()

const char * love_text | ( | const int | love | ) |

Return a text describing an AI's love for you. (Oooh, kinky!!)

Definition at line 1354 of file player.c.

Referenced by col_love().

## ◆ num_known_tech_with_flag()

int num_known_tech_with_flag | ( | const struct player * | pplayer,
|  | enum tech_flag_id | flag
| ) |  |

Returns the number of techs the player has researched which has this flag. Needs to be optimized later (e.g. int tech_flags[TF_COUNT] in struct player)

Definition at line 1273 of file player.c.

Referenced by is_claimable_ocean(), and player_knows_techs_with_flag().

## ◆ number_of_ai_levels()

int number_of_ai_levels | ( | void |  | ) |

Return number of AI levels in game

Definition at line 1938 of file player.c.

## ◆ player_age()

int player_age | ( | const struct player * | pplayer | ) |

"Age" of the player: number of turns spent alive since created.

Definition at line 954 of file player.c.

Referenced by is_age_req_active(), and tri_req_active_turns().

## ◆ player_ai_data()

void * player_ai_data | ( | const struct player * | pplayer,
|  | const struct ai_type * | ai
| ) |  |

Return pointer to ai data of given player and ai type.

Definition at line 1946 of file player.c.

Referenced by def_ai_player_data(), texai_city_destruction_recv(), texai_city_info_recv(), texai_player_data(), texai_player_free(), texai_player_units(), texai_unit_destruction_recv(), and texai_unit_info_recv().

## ◆ player_by_name()

struct player * player_by_name | ( | const char * | name | ) |

Find player by given name.

Definition at line 881 of file player.c.

Referenced by aifill(), api_find_player_by_name(), create_command_newcomer(), create_command_pregame(), makeup_connection_name(), observe_command(), pick_random_player_name(), sg_load_treaties(), sg_load_treaties(), and take_command().

## ◆ player_by_name_prefix()

struct player * player_by_name_prefix | ( | const char * | name,
|  | enum m_pre_result * | result
| ) |  |

Find player by its name prefix

Definition at line 920 of file player.c.

Referenced by aicmd_command(), debug_command(), delegate_command(), handle_chat_msg_req(), mapimg_checkplayers(), observe_command(), playercolor_command(), playernation_command(), remove_player_command(), set_ai_level(), take_command(), team_command(), and toggle_ai_command().

## ◆ player_by_number()

struct player * player_by_number | ( | const int | player_id | ) |

Return struct player pointer for the given player index.

You can retrieve players that are not in the game (with IDs larger than player_count). An out-of-range player request will return NULL.

Definition at line 849 of file player.c.

## ◆ player_by_user()

struct player * player_by_user | ( | const char * | name | ) |

Find player by its user name (not player/leader name)

Definition at line 940 of file player.c.

Referenced by create_command_newcomer(), create_command_pregame(), establish_new_connection(), makeup_connection_name(), and pick_random_player_name().

## ◆ player_can_invade_tile()

bool player_can_invade_tile | ( | const struct player * | pplayer,
|  | const struct tile * | ptile
| ) |  |

Return TRUE iff the player can invade a particular tile (linked with borders and diplomatic states).

Definition at line 270 of file player.c.

Referenced by pf_danger_node_init(), pf_fuel_node_init(), pf_normal_node_init(), player_may_explore(), unit_move_to_tile_test(), and unit_teleport_to_tile_test().

## ◆ player_can_see_city_externals()

bool player_can_see_city_externals | ( | const struct player * | pow_player,
|  | const struct city * | target_city
| ) |  |

Returns TRUE iff pow_player can see externally visible features of target_city.

A city's external features are visible to its owner, to players that currently sees the tile it is located at. If ruleset has reveal_trade_partner enabled, also anyone trading with the city sees it.

Definition at line 1164 of file player.c.

Referenced by action_prob_vs_city_full(), actres_possible(), broadcast_city_info(), is_req_knowable(), and refresh_dumb_city().

## ◆ player_can_trust_tile_has_no_units()

bool player_can_trust_tile_has_no_units | ( | const struct player * | pplayer,
|  | const struct tile * | ptile
| ) |  |

Returns TRUE iff pplayer can trust that ptile really has no units when it looks empty. A tile looks empty if the player can't see any units on it and it doesn't contain anything marked as occupied by a unit.

See can_player_see_unit_at() for rules about when an unit is visible.

Definition at line 967 of file player.c.

Referenced by action_prob_vs_stack_full(), and can_player_see_hypotetic_units_at().

## ◆ player_city_by_number()

struct city * player_city_by_number | ( | const struct player * | pplayer,
|  | int | city_id
| ) |  |

If the specified player owns the city with the specified id, return pointer to the city struct. Else return NULL. Now always uses fast idex_lookup_city.

pplayer may be NULL in which case all cities registered to hash are considered - even those not currently owned by any player. Callers expect this behavior.

Definition at line 1203 of file player.c.

Referenced by api_find_city(), city_from_wonder(), dai_find_strategic_airbase(), do_capture_units(), do_unit_establish_trade(), get_unit_info_label_text2(), handle_city_buy(), handle_city_change(), handle_city_change_specialist(), handle_city_make_specialist(), handle_city_make_worker(), handle_city_options_req(), handle_city_rally_point(), handle_city_refresh(), handle_city_rename(), handle_city_sell(), handle_city_worklist(), handle_web_cma_clear(), handle_web_cma_set(), player_primary_capital(), popup_info_text(), sg_load_player_cities(), sg_load_player_cities(), supported_unit_activate_close_callback(), supported_unit_activate_close_callback(), unit_description(), hud_units::update_actions(), and update_city_activity().

## ◆ player_clear()

void player_clear | ( | struct player * | pplayer,
|  | bool | full
| ) |  |

Clear all player data.

If full is set, also

- The nation is cleared
- The team is cleared
- Nationality information of remaining units is adjusted

Definition at line 669 of file player.c.

Referenced by game_reset(), player_destroy(), and server_remove_player().

## ◆ player_count()

int player_count | ( | void |  | ) |

Return the number of players.

Definition at line 817 of file player.c.

Referenced by aifill(), api_methods_private_list_players(), assign_player_colors(), begin_turn(), bvplayers_count(), connection_attach_real(), create_command_newcomer(), create_start_positions(), generator_init_topology(), get_info_label_text(), handle_edit_player_create(), handle_start_phase(), historian_generic(), init_new_game(), is_allowed_to_take(), make_history_report(), map_fractal_generate(), map_generate_fair_islands(), mapgenerator2(), mapgenerator3(), mapgenerator4(), mapimg_client_plrcolor_count(), mapimg_client_plrcolor_get(), maxplayers_callback(), normal_player_count(), refresh_tool_applied_player_combo(), report_final_scores(), report_top_cities(), report_wonders_of_the_world(), report_wonders_of_the_world_long(), revolentype_length(), sg_load_players_basic(), sg_load_players_basic(), sg_save_players(), show_colors(), show_players(), start_command(), take_command(), and plr_report::update_report().

## ◆ player_destroy()

void player_destroy | ( | struct player * | pplayer | ) |

Destroys and remove a player from the game.

Definition at line 756 of file player.c.

Referenced by handle_player_remove(), player_slots_free(), server_create_player(), and server_remove_player().

## ◆ player_diplstate_get()

struct player_diplstate * player_diplstate_get | ( | const struct player * | plr1,
|  | const struct player * | plr2
| ) |  |

Returns diplomatic state type between two players

Definition at line 324 of file player.c.

Referenced by action_give_casus_belli(), add_clause(), adv_data_phase_init(), adv_is_player_dangerous(), barbarian_initial_wars(), can_plr_see_all_sym_diplrels_of(), cities_trade_route_type(), col_diplstate(), col_government(), could_intel_with_player(), could_meet_with_player(), create_clause_menu(), dai_data_phase_begin(), dai_declare_war(), dai_diplomacy_actions(), dai_diplomacy_begin_new_phase(), dai_diplomacy_first_contact(), dai_effect_value(), dai_goldequiv_clause(), dai_hunter_try_launch(), dai_incident_war(), dai_treaty_accepted(), dai_treaty_evaluate(), dai_war_desire(), diplo_wdg::diplo_wdg(), diplstate_value(), do_paradrop(), expl_act_not_enabl(), fill_row(), get_allied_with_enemy_player(), get_embassy_status(), get_gold_info(), handle_diplomacy_accept_treaty_req(), handle_diplomacy_cancel_pact(), handle_player_diplstate(), is_diplrel_between(), is_valid_alliance(), make_contact(), plr_widget::nation_selected(), need_war_enabler(), package_player_diplstate(), package_player_info(), player_diplstate_defaults(), player_diplstate_destroy(), player_has_embassy_from_effect(), player_mood(), player_nation_callback(), players_non_invade(), players_war_callback(), players_war_callback(), popup_add_menu(), popup_diplomacy_dialog(), popup_diplomatic_objects(), popup_goto_airlift_dialog(), popup_info_text(), popup_players_nations_dialog(), pplayer_can_cancel_treaty(), pplayer_can_make_treaty(), pplayers_allied(), pplayers_at_war(), pplayers_in_peace(), pplayers_non_attack(), real_players_dialog_update(), redraw_unit_info_label(), rel_may_become_war(), score_tooltip(), sg_load_player_main(), sg_load_player_main(), sg_load_players(), sg_load_players(), sg_save_player_main(), shared_vision_is_safe(), diplo_wdg::show_menu(), split_player(), srv_ready(), update_diplomatics(), update_intel_dialog(), and world_peace_turn().

## ◆ player_get_expected_income()

int player_get_expected_income | ( | const struct player * | pplayer | ) |

Return the expected net income of the player this turn. This includes tax revenue and upkeep, but not one-time purchases or found gold.

This function depends on pcity->prod[O_GOLD] being set for all cities, so make sure the player's cities have been refreshed.

Definition at line 1286 of file player.c.

Referenced by dai_manage_cities(), get_info_label_text(), get_info_label_text_popup(), package_player_info(), show_new_turn_info(), and fc_client::update_info_label().

## ◆ player_has_embassy()

bool player_has_embassy | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Check if pplayer has an embassy with pplayer2. We always have an embassy with ourselves.

Definition at line 208 of file player.c.

Referenced by could_meet_with_player(), dai_choose_diplomat_offensive(), dai_manage_diplomat(), dai_share(), find_city_to_diplomat(), get_embassy_status(), is_diplrel_between(), and research_total_bulbs_required().

## ◆ player_has_embassy_from_effect()

bool player_has_embassy_from_effect | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Returns whether pplayer has got embassy with pplayer2 thanks to an effect (e.g. Macro Polo Embassy).

Definition at line 250 of file player.c.

Referenced by player_has_embassy(), and team_has_embassy().

## ◆ player_has_flag()

bool player_has_flag | ( | const struct player * | pplayer,
|  | enum plr_flag_id | flag
| ) |  |

Check if player has given flag

Definition at line 1996 of file player.c.

Referenced by api_methods_player_has_flag(), city_build_free_buildings(), establish_new_connection(), handle_edit_player(), is_plr_flag_req_active(), objbind_get_value_from_object(), objbind_pack_current_values(), real_conn_list_dialog_update(), sg_load_player_cities(), sg_save_player_main(), and fc_client::update_start_page().

## ◆ player_has_real_embassy()

bool player_has_real_embassy | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Returns whether pplayer has a real embassy with pplayer2, established from a diplomat, or through diplomatic meeting.

Definition at line 240 of file player.c.

Referenced by add_clause(), create_clause_menu(), handle_diplomacy_accept_treaty_req(), is_diplrel_between(), package_player_info(), player_has_embassy(), popup_add_menu(), popup_diplomatic_objects(), sg_save_player_main(), diplo_wdg::show_menu(), and team_has_embassy().

## ◆ player_has_state()

bool player_has_state | ( | const struct player * | pplayer,
|  | enum plrstate_type | state
| ) |  |

Check if player has given state

Definition at line 2004 of file player.c.

Referenced by is_plr_state_req_active().

## ◆ player_in_city_map()

bool player_in_city_map | ( | const struct player * | pplayer,
|  | const struct tile * | ptile
| ) |  |

Return true iff tile is inside any of the player's city map.

Definition at line 1249 of file player.c.

Referenced by fill_grid_sprite_array().

## ◆ player_in_territory()

int player_in_territory | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Return the number of pplayer2's visible units in pplayer's territory, from the point of view of pplayer. Units that cannot be seen by pplayer will not be found (this function doesn't cheat).

Definition at line 1884 of file player.c.

Referenced by dai_diplomacy_begin_new_phase().

## ◆ player_index()

int player_index | ( | const struct player * | pplayer | ) |

Return the player index.

Currently same as player_number(), but indicates use as an array index. The array must be sized by player_slot_count() or MAX_NUM_PLAYER_SLOTS (player_count() cannot be used) and is likely to be sparse.

Definition at line 829 of file player.c.

Referenced by achievement_check(), achievement_player_has(), achievement_plr(), adv_dipl_free(), adv_dipl_get(), adv_dipl_new(), adv_is_player_dangerous(), build_landarea_map(), cmp_love(), col_love(), collect_ransom(), construct_move_data_list(), create_current_governments_data(), create_current_governments_data_all(), create_vision_dependencies(), dai_declare_war(), dai_diplomacy_actions(), dai_diplomacy_begin_new_phase(), dai_diplomacy_defaults(), dai_diplomacy_destroy(), dai_diplomacy_first_contact(), dai_diplomacy_get(), dai_diplomacy_new(), dai_goldequiv_clause(), dai_hunter_manage(), dai_incident_nuclear(), dai_incident_nuclear_not_target(), dai_incident_nuclear_self(), dai_incident_simple(), dai_incident_war(), dai_manage_taxes(), dai_player_load_relations(), dai_player_save_relations(), dai_players_can_agree_on_ceasefire(), dai_treaty_accepted(), dai_unit_new_task(), dai_war_desire(), destroy_extra(), establish_embassy(), event_cache_add_for_player(), event_cache_match(), event_cache_player_add(), event_cache_save(), fill_grid_sprite_array(), fill_sprite_array(), found_new_tech(), free_current_governments_data(), get_player_landarea(), give_shared_vision(), gives_shared_tiles(), gives_shared_vision(), handle_achievement_info(), handle_diplomacy_accept_treaty_req(), handle_diplomacy_cancel_pact(), handle_edit_city(), img_createmap(), img_playerstr(), img_save_ppm(), init_new_game(), kill_unit(), log_civ_score_now(), map_claim_base(), mapimg_checkplayers(), mapimg_client_define(), mapimg_create(), notify_new_government_options(), objbind_get_value_from_object(), package_player_diplstate(), package_player_info(), player_diplstate_destroy(), player_diplstate_get(), player_diplstate_new(), player_has_real_embassy(), popup_airlift_dialog(), popup_goto_airlift_dialog(), popup_goto_dialog(), rank_users(), real_diplo_log(), really_gives_vision(), remove_shared_vision(), send_unit_info(), server_remove_player(), sg_load_map_known(), sg_load_map_known(), sg_load_player_main(), sg_load_player_main(), sg_load_players(), sg_load_players(), sg_save_map_known(), sg_save_player_cities(), sg_save_player_main(), srv_ready(), tileset_player_init(), toggle_goto_nations_cities_dialog_callback(), transfer_city(), unit_goes_out_of_sight(), unit_move(), unit_transport_load_send(), and update_goto_dialog().

## ◆ player_is_cpuhog()

static bool player_is_cpuhog | ( | const struct player * | pplayer | ) |

inlinestatic

Definition at line 577 of file player.h.

Referenced by adv_best_government(), assess_danger(), and cm_find_best_solution().

## ◆ player_knows_techs_with_flag()

bool player_knows_techs_with_flag | ( | const struct player * | pplayer,
|  | enum tech_flag_id | flag
| ) |  |

Returns TRUE iff the player knows at least one tech which has the given flag.

Definition at line 1328 of file player.c.

Referenced by can_build_extra_base(), dai_choose_attacker_air(), and is_techflag_req_active().

## ◆ player_multiplier_effect_value()

int player_multiplier_effect_value | ( | const struct player * | pplayer,
|  | const struct multiplier * | pmul
| ) |  |

Return the multiplier value currently in effect for pplayer, scaled from display units to the units used in the effect system (if different). Result is multiplied by 100 (caller should divide down).

Definition at line 1975 of file player.c.

Referenced by dai_effect_value(), get_city_dialog_culture_text(), get_city_dialog_illness_text(), get_city_dialog_output_text(), get_potential_improvement_bonus(), and get_target_bonus_effects().

## ◆ player_multiplier_target_value()

int player_multiplier_target_value | ( | const struct player * | pplayer,
|  | const struct multiplier * | pmul
| ) |  |

Return the player's target value for a multiplier (which may be different from the value currently in force; it will take effect next turn). Result is in display units.

Definition at line 1987 of file player.c.

Referenced by multipler_rates_dialog::multipler_rates_dialog(), and multiplier_dialog_update_values().

## ◆ player_multiplier_value()

int player_multiplier_value | ( | const struct player * | pplayer,
|  | const struct multiplier * | pmul
| ) |  |

Return the multiplier value currently in effect for pplayer (in display units).

Definition at line 1964 of file player.c.

Referenced by dai_adjust_policies(), multiplier_dialog_update_values(), and player_multiplier_effect_value().

## ◆ player_name()

const char * player_name | ( | const struct player * | pplayer | ) |

Return the leader name of the player.

Definition at line 895 of file player.c.

Referenced by adv_data_get(), agents_unit_changed(), agents_unit_new(), agents_unit_remove(), aicmd_command(), aifill(), announce_player(), away_command(), begin_phase(), can_unit_move_to_tile_with_notify(), chat_msg_to_player(), check_city_migrations_player(), check_for_game_over(), citizens_convert(), citizens_convert_conquest(), citizens_print(), city_add_unit(), city_build_unit(), city_from_great_wonder(), city_from_wonder(), city_name_suggestion(), civil_war(), civil_war_triggered(), client_take_player(), cmp_name(), col_name(), conn_description(), conn_menu_player_command(), conn_menu_player_command(), conn_menu_team_chosen(), conn_menu_team_chosen(), connection_detach(), create_barbarian_player(), create_command_newcomer(), create_command_pregame(), create_conn_menu(), create_races_dialog(), create_spaceship_dialog(), dai_auto_settler_reset(), dai_choose_diplomat_offensive(), dai_choose_paratrooper(), dai_diplomacy_actions(), dai_diplomacy_begin_new_phase(), dai_diplomacy_first_contact(), dai_diplomacy_suggest(), dai_do_build_city(), dai_go_to_war(), dai_goldequiv_clause(), dai_incident_war(), dai_manage_taxes(), dai_manage_tech(), dai_plr_data_get(), dai_spend_gold(), dai_treaty_evaluate(), dai_treaty_react(), debug_command(), default_title_for_player(), delegate_command(), delegate_player_str(), detach_command(), diplomat_bribe(), do_spaceship_place(), do_tech_parasite_effects(), do_unit_change_homecity(), end_turn(), endgame_report_dialog_player(), establish_new_connection(), explain_why_no_action_enabled(), extviewer_refresh_widgets(), fit_nationset_to_players(), form_chat_name(), generate_players(), get_info_label_text(), get_player_landarea(), give_shared_vision(), government_change(), handle_chat_msg_req(), handle_diplomacy_accept_treaty_req(), handle_diplomacy_cancel_pact(), handle_edit_player(), handle_event(), handle_nation_select_req(), handle_player_change_government(), handle_player_multiplier(), handle_player_rates(), handle_tile_info(), handle_unit_orders(), illegal_action_msg(), img_playerstr(), init_new_game(), log_civ_score_now(), make_contact(), map_change_seen(), map_hide_tile(), map_show_tile(), observe_button_callback(), observe_command(), package_player_common(), place_starting_unit(), player_balance_treasury_units(), player_balance_treasury_units_and_buildings(), player_name_by_number(), player_nation_defaults(), player_tech_upkeep(), playercolor_command(), playernation_command(), players_ai_skill_callback(), players_ai_skill_callback(), players_ai_toggle_callback(), players_ai_toggle_callback(), rank_users(), real_conn_list_dialog_update(), real_diplo_log(), real_tech_log(), really_diplomacy_cancel_meeting(), refresh_player_pov_indicator(), refresh_tool_applied_player_combo(), remove_player_command(), remove_shared_vision(), research_name_translation(), research_rule_name(), ruler_title_for_player(), sell_random_building(), sell_random_unit(), send_delegation_info(), server_player_name_is_allowed(), server_remove_player(), server_remove_unit_full(), set_ai_level(), set_ai_level_direct(), sg_load_map_owner(), sg_load_map_owner(), sg_load_players(), sg_load_players(), sg_load_players_basic(), sg_load_players_basic(), sg_load_sanitycheck(), sg_load_sanitycheck(), sg_save_player_main(), show_colors(), show_conn_popup(), show_delegations(), show_players(), show_teams(), shuffled_player(), spy_poison(), fc_client::start_page_menu(), surrender_command(), take_command(), team_command(), team_remove_player(), plr_report::toggle_ai_mode(), toggle_ai_player_direct(), treaty_save(), try_summon_barbarians(), unit_attack_civilian_casualties(), unit_conquer_city(), unit_do_destroy_city(), update_diplomatics(), update_dumb_city(), update_intel_dialog(), endgame_report::update_report(), update_revolution(), fc_client::update_start_page(), update_start_page_buttons(), and war_countdown().

## ◆ player_new()

struct player * player_new | ( | struct player_slot * | pslot | ) |

Creates a new player for the slot. If slot is NULL, it will lookup to a free slot. If the slot is already used, then just return the player.

Definition at line 493 of file player.c.

Referenced by handle_player_info(), and server_create_player().

## ◆ player_number()

int player_number | ( | const struct player * | pplayer | ) |

Return the player index/number/id.

Definition at line 837 of file player.c.

Referenced by diplo_wdg::all_advances(), api_methods_player_number(), begin_phase(), call_meeting_dlg_callback(), cancel_pact_dlg_callback(), check_leaving_edit_mode(), cities_callback(), city_from_great_wonder(), city_from_wonder(), city_original_owner(), clear_old_treaty(), client_player_number(), client_take_player(), cmp_love(), conn_menu_ready_chosen(), conn_menu_ready_chosen(), create_barbarian_player(), create_clause_menu(), dai_declare_war(), dai_diplomacy_actions(), dai_diplomacy_suggest(), dai_treaty_evaluate(), diplo_wdg::dbl_click(), diplo_dialog_returnkey(), diplomacy_dialog_add_pact_clause(), diplomacy_dialog_add_pact_clause(), diplomacy_dialog_embassy_callback(), diplomacy_dialog_embassy_callback(), diplomacy_dialog_map_callback(), diplomacy_dialog_map_callback(), diplomacy_dialog_seamap_callback(), diplomacy_dialog_seamap_callback(), diplomacy_dialog_shared_tiles_callback(), diplomacy_dialog_shared_tiles_callback(), diplomacy_dialog_vision_callback(), diplomacy_dialog_vision_callback(), diplomacy_main_response(), diplomacy_response(), editor_grab_applied_player(), embassy_callback(), end_phase(), fill_row(), fill_tile_edit_packet(), diplo_wdg::give_advance(), diplo_wdg::give_city(), diplo_wdg::give_embassy(), diplo_wdg::give_shared_vision(), gold_callback(), diplo_wdg::gold_changed1(), diplo_wdg::gold_changed2(), handle_diplomacy_accept_treaty_req(), handle_diplomacy_cancel_pact(), handle_diplomacy_create_clause_req(), handle_diplomacy_init_meeting_req(), handle_diplomacy_remove_clause_req(), handle_edit_player(), handle_edit_player_create(), handle_edit_toggle_fogofwar(), handle_endgame_player(), handle_player_info(), handle_player_remove(), handle_research_info(), handle_unknown_research(), img_playerstr(), initialize_globals(), is_player_phase(), log_civ_score_now(), map_change_seen(), maps_callback(), model_get_player_iter(), objbind_pack_current_values(), object_put(), objtype_get_id_from_object(), races_dialog::ok_pressed(), package_city(), package_conn_info(), package_dumb_city(), package_player_common(), package_short_unit(), package_unit(), diplo_wdg::pact_allianze(), pact_callback(), diplo_wdg::pact_ceasfire(), diplo_wdg::pact_peace(), paste_tile(), player_balance_treasury_units(), player_balance_treasury_units_and_buildings(), player_index(), player_preferred_color(), player_tech_upkeep(), popup_add_menu(), popup_diplomatic_objects(), popup_goto_airlift_dialog(), races_dialog_ok_callback(), races_response(), races_dialog::random_pressed(), ready_button_callback(), real_conn_list_dialog_update(), real_players_dialog_update(), really_diplomacy_cancel_meeting(), refresh_player_pov_indicator(), refresh_tool_applied_player_combo(), reject_all_treaties(), remove_clause_callback(), remove_clause_widget_from_list(), report_final_scores(), plr_report::req_caancel_threaty(), plr_report::req_meeeting(), plr_report::req_wiithdrw_vision(), research_get(), diplo_wdg::response_accept(), diplo_wdg::response_cancel(), row_callback(), diplo_wdg::sea_map_clause(), send_diplomatic_meetings(), send_spaceship_info(), send_tile_info(), server_player_set_name_full(), sg_load_player_attributes(), sg_load_player_attributes(), sg_load_player_cities(), sg_load_player_cities(), sg_load_player_city(), sg_load_player_city(), sg_load_player_main(), sg_load_player_main(), sg_load_player_unit(), sg_load_player_unit(), sg_load_player_units(), sg_load_player_units(), sg_load_player_units_transport(), sg_load_player_units_transport(), sg_load_player_vision(), sg_load_player_vision(), sg_load_players_basic(), sg_load_players_basic(), sg_save_map_owner(), sg_save_player_attributes(), sg_save_player_cities(), sg_save_player_main(), sg_save_player_units(), sg_save_player_vision(), sg_save_players(), shared_tiles_callback(), fc_client::slot_pregame_start(), srv_ready(), start_command(), team_add_player(), team_remove_player(), techs_callback(), texai_city_update(), texai_unit_update(), update_clauses_list(), update_diplomacy_dialog(), update_diplomatics(), vision_callback(), withdraw_vision_dlg_callback(), wonder_built(), wonder_destroyed(), and diplo_wdg::world_map_clause().

## ◆ player_owns_city()

bool player_owns_city | ( | const struct player * | pplayer,
|  | const struct city * | pcity
| ) |  |

Return TRUE iff the given player owns the city.

Definition at line 261 of file player.c.

Referenced by calc_civ_score(), popup_find_dialog(), really_handle_city_buy(), and update_goto_dialog().

## ◆ player_primary_capital()

struct city * player_primary_capital | ( | const struct player * | pplayer | ) |

Locate the player's primary capital city, (NULL Otherwise)

Definition at line 1337 of file player.c.

Referenced by center_next_player_capital(), center_on_something(), do_expel_unit(), handle_spaceship_launch(), unit_hud_selector::island_filter(), key_center_capital(), plr_widget::nation_selected(), player_has_state(), unit_do_destroy_city(), update_intel_dialog(), and fc_client::update_sidebar_tooltips().

## ◆ player_ruleset_close()

void player_ruleset_close | ( | struct player * | pplayer | ) |

Clear the ruleset dependent pointers of the player structure. Called by game_ruleset_free().

Definition at line 745 of file player.c.

Referenced by game_ruleset_free().

## ◆ player_set_ai_data()

void player_set_ai_data | ( | struct player * | pplayer,
|  | const struct ai_type * | ai,
|  | void * | data
| ) |  |

Attach ai data to player

Definition at line 1954 of file player.c.

Referenced by dai_player_alloc(), dai_player_free(), texai_player_alloc(), and texai_player_free().

## ◆ player_set_color()

void player_set_color | ( | struct player * | pplayer,
|  | const struct rgbcolor * | prgbcolor
| ) |  |

Set the player's color. May be NULL in pregame.

Definition at line 648 of file player.c.

Referenced by assign_player_colors(), handle_player_info(), server_create_player(), and server_player_set_color().

## ◆ player_set_nation()

bool player_set_nation | ( | struct player * | pplayer,
|  | struct nation_type * | pnation
| ) |  |

Set the player's nation to the given nation (may be NULL). Returns TRUE iff there was a change. Doesn't check if the nation is legal wrt nationset.

Definition at line 861 of file player.c.

Referenced by aifill(), create_animals(), fit_nationset_to_players(), handle_edit_player(), handle_nation_select_req(), handle_player_info(), nationset_action(), player_clear(), player_nation_defaults(), player_ruleset_close(), playernation_command(), sg_load_player_main(), sg_load_player_main(), sg_load_players(), and sg_load_players().

## ◆ player_slot_by_number()

struct player_slot * player_slot_by_number | ( | int | player_id | ) |

Return the possibly unused and uninitialized player slot.

Definition at line 463 of file player.c.

Referenced by handle_city_nationalities(), handle_conn_info(), handle_player_info(), handle_player_remove(), player_by_number(), server_create_player(), sg_load_map_known(), sg_load_map_known(), and sg_save_map_known().

## ◆ player_slot_count()

int player_slot_count | ( | void |  | ) |

Returns the total number of player slots, i.e. the maximum number of players (including barbarians, etc.) that could ever exist at once.

Definition at line 418 of file player.c.

Referenced by adv_data_init(), aifill(), check_leaving_edit_mode(), check_player_or_user_name(), collect_ransom(), compat_load_020600(), create_command_newcomer(), create_current_governments_data(), create_current_governments_data_all(), dai_data_init(), dai_diplomacy_begin_new_phase(), edithand_init(), found_new_tech(), give_shared_vision(), handle_edit_player_create(), init_new_game(), is_allowed_to_take(), kill_unit(), log_civ_score_init(), object_put(), package_conn_info(), package_player_common(), player_by_name_prefix(), player_new(), player_slot_by_number(), player_slot_next(), player_slots_init(), rank_users(), remove_shared_vision(), researches_init(), scan_score_log(), server_player_set_name_full(), set_shuffled_players(), sg_load_players_basic(), sg_load_players_basic(), shuffle_players(), start_command(), and take_command().

## ◆ player_slot_first()

struct player_slot * player_slot_first | ( | void |  | ) |

Returns the first player slot.

Definition at line 399 of file player.c.

## ◆ player_slot_get_player()

struct player * player_slot_get_player | ( | const struct player_slot * | pslot | ) |

Returns the team corresponding to the slot. If the slot is not used, it will return NULL. See also player_slot_is_used().

Definition at line 437 of file player.c.

Referenced by achievement_check(), citizen_happiness_nationality(), citizens_convert(), citizens_convert_conquest(), citizens_count(), citizens_dialog_row(), citizens_print(), citizens_unit_nationality(), citizens_update(), col_nation(), do_city_migration(), extviewer_refresh_widgets(), handle_conn_info(), handle_player_remove(), is_nationality_req_active(), log_civ_score_now(), package_city(), player_by_number(), text_happiness_nationality(), and city_dialog::update_nation_table().

## ◆ player_slot_index()

int player_slot_index | ( | const struct player_slot * | pslot | ) |

Returns the index of the player slot.

Definition at line 426 of file player.c.

Referenced by adv_data_init(), citizens_dialog_row(), citizens_nation_get(), citizens_nation_set(), compat_load_020400(), compat_load_020600(), compat_load_030000(), compat_load_030100(), compat_load_030200(), compat_load_030300(), dai_data_init(), extviewer_refresh_widgets(), insert_server_side_agent(), log_civ_score_free(), log_civ_score_init(), log_civ_score_now(), package_city(), player_defaults(), player_new(), player_number(), player_slot_max_used_number(), send_player_remove_info_c(), sg_load_player_city_citizens(), sg_load_player_city_citizens(), sg_load_players_basic(), sg_load_players_basic(), sg_save_player_cities(), and tileset_init().

## ◆ player_slot_is_used()

bool player_slot_is_used | ( | const struct player_slot * | pslot | ) |

Returns TRUE is this slot is "used" i.e. corresponds to a valid, initialized player that exists in the game.

Definition at line 448 of file player.c.

Referenced by extviewer_refresh_widgets(), handle_player_info(), handle_player_remove(), log_civ_score_now(), player_new(), player_slot_max_used_number(), send_player_remove_info_c(), server_create_player(), sg_load_map_known(), sg_load_map_known(), sg_load_player_city_citizens(), sg_load_player_city_citizens(), and sg_save_map_known().

## ◆ player_slot_max_used_number()

int player_slot_max_used_number | ( | void |  | ) |

Return the highest used player slot index.

Definition at line 476 of file player.c.

Referenced by sg_load_map_known(), sg_load_map_known(), and sg_save_map_known().

## ◆ player_slot_next()

struct player_slot * player_slot_next | ( | struct player_slot * | pslot | ) |

Returns the next slot.

Definition at line 407 of file player.c.

## ◆ player_slots_free()

void player_slots_free | ( | void |  | ) |

Remove all player slots.

Definition at line 386 of file player.c.

Referenced by game_free().

## ◆ player_slots_init()

void player_slots_init | ( | void |  | ) |

Initialise all player slots (= pointer to player pointers).

Definition at line 360 of file player.c.

Referenced by game_init().

## ◆ player_slots_initialised()

bool player_slots_initialised | ( | void |  | ) |

Return whether player slots are already initialized.

Definition at line 378 of file player.c.

Referenced by player_new(), player_slot_by_number(), player_slot_is_used(), and research_iter_player_next().

## ◆ player_unit_by_number()

struct unit * player_unit_by_number | ( | const struct player * | pplayer,
|  | int | unit_id
| ) |  |

If the specified player owns the unit with the specified id, return pointer to the unit struct. Else return NULL. Uses fast idex_lookup_city.

pplayer may be NULL in which case all units registered to hash are considered - even those not currently owned by any player. Callers expect this behavior.

Definition at line 1229 of file player.c.

Referenced by api_find_unit(), auto_worker_setup_work(), diplomat_bribe(), unit_item::disband(), do_capture_units(), do_disband_alternative(), execute_orders(), find_something_to_kill(), goto_map_unit(), handle_city_name_suggestion_info(), handle_city_name_suggestion_req(), handle_city_sabotage_list(), handle_unit_action_answer(), handle_unit_action_query(), handle_unit_change_activity(), handle_unit_change_activity_real(), handle_unit_orders(), handle_unit_packet_common(), handle_unit_server_side_agent_set(), handle_unit_sscs_set(), middle_present_unit_release(), middle_supported_unit_release(), present_unit_activate_close_callback(), present_unit_activate_close_callback(), present_unit_callback(), present_unit_callback(), present_unit_middle_callback(), right_unit_release(), sg_load_player_units_transport(), sg_load_player_units_transport(), supported_unit_activate_close_callback(), supported_unit_activate_close_callback(), supported_unit_callback(), supported_unit_callback(), supported_unit_middle_callback(), unit_activate_callback(), unit_activate_callback(), unit_center_callback(), unit_center_callback(), unit_disband_callback(), unit_disband_callback(), unit_fortify_callback(), unit_fortify_callback(), unit_homecity_callback(), unit_homecity_callback(), unit_load_callback(), unit_load_callback(), unit_perform_action(), unit_select_callback(), unit_sentry_callback(), unit_sentry_callback(), unit_unload_callback(), unit_unload_callback(), unit_upgrade_callback(), unit_upgrade_callback(), units_orders_city_dlg_callback(), usdlg_cmd_center(), usdlg_cmd_cursor_changed(), usdlg_cmd_focus_real(), worker_evaluate_city_requests(), and worker_evaluate_improvements().

## ◆ players_non_invade()

bool players_non_invade | ( | const struct player * | pplayer1,
|  | const struct player * | pplayer2
| ) |  |

Returns TRUE if players can't enter each others' territory.

Definition at line 1446 of file player.c.

Referenced by player_can_invade_tile().

## ◆ players_on_same_team()

bool players_on_same_team | ( | const struct player * | pplayer1,
|  | const struct player * | pplayer2
| ) |  |

Return TRUE if players are in the same team

Definition at line 1480 of file player.c.

Referenced by compute_tech_sell_price(), conn_can_see_vote(), conn_can_vote(), dai_diplomacy_actions(), dai_diplomacy_begin_new_phase(), dai_effect_value(), dai_share(), diplomacy_possible(), handle_diplomacy_cancel_pact(), notify_team(), package_player_info(), players_in_same_range(), pplayer_can_cancel_treaty(), pplayer_can_make_treaty(), sg_load_players(), sg_load_players(), srv_ready(), update_diplomatics(), update_players_menu(), and plr_report::update_report().

## ◆ pplayer_can_cancel_treaty()

enum dipl_reason pplayer_can_cancel_treaty | ( | const struct player * | p1,
|  | const struct player * | p2
| ) |  |

The senate may not allow you to break the treaty. In this case you must first dissolve the senate then you can break it. This is waived if you have statue of liberty since you could easily just dissolve and then recreate it.

Definition at line 98 of file player.c.

Referenced by dai_declare_war(), dai_go_to_war(), handle_diplomacy_cancel_pact(), popup_diplomacy_dialog(), update_players_menu(), and plr_report::update_report().

## ◆ pplayer_can_make_treaty()

enum dipl_reason pplayer_can_make_treaty | ( | const struct player * | p1,
|  | const struct player * | p2,
|  | enum diplstate_type | treaty
| ) |  |

Returns the reason p1 can't make given treaty with p2, or DIPL_OK if they can.

We cannot regress in a treaty chain. So we cannot suggest 'Peace' if we are in 'Alliance'. Then you have to cancel.

For alliance there is only one condition: We are not at war with any of p2's allies.

Definition at line 159 of file player.c.

Referenced by handle_diplomacy_accept_treaty_req(), popup_diplomatic_objects(), sg_load_players(), and sg_load_players().

## ◆ pplayers_allied()

bool pplayers_allied | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Returns true iff players are allied.

Definition at line 1409 of file player.c.

Referenced by action_hard_reqs_actor(), adv_danger_at(), adv_data_phase_init(), api_edit_create_unit_full(), api_edit_unit_teleport(), api_methods_enemy_tile(), autoworker_tile_behavior(), calculate_want_for_paratrooper(), can_create_unit_at_tile(), can_player_see_unit_at(), can_player_see_units_in_city(), chat_msg_to_allies(), check_for_game_over(), compute_tech_sell_price(), could_unit_load(), create_extra(), dai_action_value_unit_vs_city(), dai_caravan_can_trade_cities_diff_cont(), dai_choose_diplomat_offensive(), dai_choose_trade_route(), dai_consider_tile_dangerous(), dai_data_phase_begin(), dai_diplomacy_actions(), dai_diplomacy_begin_new_phase(), dai_incident_war(), dai_manage_caravan(), dai_manage_diplomat(), dai_war_desire(), destroy_extra(), diplomat_bribe(), do_attack(), do_paradrop(), does_foreign_trade_param_allow(), find_best_tile_to_paradrop_to(), find_city_to_diplomat(), find_nearest_safe_city(), get_allied_with_enemy_player(), get_attacker(), get_default_diplstate(), handle_diplomacy_cancel_pact(), handle_edit_unit_create(), is_action_possible(), is_friendly_city_near(), is_plr_zoc_client(), is_plr_zoc_srv(), is_valid_alliance(), map_change_seen(), maybe_cancel_patrol_due_to_enemy(), non_allied_not_listed_at(), overview_tile_color(), pf_get_move_scope(), pf_transport_check(), player_can_trust_tile_has_no_units(), player_may_explore(), players_in_same_range(), redraw_unit_info_label(), reinforcements_cost_and_value(), score_tooltip(), sg_load_players(), sg_load_players(), test_unit_can_airlift_to(), throw_units_from_illegal_cities(), tile_allied_city(), tile_allied_unit(), tile_has_units_not_allied_to_but_seen_by(), tile_non_allied_city(), tile_non_allied_unit(), transfer_city_units(), unit_being_aggressive(), unit_move_to_tile_test(), unit_teleport_to_tile_test(), update_diplomatics(), wakeup_neighbor_sentries(), and war_countdown().

## ◆ pplayers_at_war()

bool pplayers_at_war | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Returns true iff players can attack each other.

Definition at line 1388 of file player.c.

Referenced by action_prob_vs_stack_full(), adv_danger_at(), aiguard_check_guard(), can_player_attack_tile(), citizen_happiness_nationality(), dai_action_value_unit_vs_city(), dai_consider_tile_dangerous(), dai_diplomacy_actions(), dai_rampage_want(), do_paradrop(), does_foreign_trade_param_allow(), find_best_tile_to_paradrop_to(), find_closest_city(), find_something_to_kill(), is_square_threatened(), kill_unit(), pf_attack_possible(), restrict_infra(), sg_load_player_units(), text_happiness_nationality(), tile_enemy_city(), tile_enemy_unit(), unit_conquer_city(), unit_move(), and unit_occupies_tile().

## ◆ pplayers_in_peace()

bool pplayers_in_peace | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Returns true iff players are allied or at peace.

Definition at line 1430 of file player.c.

Referenced by dai_goldequiv_clause(), does_foreign_trade_param_allow(), and settler_map_iterate().

## ◆ pplayers_non_attack()

bool pplayers_non_attack | ( | const struct player * | pplayer,
|  | const struct player * | pplayer2
| ) |  |

Returns true iff players have peace, cease-fire, or armistice.

Definition at line 1463 of file player.c.

Referenced by dai_diplomacy_begin_new_phase(), dai_goldequiv_clause(), do_attack(), do_paradrop(), popup_advanced_terrain_dialog(), tile_non_attack_city(), tile_non_attack_unit(), unit_move_to_tile_test(), and unit_teleport_to_tile_test().

## ◆ team_has_embassy()

bool team_has_embassy | ( | const struct team * | pteam,
|  | const struct player * | tgt_player
| ) |  |

Check if team has an embassy with tgt_player. Team always has an embassy with its members.

Definition at line 220 of file player.c.

Referenced by can_plr_see_all_sym_diplrels_of(), can_see_techs_of_target(), col_government(), could_intel_with_player(), create_clause_menu(), dem_line_item(), get_culture_info(), get_gold_info(), get_luxury_info(), get_researching_info(), get_science_info(), get_tax_info(), have_diplomat_info_about(), is_diplrel_between(), make_contact(), plr_widget::nation_selected(), notify_embassies(), notify_research_embassies(), player_info_level(), popup_add_menu(), send_research_info(), update_intel_dialog(), and wonder_visible_to_player().