From Valve Developer Community
Revision as of 02:53, 14 March 2016 by Tuxxi (talk | contribs)
Jump to: navigation, search
Deutsch Русский

Think functions allow entities to schedule code to be run in the future. By constantly rescheduling thinks, automated loops can be created that make an entity autonomous.


SetNextThink() is used to configure when an entity should next think. It accepts a float value.

void CMyEntity::Spawn()
	SetNextThink( gpGlobals->curtime ); // Think now

void CMyEntity::Think()
	BaseClass::Think(); // Always do this if you override Think()

	Msg( "I think, therefore I am.\n" );
	SetNextThink( gpGlobals->curtime + 1 ); // Think again in 1 second

Notice the use of gpGlobals->curtime to make the value passed relative to the time of execution.

Tip.png Tip: 

New think functions

An entity can have any number of additional think functions. To register a new one:

  1. Ensure the function is void.
  2. Add it to the entity's DATADESC with DEFINE_THINKFUNC().
  3. Call SetThink() and pass a pointer to the function (see example below).
  4. Ensure DECLARE_DATADESC(); is in your class.
	DEFINE_THINKFUNC( MyThink ), // Register new think function

void CMyEntity::Spawn()
	SetThink( &CMyEntity::MyThink ); // Pass a function pointer

void CMyEntity::MyThink()
	Msg( "I think, therefore I am.\n" );
	SetNextThink( gpGlobals->curtime + 1 );

Splitting your think code into different functions makes it easy to switch an entity between modes of operation.

Tip.png Tip: SetThink() can be called from within a think function, too. The next call will be to the new function.

Using contexts

It is possible to schedule any number of think functions side-by-side with "think contexts". To create a new context:

  1. Call RegisterThinkContext(string ContextName)
  2. Call SetContextThink(void* Function, float NextThinkTime, string ContextName)
  3. For subsequent thinks, call SetNextThink(float NextThinkTime, string ContextName)
	DEFINE_THINKFUNC( ContextThink ),

void CMyEntity::Spawn()
	SetNextThink( gpGlobals->curtime ); // Default think loop - no context 
	RegisterThinkContext( "TestContext" );
	SetContextThink( &CMyEntity::ContextThink, gpGlobals->curtime, "TestContext" );

void CMyEntity::Think()

	Msg( "Think\n" );
	SetNextThink( gpGlobals->curtime + .1 );

void CMyEntity::ContextThink()
	Msg( "Context think\n" );
	SetNextThink(gpGlobals->curtime + .2, "TestContext" );

This creates two simultaneous think loops, both writing to the console at different rates.

Tip.png Tip: Creating a new context is a great way to delay function calls to the future without upsetting existing think loops.


These should be self-explanatory:

float	GetLastThink()
float	GetNextThink()
int	GetLastThinkTick()
int	GetNextThinkTick()

The GetLast functions are useful for controlling the rate at which something occurs. This think code from npc_barnacle modulates the speed of tongue movement, even if the frequency of thinking changes:

float dt = gpGlobals->curtime - GetLastThink(); // dt is "delta time"
SetAltitude( m_flAltitude + m_flBarnaclePullSpeed * dt ); // Change tongue altitude

For its non-skeletal animation to be smooth this code would need to be executed every frame. This is exactly what happens, until the barnacle is no longer in the player's PVS and the rate is slowed down – thus requiring the above code.


Thinking can also occur on the client, but its effects are limited. Only one think function is supported for each entity.

void C_MyEntity::ClientThink()
	Msg( "Don't put anything expensive in this function!\n" );
	SetNextClientThink( CLIENT_THINK_ALWAYS ); // Think every frame

Some examples of client-side thinking are:

  • Visual effects / particles
  • VGUI screen interaction
  • Modifying player speed (done on the client as well as server to avoid prediction errors)
  • Striders’ legs snapping ropes (disabled by default)

SetNextClientThink() is used to schedule ClientThink(). There are two special values it accepts:

Think on the client once every frame. Use with caution!
Tip.png Tip: Use gpGlobals->frametime to regulate speed.
Pause all automated client thinking.