đź Test Server đź
đ Discord(Support) đ
Updates
Non Item Clothing Version!
- Clothes are not items in this version.  ( Video )
- You can remove your clothes and put them on again by clicking on the clothing slots
- if you want itemized clothes you need the tgiann-clothing script
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.
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.
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.
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.
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.
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.
/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
Config File
TGIANN Inventory Documents(gitbook.io)
TGIANN | Scripts (tebex.io)