server/include/player.h

/*
 * This file is part of Deliantra, the Roguelike Realtime MMORPG.
 * 
 * Copyright (©) 2005,2006,2007,2008,2009,2010 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;                  // spee doptimisation, see process_players[12]
  char write_buf[MAX_BUF];                /* Holds arbitrary input from client */ /* should go */
  char ACC (RW, password)[16];            /* 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;

  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 (expect_true (contr)) contr->statusmsg (msg, color);
}

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

#endif

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