Shared

clamp

fjsf.clamp(inputValue, minimum, maximum)

Restricts a number to a specified range.

Parameters

• inputValue (number) — The value to clamp

• minimum (number) — The lower boundary

• maximum (number) — The upper boundary

Returns

• (number) — The value constrained to the range

Example

local health = fjsf.clamp(playerHealth, 0, 200)

---

round

fjsf.round(inputValue, decimalPlaces)

Rounds a number to a specified number of decimal places.

Parameters

• inputValue (number) — The number to round

• decimalPlaces (number) — The amount of decimal precision

Returns

• (number) — The rounded number

Example

local speed = fjsf.round(GetEntitySpeed(vehicle) * 3.6, 2)

---

lerp

fjsf.lerp(startValue, endValue, progress)

Performs linear interpolation between two numbers.

Useful for smooth transitions such as fades, movement, or UI animations.

Parameters

• startValue (number) — The starting value

• endValue (number) — The target value

• progress (number) — Interpolation factor between 0 and 1

Returns

• (number) — The interpolated value

Example

local alpha = fjsf.lerp(0, 255, fadeProgress)

---

invLerp

fjsf.invLerp(rangeStart, rangeEnd, currentValue)

Converts a value into a normalized range between 0 and 1.

Often used to calculate progress or percentages from raw values.

Parameters

• rangeStart (number) — The minimum range value

• rangeEnd (number) — The maximum range value

• currentValue (number) — The value to normalize

Returns

• (number) — A normalized value between 0 and 1

Example

local progress = fjsf.invLerp(0, 100, armor)

---

snap

fjsf.snap(inputValue, stepSize)

Snaps a number to the nearest step value.

Parameters

• inputValue (number) — The value to snap

• stepSize (number) — The step interval

Returns

• (number) — The snapped value

Example

local heading = fjsf.snap(GetEntityHeading(ped), 15)

---

oscillate

fjsf.oscillate(timeValue, amplitude, frequency)

Generates a smooth oscillating value using a sine wave.

Useful for UI effects and subtle animations.

Parameters

• timeValue (number) — The time or frame value

• amplitude (number) — The maximum output value

• frequency (number) — The speed of oscillation

Returns

• (number) — The oscillated value

Example

local t = GetGameTimer() / 1000
local pulse = fjsf.oscillate(t, 1.0, 2.0)

---

mapRange

fjsf.mapRange(inputValue, sourceMin, sourceMax, targetMin, targetMax)

Maps a number from one range into another range.

Parameters

• inputValue (number) — The value to remap

• sourceMin (number) — The minimum of the source range

• sourceMax (number) — The maximum of the source range

• targetMin (number) — The minimum of the target range

• targetMax (number) — The maximum of the target range

Returns

• (number) — The remapped value

Example

local volume = fjsf.mapRange(speed, 0, 60, 0.2, 1.0)

hexToRgb

Converts a HEX color string into RGB values.

Parameters

• hexColor (string) — Color in #RRGGBB or RRGGBB format

Returns

• (number) Red

• (number) Green

• (number) Blue

Example

local r, g, b = fjsf.hexToRgb('#ff8800')

---

rgbToHex

Converts RGB values into a HEX color string.

Parameters

• red (number)

• green (number)

• blue (number)

Returns

• (string) HEX color string

Example

local hex = fjsf.rgbToHex(255, 136, 0)

---

hexToRgba

Converts a HEX color into RGBA values.

Parameters

• hexColor (string)

• alpha (number, optional)

Returns

• (number) Red

• (number) Green

• (number) Blue

• (number) Alpha

Example

local r, g, b, a = fjsf.hexToRgba('#00ff00', 200)