AlliedModders Wiki - User contributions [en]

Entity References (SourceMod)

2013-12-16T08:34:23Z

Foo bar:

An entity reference is a combination of a standard entity index (used for all entities in SourceMod previously) and a pseudo-unique serial number that identifies the entity. Since entities are constantly being created and destroyed a cached index doesn't guarantee the underlying entity is the same, references provide a way of verifying the same entity still exists. Generally speaking, if you have an entity index you wish to cache you should convert it to a reference first. All natives (provided by SourceMod) should be able to accept references in place of indexes (wherever the parameter asks for an entity - Not clients), and these will use the serial to check that the entity index contained in the reference is the same as when the reference was created.

SourceMod now also supports handling of logical (non-networked entities) and these use references exclusively. Natives that used to return an entity index will continue to do so in the case of networked entities (for backwards compatability) and will only return a reference for non-networked ones.

==Converting a backwards-compat index/ref to a guaranteed reference for safely caching==

<pawn>
new index = GetEntPropEnt(client, Prop_Send, "m_hActiveWeapon");

/* Convert our backwards-compat index/ref to a guaranteed reference */
new ref = EntIndexToEntRef(index);
</pawn>

==Converting a reference back to an entity index==

<pawn>
new index = EntRefToEntIndex(ref);

if (index == INVALID_ENT_REFERENCE)
{
/* Reference wasn't valid - Entity must have been deleted */
}
</pawn>

==Using References to handle a logic entity==

<pawn>
new ent = -1;

while ((ent = FindEntityByClassname(ent, "logic_auto")) != -1)
{
/**
* Get the entity index from this reference - This works on references and indexes for convenience.
* Should be a number >2048 since logic_auto is a non networked entity
*/
new ref = EntIndexToEntRef(ent);

/* Fire an input on this entity - We use the reference version since this includes a serial check */
AcceptEntityInput(ref, "Kill");

}
</pawn>

[[Category:SourceMod Scripting]]

Vice keys

2013-11-04T03:30:52Z

Foo bar:

VICE keys are used to encrypt the game's weapon config files in an effort to make them more difficult to tamper with. It's not really a great protection, as usually the key is just hardcoded into the server binaries. Some games, such as Golden Eye Source, try to make it more difficult to retrieve these, but even then it's trivial.

These keys can be used to decrypt the CTX files that many games provide.

{|
!width="300"| Game
!width="100"| Key
|-
| Contagion
| fUk0fF69
|-
| Counter-Strike: Source / Global Offensive
| d7NSuLq2
|-
| CSPromod
| H1aRQ0n1
|-
| Day of Defeat: Source
| Wl0u5B3F
|-
| Dystopia (1.2?)
| pH3apO8w
|-
| Dystopia 1.3 RC2
| G8stUh3F
|-
| Golden Eye Source
| Gr3naDes
|
|-
| Half-Life 2: Capture the Flag 2.1
| R1dj3axP
|-
| Half-Life 2: Deathmatch
| x9Ke0BY7
|-
| Insurgency
| DrA5e3EB
|-
| Left 4 Dead 2 (VScript .nuc)
| SDhfi878
|-
| No More Room In Hell
| yERrrncN
|-
| Nuclear Dawn
| TA+*veh9
|-
| TF2 (items.ctx)
| A5fSXbf7
|-
| TF2 (everything else)
| E2NcUkG2
|-
| ZPS
| 5R0ni0pZ
|}

Vice keys

2013-11-04T03:30:41Z

Foo bar:

VICE keys are used to encrypt the game's weapon config files in an effort to make them more difficult to tamper with. It's not really a great protection, as usually the key is just hardcoded into the server binaries. Some games, such as Golden Eye Source, try to make it more difficult to retrieve these, but even then it's trivial.

These keys can be used to decrypt the CTX files that many games provide.

{|
!width="300"| Game
!width="100"| Key
|-
| Contagion
| fUk0fF69
|-
| Counter-Strike: Source / Global Offensive
| d7NSuLq2
|-
| CSPromod
| H1aRQ0n1
|-
| Day of Defeat: Source
| Wl0u5B3F
|-
| Dystopia (1.2?)
| pH3apO8w
|-
| Dystopia 1.3 RC2
| G8stUh3F
|-
| Golden Eye Source
| Gr3naDes
|
|-
| Half-Life 2: Capture the Flag
| R1dj3axP
|-
| Half-Life 2: Deathmatch
| x9Ke0BY7
|-
| Insurgency
| DrA5e3EB
|-
| Left 4 Dead 2 (VScript .nuc)
| SDhfi878
|-
| No More Room In Hell
| yERrrncN
|-
| Nuclear Dawn
| TA+*veh9
|-
| TF2 (items.ctx)
| A5fSXbf7
|-
| TF2 (everything else)
| E2NcUkG2
|-
| ZPS
| 5R0ni0pZ
|}