| Variable Name | Value | Default | Notes |
|---|---|---|---|
NWNX_UTIL_PRE_MODULE_START_SCRIPT | string | Unset | Allows you to set a NWScript that runs before the OnModuleLoad event |
NWNX_UTIL_PRE_MODULE_START_SCRIPT_CHUNK | string | Unset | Allows you to set a NWScript Chunk that runs before the OnModuleLoad event |
Files | |
| file | nwnx_util.nss |
Classes | |
| struct | NWNX_Util_WorldTime |
| A world time struct. More... | |
| struct | NWNX_Util_HighResTimestamp |
| A high resolution timestamp. More... | |
Functions | |
| string | NWNX_Util_GetCurrentScriptName (int depth=0) |
| Gets the name of the currently executing script. More... | |
| string | NWNX_Util_GetAsciiTableString () |
| Gets a string that contains the ascii table. More... | |
| int | NWNX_Util_Hash (string str) |
| Gets an integer hash of a string. More... | |
| int | NWNX_Util_GetModuleMtime () |
| Gets the last modified timestamp (mtime) of the module file in seconds. More... | |
| string | NWNX_Util_GetModuleFile () |
| Gets the module short file name. More... | |
| string | NWNX_Util_GetCustomToken (int customTokenNumber) |
| Gets the value of customTokenNumber. More... | |
| itemproperty | NWNX_Util_EffectToItemProperty (effect e) |
| Convert an effect type to an itemproperty type. More... | |
| effect | NWNX_Util_ItemPropertyToEffect (itemproperty ip) |
| Convert an itemproperty type to an effect type. More... | |
| string | NWNX_Util_StripColors (string str) |
| Strip any color codes from a string. More... | |
| string | NWNX_Util_GetEnvironmentVariable (string sVarname) |
| Retrieves an environment variable. More... | |
| int | NWNX_Util_GetMinutesPerHour () |
| Gets the module real life minutes per in game hour. More... | |
| void | NWNX_Util_SetMinutesPerHour (int minutes) |
| Set module real life minutes per in game hour. More... | |
| string | NWNX_Util_EncodeStringForURL (string str) |
| Encodes a string for usage in a URL. More... | |
| string | NWNX_Util_GetFirstResRef (int nType, string sRegexFilter="", int bModuleResourcesOnly=TRUE) |
| Get the first resref of nType. More... | |
| string | NWNX_Util_GetNextResRef () |
| Get the next resref. More... | |
| object | NWNX_Util_GetLastCreatedObject (int nObjectType, int nNthLast=1) |
| Get the last created object. More... | |
| string | NWNX_Util_AddScript (string sFileName, string sScriptData, int bWrapIntoMain=FALSE, string sAlias="NWNX") |
| Compiles and adds a script to the UserDirectory/nwnx folder, or to the location of sAlias. More... | |
| int | NWNX_Util_AddNSSFile (string sFileName, string sContents, string sAlias="NWNX") |
| Adds a nss file to the UserDirectory/nwnx folder, or to the location of sAlias. More... | |
| int | NWNX_Util_RemoveNWNXResourceFile (string sFileName, int nType, string sAlias="NWNX") |
| Remove sFileName of nType from the UserDirectory/nwnx folder, or from the location of sAlias. More... | |
| void | NWNX_Util_SetInstructionLimit (int nInstructionLimit) |
| Set the NWScript instruction limit. More... | |
| int | NWNX_Util_GetInstructionLimit () |
| Get the NWScript instruction limit. More... | |
| void | NWNX_Util_SetInstructionsExecuted (int nInstructions) |
| Set the number of NWScript instructions currently executed. More... | |
| int | NWNX_Util_GetInstructionsExecuted () |
| Get the number of NWScript instructions currently executed. More... | |
| int | NWNX_Util_RegisterServerConsoleCommand (string sCommand, string sScriptChunk) |
| Register a server console command that will execute a script chunk. More... | |
| void | NWNX_Util_UnregisterServerConsoleCommand (string sCommand) |
| Unregister a server console command that was registered with NWNX_Util_RegisterServerConsoleCommand(). More... | |
| string | NWNX_Util_GetUserDirectory () |
| Gets the server's current working user folder. More... | |
| int | NWNX_Util_GetScriptReturnValue () |
| Get the return value of the last run script with a StartingConditional. More... | |
| object | NWNX_Util_CreateDoor (string sResRef, location locLocation, string sNewTag="", int nAppearanceType=-1) |
| Create a door. More... | |
| void | NWNX_Util_SetItemActivator (object oObject) |
| Set the object that will be returned by GetItemActivator. More... | |
| struct NWNX_Util_WorldTime | NWNX_Util_GetWorldTime (float fAdjustment=0.0f) |
| Get the world time as calendar day and time of day. More... | |
| void | NWNX_Util_SetResourceOverride (int nResType, string sOldName, string sNewName) |
| Set a server-side resource override. More... | |
| string | NWNX_Util_GetResourceOverride (int nResType, string sName) |
| Get a server-side resource override. More... | |
| int | NWNX_Util_GetScriptParamIsSet (string sParamName) |
| Get if a script param is set. More... | |
| void | NWNX_Util_SetDawnHour (int nDawnHour) |
| Set the module dawn hour. More... | |
| int | NWNX_Util_GetDawnHour () |
| Get the module dawn hour. More... | |
| void | NWNX_Util_SetDuskHour (int nDuskHour) |
| Set the module dusk hour. More... | |
| int | NWNX_Util_GetDuskHour () |
| Get the module dusk hour. More... | |
| struct NWNX_Util_HighResTimestamp | NWNX_Util_GetHighResTimeStamp () |
| string | NWNX_Util_GetTTY () |
| void | NWNX_Util_SetCurrentlyRunningEvent (int nEventID) |
| Set the currently running script event. More... | |
| int | NWNX_Util_GetStringLevenshteinDistance (string sString, string sCompareTo) |
| Calculate the levenshtein distance of two strings. More... | |
| void | NWNX_Util_UpdateClientObject (object oObjectToUpdate, object oPlayer=OBJECT_INVALID) |
| Sends a full object update of oObjectToUpdate to all clients. More... | |
| int | NWNX_Util_CleanResourceDirectory (string sAlias, int nResType=0xFFFF) |
| Clean a resource directory, deleting all files of nResType. More... | |
| string | NWNX_Util_GetModuleTlkFile () |
| Return the filename of the tlk file. More... | |
| int | NWNX_Util_UpdateResourceDirectory (string sAlias) |
| Update a resource directory by having ResMan reindex it. More... | |
| string NWNX_Util_GetCurrentScriptName | ( | int | depth = 0 | ) |
Gets the name of the currently executing script.
| depth | to seek the executing script. |
Definition at line 274 of file nwnx_util.nss.
| string NWNX_Util_GetAsciiTableString | ( | ) |
Gets a string that contains the ascii table.
Definition at line 281 of file nwnx_util.nss.
| int NWNX_Util_Hash | ( | string | str | ) |
Gets an integer hash of a string.
| str | The string to hash. |
Definition at line 287 of file nwnx_util.nss.
| int NWNX_Util_GetModuleMtime | ( | ) |
Gets the last modified timestamp (mtime) of the module file in seconds.
Definition at line 294 of file nwnx_util.nss.
| string NWNX_Util_GetModuleFile | ( | ) |
Gets the module short file name.
Definition at line 300 of file nwnx_util.nss.
| string NWNX_Util_GetCustomToken | ( | int | customTokenNumber | ) |
Gets the value of customTokenNumber.
| customTokenNumber | The token number to query. |
Definition at line 306 of file nwnx_util.nss.
| itemproperty NWNX_Util_EffectToItemProperty | ( | effect | e | ) |
Convert an effect type to an itemproperty type.
| e | The effect to convert to an itemproperty. |
Definition at line 313 of file nwnx_util.nss.
| effect NWNX_Util_ItemPropertyToEffect | ( | itemproperty | ip | ) |
Convert an itemproperty type to an effect type.
| ip | The itemproperty to convert to an effect. |
Definition at line 320 of file nwnx_util.nss.
| string NWNX_Util_StripColors | ( | string | str | ) |
Strip any color codes from a string.
| str | The string to strip of color. |
Definition at line 327 of file nwnx_util.nss.
| string NWNX_Util_GetEnvironmentVariable | ( | string | sVarname | ) |
Retrieves an environment variable.
| sVarname | The environment variable to query. |
Definition at line 334 of file nwnx_util.nss.
| int NWNX_Util_GetMinutesPerHour | ( | ) |
Gets the module real life minutes per in game hour.
Definition at line 341 of file nwnx_util.nss.
| void NWNX_Util_SetMinutesPerHour | ( | int | minutes | ) |
Set module real life minutes per in game hour.
| minutes | The minutes per hour. |
Definition at line 347 of file nwnx_util.nss.
| string NWNX_Util_EncodeStringForURL | ( | string | str | ) |
Encodes a string for usage in a URL.
| str | The string to encode for a URL. |
Definition at line 353 of file nwnx_util.nss.
| string NWNX_Util_GetFirstResRef | ( | int | nType, |
| string | sRegexFilter = "", |
||
| int | bModuleResourcesOnly = TRUE |
||
| ) |
Get the first resref of nType.
| nType | A Resref Type. |
| sRegexFilter | Lets you filter out resrefs using a regexfilter. For example: nwnx_.* gets you all scripts prefixed with nwnx_ when using the NSS resref type. |
| bModuleResourcesOnly | If TRUE only custom resources will be returned. |
Definition at line 360 of file nwnx_util.nss.
| string NWNX_Util_GetNextResRef | ( | ) |
Get the next resref.
Definition at line 369 of file nwnx_util.nss.
| object NWNX_Util_GetLastCreatedObject | ( | int | nObjectType, |
| int | nNthLast = 1 |
||
| ) |
Get the last created object.
| nObjectType | Does not take the NWScript OBJECT_TYPE_* constants. Use NWNX_Consts_TranslateNWScriptObjectType() to get their NWNX equivalent. |
| nNthLast | The nth last object created. |
Definition at line 375 of file nwnx_util.nss.
| string NWNX_Util_AddScript | ( | string | sFileName, |
| string | sScriptData, | ||
| int | bWrapIntoMain = FALSE, |
||
| string | sAlias = "NWNX" |
||
| ) |
Compiles and adds a script to the UserDirectory/nwnx folder, or to the location of sAlias.
| sFileName | The script filename without extension, 16 or less characters. |
| sScriptData | The script data to compile |
| bWrapIntoMain | Set to TRUE to wrap sScriptData into void main(){}. |
| sAlias | The alias of the resource directory to add the ncs file to. Default: UserDirectory/nwnx |
Definition at line 383 of file nwnx_util.nss.
| int NWNX_Util_AddNSSFile | ( | string | sFileName, |
| string | sContents, | ||
| string | sAlias = "NWNX" |
||
| ) |
Adds a nss file to the UserDirectory/nwnx folder, or to the location of sAlias.
| sFileName | The script filename without extension, 16 or less characters. |
| sContents | The contents of the nss file |
| sAlias | The alias of the resource directory to add the nss file to. Default: UserDirectory/nwnx |
Definition at line 393 of file nwnx_util.nss.
| int NWNX_Util_RemoveNWNXResourceFile | ( | string | sFileName, |
| int | nType, | ||
| string | sAlias = "NWNX" |
||
| ) |
Remove sFileName of nType from the UserDirectory/nwnx folder, or from the location of sAlias.
| sFileName | The filename without extension, 16 or less characters. |
| nType | The Resref Type. |
| sAlias | The alias of the resource directory to remove the file from. Default: UserDirectory/nwnx |
Definition at line 402 of file nwnx_util.nss.
| void NWNX_Util_SetInstructionLimit | ( | int | nInstructionLimit | ) |
Set the NWScript instruction limit.
| nInstructionLimit | The new limit or -1 to reset to default. |
Definition at line 411 of file nwnx_util.nss.
| int NWNX_Util_GetInstructionLimit | ( | ) |
Get the NWScript instruction limit.
Definition at line 417 of file nwnx_util.nss.
| void NWNX_Util_SetInstructionsExecuted | ( | int | nInstructions | ) |
Set the number of NWScript instructions currently executed.
| nInstructions | The number of instructions, must be >= 0. |
Definition at line 423 of file nwnx_util.nss.
| int NWNX_Util_GetInstructionsExecuted | ( | ) |
Get the number of NWScript instructions currently executed.
Definition at line 429 of file nwnx_util.nss.
| int NWNX_Util_RegisterServerConsoleCommand | ( | string | sCommand, |
| string | sScriptChunk | ||
| ) |
Register a server console command that will execute a script chunk.
| sCommand | The name of the command. |
| sScriptChunk | The script chunk to run. You can use $args to get the console command arguments. |
Definition at line 435 of file nwnx_util.nss.
| void NWNX_Util_UnregisterServerConsoleCommand | ( | string | sCommand | ) |
Unregister a server console command that was registered with NWNX_Util_RegisterServerConsoleCommand().
| sCommand | The name of the command. |
Definition at line 443 of file nwnx_util.nss.
| string NWNX_Util_GetUserDirectory | ( | ) |
Gets the server's current working user folder.
Definition at line 449 of file nwnx_util.nss.
| int NWNX_Util_GetScriptReturnValue | ( | ) |
Get the return value of the last run script with a StartingConditional.
Definition at line 455 of file nwnx_util.nss.
| object NWNX_Util_CreateDoor | ( | string | sResRef, |
| location | locLocation, | ||
| string | sNewTag = "", |
||
| int | nAppearanceType = -1 |
||
| ) |
Create a door.
| sResRef | The ResRef of the door. |
| locLocation | The location to create the door at. |
| sNewTag | An optional new tag for the door. |
| nAppearanceType | An optional index into doortypes.2da for appearance. |
Definition at line 461 of file nwnx_util.nss.
| void NWNX_Util_SetItemActivator | ( | object | oObject | ) |
Set the object that will be returned by GetItemActivator.
| oObject | An object. |
Definition at line 471 of file nwnx_util.nss.
| struct NWNX_Util_WorldTime NWNX_Util_GetWorldTime | ( | float | fAdjustment = 0.0f | ) |
Get the world time as calendar day and time of day.
| fAdjustment | An adjustment in seconds, 0.0f will return the current world time, positive or negative values will return a world time in the future or past. |
Definition at line 471 of file nwnx_util.nss.
| void NWNX_Util_SetResourceOverride | ( | int | nResType, |
| string | sOldName, | ||
| string | sNewName | ||
| ) |
Set a server-side resource override.
| nResType | A Resref Type. |
| sOldName | The old resource name, 16 characters or less. |
| sNewName | The new resource name or "" to clear a previous override, 16 characters or less. |
Definition at line 487 of file nwnx_util.nss.
| string NWNX_Util_GetResourceOverride | ( | int | nResType, |
| string | sName | ||
| ) |
Get a server-side resource override.
| nResType | A Resref Type. |
| sName | The name of the resource, 16 characters or less. |
Definition at line 495 of file nwnx_util.nss.
| int NWNX_Util_GetScriptParamIsSet | ( | string | sParamName | ) |
Get if a script param is set.
| sParamName | The script parameter name to check. |
Definition at line 503 of file nwnx_util.nss.
| void NWNX_Util_SetDawnHour | ( | int | nDawnHour | ) |
Set the module dawn hour.
| nDawnHour | The new dawn hour |
Definition at line 510 of file nwnx_util.nss.
| int NWNX_Util_GetDawnHour | ( | ) |
| void NWNX_Util_SetDuskHour | ( | int | nDuskHour | ) |
Set the module dusk hour.
| nDuskHour | The new dusk hour |
Definition at line 522 of file nwnx_util.nss.
| int NWNX_Util_GetDuskHour | ( | ) |
| struct NWNX_Util_HighResTimestamp NWNX_Util_GetHighResTimeStamp | ( | ) |
Definition at line 528 of file nwnx_util.nss.
| string NWNX_Util_GetTTY | ( | ) |
Definition at line 543 of file nwnx_util.nss.
| void NWNX_Util_SetCurrentlyRunningEvent | ( | int | nEventID | ) |
Set the currently running script event.
| nEventID | The ID of the event. |
Definition at line 549 of file nwnx_util.nss.
| int NWNX_Util_GetStringLevenshteinDistance | ( | string | sString, |
| string | sCompareTo | ||
| ) |
Calculate the levenshtein distance of two strings.
| sString | The string to compare with. |
| sCompareTo | The string to compare sString to. |
Definition at line 555 of file nwnx_util.nss.
| void NWNX_Util_UpdateClientObject | ( | object | oObjectToUpdate, |
| object | oPlayer = OBJECT_INVALID |
||
| ) |
Sends a full object update of oObjectToUpdate to all clients.
| oObjectToUpdate | The object to update |
| oPlayer | The player for which the objects needs to update, OBJECT_INVALID for all players |
Definition at line 563 of file nwnx_util.nss.
| int NWNX_Util_CleanResourceDirectory | ( | string | sAlias, |
| int | nResType = 0xFFFF |
||
| ) |
Clean a resource directory, deleting all files of nResType.
| sAlias | A resource directory alias, NWNX or one defined in the custom resource directory file. |
| nResType | The type of file to delete or 0xFFFF for all types. |
Definition at line 570 of file nwnx_util.nss.
| string NWNX_Util_GetModuleTlkFile | ( | ) |
| int NWNX_Util_UpdateResourceDirectory | ( | string | sAlias | ) |
Update a resource directory by having ResMan reindex it.
| sAlias | A resource directory alias, eg: TEMP |
Definition at line 585 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_NSS = 2009 |
Definition at line 13 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_NCS = 2010 |
Definition at line 14 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_AREA_ARE = 2012 |
Definition at line 15 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_TWODA = 2017 |
Definition at line 16 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_AREA_GIT = 2023 |
Definition at line 17 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_ITEM = 2025 |
Definition at line 18 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_CREATURE = 2027 |
Definition at line 19 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_DIALOG = 2029 |
Definition at line 20 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_TRIGGER = 2032 |
Definition at line 21 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_SOUND = 2035 |
Definition at line 22 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_ENCOUNTER = 2040 |
Definition at line 23 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_DOOR = 2042 |
Definition at line 24 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_PLACEABLE = 2044 |
Definition at line 25 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_STORE = 2051 |
Definition at line 26 of file nwnx_util.nss.
| const int NWNX_UTIL_RESREF_TYPE_WAYPOINT = 2058 |
Definition at line 27 of file nwnx_util.nss.