Showcase Video
🎮 Test Server 🎮
🆘 Discord(Support) 🆘

Clothing As Items

• If you own the tgiann-clothing script, you can take advantage of the inventory’s “clothing as item” feature.
  If you don’t have the tgiann-clothing script, the clothing slots will automatically turn into buttons, allowing you to equip or remove the clothes you’re currently wearing. ( Video )

This means the inventory system works even without tgiann-clothing. However, if you are using a different clothing script, the inventory’s clothing as item feature will not be compatible with it.

Main Features

• Diverse Inventory Types: Unlock a wide array of inventory options, including trunks, gloveboxes, personal stashes, crafting, player searching, item dropping, and a market system to meet all your needs.
• Advanced Item Management for Stashes: Configure whitelist and blacklist options for stash items, ensuring only approved items are stored.
• Seamless Compatibility: Fully integrates with all QB exports, making it versatile and server-friendly.
• Item Functionality Customization: Empower your items with added functionality through an items.lua file, similar to Ox Inventory, giving each item unique properties.
• Personalized Inventory Settings: Enjoy a customizable inventory settings menu, where you can adjust the look and feel to suit your style.
• Efficient Search & Filter: Quickly locate items with a built-in search and filtering system, streamlining item management.
• Quick Use & Transfer Shortcuts: Use convenient shortcuts for quick item access and seamless transfers between inventories.
• Share & Toss Items with Ease: Effortlessly throw items or hand them to nearby players.
• Enhanced Item Rarity System: Distinguish rare items with a color-coded rarity system, adding a touch of flair to unique possessions.
• Immersive World with Prop Drops: Every item you drop appears as a realistic prop on the ground, creating a fully immersive environment.
• Realism in Death: Upon death, your weapon and cash will drop to the ground, adding a layer of realism.
• Customize Items with Renaming & Icon Changes: Personalize your inventory by renaming items and changing their icons for easy recognition.
• Dynamic Attachments & Animations: Items automatically attach to your character’s hand with appropriate animations, enhancing roleplay immersion.
• Sophisticated Weapon Attachment System: Customize and enhance weapons with attachments, making each weapon truly unique.
• Powerful Admin Controls: Monitor item quantities server-wide and locate them across inventories with specialized admin commands.
• Role-Based Police Weapon Access: Only assigned roles can access police weapons while on duty, maintaining realism and control.
• Item Decay System: Define items to decay over time, adding depth and strategy to item usage.
• Usage-Based Item Limits: Set a max use limit for items, automatically removing them after a specified number of uses.
• Dynamic Backpack Feature: Equip a backpack to boost your max weight and slots, only when wearing a suitable bag.
• Owner-Only Trunks & Gloveboxes: Secure your valuables with trunks and gloveboxes accessible exclusively to their owners.
• Detailed Logs for Precision Tracking: Keep a thorough log of item activity, helping with detailed tracking and management.
• Water-Damageable Items: Items can degrade or become unusable if submerged, adding to environmental realism.
• Stun Gun Ammo System: Manage ammunition for stun guns, introducing realism and balance.
• Hotbar for Quick Access: Use a sleek, functional hotbar to access essential items on the go.
• Preventing Item Loss: If a player receives an item using the addItem function while their inventory is full, the item will automatically drop to the ground instead of being deleted.

Convert from Other Inventories

• Seamless Migration to Tgiann-Inventory
  Effortlessly transfer your data from QB Default, ESX Default, OX Inventory, Quasar Inventory, and Codem Inventory to Tgiann-Inventory without any data loss.
• Detailed Migration Guide
  For step-by-step instructions, visit: Tgiann-Inventory Migration Guide

Inventory Compatibility

• Seamless QB Integration: This script works smoothly with many QB inventory exports, allowing you to keep using existing exports without any modifications. For the full list of compatible exports, click here.
• Like OX Inventory Item Customization: Similar to OX Inventory’s items.lua file, this script allows you to add custom properties to items. For example, you can set the progress bar duration, animation, and hunger value restoration for food items directly in items.lua. For more details, click here.

Inventory Settings Menu

• Customizable Inventory: Through this menu, players can personalize the inventory color based on the preset options you’ve configured, and toggle extra visual details like blur effects and character visibility.

• Default Color Setting: The initial color you define in the config serves as the main color theme for the inventory, providing a cohesive look right from the start.

Stackable Items

• Every Item Can Be Stacked (Video)
  All inventory items can be stacked, including those with metadata. When stacked, metadata values remain intact.
• Configurable Stack Limits
  Set a maximum stack size for each item in the config file, similar to Minecraft’s stacking system, allowing full customization of inventory management.
  

Inventory Types

• Shop: Easily set up shops anywhere via config. Control item visibility within each shop based on the player’s job, gang affiliation, or license requirements, ensuring only eligible players see specific items. If you’re curious about the config settings, just click here.

• Stash: Open customizable stashes through exports, with options to define whitelist and blacklist items for precise inventory control.
  Example Exports

• Vehicle Glovebox & Trunk: Configure unique stash sizes and weight limits for each vehicle class, offering tailored storage capacities.

• Crafting: Add a crafting button directly to the inventory’s main menu to enable seamless item crafting for players. Alternatively, use open exports to create crafting inventories as needed.

• Player Interaction: Utilize inventories for player searches, or allow items to be dropped on the ground for easy retrieval and exchange.

Item Search and Filter Buttons

• Efficient Searching: Quickly locate items within large inventories using the search menu. Non-matching items will appear dimmed, helping you focus on relevant results.
• Customizable Filter Buttons: Speed up your search with preset filter buttons, which can be tailored in the config for streamlined access. Click here for an example config.

Item Transfer Restriction

• Prevent Unauthorized Transfers: Easily block specific items from being transferred to other players or inventories using config.blockItems. Simply add the item to the list and set the inventory types you want to block to true. This ensures controlled item handling and prevents misuse.

Shortcut Keys

• Streamlined Item Actions: Manage items swiftly with intuitive shortcuts. Double-clicking a usable item will instantly activate it. Use Shift + Right-Click to transfer items between the main and secondary inventories seamlessly. For additional control, right-clicking on items also allows quick access to these actions, ideal for fans of a tactile inventory experience.

Reloading Ammo Types (Video)

• Type 1: To load bullets into the gun, you must use the bullet item. When used, it will load bullets based on the config.ammo.ammo value.
• Type 2: Pressing the R key reloads bullets from your inventory up to the weapon’s magazine limit. For example, if the magazine limit is 30, it will deduct 30 bullets from your inventory and load them into the clip.

Realistic Armor & Plate System (Video)

Add a tactical layer of gear management with fully customizable armors and plates:

• Custom Armors: Define each armor’s maximum protection value (e.g., set Light Armor’s max to 50).
• Configurable Plates: Create unlimited plate types—any plate can be used with any armor.
• Scalable Protection: Plates add a configurable amount of armor value to the player, letting you fine-tune defensive strengths.
• Persistent Durability: Armor retains its current condition when unequipped. If you remove a 50-max armor at 30% durability, it stays at 30% and restores that value when re-worn.
• Dynamic Strategy: Equip, swap, and remove armors on the fly, forcing players to manage resources and adapt their load-out to each encounter.

Throwing and Giving Items

• Item Throwing: If you need to discard an item or pass it to someone at a distance, simply use the “Throw” button by double-clicking the item. For a detailed demonstration, click here.
• Giving Items Nearby: Alternatively, select the “Give” option to hand the item to someone close by. Your character will automatically send a “Me” command (e.g., hands over the bandage) when giving an item, adding a realistic touch. If you prefer, this auto “Me” feature can be disabled in settings. Example video

Rare System

• Customizable Rarity: Define rarity levels in the config and assign them to items in items.lua to display unique colors in the inventory. Add custom descriptions that appear when hovering over rare items, giving each item a distinct feel. The possibilities are endless—mark illegal items, designate police-exclusive items, and more to enhance immersion and clarity.

Item Dropping with Props

• Realistic Item Appearance: When items are dropped, they appear as models (props) on the ground, enhancing immersion. You can configure the specific model for each item in the config file. Unconfigured items will appear as smaller props, and when multiple items are dropped together, the model transforms into a larger box for clarity. Click here for the config file and here for a demonstration video.

Dropping Cash and Weapons on Death

• Realistic Death Drops: When your character dies while holding a weapon, the weapon will drop to the ground. Similarly, if your cash exceeds a certain amount, a portion of it can also be dropped. Both the drop thresholds and specific behaviors can be fully customized in the config file, allowing you to fine-tune this feature to your server’s needs.

Renaming and Image Customization

• Personalized Items: Players can rename and change the icon of specific items configured in the config file, adding a unique touch to their inventory. Items with custom names remain unique, ensuring that when transferred, the new owner sees the same name and image. This feature enhances personalization and item ownership across the server.

Carryable Items

• Visible Carryable Props: Items configured as “carryable” in the config will automatically appear as props in the player’s hand, complete with animations, until they are removed from the inventory. For example, if a player has a TV in their inventory, other players will see them carrying it. This feature adds realism and visual feedback for held items. Click here for the config file and here for a detailed video demonstration.

Weapon Attachment Menu

• Easy Access to Attachments: Players can access the attachment menu by right-clicking on a weapon, allowing for seamless customization. You can set this feature to be available everywhere or restrict it to specific locations. Attachments can be added for a fee or with specific items, all of which are fully configurable. Click here to view the config file.

Police Weapon System

• Role-Restricted Weapons: Configure weapons and ammunition that can only be used by specific jobs, such as police officers, while on duty. This ensures that only designated roles have access to particular weapons. Setup is simple: just add the item to your item file as you would for any weapon, but with a police_ prefix (e.g., weapon_police_pistol instead of weapon_pistol). The script handles the rest, making it easy to enforce role-based weapon restrictions.

Item Decay and Maximum Usability

• Configurable Item Lifespan: Set any item to become unusable after a specified amount of time. For example, a cake item could expire 24 hours after creation, adding a layer of realism.
• Usage Limit for Items: Limit the number of uses for specific items. For instance, a repair kit can be set to disappear after 5 uses, encouraging strategic planning. The possibilities are endless—customize items to fit your server’s needs. Click here for the introduction video, here for Config 1, and here for Config 2.

Backpack

• Dynamic Carry Capacity: When a player equips a backpack as clothing, this feature adjusts their maximum carry weight and inventory slots based on the type of backpack. Tailor these settings in the config for different bag types. Click here(config.backpack) to view the config file and here for a demo video.

Secured Trunk and Glovebox

• Owner-Only Access: Configure trunks and gloveboxes to be accessible only by the vehicle owner, adding an extra layer of security for stored items. This option can be easily enabled in the config file.

Water-Damageable Items

• Realistic Water Damage: Configure items that can be damaged when a player enters water. For instance, if a player enters water while carrying a phone and stays submerged for a certain duration, the phone will transform into a broken item. This feature adds realism and encourages mindful inventory management.

Stun Gun Ammo

• Ammo Requirement for Stun Gun: Unlike the default GTA setup, this feature requires players to have ammunition to use the stun gun, adding a layer of realism and strategy. If preferred, you can disable this feature in the config to revert to the unlimited default setting.

Hotbar

• Dynamic Hotbar for Quick Access: This hotbar allows you to drag and drop items for easy use with shortcut keys. Unique to this hotbar, if an item like a bandage is in the 4th slot and runs out, it will remain in the slot but turn red to indicate it’s empty. Once you obtain more of the item, you can use it again without re-adding it to the hotbar. This intuitive feature works seamlessly for all items, enhancing quick access and convenience.

Clothing Slots

• Flexible Clothing Management: If you’re not using tgiann-clothing, these slots function like dp-clothes, allowing players to equip and remove clothing items directly. With tgiann-clothing, these slots support wearable clothing items, turning all clothing into visual, itemized inventory pieces. This provides a fully illustrated wardrobe experience within the inventory system.
• Clothe set item for tgiann-clothing (Video)
  • This item allows you to add a clothing set of your choice. When you equip the clothe set item, all items within the set will be equipped automatically. For example, you can put a suit set or an outfit for work inside the item, so by equipping just one item, you wear the entire outfit at once. Additionally, you can name the set to know which set it is.

Trash Can Looting System

• Players can search trash cans to receive random items, adding a new way to scavenge and explore the city.
• Once a trash can is searched, it enters a cooldown state, preventing players from abusing the system by farming the same location repeatedly.
• This feature encourages players to move around the map and adds a layer of immersion and balance to the loot system.

/checkitem Admin Command

• Detailed Item Tracking: Use this command to search for any specific item across all inventories, displaying a detailed log for easy monitoring and management. This feature provides admins with precise oversight of item distribution on the server.

Requirements

• ESX, QB or QBOX
• tgiann-core (free)

Config File

• Inventory Config Files (gitbook.io)

TGIANN Inventory Documents(gitbook.io)
TGIANN | Scripts (tebex.io)