server/include/player.h

/*
 * This file is part of Deliantra, the Roguelike Realtime MMORPG.
 *
 * Copyright (©) 2017,2018 Marc Alexander Lehmann / the Deliantra team
 * Copyright (©) 2005,2006,2007,2008,2009,2010,2011,2012,2013,2014,2015,2016 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
 * Copyright (©) 2002 Mark Wedel & Crossfire Development Team
 * Copyright (©) 1992 Frank Tore Johansen
 *
 * Deliantra is free software: you can redistribute it and/or modify it under
 * the terms of the Affero GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the Affero GNU General Public License
 * and the GNU General Public License along with this program. If not, see
 * <http://www.gnu.org/licenses/>.
 *
 * The authors can be reached via e-mail to <support@deliantra.net>
 */

#ifndef PLAYER_H_
#define PLAYER_H_

//+GPL

enum bowtype_t
{
  bow_normal     = 0,
  bow_threewide  = 1,
  bow_spreadshot = 2,
  bow_n  = 3,                    /* must stay at 3 */
  bow_ne = 4,
  bow_e  = 5,
  bow_se = 6,
  bow_s  = 7,
  bow_sw = 8,
  bow_w  = 9,
  bow_nw = 10,                  /* must stay at 10 */
  bow_bestarrow = 11
};

enum petmode_t
{
  pet_normal = 0,
  pet_sad    = 1,
  pet_defend = 2,
  pet_arena  = 3,
};

enum usekeytype
{
  key_inventory = 0,
  keyrings      = 1,
  containers    = 2,
};

/* This is used to control what to do when we need to unapply
 * an object before we can apply another one.
 */
enum unapplymode
{
  unapply_nochoice = 0,         /* Will unapply objects when there no choice to unapply */
  unapply_never = 1,            /* will not unapply objects automatically */
  unapply_always = 2            /* Will unapply whatever is necessary - this goes beyond */
    /* no choice - if there are multiple ojbect of the same type */
    /* that need to be unapplied, there is no way for the player */
    /* to control which of these will be unapplied. */
};

/* not really the player, but tied pretty closely */
INTERFACE_CLASS (partylist)
struct partylist
{
  utf8_string ACC (RW, partyleader);
  char ACC (RW, passwd)[9];
  partylist *ACC (RW, next);
  utf8_string ACC (RW, partyname);

  struct party_kill
  {
    char killer[MAX_NAME + 1], dead[MAX_NAME + 1];
    sint64 exp;
  } party_kills[PARTY_KILL_LOG];

  sint64 ACC (RW, total_exp);
  uint32 ACC (RW, kills);
};

// used for pet monster logic etc.
static inline bool
same_party (partylist *a, partylist *b)
{
  return a == b && a;
}

INTERFACE_CLASS (player)
struct player : zero_initialised, attachable
{
  client *ACC (RO, ns);               /* Socket information for this player, ALWAYS valid when a player is on a map */
  object *ACC (RW, ob);               /* The object representing the player, ALWAYS valid */
  object_vector_index ACC (RO, active);

  bowtype_t ACC (RW, bowtype);        /* which firemode? */
  petmode_t ACC (RW, petmode);        /* which petmode? */
  usekeytype ACC (RW, usekeys);       /* Method for finding keys for doors */
  unapplymode ACC (RW, unapply);      /* Method for auto unapply */
  uint32 ACC (RW, count);             /* Any numbers typed before a command */
  uint32 ACC (RW, mode);              /* Mode of player for pickup. */

  int ACC (RW, digestion);            /* Any bonuses/penalties to digestion */
  int ACC (RW, gen_hp);               /* Bonuses to regeneration speed of hp */
  int ACC (RW, gen_sp);               /* Bonuses to regeneration speed of sp */
  int ACC (RW, gen_sp_armour);        /* Penalty to sp regen from armour */
  int ACC (RW, gen_grace);            /* Bonuses to regeneration speed of grace */
  int ACC (RW, item_power);           /* Total item power of objects equipped */
  uint8 ACC (RW, gender);             /* 0 male, 1 female, others not yet defined */
  uint8 ACC (RW, hintmode);           /* 0 full, 1 hint, 2 disable */

  /* Try to put all the bitfields together - saves some small amount of memory */
  bool ACC (RW, braced);              /* Will not move if braced, only attack */
  bool ACC (RW, tmp_invis);           /* Will invis go away when we attack ? */
  bool ACC (RW, do_los);              /* If true, need to call update_los() in draw(), and clear */
  bool ACC (RW, fire_on);             /* Player should fire object, not move */
  bool ACC (RW, run_on);              /* Player should keep moving in dir until run is off */
  bool ACC (RW, peaceful);            /* If set, won't attack friendly creatures */
  bool ACC (RW, hidden);              /* If True, player (DM) is hidden from view */
  bool ACC (RW, dirty);               // set if player is dirty (not reliable yet!)

  float ACC (RW, weapon_sp);              /* Penalties to speed when fighting w speed >ws/10 */
  float ACC (RW, weapon_sp_left);         // same as speed_left, but for attacks
  living ACC (RO, orig_stats);            /* Permanent real stats of player */
  object_ptr last_skill_ob[CS_NUM_SKILLS];   /* the exp object */
  object_ptr ACC (RW, last_used);            /* Pointer to object last picked or applied */

  object_ptr ACC (RW, combat_ob);     // which weapon/bow/skill to use for direct attacks
  object_ptr ACC (RW, ranged_ob);     // which skill/item/spell to use for ranged attacks
  object_ptr ACC (RW, golem);         // the currently controlled golem
  object_ptr ACC (RW, observe);       // the object that is being observed (never 0)
  object_ptr ACC (RW, viewpoint);     // the object that is being viewed in the map (never 0)

  sint16 ACC (RW, bed_x), ACC (RW, bed_y);          /* x,y - coordinates of respawn (savebed) */
  shstr ACC (RW, savebed_map);    /* map where player will respawn after death */
  shstr ACC (RW, maplevel);       /* On which level is the player? */
  char ACC (RW, spellparam)[MAX_BUF];     /* What param to add to spells */

  char ACC (RW, own_title)[MAX_NAME];     /* Title the player has chosen for themself */
  /* Note that for dragon players, this is filled in for them */
  char ACC (RW, title)[64];         /* Default title, like fighter, wizard, etc */

  sint8 ACC (RW, levhp[11]);              /* What the player gained on that level */
  sint8 ACC (RW, levsp[11]);              /* Same for sp */
  sint8 ACC (RW, levgrace[11]);           /* And same for grace */

  object_ptr ACC (RW, killer);            /* Who last tried to kill this player (this object is usually destroyed) */

  float speed_left_save;                  // speed optimisation, see process_players[12]
  char write_buf[MAX_BUF];                /* Holds arbitrary input from client */ /* should go */
  char ACC (RW, password)[256];           /* 2 (seed) + 11 (crypted) + 1 (EOS) + 2 (safety) = 16 */

  partylist *ACC (RW, party);             /* Party this player is part of */
  partylist *ACC (RW, party_to_join);     /* used when player wants to join a party */
  /* but we will have to get password first */
  /* so we have to remember which party to */
  /* join */
  char ACC (RW, search_str)[256];         /* Item we are looking for */
  sint16 ACC (RW, encumbrance);           /* How much our player is encumbered  */
  uint16 ACC (RW, outputs_sync);          /* How often to print, no matter what */
  uint16 ACC (RW, outputs_count);         /* Print if this count is exceeded */
  object_ptr ACC (RW, mark);                 /* marked object */
  /* Special DM fields */
  tag_t *stack_items;           /* Item stack for patch/dump/... commands */
  int ACC (RW, stack_position);           /* Current stack position, 0 for no item */
  sint8 los[MAP_CLIENT_X][MAP_CLIENT_Y];        /* array showing what spaces */
                                                /* the player can see.  For maps smaller than */
                                                /* MAP_CLIENT_.., the center is used */

//-GPL

  // stats updates are very costly, so delay them if at all possible
  bool ACC (RW, delayed_update);
  void queue_stats_update ()
  {
    delayed_update = true;
  }
  void need_updated_stats ()
  {
    if (delayed_update)
      ob->update_stats ();
  }

#if 0
  enum {
    SA_SPELLS = 1<<0,
    SA_EXP    = 1<<1,
  };

  uint8 ACxC (RW, stat_update_flags);

  void need_stat_update (int flags)
  {
    stat_update_flags |= flags;
  }
#endif

  // return the los value for the given coordinate
  MTH sint8 blocked_los (int dx, int dy) const
  {
    dx += LOS_X0;
    dy += LOS_Y0;

    return 0 <= dx && dx < MAP_CLIENT_X
        && 0 <= dy && dy < MAP_CLIENT_Y
           ? los[dx][dy] : LOS_BLOCKED;
  }

  // unchecked variant
  sint8 blocked_los_uc (int dx, int dy) const
  {
    return los[dx + LOS_X0][dy + LOS_Y0];
  }

  MTH void clear_los (sint8 value = LOS_BLOCKED);
  MTH void update_los ();

  shstr ACC (RW, invis_race);             /* What race invisible to? */

  MTH const_utf8_string killer_name () const; // makes a string out of ->killer

  MTH static player *create ();
  static player *find (const_utf8_string name);

  static player *load_pl (object_thawer &thawer);
  MTH static player *load_pl (object_thawer *thawer) { return load_pl (*thawer); }

  MTH void link_skills ();
  MTH object *find_skill (shstr_cmp name) const;

  bool save_pl (object_freezer &freezer);
  MTH bool save_pl (const_octet_string path);

  void do_destroy ();
  void gather_callbacks (AV *&callbacks, event_type event) const;

  MTH dynbuf_text *expand_cfpod (const_utf8_string cfpod) const;
  static dynbuf_text *expand_cfpod (int hintmode, int gender, const_utf8_string cfpod);

  MTH void touch () { dirty = true; } // need to touch when logged out and changed

  MTH void play_sound (faceidx sound, int dx = 0, int dy = 0) const
  {
    if (ns)
      ns->play_sound (sound, dx, dy);
  }

  // wether the player can "see" this mapspace or not, decided by los
  // 0 - bright, 3 dark, 4 too dark, 100 blocked or out of range
  MTH sint8 darkness_at (maptile *map, int x, int y) const;

  MTH void connect (client *ns);
  MTH void disconnect ();

  MTH void activate ();
  MTH void deactivate ();

  MTH void chargen_race_done ();
  MTH void chargen_race_next ();

  MTH void set_observe (object_ornull *ob);
  MTH void set_viewpoint (object_ornull *ob);

  void send_msg (int color, const_utf8_string type, const_utf8_string msg)
  {
    ns->send_msg (color, type, msg);
  }

  // a prominent box that can easily be escaped away or so
  // should be used for informative output such as who, maps etc.
  // will stay on-screen
  MTH void infobox (const_utf8_string title, const_utf8_string msg, int color = NDI_BLACK);

  // a prominent msg that signifies some important event,
  // an improvement potion effect potion. should not be long.
  // might time out after a while
  MTH void statusmsg (const_utf8_string msg, int color = NDI_BLACK);

  // a prominent box that signifies some error such as a failed
  // improvement potion. should not be long.
  MTH void failmsg (const_utf8_string msg, int color = NDI_RED);
  void failmsgf (const_utf8_string format, ...); // always NDI_RED

  MTH void update_spells () const
  {
    if (ns)
      ns->update_spells = true;
  }

  ~player ();

private:
  void set_object (object *op);
  player ();
};

typedef object_vector<player, &player::active> playervec;

extern playervec players;

#define for_all_players(var)                    \
  for (unsigned _i = 0; _i < ::players.size (); ++_i)   \
    statementvar (player *, var, ::players [_i])

#define for_all_players_on_map(var,mapp)                \
  for_all_players(var)                                  \
    if ((var)->ob->map == (mapp))

inline void
object::statusmsg (const_utf8_string msg, int color)
{
  if (ecb_expect_true (contr)) contr->statusmsg (msg, color);
}

inline void
object::failmsg (const_utf8_string msg, int color)
{
  if (ecb_expect_true (contr)) contr->failmsg (msg, color);
}

#endif

Revision:	1.116
Committed:	Wed Dec 5 19:03:26 2018 UTC (5 years, 5 months ago) by root
Content type:	text/plain
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.115:	+2 -2 lines
Log Message:	some bugfixes
#	User	Rev	Content
1	root	1.1	/*
2	root	1.74	* This file is part of Deliantra, the Roguelike Realtime MMORPG.
3	root	1.111	*
4	root	1.115	* Copyright (©) 2017,2018 Marc Alexander Lehmann / the Deliantra team
5	root	1.113	* Copyright (©) 2005,2006,2007,2008,2009,2010,2011,2012,2013,2014,2015,2016 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
6	root	1.103	* Copyright (©) 2002 Mark Wedel & Crossfire Development Team
7			* Copyright (©) 1992 Frank Tore Johansen
8	root	1.111	*
9	root	1.92	* Deliantra is free software: you can redistribute it and/or modify it under
10			* the terms of the Affero GNU General Public License as published by the
11			* Free Software Foundation, either version 3 of the License, or (at your
12			* option) any later version.
13	root	1.111	*
14	root	1.64	* This program is distributed in the hope that it will be useful,
15			* but WITHOUT ANY WARRANTY; without even the implied warranty of
16			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17			* GNU General Public License for more details.
18	root	1.111	*
19	root	1.92	* You should have received a copy of the Affero GNU General Public License
20			* and the GNU General Public License along with this program. If not, see
21			* <http://www.gnu.org/licenses/>.
22	root	1.111	*
23	root	1.74	* The authors can be reached via e-mail to <support@deliantra.net>
24	pippijn	1.45	*/
25	root	1.103
26	root	1.93	#ifndef PLAYER_H_
27			#define PLAYER_H_
28	root	1.1
29	root	1.95	//+GPL
30
31	root	1.16	enum bowtype_t
32			{
33	root	1.50	bow_normal = 0,
34			bow_threewide = 1,
35	root	1.16	bow_spreadshot = 2,
36	root	1.50	bow_n = 3, /* must stay at 3 */
37	root	1.16	bow_ne = 4,
38	root	1.50	bow_e = 5,
39	root	1.16	bow_se = 6,
40	root	1.50	bow_s = 7,
41	root	1.16	bow_sw = 8,
42	root	1.50	bow_w = 9,
43	root	1.16	bow_nw = 10, /* must stay at 10 */
44			bow_bestarrow = 11
45			};
46
47			enum petmode_t
48			{
49			pet_normal = 0,
50	root	1.50	pet_sad = 1,
51	root	1.16	pet_defend = 2,
52	root	1.50	pet_arena = 3,
53	root	1.16	};
54
55			enum usekeytype
56			{
57			key_inventory = 0,
58	root	1.50	keyrings = 1,
59			containers = 2,
60	root	1.16	};
61	root	1.1
62			/* This is used to control what to do when we need to unapply
63			* an object before we can apply another one.
64			*/
65	root	1.16	enum unapplymode
66			{
67			unapply_nochoice = 0, /* Will unapply objects when there no choice to unapply */
68			unapply_never = 1, /* will not unapply objects automatically */
69			unapply_always = 2 /* Will unapply whatever is necessary - this goes beyond */
70			/* no choice - if there are multiple ojbect of the same type */
71			/* that need to be unapplied, there is no way for the player */
72			/* to control which of these will be unapplied. */
73			};
74
75			/* not really the player, but tied pretty closely */
76	root	1.38	INTERFACE_CLASS (partylist)
77	root	1.16	struct partylist
78			{
79	root	1.101	utf8_string ACC (RW, partyleader);
80	root	1.38	char ACC (RW, passwd)[9];
81			partylist *ACC (RW, next);
82	root	1.101	utf8_string ACC (RW, partyname);
83	root	1.1
84	root	1.16	struct party_kill
85			{
86			char killer[MAX_NAME + 1], dead[MAX_NAME + 1];
87			sint64 exp;
88			} party_kills[PARTY_KILL_LOG];
89	root	1.38
90			sint64 ACC (RW, total_exp);
91			uint32 ACC (RW, kills);
92	root	1.16	};
93	root	1.1
94	root	1.55	// used for pet monster logic etc.
95	root	1.96	static inline bool
96	root	1.55	same_party (partylist a, partylist b)
97			{
98			return a == b && a;
99			}
100
101	root	1.35	INTERFACE_CLASS (player)
102			struct player : zero_initialised, attachable
103	root	1.6	{
104	root	1.67	client ACC (RO, ns); / Socket information for this player, ALWAYS valid when a player is on a map */
105			object ACC (RW, ob); / The object representing the player, ALWAYS valid */
106	root	1.62	object_vector_index ACC (RO, active);
107	root	1.43
108	root	1.51	bowtype_t ACC (RW, bowtype); /* which firemode? */
109			petmode_t ACC (RW, petmode); /* which petmode? */
110			usekeytype ACC (RW, usekeys); /* Method for finding keys for doors */
111			unapplymode ACC (RW, unapply); /* Method for auto unapply */
112			uint32 ACC (RW, count); /* Any numbers typed before a command */
113			uint32 ACC (RW, mode); /* Mode of player for pickup. */
114
115	root	1.91	int ACC (RW, digestion); /* Any bonuses/penalties to digestion */
116			int ACC (RW, gen_hp); /* Bonuses to regeneration speed of hp */
117			int ACC (RW, gen_sp); /* Bonuses to regeneration speed of sp */
118			int ACC (RW, gen_sp_armour); /* Penalty to sp regen from armour */
119			int ACC (RW, gen_grace); /* Bonuses to regeneration speed of grace */
120			int ACC (RW, item_power); /* Total item power of objects equipped */
121	root	1.82	uint8 ACC (RW, gender); /* 0 male, 1 female, others not yet defined */
122			uint8 ACC (RW, hintmode); /* 0 full, 1 hint, 2 disable */
123	root	1.16
124			/* Try to put all the bitfields together - saves some small amount of memory */
125	root	1.43	bool ACC (RW, braced); /* Will not move if braced, only attack */
126			bool ACC (RW, tmp_invis); /* Will invis go away when we attack ? */
127			bool ACC (RW, do_los); /* If true, need to call update_los() in draw(), and clear */
128			bool ACC (RW, fire_on); /* Player should fire object, not move */
129			bool ACC (RW, run_on); /* Player should keep moving in dir until run is off */
130			bool ACC (RW, peaceful); /* If set, won't attack friendly creatures */
131			bool ACC (RW, hidden); /* If True, player (DM) is hidden from view */
132	root	1.76	bool ACC (RW, dirty); // set if player is dirty (not reliable yet!)
133	root	1.16
134	root	1.18	float ACC (RW, weapon_sp); /* Penalties to speed when fighting w speed >ws/10 */
135	root	1.57	float ACC (RW, weapon_sp_left); // same as speed_left, but for attacks
136	root	1.18	living ACC (RO, orig_stats); /* Permanent real stats of player */
137	root	1.106	object_ptr last_skill_ob[CS_NUM_SKILLS]; /* the exp object */
138	root	1.18	object_ptr ACC (RW, last_used); /* Pointer to object last picked or applied */
139	root	1.16
140	root	1.53	object_ptr ACC (RW, combat_ob); // which weapon/bow/skill to use for direct attacks
141			object_ptr ACC (RW, ranged_ob); // which skill/item/spell to use for ranged attacks
142	root	1.51	object_ptr ACC (RW, golem); // the currently controlled golem
143	root	1.94	object_ptr ACC (RW, observe); // the object that is being observed (never 0)
144			object_ptr ACC (RW, viewpoint); // the object that is being viewed in the map (never 0)
145	root	1.51
146	root	1.18	sint16 ACC (RW, bed_x), ACC (RW, bed_y); /* x,y - coordinates of respawn (savebed) */
147	root	1.39	shstr ACC (RW, savebed_map); /* map where player will respawn after death */
148			shstr ACC (RW, maplevel); /* On which level is the player? */
149	root	1.18	char ACC (RW, spellparam)[MAX_BUF]; /* What param to add to spells */
150	root	1.16
151	root	1.18	char ACC (RW, own_title)[MAX_NAME]; /* Title the player has chosen for themself */
152	root	1.16	/* Note that for dragon players, this is filled in for them */
153	root	1.19	char ACC (RW, title)[64]; /* Default title, like fighter, wizard, etc */
154	root	1.16
155	root	1.34	sint8 ACC (RW, levhp[11]); /* What the player gained on that level */
156			sint8 ACC (RW, levsp[11]); /* Same for sp */
157			sint8 ACC (RW, levgrace[11]); /* And same for grace */
158	root	1.16
159	root	1.77	object_ptr ACC (RW, killer); /* Who last tried to kill this player (this object is usually destroyed) */
160	root	1.16
161	root	1.114	float speed_left_save; // speed optimisation, see process_players[12]
162	root	1.99	char write_buf[MAX_BUF]; /* Holds arbitrary input from client / / should go */
163	root	1.108	char ACC (RW, password)[256]; /* 2 (seed) + 11 (crypted) + 1 (EOS) + 2 (safety) = 16 */
164	root	1.1
165	root	1.18	partylist ACC (RW, party); / Party this player is part of */
166			partylist ACC (RW, party_to_join); / used when player wants to join a party */
167	root	1.16	/* but we will have to get password first */
168			/* so we have to remember which party to */
169			/* join */
170	root	1.98	char ACC (RW, search_str)[256]; /* Item we are looking for */
171	root	1.18	sint16 ACC (RW, encumbrance); /* How much our player is encumbered */
172			uint16 ACC (RW, outputs_sync); /* How often to print, no matter what */
173			uint16 ACC (RW, outputs_count); /* Print if this count is exceeded */
174			object_ptr ACC (RW, mark); /* marked object */
175	root	1.16	/* Special DM fields */
176			tag_t stack_items; / Item stack for patch/dump/... commands */
177	root	1.18	int ACC (RW, stack_position); /* Current stack position, 0 for no item */
178	root	1.85	sint8 los[MAP_CLIENT_X][MAP_CLIENT_Y]; /* array showing what spaces */
179			/* the player can see. For maps smaller than */
180			/* MAP_CLIENT_.., the center is used */
181
182	root	1.95	//-GPL
183
184	root	1.98	// stats updates are very costly, so delay them if at all possible
185			bool ACC (RW, delayed_update);
186			void queue_stats_update ()
187			{
188			delayed_update = true;
189			}
190			void need_updated_stats ()
191			{
192			if (delayed_update)
193			ob->update_stats ();
194			}
195
196	root	1.104	#if 0
197			enum {
198			SA_SPELLS = 1<<0,
199			SA_EXP = 1<<1,
200			};
201
202			uint8 ACxC (RW, stat_update_flags);
203
204			void need_stat_update (int flags)
205			{
206			stat_update_flags \|= flags;
207			}
208			#endif
209
210	root	1.85	// return the los value for the given coordinate
211			MTH sint8 blocked_los (int dx, int dy) const
212			{
213			dx += LOS_X0;
214			dy += LOS_Y0;
215
216			return 0 <= dx && dx < MAP_CLIENT_X
217			&& 0 <= dy && dy < MAP_CLIENT_Y
218			? los[dx][dy] : LOS_BLOCKED;
219			}
220
221			// unchecked variant
222			sint8 blocked_los_uc (int dx, int dy) const
223			{
224			return los[dx + LOS_X0][dy + LOS_Y0];
225			}
226	root	1.16
227	root	1.86	MTH void clear_los (sint8 value = LOS_BLOCKED);
228	root	1.88	MTH void update_los ();
229	root	1.86
230	root	1.31	shstr ACC (RW, invis_race); /* What race invisible to? */
231	root	1.13
232	root	1.100	MTH const_utf8_string killer_name () const; // makes a string out of ->killer
233	root	1.77
234	root	1.36	MTH static player *create ();
235	root	1.73	static player *find (const_utf8_string name);
236	root	1.43
237			static player *load_pl (object_thawer &thawer);
238	root	1.73	MTH static player load_pl (object_thawer thawer) { return load_pl (*thawer); }
239	root	1.43
240	root	1.83	MTH void link_skills ();
241	root	1.90	MTH object *find_skill (shstr_cmp name) const;
242	root	1.83
243	root	1.43	bool save_pl (object_freezer &freezer);
244	root	1.102	MTH bool save_pl (const_octet_string path);
245	root	1.43
246	root	1.35	void do_destroy ();
247			void gather_callbacks (AV *&callbacks, event_type event) const;
248	root	1.31
249	root	1.101	MTH dynbuf_text *expand_cfpod (const_utf8_string cfpod) const;
250	root	1.112	static dynbuf_text *expand_cfpod (int hintmode, int gender, const_utf8_string cfpod);
251	root	1.82
252	root	1.78	MTH void touch () { dirty = true; } // need to touch when logged out and changed
253
254	root	1.65	MTH void play_sound (faceidx sound, int dx = 0, int dy = 0) const
255			{
256			if (ns)
257			ns->play_sound (sound, dx, dy);
258			}
259
260	root	1.46	// wether the player can "see" this mapspace or not, decided by los
261	root	1.89	// 0 - bright, 3 dark, 4 too dark, 100 blocked or out of range
262			MTH sint8 darkness_at (maptile *map, int x, int y) const;
263	root	1.46
264	root	1.36	MTH void connect (client *ns);
265			MTH void disconnect ();
266	root	1.31
267	root	1.43	MTH void activate ();
268			MTH void deactivate ();
269
270	root	1.48	MTH void chargen_race_done ();
271			MTH void chargen_race_next ();
272
273	root	1.80	MTH void set_observe (object_ornull *ob);
274	root	1.94	MTH void set_viewpoint (object_ornull *ob);
275	root	1.60
276	root	1.101	void send_msg (int color, const_utf8_string type, const_utf8_string msg)
277	root	1.68	{
278			ns->send_msg (color, type, msg);
279			}
280
281			// a prominent box that can easily be escaped away or so
282			// should be used for informative output such as who, maps etc.
283			// will stay on-screen
284	root	1.101	MTH void infobox (const_utf8_string title, const_utf8_string msg, int color = NDI_BLACK);
285	root	1.68
286			// a prominent msg that signifies some important event,
287			// an improvement potion effect potion. should not be long.
288			// might time out after a while
289	root	1.101	MTH void statusmsg (const_utf8_string msg, int color = NDI_BLACK);
290	root	1.68
291			// a prominent box that signifies some error such as a failed
292			// improvement potion. should not be long.
293	root	1.101	MTH void failmsg (const_utf8_string msg, int color = NDI_RED);
294	root	1.107	void failmsgf (const_utf8_string format, ...); // always NDI_RED
295	root	1.68
296	root	1.97	MTH void update_spells () const
297			{
298			if (ns)
299			ns->update_spells = true;
300			}
301
302	root	1.31	~player ();
303
304			private:
305			void set_object (object *op);
306			player ();
307	root	1.16	};
308	root	1.13
309	root	1.43	typedef object_vector<player, &player::active> playervec;
310
311			extern playervec players;
312
313			#define for_all_players(var) \
314	root	1.65	for (unsigned _i = 0; _i < ::players.size (); ++_i) \
315			statementvar (player *, var, ::players [_i])
316	root	1.43
317	root	1.87	#define for_all_players_on_map(var,mapp) \
318			for_all_players(var) \
319			if ((var)->ob->map == (mapp))
320
321	root	1.68	inline void
322	root	1.101	object::statusmsg (const_utf8_string msg, int color)
323	root	1.68	{
324	root	1.116	if (ecb_expect_true (contr)) contr->statusmsg (msg, color);
325	root	1.68	}
326
327			inline void
328	root	1.101	object::failmsg (const_utf8_string msg, int color)
329	root	1.68	{
330	root	1.116	if (ecb_expect_true (contr)) contr->failmsg (msg, color);
331	root	1.68	}
332	root	1.93
333			#endif
334	root	1.101