Attribute Definitions

Character attribute definition system for the Lilia framework.

---

Overview

The attribute system provides functionality for defining character attributes within the Lilia framework. Attributes represent character statistics that can be modified, boosted, and used in gameplay calculations. The system includes automatic attribute loading from directories, localization support for attribute names and descriptions, and hooks for custom attribute behavior. Attributes can be configured with maximum values, starting limits, and whether they appear in character creation. The system supports attribute boosts through the character system and validation through callback methods that are automatically invoked during character setup.

---

name

Purpose

Sets the display name of the attribute

When Called

During attribute definition

Example Usage

ATTRIBUTE.name = "Strength"

---

desc

Purpose

Sets the description of the attribute that appears in tooltips and UI

When Called

During attribute definition

Example Usage

ATTRIBUTE.desc = "Physical power and muscle strength. Affects melee damage and carrying capacity."

---

maxValue

Purpose

Sets the maximum value this attribute can reach

When Called

During attribute definition (used by GetAttributeMax hook)

Example Usage

ATTRIBUTE.maxValue = 50

---

startingMax

Purpose

Sets the maximum value this attribute can have during character creation

When Called

During attribute definition (used by GetAttributeStartingMax hook)

Example Usage

ATTRIBUTE.startingMax = 20

---

noStartBonus

Purpose

Prevents this attribute from appearing in character creation attribute allocation

When Called

During attribute definition (checked in character creation UI)

Example Usage

ATTRIBUTE.noStartBonus = true

---

OnSetup

Purpose

Hook function called when setting up attributes for a character

When Called

When a character spawns or when their attributes are initialized

Realm

Server

Parameters

• client (Player): The client whose character is being set up
• value (number): The current attribute value

Returns

• None

Example Usage

function ATTRIBUTE:OnSetup(client, value)
    local char = client:getChar()
    if not char then return end
    -- Set default attribute value if not already set
    if value == 0 then
        char:setAttrib(self.uniqueID, 10)
    end
end

---