Exports

toggleUI

Description: Toggles the visibility of the UI.

Usage:

exports['cdev_emotemenu']:toggleUI()

---

hideUI

Description: Hides the UI.

Usage:

exports['cdev_emotemenu']:hideUI()

---

blockUIUsage

Description: Blocks UI usage.

Parameters:

• block (boolean): Determines whether to block the UI usage (true) or allow it (false).

Usage:

exports['cdev_emotemenu']:blockUIUsage(block)

---

showUI

Description: Shows the UI.

Usage:

exports['cdev_emotemenu']:showUI()

---

playAnimById

Description: Plays an animation by its ID.

Parameters:

• animId (number): The ID of the animation to play.

• customCoords (table, optional): Custom coordinates to play the animation at.

• customHeading (number, optional): Custom heading to play the animation at.

• freezePlayer (boolean, optional): Whether to freeze the player while playing the animation.

• oldCoords (table, optional): The old coordinates of the player before playing the animation.

• forceLoop (boolean, optional): Force the animation to loop.

• customPerson (string, optional): The person/side to play the animation on (first or second person).

Usage:

exports['cdev_emotemenu']:playAnimById(animId, customCoords, customHeading, freezePlayer, oldCoords, forceLoop, customPerson)

---

setExpressionById

Description: Sets a facial expression by its ID.

Parameters:

• expressionId (number): The ID of the expression to set.

Usage:

exports['cdev_emotemenu']:setExpressionById(expressionId)

---

resetExpression

Description: Resets the facial expression to the default.

Usage:

exports['cdev_emotemenu']:resetExpression()

---

initializeExpression

Description: Initializes the facial expression system.

Usage:

exports['cdev_emotemenu']:initializeExpression()

---

getExpression

Description: Retrieves the current facial expression ID.

Returns:

• (number): The ID of the current expression.

Usage:

local expressionId = exports['cdev_emotemenu']:getExpression()

---

setWalkStyleById

Description: Sets a walk style by its ID.

Parameters:

• walkStyleId (number): The ID of the walk style to set.

Usage:

exports['cdev_emotemenu']:setWalkStyleById(walkStyleId)

---

resetWalkStyle

Description: Resets the walk style to the default.

Usage:

exports['cdev_emotemenu']:resetWalkStyle()

---

initializeWalkStyle

Description: Initializes the walk style system.

Usage:

exports['cdev_emotemenu']:initializeWalkStyle()

---

getWalkStyle

Description: Retrieves the current walk style ID.

Returns:

• (number): The ID of the current walk style.

Usage:

local walkStyleId = exports['cdev_emotemenu']:getWalkStyle()

---

cancelAnim

Description: Cancels the current animation.

Usage:

exports['cdev_emotemenu']:cancelAnim()

---

isAnimRunning

Description: Checks if an animation is currently running.

Returns:

• (boolean): true if an animation is running; otherwise, false.

Usage:

local isRunning = exports['cdev_emotemenu']:isAnimRunning()

---

blockAnimationUsage

Description: Blocks or unblocks animation usage.

Parameters:

• block (boolean): Set to true to block animations, or false to unblock them.

Usage:

exports['cdev_emotemenu']:blockAnimationUsage(block)

---

registerAnimation

Description: Registers a new animation.

Parameters:

• data (table): A table containing animation data with the following fields:

  • id (number): The ID of the animation.

  • category (string): The category of the animation.

  • thumbnail (string): The path to the thumbnail image.

  • label (string): The display label for the animation.

  • firstperson (table): Contains dict and anim for the animation.

  • vip (boolean, optional): Indicates if the animation is VIP-only.

Usage:

exports['cdev_emotemenu']:registerAnimation({
    id = 1,
    category = 'dance',
    thumbnail = 'path/to/thumbnail.png',
    label = 'My Custom Dance',
    firstperson = {
        dict = 'anim@mp_player_intcelebrationmale@uncle_disco',
        anim = 'uncle_disco'
    },
    vip = false
})

---

toggleExtraActionBlock

Description: Enables or disables (blocks/unblocks) the usage of a specific extra action (e.g., prone, handsup, crouch, point, ragdoll).

Parameters:

• action ('prone' | 'handsup' | 'crouch' | 'point' | 'ragdoll'): The action to control.

• toggle (boolean): Set to true to block the action or false to unblock it.

Usage:

exports['cdev_emotemenu']:toggleExtraActionBlock('handsup', true)

---

isExtraActionDisabled

Description: Checks whether a specific extra action is currently disabled.

Parameters:

• action ('prone' | 'handsup' | 'crouch' | 'point' | 'ragdoll'): The action to check.

Returns:

• (boolean): true if the action is disabled; otherwise, false.

Usage:

local isDisabled = exports['cdev_emotemenu']:isExtraActionDisabled('handsup')
print("Is handsup disabled? ", isDisabled)

---

BlockIdleAnimation

Description: Blocks the idle animation from playing automatically.

Usage:

exports['cdev_emotemenu']:BlockIdleAnimation()

---

UnblockIdleAnimation

Description: Unblocks the idle animation, allowing it to play automatically again.

Usage:

exports['cdev_emotemenu']:UnblockIdleAnimation()

---

Notes

Installation: Ensure that the cdev_emotemenu resource is properly installed and running on your server. Replace 'cdev_emotemenu' with the appropriate resource name if it differs.

Optional Parameters: Optional parameters can be omitted or set to nil.

Reference: Consult the resource documentation for specific IDs and available animations.