Entity Basics - Revision history

Outerbeast: /* What are entities? */

2025-02-15T01:46:56Z

What are entities?

← Older revision		Revision as of 03:46, 15 February 2025
Line 35:		Line 35:
	* CBaseDoor		* CBaseDoor

	Note: Entity handles are not reference counted, which means that unlike most objects in AngelScript, they will not exist as long as you still have a handle to it. This also means that a handle can point to an entity that no longer exists. For this reason you should avoid using entity handles for storage and use [[EHandle]] instead. The game will scan for entity handles declared as global variables, and will prevent compilation from succeeding if it detects any of them.		'''Note''': Entity handles are not reference counted, which means that unlike most objects in AngelScript, they will not exist as long as you still have a handle to it. This also means that a handle can point to an entity that no longer exists. For this reason you should avoid using entity handles for storage and use [[EHandle]] instead.

			The game will scan for entity handles declared as global variables, and will prevent compilation from succeeding if it detects any of them. Entity handles as member variables are just as dangerous, even if the compiler does not catch these. Arrays of entity handles are also not caught by the compiler but are still subject to the same risks. Passing entity handles through scheduled functions/methods is equally dangerous and should be avoided.
			In all these scenarios you must use EHandle.

	== Entity Variables ==		== Entity Variables ==

Outerbeast at 23:59, 13 February 2025

2025-02-13T23:59:42Z

@@ Line 1: / Line 1: @@
 Entities are objects in the game that are effectively small programs which serve a specific function or represent an actual thing: players, NPCs, platforms, triggers, etc.
 CBaseEntity is the type used to represent entities themselves. All entities derive from CBaseEntity, so you can do most things with this interface. It has a rather large amount of methods and variables, so be sure to check out the documentation for it.
@@ Line 34: / Line 36: @@
 Note: Entity handles are not reference counted, which means that unlike most objects in AngelScript, they will not exist as long as you still have a handle to it. This also means that a handle can point to an entity that no longer exists. For this reason you should avoid using entity handles for storage and use [[EHandle]] instead. The game will scan for entity handles declared as global variables, and will prevent compilation from succeeding if it detects any of them.
 [[Category:Scripting]]

Outerbeast at 23:36, 13 February 2025

2025-02-13T23:36:20Z

← Older revision		Revision as of 01:36, 14 February 2025
Line 34:		Line 34:

	Note: Entity handles are not reference counted, which means that unlike most objects in AngelScript, they will not exist as long as you still have a handle to it. This also means that a handle can point to an entity that no longer exists. For this reason you should avoid using entity handles for storage and use [[EHandle]] instead. The game will scan for entity handles declared as global variables, and will prevent compilation from succeeding if it detects any of them.		Note: Entity handles are not reference counted, which means that unlike most objects in AngelScript, they will not exist as long as you still have a handle to it. This also means that a handle can point to an entity that no longer exists. For this reason you should avoid using entity handles for storage and use [[EHandle]] instead. The game will scan for entity handles declared as global variables, and will prevent compilation from succeeding if it detects any of them.
			[[Category:Scripting]]

Outerbeast: Created page with "Entities are objects in the game that are effectively small programs which serve a specific function or represent an actual thing: players, NPCs, platforms, triggers, etc. CB..."

2025-02-13T23:35:57Z

Created page with "Entities are objects in the game that are effectively small programs which serve a specific function or represent an actual thing: players, NPCs, platforms, triggers, etc. CB..."

New page

Entities are objects in the game that are effectively small programs which serve a specific function or represent an actual thing: players, NPCs, platforms, triggers, etc.

CBaseEntity is the type used to represent entities themselves. All entities derive from CBaseEntity, so you can do most things with this interface. It has a rather large amount of methods and variables, so be sure to check out the documentation for it.

There are several subclasses that extend functionality for different types of entities:

CBaseToggle provides support for toggled behaviour, found in doors, buttons, trains, and platforms.
CBaseAnimating provides support for entities using studio models.
CBaseMonster provides the basis for all monsters and the player. This includes navigation, scheduling of tasks like movement, combat, and more.
There are many more classes available in the API, so be sure to check them out of as well. Here's a list of all entities in the API:

* CBaseEntity
* CBaseDelay
* CBaseAnimating
* CBaseToggle
* CBasePlayerItem
* CBasePlayerWeapon
* CBasePlayerAmmo
* CItemInventory
* CItem
* CGrenade
* CBaseMonster
* CCineMonster
* CBasePlayer
* CSprite
* CTalkMonster
* CPathTrack
* CBeam
* CLaser
* CBaseTank
* CPathCondition
* CBaseButton
* CBaseDoor

Note: Entity handles are not reference counted, which means that unlike most objects in AngelScript, they will not exist as long as you still have a handle to it. This also means that a handle can point to an entity that no longer exists. For this reason you should avoid using entity handles for storage and use [[EHandle]] instead. The game will scan for entity handles declared as global variables, and will prevent compilation from succeeding if it detects any of them.