[BHaType]

I think it would be a good idea to attach this topic so that no one don't have to search for it in the future also a new sourcemod user will see this topic and maybe this will fix the problem of identical errors and requests for
help such as: no debug stringtable, Error parsing gameconfig file, Language phrase "..." not found and so on

[Desktop]

I think it would be nice to add the usage of RequestFrame instead of CreateTimer with 0.1 seconds to execution as a good practice.

For example:

PHP Code:

public Action EventOnPlayerConnectedFull(Event event, char[] name, bool dontBroadcast){

    int client = GetClientOfUserId(GetEventInt(event, "userid"));
    
    RequestFrame(view_as<RequestFrameCallback>(MoveToSpectator), client);
}
public Action MoveToSpectator(any data){
    
    ChangeClientTeam(data, CS_TEAM_NONE);
} 


[Maxximou5]

Originally Posted by Desktop I think it would be nice to add the usage of RequestFrame instead of CreateTimer with 0.1 seconds to execution as a good practice. Spoiler For example: PHP Code: public Action EventOnPlayerConnectedFull(Event event, char[] name, bool dontBroadcast){     int client = GetClientOfUserId(GetEventInt(event, "userid"));          RequestFrame(view_as<RequestFrameCallback>(MoveToSpectator), client); } public Action MoveToSpectator(any data){          ChangeClientTeam(data, CS_TEAM_NONE); }

It would depend on the use case, you could be using a repeat timer. Though for the instance you are probably mentioning, it would be a one time with an immediate response. That would be a great use of RequestFrame as it's that's what it should be used for. Though, I would say it would better to have a complete example, along with the newest method of usage. Such as -

PHP Code:

#include <cstrike>

public void OnPluginStart()
{
    HookEvent("player_connect_full", Event_PlayerConnectFull);
}

public void Event_PlayerConnectFull(Event event, const char[] name, bool dontBroadcast)
{
    int client = GetClientOfUserId(event.GetInt("userid"));
    RequestFrame(Frame_ChangeTeam, client);
}

public void Frame_ChangeTeam(any client)
{
    ChangeClientTeam(client, CS_TEAM_NONE)
} 


It should be mentioned that there are scenarios were RequestFrame and using a timer delay are different enough that something such as when a player is spawning and not creating a delay will cause a function to not work. Case scenarios I believe exist, like equipping a weapon, dropping a weapon, or cycling and stripping certain weapons, are such examples.

Of course, correct me if I am wrong, but this was such issues I had awhile ago.

[Dragokas]

// TODO:
Where is a good start for learning VScript system? Some links for novice...

Skip it. Already included in 1st post:

Spoiler

BHaType, +1. Definitely, topic deserve to be pin.
I added it to my favorites, since, I noticed it is very convenient to access to other links via it.

Orthographic misprints:

"with too may handles" => many (missing "n")
emphasise => emphasize
eg with => e.g. with
mistakingly => mistakenly
contributers => contributors

Debug:
- LogStackTrace - rephrase please: Useful to write the last chain of function calls to error log. This is a feature from SM 1.10.

Rearrange items in that section from most used to less, I think:

Spoiler

- Check addons/sourcemod/logs/error_<date>.log ...

- Most direct and fastest method ...

- Install Accelerator ...

- Use -debug switch ...

- Memory leaks can be found ...
- In that case it's better to compare ...

- Benchmarking plugin ...

- Use ac_debug ...

- LogStackTrace ...

Optimiz:

- Use %N instead of GetClientName()

Mistakes:

- You need to check is map started before creating the entity.

- Before searching and modifying entity in OnMapStart(), you have to wait a bit to allow entities correctly initialize. It's better to use "round_freeze_end" event (not available for some games).

- "Local variable "v" shadows a variable at a preceding level" - mean you declared variable "v" twice.

Entity cmds:

- cl_showpos 1 - to open mini-panel tracking your current position, angles, velocity

Tools descr.:

- GCFScape - append ... - also, to open BSP and extract map resources.

2. Server Setup
I think it is missed essential part:

"Connect to Server":

To allow other people join your server over internet:

- Setup port forwarding for 27016 port.
- (CS:GO only) Create token and specify it in csgo\cfg\autoexec.cfg file: sv_setsteamaccount <login_token>
- Other people should enter in console:

connect Your.Public.IP:27016

If YOU want to join:
- your client application should be run before server! (otherwise, Steam will deny you from running client; so, later you could only run it manually and insecurely)
- enter in client's console:

connect Local.IP:27016

[Desktop]

Originally Posted by Maxximou5 It would depend on the use case, you could be using a repeat timer. Though for the instance you are probably mentioning, it would be a one time with an immediate response. That would be a great use of RequestFrame as it's that's what it should be used for. Though, I would say it would better to have a complete example, along with the newest method of usage. Such as - PHP Code: #include <cstrike> public void OnPluginStart() {     HookEvent("player_connect_full", Event_PlayerConnectFull); } public void Event_PlayerConnectFull(Event event, const char[] name, bool dontBroadcast) {     int client = GetClientOfUserId(event.GetInt("userid"));     RequestFrame(Frame_ChangeTeam, client); } public void Frame_ChangeTeam(any client) {     ChangeClientTeam(client, CS_TEAM_NONE) }  It should be mentioned that there are scenarios were RequestFrame and using a timer delay are different enough that something such as when a player is spawning and not creating a delay will cause a function to not work. Case scenarios I believe exist, like equipping a weapon, dropping a weapon, or cycling and stripping certain weapons, are such examples. Of course, correct me if I am wrong, but this was such issues I had awhile ago.

Yes, you're right, that would be a correct case, as you said, sometimes you have to "let things happen" before calling a func to that, like the case when the player equips a weapon or while working with networked entities and you need them to exist first.

There are two ways of using this logic, one is firing a timer for example on a "Pre" event (Time) and the other is to request a frame in the "post" event (requestFrame), both should work similarly on most cases.
The difference is that on the "post" event, you can read/know all the data you need to work with the entity (because you are sure it already exists)

[conglyvaness]

Originally Posted by Silvers
ConVars Anomaly Fixer

[Silvers]

lol what, not by me... I think you made error posting? I have been meaning to update 1st post for a while, soon eventually I will please bear with me.

[Silvers]

We're stickied! Thanks! @Mods I'll try to keep this updated over the foreseeable future also feel free to make any changes.

Updated with suggestions from above and added various details to "Information:" part of section 7. Thanks to "JoinedSenses" and "Lux" for some details.

Added the RequestFrame example and one from my own uses.

Dragokas has even more additions coming soon!

Huge thanks to "GAMMACASE" for compiling a list of CS:S and CS:GO fixes, now added to the section 6.

[Dragokas]

New link to add: https://wiki.alliedmods.net/Csgo_quirks
(it's for discussion, since 2015 year topic, maybe too outdated, need overview from somebody in CSGO world).

Various:

net_graph 3

net_graph 4 will show you a bit more info - sv, var. Useful when server experience CPU overloading.

you need to compile the plugin with an older version of SM, e.g. 1.9

There are many questions "how to find it?". I'd suggest highlight "1.9" with hyperlink: https://www.sourcemod.net/downloads....=1.9-dev&all=1
(or alternate: https://www.sourcemod.net/smdrop/1.9/ )

======
P.S. More code samples coming soon.


Skip it. Already included in 1st post:

Spoiler

Sound hooks source code:

Those wiki-page prototype is wrong, so use info from inc-file instead: https://github.com/alliedmodders/sou...sound.inc#L322
Here is a sample that compile correctly even without 'view_as' on both sm 1.10, 1.9 (sorry for some dirty example previous time):

Spoiler

PHP Code:

#include <sdktools>

public void OnPluginStart() 
{
    AddNormalSoundHook(SoundHook);
    AddAmbientSoundHook(AmbientHook);
}

public Action SoundHook (int clients[MAXPLAYERS], int &numClients, char sample[PLATFORM_MAX_PATH],
        int &entity, int &channel, float &volume, int &level, int &pitch, int &flags,
        char soundEntry[PLATFORM_MAX_PATH], int &seed)
{
    return Plugin_Continue;
}

public Action AmbientHook (char sample[PLATFORM_MAX_PATH], int &entity, float &volume,
        int &level, int &pitch, float pos[3], int &flags, float &delay)
{
    return Plugin_Continue;
} 


Various:

PHP Code:

ChangeClientTeam(client, CS_TEAM_NONE) 


missing ";"
Also, the snippet doesn't work for me in CS:GO. Flag should be CS_TEAM_SPECTATOR. In such case it works correctly.

SDKHooks Extension - Many useful functions and forwards, e.g. hooking OnTakeDamage, entity PreThink and OnEntityCreated/Destroyed forwards etc.

I would add notice:
Updated list and callback prototypes are always available in inc-file: https://github.com/alliedmodders/sou...e/sdkhooks.inc

On Listen servers a clients index via console is also 0

"via console" in Bold (or something), for noobs like me, since I was thinking client is physically 0 there.

Hiding particles might not work for all games or might only work on Windows. This is an engine limitation.

Little correction/addition =>

Hiding some particles or entities might not work for all games or might only work on Windows.

(under "some" I mean like "prop_glowing_object" in L4D1 that doesn't hide via transmit hook)

blah[0] == 0; or blah[0] == '\0';

or just !blah[0]


Connect to Server

so, later you could only run it manually and insecurely)

re-phrase please into:

so, later you could only run it by executing exe-file directly)

Append the end of this line:

- Setup port forwarding for 27016 port (or whichever port your game server uses) + client port.

+ after this item, please, add new one:

- Configure firewall to allow same port (tcp/udp) + 27005 port or the one specified in +clientport argument. More details: https://developer.valvesoftware.com/...dicated_Server

Common Scripting Mistakes

"Native XXX is not bound" - dependency plugin is not installed, not loaded yet or failed. If dependency is optional,
always check is native available using GetFeatureStatus() before calling it, or check for library presence if dependency register one.

"Instruction contained invalid parameter" - source code is successfully compiled despite of syntax or structure error since parser is not ideal, example: un-initialized variable.
In this case, error log can point to a wrong plugin name, e.g. normal plugin that leads to raising event in other - guilty plugin.

[Silvers]

Thanks added.

Is + client port really necessary? I don't have mine forwarded and people can connect only when I forward the main port 27016.