Zh/Condition

From Valve Developer Community
< Zh
Jump to: navigation, search
Info content.png
This page needs to be translated.
This page either contains information that is only partially or incorrectly translated, or there isn't a translation yet.
If this page cannot be translated for some reason, or is left untranslated for an extended period of time after this notice is posted, the page should be requested to be deleted.
Also, please make sure the article tries to comply with the alternate languages guide.

条件是NPC用于记录一些关于地图的状态的标签(en)。条件主要是用于选择或插入修改schedule:zh-cn(en)的,并且每次 NPCThink()(en)都会提醒。 一些条件实例:

  • "I can see an enemy"//我可以看见一个敌人
  • "I have taken some damage"//我被打中了!
  • "My weapon's clip is empty"//我没子弹啦

The engine's set of shared conditions are usually supplemented by others specific to an NPC. For example, antlions(en) drown when in water, so they have a condition of their own that tells them "I am underwater".

Tip.png提示:You can see a list of all conditions by searching in Visual Studio's 'Class View'.
Note.png注意:By default there is a maximum of 256 conditions in any one game or mod. You can increase this number in ai_condition.h, but doing so will break older saved games and increase memory usage.

Interrupt conditions

As well as being used when selecting a new schedule(en), conditions validate the current one by acting as "interrupts". Each schedule has an associated list of conditions that will cause it to exit if detected. When this happens, a new schedule is chosen.

For example, an NPC may be running a schedule to "Chase my enemy". This kind of schedule usually specifies the "I have chosen a new enemy" condition as an interrupt, because the NPC shouldn't keep chasing the old enemy if it has found a a newer, more important one.

Adding new conditions

Conditions are normally enumerated inside the NPC class. For example, if our new NPC has a custom condition to reflect "I am hungry", our condition enum should look something like this:

enum 
{
	COND_MYNPC_HUNGRY = BaseClass::NEXT_CONDITION,
	NEXT_CONDITION
};

It's good practice to include the NEXT_CONDITION enum, so that NPCs derived from our NPC can use BaseClass::NEXT_CONDITION (as we do, on the first line) to declare their custom conditions without causing collisions with ours.

Warning.png警告:If your condition enum isn't inside your class definition then you must choose a different, unique name for your "next condition" item.

Conditions must then be declared inside the NPC's AI_BEGIN_CUSTOM_NPC block. This is done through the DECLARE_CONDITION macro. For the above example, we'd use this line:

AI_BEGIN_CUSTOM_NPC( npc_custom, CNPC_Custom )
	DECLARE_CONDITION( COND_MYNPC_HUNGRY )
AI_END_CUSTOM_NPC()

Condition functions

CAI_BaseNPC(en) stores conditions as flag(en)s in m_Conditions, but it should not be accessed directly. Instead, condition handling is done with these functions:

GatherConditions()
The primary entry point for condition generation, which is called every time the NPC thinks.
Note.png注意:Make sure you call BaseClass::GatherConditions() at the end!
SetCondition( int(en) iCondition )
ClearCondition( int(en) iCondition )
Sets/clears a condition. Instead of passing an integer, you'll of course make use of your enum.
bool(en) HasCondition( int(en) iCondition )
True if the specified condition is currently set. Remember that conditions are thrown away and re-generated on every think.
BuildScheduleTestBits()
This function allows you to dynamically modify a schedule's interrupts at any time. It's useful for appending your custom NPC conditions to base NPC or shared schedules. See below for an example.

Examples

GatherConditions()

Here's a slightly trimmed version of the Antlion(en)'s GatherConditions(). Antlions jump around a lot, and sometimes land on top of other NPCs. They need to know whether they've landed on an NPC when decision making, so they generate a condition when they have. Antlions also need to drown if they ever find themselves in water, so they set a condition when their water level reaches waist high.

void CNPC_Antlion::GatherConditions()
{
	BaseClass::GatherConditions();

	// See if I've landed on another NPC after jumping.
	CBaseEntity *pGroundEnt = GetGroundEntity();
	if ( pGroundEnt && pGroundEnt->GetSolidFlags() & FSOLID_NOT_STANDABLE && GetFlags() & FL_ONGROUND )
		SetCondition( COND_ANTLION_ON_NPC );
	else
		ClearCondition( COND_ANTLION_ON_NPC );

	// See if I've landed in water
	if( m_lifeState == LIFE_ALIVE && GetWaterLevel() > 1 )
		SetCondition( COND_ANTLION_IN_WATER );
}

The else statement uses ClearCondition() here because if the first if statement is true, then the boolean COND_ANTLION_ON_NPC is set to True. When this happens, another piece of code later on is fired, telling the antlion to get off the NPC's head, and hopefully, the antlion does not jump onto another NPC. Once it is no longer standing on an NPC, the condition goes back to being false, so it resumes normal activity.

//On another NPC's head?
if( HasCondition( COND_ANTLION_ON_NPC ) )
{
        // You're on an NPC's head. Get off.
        return SCHED_ANTLION_DISMOUNT_NPC;
}

BuildScheduleTestBits()

The Assault behavior(en) allows mappers to specify whether an NPC should divert from their path to fight new enemies or keep running. This kind of dynamic interrupt specification can't be done in the static schedule definitions, and is exactly what BuildScheduleTestBits() is designed for.

void CAI_AssaultBehavior::BuildScheduleTestBits()
{
	BaseClass::BuildScheduleTestBits();

	// If we're allowed to divert, add the appropriate interrupts to our movement schedules
	if ( m_hAssaultPoint && m_hAssaultPoint->m_bAllowDiversion )
	{
		if ( IsCurSchedule( SCHED_MOVE_TO_ASSAULT_POINT ) ||
			 IsCurSchedule( SCHED_MOVE_TO_RALLY_POINT ) || 
			 IsCurSchedule( SCHED_HOLD_RALLY_POINT ) )
		{
			GetOuter()->SetCustomInterruptCondition( COND_NEW_ENEMY );
			GetOuter()->SetCustomInterruptCondition( COND_SEE_ENEMY );
		}
	}
}

See also

  • Shared conditions(en) - a list of conditions inherited by all NPCs
  • State(en) - records whether the NPC is idle, alert, in combat, etc.