Freeciv-3.2
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 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_slotplayer_slot_first (void)
 
struct player_slotplayer_slot_next (struct player_slot *pslot)
 
int player_slot_count (void)
 
int player_slot_index (const struct player_slot *pslot)
 
struct playerplayer_slot_get_player (const struct player_slot *pslot)
 
bool player_slot_is_used (const struct player_slot *pslot)
 
struct player_slotplayer_slot_by_number (int player_id)
 
int player_slot_max_used_number (void)
 
struct playerplayer_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 playerplayer_by_number (const int player_id)
 
const charplayer_name (const struct player *pplayer)
 
struct playerplayer_by_name (const char *name)
 
struct playerplayer_by_name_prefix (const char *name, enum m_pre_result *result)
 
struct playerplayer_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 cityplayer_city_by_number (const struct player *pplayer, int city_id)
 
struct unitplayer_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 cityplayer_primary_capital (const struct player *pplayer)
 
const charlove_text (const int love)
 
enum diplstate_type cancel_pact_result (enum diplstate_type oldstate)
 
struct player_diplstateplayer_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 chardiplrel_rule_name (int value)
 
const chardiplrel_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)
 
voidplayer_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 567 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 230 of file player.h.

◆ is_human

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

Definition at line 229 of file player.h.

◆ MAX_AI_LOVE

#define MAX_AI_LOVE   1000

Definition at line 561 of file player.h.

◆ MAX_ATTRIBUTE_BLOCK

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

Definition at line 221 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 555 of file player.h.

◆ player_list_iterate_end

#define player_list_iterate_end    LIST_ITERATE_END

Definition at line 557 of file player.h.

◆ player_nation

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

Definition at line 406 of file player.h.

◆ player_slots_iterate

#define player_slots_iterate (   _pslot)
Value:
char * incite_cost
Definition comments.c:75
struct player_slot * player_slot_next(struct player_slot *pslot)
Definition player.c:407
bool player_slots_initialised(void)
Definition player.c:378
struct player_slot * player_slot_first(void)
Definition player.c:399

Definition at line 523 of file player.h.

◆ player_slots_iterate_end

#define player_slots_iterate_end
Value:
} \
}

Definition at line 527 of file player.h.

◆ players_iterate

#define players_iterate (   _pplayer)
Value:
#define player_slots_iterate(_pslot)
Definition player.h:523
struct player * player_slot_get_player(const struct player_slot *pslot)
Definition player.c:437

Definition at line 532 of file player.h.

◆ players_iterate_alive

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

Definition at line 542 of file player.h.

◆ players_iterate_alive_end

#define players_iterate_alive_end    } players_iterate_end;

Definition at line 547 of file player.h.

◆ players_iterate_end

#define players_iterate_end
Value:
} \
#define player_slots_iterate_end
Definition player.h:527

Definition at line 537 of file player.h.

◆ set_as_ai

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

Definition at line 232 of file player.h.

◆ set_as_human

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

Definition at line 231 of file player.h.

◆ SPECENUM_COUNT [1/3]

#define SPECENUM_COUNT   PSTATUS_COUNT

Definition at line 78 of file player.h.

◆ SPECENUM_COUNT [2/3]

#define SPECENUM_COUNT   DS_LAST /* leave this last */

Definition at line 78 of file player.h.

◆ SPECENUM_COUNT [3/3]

#define SPECENUM_COUNT   DRO_LAST

Definition at line 78 of file player.h.

◆ SPECENUM_NAME [1/3]

Definition at line 68 of file player.h.

◆ SPECENUM_NAME [2/3]

Definition at line 68 of file player.h.

◆ SPECENUM_NAME [3/3]

Definition at line 68 of file player.h.

◆ SPECENUM_VALUE0 [1/2]

#define SPECENUM_VALUE0   PSTATUS_NORMAL

Definition at line 70 of file player.h.

◆ SPECENUM_VALUE0 [2/2]

#define SPECENUM_VALUE0   DS_ARMISTICE

Definition at line 70 of file player.h.

◆ SPECENUM_VALUE0NAME

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

Definition at line 136 of file player.h.

◆ SPECENUM_VALUE1 [1/2]

#define SPECENUM_VALUE1   PSTATUS_DYING

Definition at line 72 of file player.h.

◆ SPECENUM_VALUE1 [2/2]

#define SPECENUM_VALUE1   DS_WAR

Definition at line 72 of file player.h.

◆ SPECENUM_VALUE10

#define SPECENUM_VALUE10   DRO_HAS_EMBASSY

Definition at line 167 of file player.h.

◆ SPECENUM_VALUE10NAME

#define SPECENUM_VALUE10NAME   N_("Has embassy")

Definition at line 168 of file player.h.

◆ SPECENUM_VALUE11

#define SPECENUM_VALUE11   DRO_HOSTS_REAL_EMBASSY

Definition at line 169 of file player.h.

◆ SPECENUM_VALUE11NAME

#define SPECENUM_VALUE11NAME   N_("Hosts real embassy")

Definition at line 170 of file player.h.

◆ SPECENUM_VALUE12

#define SPECENUM_VALUE12   DRO_HAS_REAL_EMBASSY

Definition at line 171 of file player.h.

◆ SPECENUM_VALUE12NAME

#define SPECENUM_VALUE12NAME   N_("Has real embassy")

Definition at line 172 of file player.h.

◆ SPECENUM_VALUE13

#define SPECENUM_VALUE13   DRO_HAS_CASUS_BELLI

Definition at line 173 of file player.h.

◆ SPECENUM_VALUE13NAME

#define SPECENUM_VALUE13NAME   N_("Has Casus Belli")

Definition at line 174 of file player.h.

◆ SPECENUM_VALUE14

#define SPECENUM_VALUE14   DRO_PROVIDED_CASUS_BELLI

Definition at line 175 of file player.h.

◆ SPECENUM_VALUE14NAME

#define SPECENUM_VALUE14NAME   N_("Provided Casus Belli")

Definition at line 176 of file player.h.

◆ SPECENUM_VALUE15

#define SPECENUM_VALUE15   DRO_FOREIGN

Definition at line 177 of file player.h.

◆ SPECENUM_VALUE15NAME

#define SPECENUM_VALUE15NAME   N_("Foreign")

Definition at line 178 of file player.h.

◆ SPECENUM_VALUE16

#define SPECENUM_VALUE16   DRO_HAS_TEAM_EMBASSY

Definition at line 179 of file player.h.

◆ SPECENUM_VALUE16NAME

#define SPECENUM_VALUE16NAME   N_("Has team embassy")

Definition at line 180 of file player.h.

◆ SPECENUM_VALUE17

#define SPECENUM_VALUE17   DRO_HOSTS_TEAM_EMBASSY

Definition at line 181 of file player.h.

◆ SPECENUM_VALUE17NAME

#define SPECENUM_VALUE17NAME   N_("Hosts team embassy")

Definition at line 182 of file player.h.

◆ SPECENUM_VALUE1NAME

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

Definition at line 138 of file player.h.

◆ SPECENUM_VALUE2 [1/2]

#define SPECENUM_VALUE2   PSTATUS_WINNER

Definition at line 74 of file player.h.

◆ SPECENUM_VALUE2 [2/2]

#define SPECENUM_VALUE2   DS_CEASEFIRE

Definition at line 74 of file player.h.

◆ SPECENUM_VALUE2NAME

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

Definition at line 140 of file player.h.

◆ SPECENUM_VALUE3 [1/2]

#define SPECENUM_VALUE3   PSTATUS_SURRENDER

Definition at line 76 of file player.h.

◆ SPECENUM_VALUE3 [2/2]

#define SPECENUM_VALUE3   DS_PEACE

Definition at line 76 of file player.h.

◆ SPECENUM_VALUE3NAME

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

Definition at line 142 of file player.h.

◆ SPECENUM_VALUE4

#define SPECENUM_VALUE4   DS_ALLIANCE

Definition at line 143 of file player.h.

◆ SPECENUM_VALUE4NAME

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

Definition at line 144 of file player.h.

◆ SPECENUM_VALUE5

#define SPECENUM_VALUE5   DS_NO_CONTACT

Definition at line 145 of file player.h.

◆ SPECENUM_VALUE5NAME

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

Definition at line 146 of file player.h.

◆ SPECENUM_VALUE6

#define SPECENUM_VALUE6   DS_TEAM

Definition at line 147 of file player.h.

◆ SPECENUM_VALUE6NAME

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

Definition at line 148 of file player.h.

◆ SPECENUM_VALUE7

#define SPECENUM_VALUE7   DRO_GIVES_SHARED_VISION

Definition at line 161 of file player.h.

◆ SPECENUM_VALUE7NAME

#define SPECENUM_VALUE7NAME   N_("Gives shared vision")

Definition at line 162 of file player.h.

◆ SPECENUM_VALUE8

#define SPECENUM_VALUE8   DRO_RECEIVES_SHARED_VISION

Definition at line 163 of file player.h.

◆ SPECENUM_VALUE8NAME

#define SPECENUM_VALUE8NAME   N_("Receives shared vision")

Definition at line 164 of file player.h.

◆ SPECENUM_VALUE9

#define SPECENUM_VALUE9   DRO_HOSTS_EMBASSY

Definition at line 165 of file player.h.

◆ SPECENUM_VALUE9NAME

#define SPECENUM_VALUE9NAME   N_("Hosts embassy")

Definition at line 166 of file player.h.

◆ SPECLIST_TAG

#define SPECLIST_TAG   player

Definition at line 551 of file player.h.

◆ SPECLIST_TYPE

#define SPECLIST_TYPE   struct player

Definition at line 552 of file player.h.

Enumeration Type Documentation

◆ dipl_reason

Enumerator
DIPL_OK 
DIPL_ERROR 
DIPL_SENATE_BLOCKING 
DIPL_ALLIANCE_PROBLEM_US 
DIPL_ALLIANCE_PROBLEM_THEM 

Definition at line 190 of file player.h.

◆ player_debug_types

Enumerator
PLAYER_DEBUG_DIPLOMACY 
PLAYER_DEBUG_TECH 
PLAYER_DEBUG_LAST 

Definition at line 212 of file player.h.

◆ plrcolor_mode

Enumerator
PLRCOL_PLR_ORDER 
PLRCOL_PLR_RANDOM 
PLRCOL_PLR_SET 
PLRCOL_TEAM_ORDER 
PLRCOL_NATION_ORDER 

Definition at line 50 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 1501 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 
)

◆ 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 1640 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 1581 of file player.c.

Referenced by universal_value_from_str().

◆ diplrel_mess_close()

void diplrel_mess_close ( void  )

Free diplrel_mess

Definition at line 1808 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 1627 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 1823 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 1615 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 1493 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 
)

◆ is_barbarian()

static bool is_barbarian ( const struct player pplayer)
inlinestatic

◆ 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 1512 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 1562 of file player.c.

Referenced by is_diplrel_in_range().

◆ is_settable_ai_level()

bool is_settable_ai_level ( enum ai_level  level)

◆ 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 1908 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 1932 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 
)

◆ player_by_name()

struct player * player_by_name ( const char name)

◆ player_by_name_prefix()

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

◆ 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 
)

◆ 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  )

◆ 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(), and update_intel_dialog().

◆ 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 
)

◆ 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 1998 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 1878 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 575 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 1969 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 1981 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 1958 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(), edithand_send_initial_packets(), 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_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)

◆ 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 1948 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)

◆ player_slot_count()

int player_slot_count ( void  )

◆ 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)

◆ player_slot_index()

int player_slot_index ( const struct player_slot pslot)

◆ player_slot_is_used()

bool player_slot_is_used ( const struct player_slot pslot)

◆ 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_settler_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(), settler_evaluate_city_requests(), settler_evaluate_improvements(), 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(), and usdlg_cmd_focus_real().

◆ 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 1442 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 
)

◆ 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 1405 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(), autosettler_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 
)

◆ 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 1426 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 
)

◆ team_has_embassy()

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