the Oblivion ConstructionSet Wiki

Difference between revisions of "AddItem"

AddItem (edit)

Revision as of 19:40, 28 March 2010

1,748 bytes removed ,  19:40, 28 March 2010
→‎Console Usage: Moved some text to the discussion page
imported>Vvenaya
imported>Shademe
(→‎Console Usage: Moved some text to the discussion page)
 
(32 intermediate revisions by 13 users not shown)
Line 1: Line 1:
=='''Description'''==
__NOTOC__


Adds Count items of object ''ObjectID'' to the calling container's inventory.
'''Syntax:'''
[''ActorID''|''ContainerID''.]AddItem ''ObjectID'', ''Count''  


=='''Syntax'''==
Adds ''Count'' items of object ''ObjectID'' to the calling container's inventory.
AddItem ''ObjectID'', ''Count''  


=='''Example'''==
'''Examples:'''
  AddItem MyObject, 1  
  AddItem MyObject, 1


<br/><br/><br/>
Ref MyItem
Short count
set MyItem to ArenaAkaviriLongSword
set count to 1
player.additem MyItem Count


=='''User Comments'''==
==Notes==
* You can use a [[Variable_types:_reference_variables|reference variable]] as ''ObjectID'' and a [[Variable_types:_shortint|short]] variable for ''count''.
* This function will trigger an [[onAdd]] block in a script attached to the target container, as long as the container is in a loaded cell. When used on a container in a remote cell, the [[onAdd]] block won't run until the player enters that container's cell. However, if the player enters the remote cell after saving and loading, the onAdd block won't run.
** Note that this is only true for the onAdd block, the rest of the script will still run if applicable (GameMode block will run if it's GameMode, MenuMode if MenuMode, etc.). The script will run once, as if it were loaded. If you have any variables set on the script, it will run the next frame as well and will continue to run until no variables are set.
* See [[Message Spam]] for techniques to avoid unwanted "Item Added" messages.


 
==Console Usage==
NOTE: This will not trigger [[OnAdd]] blocks, because the item is created inside the inventory rather than actually being added. For creating items from the console that you need to trigger OnAdd, use [[PlaceAtMe]] instead and pick the item up from the ground.
When using AddItem with the console, you must use the desired item's FormID, not the EditorID.
 
----
 
Console Usage:  When using AddItem with the console, you must use the desired item's FormID, not the EditorID.


So, instead of using
So, instead of using
Line 26: Line 31:
  player.additem 00000A 1
  player.additem 00000A 1


Kedrigh wrote: [http://www.elderscrolls.com/forums/index.php?showtopic=323641&hl=#]
==See Also==
*[[AddItemNS]] - Spamless version of command (OBSE 15).
*[[GetItemCount]]
*[[RemoveItem]]
*[[Message Spam]] - Techniques for avoiding message spam.


''Form id is in the cs and looks like this: yyxxxxxx.''
==Reference==


''yy is used to reference the plugin, xxxxxx to reference the item inside the plugin (and does not change). So if you load the oblivion master in the cs, and create something, it will have 01xxxxxx as the form id.''
[[AddItem_Reference|List of existing scripts that use AddItem]]


''The yy part of the formid changes depending on the mods you load up, in alphabetical order (first one 01, second 02, and so on.)
[[Category: Functions]]
''
[[Category:Functions (CS)]]
[[Category: Functions (CS 1.0)]]
[[Category: Inventory Functions]]
[[Category: Inventory Functions (CS 1.0)]]
[[Category: Actor Functions]]
[[Category: Actor Functions (CS 1.0)]]


<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
<!-- Begin Search Terms
 
  Add
{| cellpadding="5" cellspacing="0" width="100%"
  Item
! style="background:#ffdead;" colspan="3"|This function is used in following scripts ...
End Search Terms -->
|-
| style="background:#ffeded;border-bottom:1px solid;" width="30%" |
AlessiaCaroScript
<br/>AncontarScript
<br/>BagduGroMolobscript
<br/>ClaudeMaricScript
<br/>DAAzuraStatueScript
<br/>DABoethiaStatueScript
<br/>DAClavicusStatueScript
<br/>DAHermaeusStatueScript
<br/>DAHircineStatueScript
<br/>DairihillsDeskScript
<br/>DAMalacathStatueScript
<br/>DAMephalaStatueScript
<br/>DAMeridiaStatueScript
<br/>DAMolagBalStatueScript
<br/>DANamiraPriestScript
<br/>DANamiraScript
<br/>DANamiraStatueScript
<br/>DANocturnalStatueScript
<br/>DAPeryiteStatueScript
<br/>Dark09PhillidaBodyguardScript
<br/>Dark10SpecialDeadDropScript
<br/>Dark11DeadDropScript
<br/>Dark13DeadDropScript
<br/>Dark14DeadDropScript
<br/>Dark17FollowingScript
<br/>DASanguineStatueScript
| style="background:#ffeded;border-bottom:1px solid;"  width="30%"  |
<br/>DASheogorathStatueScript
<br/>DAVaerminaStatueScript
<br/>FGPostQuest
<br/>GrayFoxScript
<br/>GwinasScript
<br/>HannibalTravenScript
<br/>HouseSkingradQuestHGScript
<br/>IverScript
<br/>MereteScript
<br/>MethredhelsChestScript
<br/>MethredhelScript
<br/>MG04Script
<br/>MG05AScript
<br/>MG08CupboardScript
<br/>MG08Script
<br/>MG09Script
<br/>MG15IrlavJarolDeadScript
<br/>MG16MageScript
<br/>MG17Script
<br/>MG19ChestScript
<br/>MQ10SigilStoneActivatorScript
<br/>MQ10SigilStoneScript
<br/>MQ12GoblinInventorySCRIPT
<br/>MQ12UndeadInventorySCRIPT
<br/>MQ13Script
<br/>MQ14SigilStoneScript
| style="background:#ffeded;border-bottom:1px solid;"  width="30%"  |
MQ15KathutetSCRIPT
<br/>MS05DreamworldAmuletScript
<br/>MS05DreamworldElementActivators01
<br/>MS05DreamworldElementActivators02
<br/>MS05DreamworldElementActivators03
<br/>MS05DreamworldElementActivators04
<br/>MS08AleronLocheScript
<br/>MS08FakeDoorKeyScript
<br/>MS13SigilScript
<br/>MS45DarMaChestScript
<br/>MS46RewardChestSCRIPT
<br/>MS48SigilStoneScript
<br/>MSScarTailScript
<br/>MyvrynasCupboardScript
<br/>NecroAltarScript
<br/>NecroAnchoriteDFScript
<br/>OghashgraMagulSCRIPT
<br/>OntusVaninsChestScript
<br/>OrumGangCourier1SCRIPT
<br/>SiegeCrawlerDeathSCRIPT
<br/>SigilStoneRandomSCRIPT
<br/>SigilStoneScript
<br/>TG05ScampScript
<br/>TG07LegionSealScript
<br/>TGIcestaffDisplayCaseScript
<br/>UmbacanoScript
|}
 
 
 
[[Category: Functions]]
[[Category: Object Functions]]
Anonymous user
Retrieved from "https://cs.uesp.net/wiki/Special:MobileDiff/11355...11388"