Skip to content

Ammo Item Definition

Ammunition item system for the Lilia framework.


name

📋 Purpose

Sets the display name of the ammo item

⏰ When Called

During item definition

💡 Example Usage

    ITEM.name = "Pistol Ammo"

model

📋 Purpose

Sets the 3D model for the ammo item

⏰ When Called

During item definition

💡 Example Usage

    ITEM.model = "models/props_c17/SuitCase001a.mdl"

width

📋 Purpose

Sets the inventory width of the ammo item

⏰ When Called

During item definition

💡 Example Usage

    ITEM.width = 1  -- Takes 1 slot width

height

📋 Purpose

Sets the inventory height of the ammo item

⏰ When Called

During item definition

💡 Example Usage

    ITEM.height = 1  -- Takes 1 slot height

health

📋 Purpose

Sets the health value for the item when it's dropped as an entity in the world

⏰ When Called

During item definition (used when item is spawned as entity) Notes: - Defaults to 100 if not specified - When the item entity takes damage, its health decreases - Item is destroyed when health reaches 0 - Only applies if ITEM.CanBeDestroyed is true (controlled by config)

💡 Example Usage

    ITEM.health = 250  -- Item can take 250 damage before being destroyed

ammo

📋 Purpose

Sets the ammo type for the item

⏰ When Called

During item definition (used in use functions)

💡 Example Usage

    ITEM.ammo = "pistol"  -- Pistol ammunition type
    ITEM.ammo = "smg1"    -- SMG ammunition type

category

📋 Purpose

Sets the category for the ammo item

⏰ When Called

During item definition

💡 Example Usage

    ITEM.category = "itemCatAmmunition"

Complete Examples

The following examples demonstrate how to use all the properties and methods together to create complete definitions.

Complete Item Example

Below is a comprehensive example showing how to define a complete item with all available properties and methods.

            ITEM.name = "Pistol Ammo"

            ITEM.model = "models/props_c17/SuitCase001a.mdl"

            ITEM.width = 1  -- Takes 1 slot width

            ITEM.height = 1  -- Takes 1 slot height

            ITEM.health = 250  -- Item can take 250 damage before being destroyed

            ITEM.ammo = "pistol"  -- Pistol ammunition type
            ITEM.ammo = "smg1"    -- SMG ammunition type

            ITEM.category = "itemCatAmmunition"

    -- Basic item identification
        ITEM.name = "Pistol Ammo"                    -- Display name shown to players
        ITEM.desc = "ammoDesc"                       -- Description text
        ITEM.model = "models/items/boxsrounds.mdl"   -- 3D model for the ammo box
        ITEM.width = 1                               -- Inventory width (1 slot)
        ITEM.height = 1                              -- Inventory height (1 slot)
        ITEM.health = 100                            -- Health when dropped (default: 100)
        ITEM.ammo = "pistol"                         -- Ammo type (matches weapon ammo type)
        ITEM.category = "itemCatAmmunition"          -- Category for inventory sorting