diff --git a/doc/script_commands.txt b/doc/script_commands.txt index d64b3e05b4..dc088043af 100644 --- a/doc/script_commands.txt +++ b/doc/script_commands.txt @@ -4393,6 +4393,8 @@ quite a few item scripts. For more examples check just about any official script *getitem2 ,,,,,,,,{,}; *getitem2 "",,,,,,,,{,}; +*getitem3 ,,,,,,,,,,,{,}; +*getitem3 "",,,,,,,,,,,{,}; This command will give an amount of specified items to the invoking character. If an optional account ID is specified, and the target character is currently @@ -4478,6 +4480,18 @@ command, creating a pet which is the same, but simultaneously exists in two eggs, and may hatch from either, although, I'm not sure what kind of a mess will this really cause. +'getitem3' is advance version of 'getitem2' that also use Item Random Option as additional values. + : Array variable of ID for item random option, see db/[pre-]re/item_randomopt_db.txt + : Array variable of item random option's value. + : Array variable of item random option's param. + +Example to get Crimson Weapon with Ghost property: + // +9 Crimson Dagger [2] + setarray .@OptID[0],RDMOPT_WEAPON_ATTR_TELEKINESIS; + setarray .@OptVal[0],0; + setarray .@OptParam[0],0; + getitem3 28705,1,1,9,0,0,0,0,0,.@OptID,.@OptVal,.@OptParam; + --------------------------------------- *getitembound ,,{,}; @@ -4498,6 +4512,8 @@ Valid bound types are: *getitembound2 ,,,,,,,,,{,}; *getitembound2 "",,,,,,,,,{,}; +*getitembound3 ,,,,,,,,,,,,{,}; +*getitembound3 "",,,,,,,,,,,,{,}; This command behaves identically to 'getitem2', but the items created will be bound to the target character as specified by the bound type. All items created @@ -4506,6 +4522,18 @@ some cases cannot be traded or stored. For a list of bound types see 'getitembound'. +'getitembound3' is advance version of 'getitembound2' that also use Item Random Option as additional values. + : Array variable of ID for item random option, see db/[pre-]re/item_randomopt_db.txt + : Array variable of item random option's value. + : Array variable of item random option's param. + +Example to get Crimson Weapon with Ghost property: + // +9 Crimson Dagger [2] + setarray .@OptID[0],RDMOPT_WEAPON_ATTR_TELEKINESIS; + setarray .@OptVal[0],0; + setarray .@OptParam[0],0; + getitembound3 28705,1,1,9,0,0,0,0,0,BOUND_CHAR,.@OptID,.@OptVal,.@OptParam; + --------------------------------------- *getnameditem ,; @@ -4551,12 +4579,26 @@ Note: 'delitem' in an NPC script can still remove rental items. *rentitem2 ,