Skins: |

NWN SCRIPTS

- Jump to comments -

Title

Zing's Stripper

Author

DJPS

Submitted / Updated

03-21-2005 / 11-22-2006

Category

Inventory Item

Expansions

NWN-1.65

View Code

//*****************************************************************************
//   Zing's DMStripper v1.0 ;) by DJPS                     www.firecat.co.uk
//*****************************************************************************
//   This script should be associated with the module OnClientEnter trigger.
//
//   Useage:
//   -Used to protect a server which allows local characters, but does not want
//   them to be able to bring non-server (cheat) gear.
//   -All items found equipt or in the inventory of a player that are not
//   available on the server are destroyed upon entry to the server.
//   -Cannot be bypassed by copying server tags to custom gear as all items
//   are removed from a player - legal items get reallocated from the server
//   vault.
//   -Makes all confiscated items available to the DM
//
//   Other Advantages:
//   -Can be used to ensure alterations to server items are automatically
//   passed onto players who already possess the item the next time they
//   log in.
//
//   Disadvantages:
//   -Ruins item related quickslot associations.
//   -Chargeable items are returned to full strength.
//   -Armour and helm will return to the default colous at each login.
//
//   Requirements:
//   -Requires a chest (or similar) to use for temporary storage of PC's
//   inventory items. (For my implementation I used a chest with the Tag CGT)
//   -Requires a chest (or similar) for confiscated items to be sent to.  This
//   is intended to be an item which can only be opened bt a DM key.
//
//   Notes:
//   -Despite trawling through a PC's complete inventory this script ran in
//   under 2 seconds during tests.
//   -I'm unsure exactly what would happen if multiple PC's joined at the
//   same time.  If NWN queues the joins everything should be fine.  Otherwise
//   some items might get muddled.
//
//   -To contact the author or report a bug please e-mail gowtigger@hotmail.com
//
//*****************************************************************************

void main()
{
    object oPC = GetEnteringObject();

//*****************************************************************************
//  Removing non-server items from PC's inventory.
//*****************************************************************************

    object TemporyInventory;
    object InvItem;
    object DMChest;
    string InvItemResRef;
    int    InvItemStackSize;
    object InvReplacementItem;

    // Initialise Chests
    //
    TemporyInventory = GetObjectByTag("CGT");
    DMChest = GetObjectByTag("ZZ");

    // Destroy any default items in the temporary transfer chest
    //
    InvItem = GetFirstItemInInventory(TemporyInventory);
    while(GetIsObjectValid(InvItem))
    {
        DestroyObject(InvItem);
        InvItem = GetNextItemInInventory(TemporyInventory);
    }

    // Go through the PC's inventory and for each item...
    //
    InvItem = GetFirstItemInInventory(oPC);
    while(GetIsObjectValid(InvItem))
    {
        // Record some details about the item...
        //
        InvItemResRef = GetResRef(InvItem);
        InvItemStackSize = GetItemStackSize(InvItem);

        // If the items ResRef matches an item available on the server
        // Create one from the server blueprint and put it in the temporary
        // chest...
        //
        if(InvItemResRef != "")
        {
            InvReplacementItem = CreateItemOnObject(InvItemResRef, TemporyInventory, InvItemStackSize);
        }

        if(InvReplacementItem == OBJECT_INVALID)
        {
            // Copy the illegal item to the DM's Inv...
            //
            CopyItem(InvItem, DMChest, TRUE);
        }

        // Then destroy the original
        //
        DestroyObject(InvItem);

        InvItem = GetNextItemInInventory(oPC);
    }

    // Now copy all items stored into the temporary chest back to the player
    //
    InvItem = GetFirstItemInInventory(TemporyInventory);

    while(GetIsObjectValid(InvItem))
    {
        InvItemResRef = GetResRef(InvItem);
        InvItemStackSize = GetItemStackSize(InvItem);
        DestroyObject(InvItem);

        if(InvItemResRef != "")
        {
            InvReplacementItem = CreateItemOnObject(InvItemResRef, oPC, InvItemStackSize);
        }

        InvItem = GetNextItemInInventory(TemporyInventory);
    }

//*****************************************************************************
//  Unequiping non-server items and removing them.
//*****************************************************************************

    object CurrentItem;
    string CurrentItemResRef;
    int    CurrentItemStackSize;
    object CurrentReplacementItem;

    // Check each equipment slot
    //
    int i;
    for(i=0; i<14; i++)
    {
        // Is there an item?
        //
        if(GetIsObjectValid(GetItemInSlot(i, oPC)))
        {
            // Record some details about it...
            //
            CurrentItem = GetItemInSlot(i, oPC);
            CurrentItemResRef = GetResRef(CurrentItem);
            CurrentItemStackSize = GetItemStackSize(CurrentItem);

            // If the items ResRef matches an item available on the server
            // Create one from the server blueprint and automatically equip it
            //
            if(CurrentItemResRef != "")
            {
                CurrentReplacementItem = CreateItemOnObject(CurrentItemResRef, oPC, CurrentItemStackSize);
                AssignCommand(oPC, ActionEquipItem(CurrentReplacementItem, i));
            }

            if(CurrentReplacementItem == OBJECT_INVALID)
            {
                // Copy the illegal item to the DM's Inv...
                //
                CopyItem(CurrentItem, DMChest, TRUE);
            }

            // Then destroy the original
            //
            DestroyObject(CurrentItem);
        }
    }
}

//*****************************************************************************

Select All Text | View Code in separate window

Format

Code Only

Type

Type - Manipulation

Includes

BioWare Standard

Description

I designed this script to protect a server which allows local characters, but does not want them to be able to bring non-server (cheat) gear with them. However unlike the usual scripts which take everything from a player upon entry this script will assess a players equipment and inventory everytime they log on and only confiscate items which are not available from the module itself.