evennia.contrib.tutorials.evadventure.npcs

EvAdventure NPCs. This includes both friends and enemies, only separated by their AI.

class evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC(*args, **kwargs)

Bases: evennia.contrib.tutorials.evadventure.characters.LivingMixin, evennia.objects.objects.DefaultCharacter

This is the base class for all non-player entities, including monsters. These generally don’t advance in level but uses a simplified, abstract measure of how dangerous or competent they are - the ‘hit dice’ (HD).

HD indicates how much health they have and how hard they hit. In _Knave_, HD also defaults to being the bonus for all abilities. HP is 4 x Hit die (this can then be customized per-entity of course).

Morale is set explicitly per-NPC, usually between 7 and 9.

Monsters don’t use equipment in the way PCs do, instead they have a fixed armor value, and their Abilities are dynamically generated from the HD (hit_dice).

If wanting monsters or NPCs that can level and work the same as PCs, base them off the EvAdventureCharacter class instead.

The weapon of the npc is stored as an Attribute instead of implementing a full inventory/equipment system. This means that the normal inventory can be used for non-combat purposes (or for loot to get when killing an enemy).

is_pc = False

hit_dice

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

armor

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

morale

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

hp_multiplier

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

hp

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

allegiance

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

is_idle

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

weapon

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

coins

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

property strength

property dexterity

property constitution

property intelligence

property wisdom

property charisma

property hp_max

at_object_creation()

Start with max health.

ai_combat_next_action()

The combat engine should ask this method in order to get the next action the npc should perform in combat.

exception DoesNotExist

Bases: evennia.objects.objects.DefaultCharacter.DoesNotExist

exception MultipleObjectsReturned

Bases: evennia.objects.objects.DefaultCharacter.MultipleObjectsReturned

path = 'evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC'

typename = 'EvAdventureNPC'

class evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC(*args, **kwargs)

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC

Talkative NPCs can be addressed by talk [to] <npc>. This opens a chat menu with communication options. The menu is created with the npc and we override the .create to allow passing in the menu nodes.

menudata

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

menu_kwargs

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

hi_text

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

at_damage(damage, attacker=None)

Talkative NPCs are generally immortal (we don’t deduct HP here by default).”

classmethod create(key, account=None, **kwargs)

Overriding the creation of the NPC, allowing some extra **kwargs.

Parameters

• key (str) – Name of the new object.

• account (Account, optional) – Account to attribute this object to.

Keyword Arguments

• description (str) – Brief description for this object (same as default Evennia)

• ip (str) – IP address of creator (for object auditing) (same as default Evennia).

• menudata (dict or str) – The menudata argument to EvMenu. This is either a dict of {“nodename”: <node_callable>,…} or the python-path to a module containing such nodes (see EvMenu docs). This will be used to generate the chat menu chat menu for the character that talks to the NPC (which means the at_talk hook is called (by our custom talk command).

• menu_kwargs (dict) – This will be passed as **kwargs into EvMenu when it is created. Make sure this dict can be pickled to an Attribute.

Returns

tuple – (new_character, errors). On error, the new_character is None and errors is a list of error strings (an empty list otherwise).

at_talk(talker, startnode='node_start', session=None, **kwargs)

Called by the talk command when another entity addresses us.

Parameters

• talker (Object) – The one talking to us.

• startnode (str, optional) – Allows to start in a different location in the menu tree. The given node must exist in the tree.

• session (Session, optional) – The talker’s current session, allows for routing correctly in multi-session modes.

• **kwargs – This will be passed into the EvMenu creation and appended and menu_kwargs given to the NPC at creation.

Notes

We pass npc=self into the EvMenu for easy back-reference. This will appear in the **kwargs of the start node.

exception DoesNotExist

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC.DoesNotExist

exception MultipleObjectsReturned

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC.MultipleObjectsReturned

path = 'evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC'

typename = 'EvAdventureTalkativeNPC'

evennia.contrib.tutorials.evadventure.npcs.node_start(caller, raw_string, **kwargs)

This is the intended start menu node for the Talkative NPC interface. It will use on-npc Attributes to build its message and will also pick its options based on nodes named node_start_* are available in the node tree.

class evennia.contrib.tutorials.evadventure.npcs.EvAdventureQuestGiver(*args, **kwargs)

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC

An NPC that acts as a dispenser of quests.

exception DoesNotExist

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC.DoesNotExist

exception MultipleObjectsReturned

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC.MultipleObjectsReturned

path = 'evennia.contrib.tutorials.evadventure.npcs.EvAdventureQuestGiver'

typename = 'EvAdventureQuestGiver'

class evennia.contrib.tutorials.evadventure.npcs.EvAdventureShopKeeper(*args, **kwargs)

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC

ShopKeeper NPC.

upsell_factor

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

miser_factor

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

common_ware_prototypes

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

at_damage(damage, attacker=None)

Immortal - we don’t deduct any damage here.

exception DoesNotExist

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC.DoesNotExist

exception MultipleObjectsReturned

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureTalkativeNPC.MultipleObjectsReturned

path = 'evennia.contrib.tutorials.evadventure.npcs.EvAdventureShopKeeper'

typename = 'EvAdventureShopKeeper'

class evennia.contrib.tutorials.evadventure.npcs.EvAdventureMob(*args, **kwargs)

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC

Mob (mobile) NPC; this is usually an enemy.

loot_chance

Attribute property descriptor. Allows for specifying Attributes as Django-like ‘fields’ on the class level. Note that while one can set a lock on the Attribute, there is no way to check said lock when accessing via the property - use the full AttributeHandler if you need to do access checks.

Example:

class Character(DefaultCharacter):
    foo = AttributeProperty(default="Bar")

ai_combat_next_action(combathandler)

Called to get the next action in combat.

Parameters

combathandler (EvAdventureCombatHandler) – The currently active combathandler.

Returns

tuple – A tuple (str, tuple, dict), being the action_key, and the *args and **kwargs for that action. The action-key is that of a CombatAction available to the combatant in the current combat handler.

at_defeat()

Mobs die right away when defeated, no death-table rolls.

at_do_loot(looted)

Called when mob gets to loot a PC.

exception DoesNotExist

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC.DoesNotExist

exception MultipleObjectsReturned

Bases: evennia.contrib.tutorials.evadventure.npcs.EvAdventureNPC.MultipleObjectsReturned

path = 'evennia.contrib.tutorials.evadventure.npcs.EvAdventureMob'

typename = 'EvAdventureMob'