NWScript
From Wikipedia, the free encyclopedia
This video game-related article may require cleanup to meet Wikipedia's quality standards or the Video Games project's guidelines. Video game-related articles should adhere to the Manual of Style and should not contain unverifiable information nor should it have gameplay instructions. This article has been tagged since May 2008. |
This article does not cite any references or sources. (May 2008) Please help improve this article by adding citations to reliable sources. Unverifiable material may be challenged and removed. |
NWscript | |
---|---|
Appeared in | June 18, 2002 |
Designed by | BioWare |
Developer | BioWare |
Latest release | 1.68/ August 30, 2006 |
Influenced by | C, Java |
OS | Microsoft Windows, 3rd party tools for Mac OS X and Linux |
License | BioWare EULA |
Website | BioWare Developers Portal |
NWScript is the scripting language developed by BioWare for the computer role-playing game Neverwinter Nights. It is based on the C programming language and is implemented in the Aurora toolset. Neverscript, an open source 3rd party editor, has been created for the Mac OS X and Linux versions of NWN because the Aurora toolset has not been ported to those platforms.
NWScript is also used in the video games Star Wars: Knights of the Old Republic and Star Wars: Knights of the Old Republic II: The Sith Lords, which use the Odyssey engine. Neverwinter Nights 2, the sequel to the original NWN, features a modified version of this scripting language.
Contents |
[edit] Syntax
While based on C, NWScript does not have many functions from the C family, excluding logical and binary operators and some mathematical functions. Function source code is not accessible to the end-user, but the correct syntax is defined in a script file called nwscript.nss. The users can create their own functions, and these can be included in other scripts through the #include directive, which works slightly differently than in C++.
[edit] Hello world
NWScript has no way to directly target the screen for output. Instead, for instance, in-game characters such as the player character can be made to speak the typical "Hello world" example message. This script makes the player character say "Hello world" 20 seconds after entering the game, so as to allow for the game to load completely before taking place. For it to work, it should be placed in the OnClientEnter event of the module's properties.
void main() { object oPlayer; oPlayer = GetEnteringObject(); DelayCommand(20.0, AssignCommand(oPlayer, ActionSpeakString("Hello world"))); }
The first line is the void main function which is the function that a NWScript will start at. In the third line, a variable of the type object is declared and assigned a value - i.e. that of the entering player's character. The next line is actually three commands nested into one. It delays the call for 20 seconds, to make it not happen immediately. It assigns the action to be executed to the player, which is useful because the module is running the script (it's in the module's properties), and the module cannot talk. And it speaks (i.e. makes the player speak, after 20 seconds) the line "Hello world".
[edit] Data types
NWScript allows structs, but not objects. The following common data types are available in NWScript:
NWScript has also introduced some data types for purposes of the Neverwinter Nights game:
- object (refers to game objects, such as NPCs and placeable objects).
- location (refers to the in-game location of an object).
- talent (refers to spells and abilities).
- vector (refers to coordinates of an object, and is a construct of three floats).
- itemproperty (refers to abilities on items such as weapons for use in the game).
[edit] File format
When saving a script, the Aurora Toolset saves the plain text of the script as a file with a .nss file extension. When compiling the script, a .ncs file is created. If turned on, a debug information file with an .ndb extension is also created. The game uses only the .ncs file (and the .ndb file if called).
When saving the created module, the files are packed into a single module file with a .mod extension, along with other information about the layout of the module.
[edit] External links
- BioWare NWN Scripting Forum – BioWare's dedicated forum for scripting discussion.
- NWN Lexicon – A database of scripting functions and tutorials.
- Lilac Soul's NWN Script Generator – A popular utility to automatically generate NWscript code.
|