Difference between revisions of "RemoveAllTypedItems"

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
imported>Yukichigai
imported>Yukichigai
(Cleanup. Also, I believe the first note is not accurate any longer.)
Line 11: Line 11:
===List of type codes===
===List of type codes===
''Note: Type codes exist for all record types found in the GECK, including those which are not items that can be taken into inventory, e.g. Static Collections.  The following list only includes type codes for record types which can be used as inventory.''
''Note: Type codes exist for all record types found in the GECK, including those which are not items that can be taken into inventory, e.g. Static Collections.  The following list only includes type codes for record types which can be used as inventory.''


*24: Armor
*24: Armor
Line 25: Line 24:
*50: ConstructibleObject
*50: ConstructibleObject


Note that not all items are in the obvious category. For example, ingestibles are under AlchemyItem and include magazines. Many of the items necessary for crafting at the workbench and reloading bech are listed under Misc alongside junk items.
Note that not all items are in the obvious category. For example, Ingestibles and other Aid items are under ''AlchemyItem'' and include magazines, while skill books such as The Wasteland Survival Guide are under the ''Book'' category, despite appearing in the Aid category when viewed in the Pip-boy.


The ''Ingredient'' type is legacy content from Oblivion and generally will not be used, as the creation of new ingredients cannot be done within the GECK and requires the use of third-party tools.
The ''Ingredient'' and ''ConstructibleObject'' types are legacy content from Oblivion and generally will not be used, as the creation of new items of these types cannot be done within the GECK and requires the use of third-party tools.


==Syntax==
==Syntax==
Line 57: Line 56:
}}
}}
==Notes==
==Notes==
* If no type code is specified, this function will remove all items from the specified actor's inventory.
* Failing to specify a type code or specifying 0 for type code ''may'' result in the function removing all items from the specified actor's inventory, but may also result in the function doing nothing.
* Unlike [[RemoveAllItems]], RemoveAllTypedItems supports the suppression of item received messages when it is used to transfer items from one container or NPC to another.
* Unlike [[RemoveAllItems]], RemoveAllTypedItems supports the suppression of item received messages when it is used to transfer items from one container or NPC to the player.


==See Also==
==See Also==

Revision as of 20:48, 26 November 2011

< [[::Category:Functions|Category:Functions]]

A function included in the GECK Version 1.1.0.262 for Fallout: New Vegas.

Description

Removes all typed items (except those not listed in the exemption FormList) from the calling reference's inventory.

If a target container is specified, the typed items are moved to the target container with all equipment items retaining their current health; otherwise the items are destroyed as they would be via RemoveItem.

If the retain ownership flag is set to a non-zero value, the items' original ownership is retained; otherwise the ownership is cleared.

If the suppress messages flag is set to 1, the standard "Item Added" pop-up will not be displayed when this command is used to transfer items to the player.

List of type codes

Note: Type codes exist for all record types found in the GECK, including those which are not items that can be taken into inventory, e.g. Static Collections. The following list only includes type codes for record types which can be used as inventory.

  • 24: Armor
  • 25: Book
  • 26: Clothing
  • 29: Ingredient
  • 31: Misc
  • 40: Weapon
  • 41: Ammo
  • 46: Key
  • 47: AlchemyItem
  • 49: Note
  • 50: ConstructibleObject

Note that not all items are in the obvious category. For example, Ingestibles and other Aid items are under AlchemyItem and include magazines, while skill books such as The Wasteland Survival Guide are under the Book category, despite appearing in the Aid category when viewed in the Pip-boy.

The Ingredient and ConstructibleObject types are legacy content from Oblivion and generally will not be used, as the creation of new items of these types cannot be done within the GECK and requires the use of third-party tools.

Syntax

Syntax

[help]
container.RemoveAllTypedItems TargetContainerID:ref RetainOwnershipFlag:int Suppress Messages:int TypeCode:int FormListID:ref

Example

player.RemoveAllTypedItems vGOMPlayerEquipmentContainer 1 0 40 NVImprovedHoldoutWeapons

Notes

  • Failing to specify a type code or specifying 0 for type code may result in the function removing all items from the specified actor's inventory, but may also result in the function doing nothing.
  • Unlike RemoveAllItems, RemoveAllTypedItems supports the suppression of item received messages when it is used to transfer items from one container or NPC to the player.

See Also