Insert Item (CMS) - Revision history

AFRLme at 12:08, 15 September 2022

2022-09-15T12:08:34Z

AFRLme at 14:07, 8 September 2019

2019-09-08T14:07:08Z

AFRLme at 14:33, 13 June 2018

2018-06-13T14:33:42Z

AFRLme at 16:54, 6 January 2015

2015-01-06T16:54:11Z

David Stoffel: Text replacement - "wikitable" to "ts"

2014-08-19T17:22:59Z

Text replacement - "wikitable" to "ts"

AFRLme at 18:45, 2 June 2014

2014-06-02T18:45:27Z

AFRLme at 20:12, 31 May 2014

2014-05-31T20:12:09Z

AFRLme at 20:11, 31 May 2014

2014-05-31T20:11:22Z

AFRLme: Created page with "{| class="wikitable" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By |- | Insert Item Function || Defi..."

2014-05-31T20:10:49Z

Created page with "{| class="wikitable" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By |- | Insert Item Function || Defi..."

New page

{| class="wikitable" style="width:100%"
|-
! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By
|-
| Insert Item Function || Definition || AFRLme
|}

This script allows you to insert & place a new item into the inventory, before or after another item.

== Instructions ==
1. Add the [[#Main_Script|main script]] to the Visionaire Studio Script Editor & set the script as a definition script.<br/>
2. To use this function you have to include both the names of the item you want to replace, & the item that that you will be replacing it with; item names are case & character sensitive.<br/>
2a. Example for placing new item before the initial item...
<syntaxhighlight>
replaceItem("hammer", "nail", false) -- place item "nail" before the hammer
</syntaxhighlight>
2b. Example for placing new item after the initial item...
<syntaxhighlight>
replaceItem("hammer", "nail", true) -- place item "nail" after the hammer
</syntaxhighlight>

== Main Script ==
<syntaxhighlight>
--[[
Insert item function [v2] (31/05/2014)
Written by AFRLme [Lee Clarke]
-- + --
alternatingfrequencies@hotmail.com | skype @ AFRLme
-- + --
This script is donation optional. In game credit is non-negotiable.
You are free to: ¹ use it in your game(s). ² modify the script.
Do not remove - or edit - this comment block.
--]]

-- * tables * --
local itm = {} -- creates an empty table
itm["_temporary_"] = "" -- set the table as temporary (we don't want it to store any data in the save files)

-- * function for inserting an item before or after another item * --
function insertItem( init, new, sta )
itm["gItm"] = game:getLinks(VGameItems) -- get all game items & store them in a table
itm["cItm"] = game:getLink(VGameCurrentCharacter):getLinks(VCharacterItems) -- get all character items & store them in a table
itm["nItm"] = nil -- default value of new item
itm["val"] = 1 -- default value of item slot
-- + --
for i = 1, #(itm.gItm) do -- run a check to see if new item exists in game item table & if so, store item link in variable
if itm.gItm[i]:getName() == new then itm.nItm = getObject("Game.GameItems[" .. new .. "]") break end
end
-- + --
for j = 1, #(itm.cItm) do -- if initial item exists and nItm is not empty then add new item before or after initial item
if itm.cItm[j]:getName() == init and itm.nItm ~= nil then
if sta then itm.val = (j + 1) else itm.val = j end -- if true then add after else add before initial item
table.insert(itm.cItm, itm["val"], itm.nItm) -- insert new item into table
break -- kill the for loop
end
end
if itm.nItm ~= nil then game:getLink(VGameCurrentCharacter):setValue(VCharacterItems, itm.cItm) end -- update character items
end
</syntaxhighlight>

@@ Line 13: / Line 13: @@
 a. Example for placing ''new'' item '''before''' the initial item...
 <syntaxhighlight lang="lua">
-replaceItem("nail", "hammer" false) -- place item "nail" before the hammer
+insertItem("nail", "hammer" false) -- place item "nail" before the hammer
 </syntaxhighlight>
 b. Example for placing ''new'' item '''after''' the initial item...
 <syntaxhighlight lang="lua">
-replaceItem("nail", "hammer", true) -- place item "nail" after the hammer
+insertItem("nail", "hammer", true) -- place item "nail" after the hammer
 </syntaxhighlight>

@@ Line 1: / Line 1: @@
 {| class="ts" style="width:100%"
 |-
-! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By {{lee_PP}}
+! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By
 |-
-| Insert Item Function || Definition || AFRLme
+| Insert Item Function || Definition || [https://www.patreon.com/AFRLme AFRLme]
 |}
@@ Line 9: / Line 9: @@
 == Instructions ==
-. Add the [[#Main_Script|main script]] to the Visionaire Studio Script Editor & set the script as a definition script.<br/>
+. Add the [[#Main_Script|main script]] to the Visionaire Studio Script Editor & set the script as a definition script.<br />
-. To use this function you have to include both the names of the item you want to replace, & the item that that you will be replacing it with; item names are case & character sensitive.<br/>
+. To use this function you have to include both the names of the item you want to replace, & the item that that you will be replacing it with; item names are case & character sensitive.<br />
 a. Example for placing ''new'' item '''before''' the initial item...
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
 replaceItem("nail", "hammer" false) -- place item "nail" before the hammer
 </syntaxhighlight>
 b. Example for placing ''new'' item '''after''' the initial item...
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
 replaceItem("nail", "hammer", true) -- place item "nail" after the hammer
 </syntaxhighlight>
@@ Line 22: / Line 22: @@
 == Main Script ==
-<syntaxhighlight>
+<syntaxhighlight lang="lua">
 --[[
 Insert item function [v2] (31/05/2014)

@@ Line 27: / Line 27: @@
 Written by AFRLme [Lee Clarke]
 -- + --
-alternatingfrequencies@hotmail.com | skype @ AFRLme
+email: afrlme@outlook.com
 -- + --
 This script is donation optional. In game credit is non-negotiable.

@@ Line 11: / Line 11: @@
 . Add the [[#Main_Script|main script]] to the Visionaire Studio Script Editor & set the script as a definition script.<br/>
 . To use this function you have to include both the names of the item you want to replace, & the item that that you will be replacing it with; item names are case & character sensitive.<br/>
-a. Example for placing new item before the initial item...
+a. Example for placing new item '''before''' the initial item...
 <syntaxhighlight>
 replaceItem("hammer", "nail", false) -- place item "nail" before the hammer
 </syntaxhighlight>
-b. Example for placing new item after the initial item...
+b. Example for placing new item '''after''' the initial item...
 <syntaxhighlight>
 replaceItem("hammer", "nail", true) -- place item "nail" after the hammer