Getitem2 modified by Brynner

Brynner — Mon, 20 Feb 2023 05:01:33 -0000

Syntax
Description
Examples
Description continue...
Examples continue...

Syntax

[Getitem2] <item id>,<amount>,<identify>,<refine>,<attribute>,<card1>,<card2>,<card3>,<card4>{,<account ID>};
[Getitem2] "<item name>",<amount>,<identify>,<refine>,<attribute>,<card1>,<card2>,<card3>,<card4>{,<account ID>};

Description

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
online, items will be created in their inventory instead. If they are not
online, nothing will happen. It works essentially the same as [Getitem] (it
even works for negative ID numbers the same way) but is a lot more flexible.

Those parameters that are different from [Getitem] are:

identify    - Whether you want the item to be identified (1) or not (0).
refine      - For how many pluses will it be refined. It will not let you 
              refine an item higher than the max refine.
attribute   - Whether the item is broken (1) or not (0).
card1,2,3,4 - If you want a card compound to it, place the card ID number 
              into the specific card slot.

Card1-card4 values are also used to store name information for named items, as
well as the elemental property of weapons and armor. You can create a named
item in this manner, however, if you just need a named piece of standard
equipment, it is much easier to the [Getnameditem] function instead.

You will need to keep these values if you want to destroy and then perfectly
recreate a named item, for this see [Getinventorylist].

If you still want to try creating a named item with this command because
[Getnameditem] won't do it for you cause it's too limited, you can do it
like this. Careful, minor magic ahead.

Examples

    // First, let's get an ID of a character who's name will be on the 
    // item. Only an existing character's name may be there.
    // Let's assume our character is 'Adam' and find his ID.

    set @charid,getcharid(0,"Adam");

    // Now we split the character ID number into two portions with a 
    // binary shift operation. If you don't understand what this does, 
    // just copy it.

    set @card3, @charid & 65535;
    set @card4, @charid &gt;&gt; 16;

    // If you're inscribing non-equipment, @card1 must be 254.
    // Arrows are also not equipment. :)
    set @card1,254;

    // For named equipment, card2 means the Star Crumbs and elemental 
    // crystals used to make this equipment. For everything else, it's 0.

    set @card2,0;

    // Now, let's give the character who invoked the script some 
    // Adam's Apples:

    getitem2 512,1,1,0,0,@card1,@card2,@card3,@card4;

Description continue...

This wasn't tested with all possible items, so I can't give any promises,
experiment first before relying on it.

To create equipment, continue this example it like this:

Examples continue...

    // We've already have card3 and card4 loaded with correct
    // values so we'll just set up card1 and card2 with data
    // for an Ice Stiletto.

    // If you're inscribing equipment, @card1 must be 255.
    set @card1,255;

    // That's the number of star crumbs in a weapon.
    set @sc,2;

    // That's the number of elemental property of the weapon.
    set @ele,1;

    // And that's the wacky formula that makes them into
    // a single number.    
    set @card2,@ele+((@sc*5)