Wiki News Account creation no longer requires administrator approval - edits are still moderated, however.

ConsoleCommand

From Zandronum Wiki
Jump to navigation Jump to search


MedalYouFailIt.png WARNING: ConsoleCommand is dangerous and is flagged for eventual removal over security reasons. It is not advised to use ConsoleCommand in new mods. Details here.
Zandronum SkulltagOverlay.png Warning: This feature is Zandronum specific and may not supported by ZDoom and its other child ports!
Documentation may not be accurate, see ACS Functions.

void ConsoleCommand (str consolecommand)

Usage

ConsoleCommand causes the game server to activate the given console command. This can be used to set mod-specific CVARs and other commands that cannot be executed by pure ACS. Only one command can be executed per function call. If the command is used from a CLIENTSIDE script, the local machine will execute the command.

The following commands cannot be used and will be ignored:

  • unbindall
  • unbind
  • bind
  • quit
  • exit
  • logfile
  • alias (including any alias commands)
  • screenshot
  • dumpmap
  • say
  • say_team
  • sv_banfile
  • sv_banexcemptionfile
  • sv_adminlistfile
  • error
  • error_fatal
  • crashout
  • wait

Aliases and bindings can be managed in a ZDoom Icon 16x16.png KEYCONF lump.

Parameters

  • consolecommand: The string to be executed in the console.

Notes

As of 3.1, if a user has cl_protectcvars enabled then any changes made to a CVar's value using this function will not be saved permanently and the CVar's original value will be restored upon exiting the game. In addition, it is possible for CVARINFO to redefine any CVars created using the "set" and "archivecvar" CCMDs with this function, so mods don't have to create new names for them anymore. This is also backwards compatible in case an old version of the mod is loaded afterwards.

Examples

This article lists no examples, please add one.