diplomats.h File Reference

#include "fc_types.h"

Go to the source code of this file.

Functions
bool	diplomat_embassy (struct player *pplayer, struct unit *pdiplomat, struct city *pcity, const struct action *paction)
bool	diplomat_investigate (struct player *pplayer, struct unit *pdiplomat, struct city *pcity, const struct action *paction)
void	spy_send_sabotage_list (struct connection *pc, struct unit *pdiplomat, struct city *pcity, const struct action *paction, int request_kind)
bool	spy_poison (struct player *pplayer, struct unit *pdiplomat, struct city *pcity, const struct action *paction)
bool	spy_spread_plague (struct player *act_player, struct unit *act_unit, struct city *tgt_city, const struct action *paction)
bool	spy_sabotage_unit (struct player *pplayer, struct unit *pdiplomat, struct unit *pvictim, const struct action *paction)
bool	diplomat_bribe (struct player *pplayer, struct unit *pdiplomat, struct unit *pvictim, const struct action *paction)
bool	spy_attack (struct player *act_player, struct unit *act_unit, struct tile *tgt_tile, const struct action *paction)
int	diplomats_unignored_tech_stealings (struct unit *pdiplomat, struct city *pcity)
bool	diplomat_get_tech (struct player *pplayer, struct unit *pdiplomat, struct city *pcity, int technology, const struct action *paction)
bool	diplomat_incite (struct player *pplayer, struct unit *pdiplomat, struct city *pcity, const struct action *paction)
bool	diplomat_sabotage (struct player *pplayer, struct unit *pdiplomat, struct city *pcity, Impr_type_id improvement, const struct action *paction)
bool	spy_steal_gold (struct player *act_player, struct unit *act_unit, struct city *tgt_city, const struct action *paction)
bool	spy_steal_some_maps (struct player *act_player, struct unit *act_unit, struct city *tgt_city, const struct action *paction)
bool	spy_nuke_city (struct player *act_player, struct unit *act_unit, struct city *tgt_city, const struct action *paction)
bool	spy_escape (struct player *pplayer, struct unit *actor_unit, struct city *target_city, struct tile *target_tile, const struct action *paction)
int	count_diplomats_on_tile (struct tile *ptile)

Function Documentation

count_diplomats_on_tile()

int count_diplomats_on_tile

(

struct tile *

ptile

)

Return number of diplomats on this square. AJS 20000130

Definition at line 2377 of file diplomats.c.

Referenced by dai_diplomat_defend(), dai_manage_diplomat(), and find_city_to_diplomat().

diplomat_bribe()

bool diplomat_bribe	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct unit *	pvictim,
		const struct action *	paction
	)

Bribe an enemy unit.

• Can't bribe a unit if:
  • Player doesn't have enough gold.
• Otherwise, the unit will be bribed.
• A successful briber will try to move onto the victim's square.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 643 of file diplomats.c.

Referenced by unit_perform_action().

diplomat_embassy()

bool diplomat_embassy	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct city *	pcity,
		const struct action *	paction
	)

Establish an embassy.

• Always success; the embassy is created.
• It costs some minimal movement to establish an embassy.
• The actor unit always survives establishing the embassy unless the action being performed is configured to always consume the actor unit.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 483 of file diplomats.c.

Referenced by unit_perform_action().

diplomat_get_tech()

bool diplomat_get_tech	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct city *	pcity,
		Tech_type_id	technology,
		const struct action *	paction
	)

Try to steal a technology from an enemy city. If paction results in ACTION_SPY_STEAL_TECH or ACTION_SPY_STEAL_TECH_ESC, steal a random technology. Otherwise, steal the technology whose ID is "technology". (Note: Only Spies can select what to steal.)

• Check for infiltration success. Our thief may not survive this.
• Check for basic success. Again, our thief may not survive this.
• If a technology has already been stolen from this city at any time:
  • Diplomats will be caught and executed.
  • Spies will have an increasing chance of being caught and executed.
• Steal technology!
• The thief may be captured and executed, or escape to its home town.

FIXME: It should give a loss of reputation to steal from a player you are not at war with

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 891 of file diplomats.c.

Referenced by unit_perform_action().

diplomat_incite()

bool diplomat_incite	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct city *	pcity,
		const struct action *	paction
	)

Incite a city to disaffect.

• Can't incite a city to disaffect if:
  • Player doesn't have enough gold.
• Check for infiltration success. Our provocateur may not survive this.
• Check for basic success. Again, our provocateur may not survive this.
• Otherwise, the city will disaffect:
  • Player gets the city.
  • Player gets certain of the city's present/supported units.
  • Player gets a technology advance, if any were unknown.
• The provocateur may be captured and executed, or escape to its home town.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 1135 of file diplomats.c.

Referenced by unit_perform_action().

diplomat_investigate()

bool diplomat_investigate	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct city *	pcity,
		const struct action *	paction
	)

Investigate a city.

• It costs some minimal movement to investigate a city.
• The actor unit always survives the investigation unless the action being performed is configured to always consume the actor unit.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 324 of file diplomats.c.

Referenced by receive_packet_city_info_100(), and unit_perform_action().

diplomat_sabotage()

bool diplomat_sabotage	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct city *	pcity,
		Impr_type_id	improvement,
		const struct action *	paction
	)

Sabotage enemy city's improvement or production. If this is untargeted sabotage city a random improvement or production is targeted. Targeted sabotage city lets the value of "improvement" decide the target. If "improvement" is -1, sabotage current production. Otherwise, sabotage the city improvement whose ID is "improvement".

• Check for infiltration success. Our saboteur may not survive this.
• Check for basic success. Again, our saboteur may not survive this.
• Determine target, given arguments and constraints.
• If specified, city walls and anything in a capital are 50% likely to fail.
• Do sabotage!
• The saboteur may be captured and executed, or escape to its home town.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 1284 of file diplomats.c.

Referenced by unit_perform_action().

diplomats_unignored_tech_stealings()

int diplomats_unignored_tech_stealings	(	struct unit *	pdiplomat,
		struct city *	pcity
	)

Returns the amount of tech thefts from a city not ignored by the EFT_STEALINGS_IGNORE effect.

Definition at line 850 of file diplomats.c.

Referenced by dai_action_value_unit_vs_city(), diplomat_get_tech(), and find_city_to_diplomat().

spy_attack()

bool spy_attack	(	struct player *	act_player,
		struct unit *	act_unit,
		struct tile *	tgt_tile,
		const struct action *	paction
	)

Diplomatic battle.

• Check for infiltration success. The entire point of this action.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 807 of file diplomats.c.

Referenced by unit_perform_action().

spy_escape()

bool spy_escape	(	struct player *	pplayer,
		struct unit *	actor_unit,
		struct city *	target_city,
		struct tile *	target_tile,
		const struct action *	paction
	)

Attempt to escape without doing anything else first.

May be captured and executed, or escape to the nearest domestic city.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 2346 of file diplomats.c.

Referenced by unit_perform_action().

spy_nuke_city()

bool spy_nuke_city	(	struct player *	act_player,
		struct unit *	act_unit,
		struct city *	tgt_city,
		const struct action *	paction
	)

Hide a suitcase nuke in a city and detonate it.

• Check for infiltration success. Our thief may not survive this.
• Check for basic success. Again, our thief may not survive this.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 1834 of file diplomats.c.

Referenced by unit_perform_action().

spy_poison()

bool spy_poison	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct city *	pcity,
		const struct action *	paction
	)

Poison a city's water supply.

• Check for infiltration success. Our poisoner may not survive this.
• Check for basic success. Again, our poisonner may not survive this.
• If successful, reduces population by one point.
• The poisoner may be captured and executed, or escape to its home town.

'pplayer' is the player who tries to poison 'pcity' with its unit 'pdiplomat'.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 97 of file diplomats.c.

Referenced by unit_perform_action().

spy_sabotage_unit()

bool spy_sabotage_unit	(	struct player *	pplayer,
		struct unit *	pdiplomat,
		struct unit *	pvictim,
		const struct action *	paction
	)

Sabotage an enemy unit.

• If successful, reduces hit points by half of those remaining.
• The saboteur may be captured and executed, or escape to its home town.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 548 of file diplomats.c.

Referenced by unit_perform_action().

spy_send_sabotage_list()

void spy_send_sabotage_list	(	struct connection *	pc,
		struct unit *	pdiplomat,
		struct city *	pcity,
		const struct action *	paction,
		int	request_kind
	)

Get list of improvements from city (for purposes of sabotage).

• Always successful; returns list.

Only send back to the originating connection, if there is one. (?)

Definition at line 429 of file diplomats.c.

Referenced by handle_unit_action_query().

spy_spread_plague()

bool spy_spread_plague	(	struct player *	act_player,
		struct unit *	act_unit,
		struct city *	tgt_city,
		const struct action *	paction
	)

Spread a plague to the target city.

• Check for infiltration success. Our infector may not survive this.
• Check for basic success. Again, our infector may not survive this.
• If successful, strikes the city with illness.
• The infector may be captured and executed, or escape to a nearby city.

'act_player' is the player who tries to infect 'tgt_city' with its unit 'act_unit'.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 214 of file diplomats.c.

Referenced by unit_perform_action().

spy_steal_gold()

bool spy_steal_gold	(	struct player *	act_player,
		struct unit *	act_unit,
		struct city *	tgt_city,
		const struct action *	paction
	)

Steal gold from another player. The amount stolen is decided randomly. Not everything stolen reaches the player that ordered it stolen.

• Check for infiltration success. Our thief may not survive this.
• Check for basic success. Again, our thief may not survive this.
• Can't steal if there is no money to take.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 1556 of file diplomats.c.

Referenced by unit_perform_action().

spy_steal_some_maps()

bool spy_steal_some_maps	(	struct player *	act_player,
		struct unit *	act_unit,
		struct city *	tgt_city,
		const struct action *	paction
	)

Steal part of another player's map.

• Check for infiltration success. Our thief may not survive this.
• Check for basic success. Again, our thief may not survive this.

Returns TRUE iff action could be done, FALSE if it couldn't. Even if this returns TRUE, unit may have died during the action.

Definition at line 1698 of file diplomats.c.

Referenced by unit_perform_action().