What feature are you looking forward to the most in v5?

Ecumbrance System
4 (3.3%)
Item Stacking System
8 (6.7%)
Events (?)
11 (9.2%)
Item Durability / Degradation Over Time
3 (2.5%)
Crafting & Item Forming
25 (20.8%)
Smelting with the Furnace & Crucible
0 (0%)
Vehicle Storage
13 (10.8%)
Display Bricks
2 (1.7%)
Storage Locking & Lock-Picking
7 (5.8%)
Backpacks & Containers
16 (13.3%)
Hybrid Item / Brick Planting
0 (0%)
Shops & Integrated Loot System (?)
5 (4.2%)
Item Modding & Repair (with the Anvil)
3 (2.5%)
Hunger, Thirst & Armor Support
23 (19.2%)

Total Members Voted: 115

Author Topic: ☐⇄☐ Item Storage (Alpha Released!)  (Read 120937 times)

    My other add-on topics (now outdated):

      Item Storage Add-On [v4]

      Interactive GUI and events that allow you to store items in bricks, backpacks, vehicles and bots!

      Important Information
      • A help manual is included in the add-ons .zip folder, which covers just about everything related to the add-on.
      • Perfect for RPGs, DMs / TDMs, exploration games, survival games and more! (This add-on allows for gametypes not previously possible).
      • Other players should download this add-on themselves to use it on your server; it'll notify them to download. However, certain features are included to allow players to still use some functionality.
      • Special thanks to Cards, Doktor, Fix, HaneZane001, Uxie, Xynn and Xanderian for helping test version 1.
      • Thanks to Mr.Nobody, MST, Pecon, Tuevon, Elm, Ostinyo, Sanctus Rem, PC, and the rest of the beta-testers who helped test version 2.
      • Thanks to Alex Dude, Catzoo and Furling for helping test version 4.

      Video Tutorials:
      - Installation Tutorial

      - Basics Overview

      Event Examples:
      Coming Soon!

      Main Features
      • Great Versatility - Store items in bricks and backpacks (as well as in vehicles and bots if setup correctly), or even create event-based shops, item repair stations, trading posts, parcel / mail centers, potion-brewing stands, crafting systems, NPC inventories, NPC pickpocketing, vehicle inventories, item-based passwords, monetary systems and more!
      • Item Stacking System - stack multiple items into a single cell; an auto-stacking feature is also included, which will stack a certain amount of like-items into a single cell that you quickly double-click. Useful for: organizing and making room in the GUI; carrying ammo or multiple explosives; gathering resources / treasure around the map; monetary systems using money items; etc.!
      • Encumbrance System - allows players to carry only a certain amount of items based on each item's weight and the player's max weight limit.
      • Backpack System - The ISBackpack item unlocks an additional personal-inventory GUI, allowing you to carry more items with you. This GUI also integrates seamlessly with the other inventory GUIs, and can be accessed at an time. Support for an auxiliary, text-based backpack is also included for players who don't have the add-on downloaded.
      • Dedicated Server Support - due to integrated client-server communication.
      • Realtime, Cross-Player GUI Updating - Changes to a brick's inventory are applied in realtime to the GUIs of all players viewing it.
      • Immediate Item Saving - Once you alter a brick's or a backpack's inventory, items are saved immediately to the host's server configuration folder. If bricks are cleared, the server crashes, etc., your items remain saved. (Allows storage for well over 854 Million items!)
      • 23 Input/Output Events Included - Allows for countless possibilities.
      • VCE Support - Includes 44 VCE variables.
      • Support for Players Without the Add-On - Players without the add-on (or with an outdated version) can still use a text-based version of the backpack system. Also, an option is included for allowing limited functionality with events (just about everything but the GUIs will still function).
      • Various Inventory Options
        • Access - Restricts which players can access the brick's inventory.
        • Remote Access - Allows or prevents accessing a brick's inventory from other bricks.
        • 4 Different Inventory Sizes - Small, Medium, Large and X-Large.
      • Any Brick Can Be Used as a Storage Container
      • Various Server Settings - such as options for the backpack system, addressing spam, setting quotas, setting stack and weight values for items, and more!
      • Secure Player-Save Management - Players have the option of listing and removing past saves; the host has their own GUI which can list other players saves (including their own) and manage add-on settings.
      • Quotas and Filters - Player quota, save file quota, brick name validation filter, event and server command spam filters and error checks.
      • Client Add-On Detection Script - If a player tries to use Item Storage events, but they don't have the add-on downloaded, they will receive a message to download the add-on from RTB. It also checks if they have an outdated version.

      Download from MediaFire (552 KB)
      3139 downloads! (since February 20, 2014)

      Mirror Download from DropBox

      Version 4 Change Log:
      Major Changes
      • Dedicated Server Support
        • -All features should now work on dedicated servers; the blacklisting features, however, has been removed.
        • -If item or server settings are present from a previous save, they are automatically reloaded the first time a player joins your dedicated server. If no past saves are found it'll use default settings instead. You can also alter the settings upon joining the server and bringing up the host GUI.
      • Item Stacking
        • -Like-items can now be stacked in the brick or backpack inventories.
        • -Items can also be auto-stacked into a single cell by double-clicking a certain item. This will only work if they're within the same inventory, relative to the item's stack-limit.
        • -The server takes multiple situations into account when stacking items. However, the general rule of thumb is that you left-click to transfer an entire stack of items, and right-click to choose a certain amount to send. The player inventory window can only hold one item within a cell.
      • Encumbrance System
        • -If enabled, a player's movement will be restricted if they carry too many items and exceed their max item-weight (they will go into orbit-cam mode until they alleviate the burden).
        • -Encumbrance is applied/removed immediatly upon updating the server settings by the host. It also takes various situations into account - such as picking up items or dropping them from your player or backpack window, teleporting, respawning, etc.
        • -Picking up or dropping a backpack will affect your max encumbrance, relative not only to the backpack item's weight, but also to the amount of items within the backpack and the amount of items stacked.
      • GUI Improvements
        • -Added new save managers (saves are now listed in columns, display the save-owner's ID for the host and are gradually loaded from the server to allow up to 50 saves per request), an items manager (for setting item stack and weight values; saved values are automatically reloaded for each game session, depending on which items are enabled) and settings manager (item/server settings must now be saved/applied upon activating a button, since they are now sent over the network)
        • -Added options for clearing backpack inventory on death/respawn, toggling encumbrance, toggling auto-backup saving (encase server crashes while writing a save), toggling event-restrictions for players without the add-on and for setting the max item-weight/symbol.
        • -Added funcitonality for a text-based backpack (encase players don't want to download the add-on for themselves). The text backpack inventory can be manipulated via server commands; type "/ISHlep" (without quotes) for an overview of the commands (this feature is meant to be used with disabled event-restrictions, but doesn't have to).
        • -Increased the player quota from 30 to 50 saves, and the file quota from 100 to 1000 lines (you can now store well over 854 million items on your server! I don't recommend maxing out the quotas though.)
        • -Added support for dropping and picking up item stacks (dropped stacks will be handled as a single item, with the amount of items within the stack shown above it; once a stack of items is picked up, it'll intelligently arrange itself in your backpack, depending on certain conditions).
        • -Added greater security for certain scripts. The server will now filter item stack and weight values to prevent issues, as well as checking cell names and position relative to an inventory size, weight options, etc. Improvements were also made to the player name filter.
        • -The player inventory window, if open, will now immediately update in real-time if you pickup or drop an item from your tools menu (to prevent cheating and issues).
      • Fixes
        • -Items without preview icons (or with errant icon names) are now supported by the inventory windows, saving/loading, events and the items manager.
        • -Support was added for removing items from your back if transferred (wasn't easy to figure out).
        • -Fixes issues with certain events when refreshing player GUIs.
        • -Fixed an issue with the Propane Tank in which it would crash servers when transferred via the inventory GUIs.
        • -Remote access now references a brick's position, instead of its datablock ID. Now only is a brick's position now stored in save files, but you also won't have to constantly update the source brick (when remote access is disabled for it) if its datablock ID changes.
      • Updated/Added New Events (with specific game types take into consideration)
        • -Changed event names to include an underscore, to make identifying them easier (you might need to use a conversion tool to fix your past .bls saves that use them; sorry for the inconvenience).
        • -The random item selection scripts for events are now MUCH more effecient.
        • -If event-resrictions are disabled, a player without the Item Storage Add-On can now use certain events; error messages and notifications adapt to using the default message box GUI, for various scripts.
        • -Support was added for executing specified ISConditionTrue/False events, similar to VCE.
        • -Added 4 new input and output events (now totaling 23 in total) - these include: IS_ifItemInCells, IS_VCESetBrName, onISGUISwapItems and onISGUIDropItem.
        • -The AddItem event now supports both the brick and backpack inventories and supports specified or random stack values / stack amounts to be added.
        • -Events are now more efficient in that they don't load items if they have been already loaded for GUIs.
        • -The SetInv event now includes settings specified or random stack values.
        • -ClearItem supports both the brick and backpack inventories.
        • -TransferItem has been greatly simplified and allows transfering a random, specified or entire stack of items.
        • -Renamed ifISSwapItem to IS_ifTransferred (includes better options for checking past transferred item data).
        • -Made slight changes to how onISGUIAddItem, onISGUIMoveItem, onISGUIRemoveItem and IS_UndoTransfer work.
        • -IS_UndoTransfer now works with items transferred through events, and only supports one undo-action per transfer.
        • -Added new options for IS_ifInvSameAs, to including item stacking.
      • Added More VCE Variables (refer to the manual for the entire list)
        • -40 new variables were included, which allow you to access the uiName, stack amount, stack limit and weight of the first and last-selected items that were previously swapped.
        • -You can also access the same info for the two swapped items, relative to which was added or removed from the brick's inventory (basically the same thing as above, but it ignores the order they were selected in and only returns item info if they involve the brick's inventory).
        • -VCE vars also include info for whether or not a player is over-encumbered, has the GUI-backpack open, has their backpack saved, has v4 of the Item Storage add-on or not/out-of-date, if encumbrance is enabled/disabled, if requiring the backpack item is enabled/disabled, the current max player weight amount, and more!
      • Added New Extra-Large (X-Large) Inventory Size (holds up to 32 items)
      • Added a Save-Conversion Script
        • -Saves prior to v4 are no longer compatible, since v4 references the amount of items within a stack for each cell. However, once you spawn in-game, type "ISConvertSaves();" (without quotes) in your console to auto-convert your old saves.
      • Updated .PDF Manual and Included More Visual References

      Minor Changes
      • -Slight improvements were made to the backpack models.
      • -Added add-on detection script to backpack (forgot to add it before) and fixed out-of-date check.
      • -Deleting an item in your saves manager will now automatically adjust the save-listing and count in your GUI.
      • -The item count when listing saves now only counts items in saves that were enabled/exist.
      • -Removed the introduction GUI.
      • -Stack and weight values will automatically snap to the server hard-limits and max-values when loading saves or when changes are made by the host.
      • -Improved initial access of the saves manager - the relative client or host GUI files now are only executed the first time the GUI is called, instead of executing all of them when the client files are executed.
      • -Made slight adjustments/improvements to dropping items from your backpack.
      • -Events no longer required the backpack to have an existing save in order access it; brick inventories, however, still required that - as a safety option.
      • -Fixed unsaving the backpack if an error comes up while saving.
      • -Added new Paradox and Over-Encumbered message box icons and made slight improvements to the Locked icon.
      • -Made slight improvements/fixes to scripts.
      • -Added gradual save-loading for the brick inventory, to bypass the network strings limit.
      • -Made slight adjustments to error messages for the Additem and ClearItem events (to prevent breaking gameplay experience, i.e. if hosting an RPG).
      • -Adjusted spamcheck limit for swapping items between GUI windows from 1 second to 0.5 seconds.
      • -Made a slight adjustment to the custom message box GUI text to be more legible.
      • -Added support for disconnecting from servers (the add-on now adapts for joining multiple servers per session (regarding GUI access) depending if you are host or not).
      • -Made many other slight fixes and improves to scripts.
      « Last Edit: August 08, 2016, 10:12:42 PM by [GSF]Ghost »

      I'm glad to see a storage mod done right.


      Yay! Finally I wont drop my printer ever again!
      « Last Edit: October 11, 2013, 04:18:10 PM by MrLoL »

      Oh my god!

      Thank you forever GCF!
      I can finally continue progress on my RPG!

      Edit: Oh, its an event for bricks. I thought it would be a server sided inventory GUI like a backpack a player can access anywhere.
      At least I can use this for item chests.

      Any possibility on adding a bot corpse looting option so you can set items to a bot and loot the dead body once you kill it?
      « Last Edit: October 11, 2013, 02:12:37 PM by Mr.Noody »

      Thanks guys. :) I hope y'all find it useful.

      Edit: Oh, its an event for bricks. I thought it would be a server sided inventory GUI like a backpack a player can access anywhere.
      At least I can use this for item chests.

      Any possibility on adding a bot corpse looting option so you can set items to a bot and loot the dead body once you kill it?
      I am planning on adding a backpack option in one of the next updates. However, you can still access your saves from anywhere via events. I didn't think about storing/accessing items from bots though; I'll definitely consider that, thanks.
      « Last Edit: October 11, 2013, 02:48:43 PM by [GSF]Ghost »

      Oh boy this is very handy! Thanks GSF!

      Cool, sometimes it remind me Minecraft, but here it could be really useful function... :3
      « Last Edit: December 12, 2014, 11:00:41 AM by Halmet »

      Cool, sometime it remind me Minecraft, but here it will be really useful function... :3
      Yeah, it reminded me of Minecraft too.

      Great for RPGs, great work!

      Holy crap sweet! Thanks.

      GSF has done it again.
      Will use.

      looks cool
      got it for client usage