---

Georg's Scripting Extreme Close-Up II: Get/Set Wing Type

By Georg Zoeller

This article discusses new scripting commands introduced in the 1.67 Update and demonstrates one possible way of using these commands to add interesting new features to a module or persistent world.

This article assumes that the reader is somewhat proficient with Neverwinter Script, but a demo module and downloadable .erf is provided for simple import and text.

SetCreatureWingType

This command lets wings be attached to any model that supports them, most prominently any kind of player model or part-based humanoid.

GetCreatureWingType

This command tells you what wing model is currently attached to a model.

CREATURE_WING_TYPE constants

These constants are defined nwscript.nss and correspond to entries in wingmodel.2da.

Example Application: Winged Cloaks

The following example demonstrates how to use the new functions to create a cloak item that will spawn a pair of wings on its owner while the cloak is worn.

Using tag based scripting, it is possible to use a single script to add any wing type to every equipable inventory item that can be created in the toolset.

Note that these items will only work on Player characters, as the OnEquip event handler for tag based scripting is set to only fire for player characters by default.

Items using this script will not overwrite wings on a character from any other source (i.e. a red dragon disciple using an Eagle's Wings cape will not lose his dragon wings when using the item)

To tell the module which type of wings your item should add to the wearer, you can set a new integer variable "X3_S_ITEM_WINGTYPE" on the item (through the button on the "Description" tab on the item's properties dialog), with a value corresponding to the CREATURE_WING_TYPE_* constant of the wings you want the item to grant.

Downloads

Builders - You can use the script and 6 premade cloaks (added to the Misc\Clothing\ category in the toolset) in your module by downloading the .erf file below and importing it into your module using the File -> Import function in the main toolset menu.

Download x3_it_wingtype.erf

Players - You can test the items discussed in this article by downloading the demo module and copying it into your nwn\modules directory. You can then start the module through the game main menu and access all the items discussed in this and the other articles by talking to the storekeeper in the first area.

---