Server Exports

GetStatus

Returns a status controller for the specified player and status.

---@param {source: number}: Player Server ID
---@param {statusName: string}: Status name defined in Config.Statuses
---@return {status: table}: Status controller with Set, GetPercentage, Add and Remove functions
local status = exports['vms_needs']:GetStatus(source, statusName)

Example Usage

local hunger = exports['vms_needs']:GetStatus(1, 'hunger')

hunger.Set(300)

print(hunger.GetPercentage())

hunger.Add(50)
hunger.Remove(25)

Returned Functions

{
    Set = function(value)
        -- Sets the raw status value.
    end,

    GetPercentage = function()
        -- Returns the current status value as a percentage from 0 to 100.
    end,

    Add = function(value)
        -- Adds the specified value to the status.
    end,

    Remove = function(value)
        -- Removes the specified value from the status.
    end,
}

---

GetPercentageStatus

Returns the current status value as a percentage (0-100).

---@param {source: number}: Player Server ID
---@param {statusName: string}: Status name defined in Config.Statuses
---@return {statusPercentage: number}: Current status value as a percentage (0-100)
local statusPercentage = exports['vms_needs']:GetPercentageStatus(source, statusName)

---

SetStatus

Sets the raw value of the specified player status.

---@param {source: number}: Player Server ID
---@param {statusName: string}: Status name defined in Config.Statuses
---@param {value: number}: New raw status value
exports['vms_needs']:SetStatus(source, statusName, value)

---

AddStatus

Adds a raw value to the specified player status.

---@param {source: number}: Player Server ID
---@param {statusName: string}: Status name defined in Config.Statuses
---@param {value: number}: Raw status value to add
exports['vms_needs']:AddStatus(source, statusName, value)

---

RemoveStatus

Removes a raw value from the specified player status.

---@param {source: number}: Player Server ID
---@param {statusName: string}: Status name defined in Config.Statuses
---@param {value: number}: Raw status value to remove
exports['vms_needs']:RemoveStatus(source, statusName, value)

---

CleanupOptionalStatuses

Clear all statuses if they are marked as isOptional in Config.Statuses.

---@param {source: number}: Player Server ID
exports['vms_needs']:CleanupOptionalStatuses(source)

---

SaveStatus

Saves the status data for the specified player or all online players.

---@param {source: number | nil}: Player Server ID or nil to save all online players.
exports['vms_needs']:SaveStatus(source)

---

GetServerTemperature

Returns the current server temperature.

local tempreature = exports['vms_needs']:GetServerTemperature()