Laine at 19:28, 11 June 2007

2007-06-11T19:28:31Z

New page

==Files==
/def/descriptor/character.c
/lib/descriptor/autonomon.h
/daemon/characters.c
/lib/characters.h

==Description==

Character descriptors are used by the random character selection system.
Characters that are suitable for random generation are registered with
the characters daemon using character descriptors, and the descriptors
are used in the selection process.

The standard support module for control daemons includes functions for
registering characters for use by the random character system, which is
referred to as "publishing" them. Example of characters being registered
from a project control daemon:

#include <Project.h>

inherit "/std/daemon";
inherit "/mod/daemon/control";

#include <daemon.h>

void configure() {
::configure();
// set_creator(), set_area(), extensions, and so on here...
add_published_character(Project_Monster("orc"),
Rarity_Very_Common);
add_published_character(([
Character_File : Project_Monster("ogre_mage"),
Character_Rarity : Rarity_Very_Rare,
]));
add_published_character(([
Character_File : Project_NPC("golbrunk"),
Character_Rarity : Rarity_Exotic,
Character_Dangers : Danger_Hated,
]));
}

===Public Fields===

Character_File: The string object name of the character blueprint object.

Character_Rarity: The general rarity with which the character is to be
randomly generated. This is an integer rarity value from rarity.h.
Required.

Character_Dangers: A field of bitmask flags indicating dangers associated
with the character, which is mainly to do with the risk of them attacking
or being attacked by other characters. These flags are normally assigned
automatically to the extent possible. The danger flags are:

Character_Danger_Aggressive: The character attacks others (only
incarnoi unless Character_Danger_Indiscriminate is also set). This
flag is assigned automatically to characters who respond true to
query_aggressive().

Character_Danger_Allied: The character is allied with a large social
group, and attacking this character will earn the enmity of that social
group; normally means that the character is attached to a project
control daemon with guardian functionality and has its area control
flag turned on. Note that it is generally best not to publish such
characters for random generation. This flag is assigned automatically
to characters who respond true to query_area_control().

Character_Danger_Bomb: The character is some variety of autonomous
bomb, and may be dangerous to anyone around it. This flag is not
assigned automatically.

Character_Danger_Enmity: There are other characters or classes of
character that this character considers enemies, on a basis other than
race, and who this character will attack. This flag is assigned
automatically to characters who have non-race values in their setting
for query_enemies().

Character_Danger_Friendly: There are other characters or classes of
character that this character is friendly with and will assist in
combat. This flag is assigned automatically to characters who respond
to query_friends() with an array of greater than size 0.

Character_Danger_Hated: There are characters or classes of character
which are aggressive specifically toward this character or class of
character (characters to whom ordinary racism settings or other forms
of aggression may apply need not set this flag). This flag is not
assigned automatically.

Character_Danger_Indiscriminate: The character is as aggressive toward
non-incarnoi as toward incarnoi. This flag is assigned automatically
to characters who respond true to query_can_kill().

Character_Danger_Racist: The character considers specific races as
enemies and will attack them. This flag is assigned automatically to
characters who have race values in their setting for query_enemies().

Character_Flags: A set of bitmask flags. Currently there is only one:

Character_Defined_Dangers: Suppresses the normal analysis of the
character for automatic assignment of Character_Dangers flags. This
means the danger flags manually assigned are relied on exclusively,
and so should be specified carefully.

===Internal Fields===

Character_Object: Query this field to retrieve a pointer to the character
blueprint. The character will be loaded if it has not been yet. Do not
set this field.

Character_Source: The string object name of the object that created the
descriptor.

Character_Tag: The tag for the descriptor system.

===Support Functions===

object Character_Resolve(descriptor dxr)

Returns the final character object suitable for use as randomly generated
content. In the case of monsters, this will be a clone of the blueprint;
in the case of NPCs, it will be the blueprint itself.

==See Also==

[[man descriptors|descriptors(mechanisms)]], [[man rarity|rarity(mechanisms)]], [[man selection|selection(mechanisms)]], [[man item|item(descriptors)]], [[man location|location(descriptors)]]

Man character - Revision history

Laine at 19:28, 11 June 2007