Dependency Constants and Compiler Directives#

Compiler Directives#

Compiler directives are a way to compile code only if a specific condition is met. To use this you have the #if, #endif, #else and #elseif keyword.

Contditons you can check for are
  • SERVER Checks if the code is compiled on the server VM.

  • CLIENT Checks if the code is compiled on the client VM.

  • UI Checks if the code is compiled on the UI VM.

  • MP Checks if the code is compiled in a multiplayer match.

  • SP Checks if the code is compiled in a singeplayer match.

  • DEV Checks if the code is compiled with the -dev keyword in the startup arguments.

These conditions can also be combined with the regular squirrel boolean expressions

#if SERVER
Chat_ServerBroadcast("Message from the server VM")
#endif
#if (CLIENT && MP) || DEV
...
#elseif SP
...
#endif

Dependency Constants#

Dependency constants are used to only compile code if a dependency your mod requires is loaded, these use the Compiler directives syntax.

Inside your mod.json define a constant as:

{
    // mod.json stuff
    "Dependencies": {
        // sets the constant to 0 or 1, depending if the mod with the name "Mod Name" exists and is enabled
        "CONSTANT_NAME": "Mod Name"
    }
}

For Example:

"PLAYER_HAS_ROGUELIKE_MOD": "TF|Roguelike"

Will define a constant PLAYER_HAS_ROGUELIKE_MOD that is set to 0 or 1 depending if the mod is enabled. It then can be used as a constant/compiler flag.

#if PLAYER_HAS_ROGUELIKE_MOD
print("player has roguelike mod")
Roguelike_Function();
#else
print("Can't use the function because the mod is off :'(")
#endif