https://sourceforge.net/p/hercules/wiki/Getitem/Recent changes to GetitemenMon, 20 Feb 2023 05:01:32 -0000https://sourceforge.net/p/hercules/wiki/Getitem/<div class="markdown_content"><p><span>[Category:Script_Command]</span></p> <div class="toc"> <ul> <li><a href="#syntax">Syntax</a></li> <li><a href="#description">Description</a></li> <li><a href="#examples">Examples</a></li> <li><a href="#see-also">See Also</a></li> </ul> </div> <h2 id="syntax">Syntax</h2> <ul> <li><a class="alink" href="/p/hercules/wiki/Getitem/">[Getitem]</a> &lt;item id&gt;,&lt;amount&gt;{,&lt;account ID&gt;}; </li> <li><a class="alink" href="/p/hercules/wiki/Getitem/">[Getitem]</a> "&lt;item name&gt;",&lt;amount&gt;{,&lt;account ID&gt;}; </li> </ul> <h2 id="description">Description</h2> <p>This command will give a specific amount of specified items to the target<br/> character. If the character is not online, nothing will happen. If &lt;character<br/> ID&gt; is not specified, items will be created in the invoking character<br/> inventory instead.</p> <p>In the first and most commonly used version of this command, items are<br/> referred to by their database ID number, which can be found in {{git|db/pre-<br/> re/item_db.txt}} or {{git|db/re/item_db.txt}}</p> <p>Giving an item ID of -1 will give a specified number of random items from the<br/> list of those that fall out of Old Blue Box. Unlike in all other cases, these<br/> will be unidentified, if they turn out to be equipment. This is exactly what's<br/> written in the Old Blue Box's item script.</p> <p>Other negative IDs also correspond to other random item generating item<br/> tables:</p> <p>Giving an item ID of -2 will produce the effects of Old Violet Box. Giving an<br/> item ID of -3 will produce the effects of Old Card Album. Giving an item ID of<br/> -4 will produce the effects of Gift Box. Giving an item ID of -5 will produce<br/> the effects of Worn Out Scroll, which drops only Jellopies anyway.</p> <p>This transaction is logged if the log script generated transactions option is<br/> enabled.</p> <p>You may also create an item by it's name in the 'english name' field in the<br/> item database:</p> <p>Which will do what you'd expect. If it can't find that name in the database,<br/> apples will be created anyway. It is often a VERY GOOD IDEA to use it like<br/> this.</p> <p>This is used in pretty much all NPC scripts that have to do with items and<br/> quite a few item scripts. For more examples check just about any official<br/> script.</p> <h2 id="examples">Examples</h2> <div class="codehilite"><pre><span></span><code> getitem 502,10; // The person will receive 10 apples getitem 617,1; // The person will receive 1 Old Violet Box getitem "RED_POTION",10; </code></pre></div> <h2 id="see-also">See Also</h2> <ul> <li><span>[Getitem2]</span> </li> </ul> <p><span>[Category:Script Command]</span></p></div>BrynnerMon, 20 Feb 2023 05:01:32 -0000https://sourceforge.net5d3a240aea94a1463cf1494a508bbbeaa985bc5a