1
0
Fork 0
forked from Simnation/Main
This commit is contained in:
Nordi98 2025-07-09 19:26:17 +02:00
parent 91f5e9d0a3
commit dda325f5ba
14 changed files with 938 additions and 127 deletions

View file

@ -2,10 +2,10 @@
A FiveM library and resource implementing reusable modules, methods, and UI elements.
![](https://img.shields.io/github/downloads/overextended/ox_lib/total?logo=github)
![](https://img.shields.io/github/downloads/overextended/ox_lib/latest/total?logo=github)
![](https://img.shields.io/github/contributors/overextended/ox_lib?logo=github)
![](https://img.shields.io/github/v/release/overextended/ox_lib?logo=github)
![](https://img.shields.io/github/downloads/communityox/ox_lib/total?logo=github)
![](https://img.shields.io/github/downloads/communityox/ox_lib/latest/total?logo=github)
![](https://img.shields.io/github/contributors/communityox/ox_lib?logo=github)
![](https://img.shields.io/github/v/release/communityox/ox_lib?logo=github)
For guidelines to contributing to the project, and to see our Contributor License Agreement, see [CONTRIBUTING.md](./CONTRIBUTING.md)
@ -14,19 +14,19 @@ For additional legal notices, refer to [NOTICE.md](./NOTICE.md).
## 📚 Documentation
https://overextended.dev/ox_lib
https://coxdocs.dev/ox_lib
## 💾 Download
https://github.com/overextended/ox_lib/releases/latest/download/ox_lib.zip
https://github.com/communityox/ox_lib/releases/latest/download/ox_lib.zip
## 📦 npm package
https://www.npmjs.com/package/@overextended/ox_lib
https://www.npmjs.com/package/@communityox/ox_lib
## 🖥️ Lua Language Server
- Install [Lua Language Server](https://marketplace.visualstudio.com/items?itemName=sumneko.lua) to ease development with annotations, type checking, diagnostics, and more.
- Install [cfxlua-vscode](https://marketplace.visualstudio.com/items?itemName=overextended.cfxlua-vscode) to add natives and cfxlua runtime declarations to LLS.
- Install [CfxLua IntelliSense](https://marketplace.visualstudio.com/items?itemName=communityox.cfxlua-vscode-cox) to add natives and cfxlua runtime declarations to LLS.
- You can load ox_lib into your global development environment by modifying workspace/user settings "Lua.workspace.library" with the resource path.
- e.g. "c:/fxserver/resources/ox_lib"

View file

@ -6,9 +6,9 @@ rdr3_warning 'I acknowledge that this is a prerelease build of RedM, and I am aw
name 'ox_lib'
author 'Overextended'
version '3.30.6'
version '3.30.10'
license 'LGPL-3.0-or-later'
repository 'https://github.com/overextended/ox_lib'
repository 'https://github.com/communityox/ox_lib'
description 'A library of shared functions to utilise in other resources.'
dependencies {

View file

@ -8,25 +8,29 @@
---@param coords vector3 The coords to check from.
---@param maxDistance? number The max distance to check.
---@param ignorePlayerId? number|false The player server ID to ignore.
---@return number? playerId
---@return number? playerPed
---@return vector3? playerCoords
function lib.getClosestPlayer(coords, maxDistance)
function lib.getClosestPlayer(coords, maxDistance, ignorePlayerId)
local players = GetActivePlayers()
local closestId, closestPed, closestCoords
maxDistance = maxDistance or 2.0
for i = 1, #players do
local playerId = players[i]
local playerPed = GetPlayerPed(playerId)
local playerCoords = GetEntityCoords(playerPed)
local distance = #(coords - playerCoords)
if distance < maxDistance then
maxDistance = distance
closestId = playerId
closestPed = playerPed
closestCoords = playerCoords
if not ignorePlayerId or playerId ~= ignorePlayerId then
local playerPed = GetPlayerPed(playerId)
local playerCoords = GetEntityCoords(playerPed)
local distance = #(coords - playerCoords)
if distance < maxDistance then
maxDistance = distance
closestId = playerId
closestPed = playerPed
closestCoords = playerCoords
end
end
end

View file

@ -59,7 +59,7 @@ end
local table = lib.table
---Loads the ox_lib locale module. Prefer using fxmanifest instead (see [docs](https://overextended.dev/ox_lib#usage)).
---Loads the ox_lib locale module. Prefer using fxmanifest instead (see [docs](https://coxdocs.dev/ox_lib#usage)).
---@param key? string
function lib.locale(key)
local lang = key or lib.getLocaleKey()

View file

@ -9,14 +9,8 @@
---@diagnostic disable: param-type-mismatch
lib.marker = {}
local defaultRotation = vector3(0, 0, 0)
local defaultDirection = vector3(0, 0, 0)
local defaultColor = { r = 255, g = 255, b = 255, a = 100 }
local defaultSize = { width = 2, height = 1 }
local defaultTextureDict = nil
local defaultTextureName = nil
local markerTypesMap = {
---@enum (key) MarkerType
local markerTypes = {
UpsideDownCone = 0,
VerticalCylinder = 1,
ThickChevronUp = 2,
@ -63,58 +57,12 @@ local markerTypesMap = {
Unknown43 = 43,
}
---@alias MarkerType
---| "UpsideDownCone"
---| "VerticalCylinder"
---| "ThickChevronUp"
---| "ThinChevronUp"
---| "CheckeredFlagRect"
---| "CheckeredFlagCircle"
---| "VerticleCircle"
---| "PlaneModel"
---| "LostMCTransparent"
---| "LostMC"
---| "Number0"
---| "Number1"
---| "Number2"
---| "Number3"
---| "Number4"
---| "Number5"
---| "Number6"
---| "Number7"
---| "Number8"
---| "Number9"
---| "ChevronUpx1"
---| "ChevronUpx2"
---| "ChevronUpx3"
---| "HorizontalCircleFat"
---| "ReplayIcon"
---| "HorizontalCircleSkinny"
---| "HorizontalCircleSkinny_Arrow"
---| "HorizontalSplitArrowCircle"
---| "DebugSphere"
---| "DollarSign"
---| "HorizontalBars"
---| "WolfHead"
---| "QuestionMark"
---| "PlaneSymbol"
---| "HelicopterSymbol"
---| "BoatSymbol"
---| "CarSymbol"
---| "MotorcycleSymbol"
---| "BikeSymbol"
---| "TruckSymbol"
---| "ParachuteSymbol"
---| "Unknown41"
---| "SawbladeSymbol"
---| "Unknown43"
---@class MarkerProps
---@field type MarkerType | number
---@field type? MarkerType | integer
---@field coords { x: number, y: number, z: number }
---@field width? number
---@field height? number
---@field color? { r: number, g: number, b: number, a: number }
---@field color? { r: integer, g: integer, b: integer, a: integer }
---@field rotation? { x: number, y: number, z: number }
---@field direction? { x: number, y: number, z: number }
---@field bobUpAndDown? boolean
@ -122,9 +70,25 @@ local markerTypesMap = {
---@field rotate? boolean
---@field textureDict? string
---@field textureName? string
---@field invert? boolean
---@param self MarkerProps
local function drawMarker(self)
local vector3_zero = vector3(0, 0, 0)
local marker_mt = {
type = 0,
width = 2.,
height = 1.,
color = {r = 255, g = 100, b = 0, a = 100},
rotation = vector3_zero,
direction = vector3_zero,
bobUpAndDown = false,
faceCamera = false,
rotate = false,
invert = false,
}
marker_mt.__index = marker_mt
function marker_mt:draw()
DrawMarker(
self.type,
self.coords.x, self.coords.y, self.coords.z,
@ -132,40 +96,19 @@ local function drawMarker(self)
self.rotation.x, self.rotation.y, self.rotation.z,
self.width, self.width, self.height,
self.color.r, self.color.g, self.color.b, self.color.a,
self.bobUpAndDown, self.faceCamera, 2, self.rotate, self.textureDict, self.textureName, false)
self.bobUpAndDown, self.faceCamera, 2, self.rotate, self.textureDict, self.textureName, self.invert)
end
---@param options MarkerProps
function lib.marker.new(options)
local markerType
if type(options.type) == "string" then
markerType = markerTypesMap[options.type]
if markerType == nil then
error(("unknown marker type '%s'"):format(options.type))
end
elseif type(options.type) == "number" then
markerType = options.type
else
error(("expected marker type to have type 'string' or 'number' (received %s)"):format(type(options.type)))
end
options.type =
type(options.type) == 'string' and markerTypes[options.type]
or type(options.type) == 'number' and options.type or nil
local self = {}
self.type = markerType
self.coords = options.coords
self.color = options.color or defaultColor
self.width = options.width or defaultSize.width
self.height = options.height or defaultSize.height
self.rotation = options.rotation or defaultRotation
self.direction = options.direction or defaultDirection
self.bobUpAndDown = type(options.bobUpAndDown) == 'boolean' and options.bobUpAndDown
self.faceCamera = type(options.faceCamera) ~= 'boolean' or options.faceCamera
self.rotate = type(options.rotate) == 'boolean' and options.rotate
self.textureDict = options.textureDict or defaultTextureDict
self.textureName = options.textureName or defaultTextureName
self.draw = drawMarker
local self = setmetatable(options, marker_mt)
self.width += 0.0
self.height += 0.0
self.width += .0
self.height += .0
return self
end

View file

@ -122,8 +122,15 @@ local function removeZone(zone)
insideZones[zone.id] = nil
table.remove(exitingZones, exitingZones:indexOf(zone))
table.remove(enteringZones, enteringZones:indexOf(zone))
local exitingIndex = exitingZones:indexOf(zone)
if exitingIndex then
table.remove(exitingZones, exitingIndex)
end
local enteringIndex = enteringZones:indexOf(zone)
if enteringIndex then
table.remove(enteringZones, enteringIndex)
end
end
CreateThread(function()

View file

@ -139,8 +139,10 @@ function SetInterval(callback, interval, ...)
repeat
interval = intervals[id]
Wait(interval)
if interval < 0 then break end
callback(table.unpack(args))
until interval < 0
until false
intervals[id] = nil
end)

View file

@ -10,7 +10,7 @@
"locale": "Sprache ändern",
"locale_description": "Aktuelle Sprache: ${language} (%s)",
"notification_audio": "Benachrichtigungs-Sound",
"notification_position": "Notification position"
"notification_position": "Benachrichtigungs-Position"
},
"position": {
"bottom": "Unten",

View file

@ -9,25 +9,25 @@
"settings": {
"locale": "Endre språk",
"locale_description": "Nåværende språk: ${language} (%s)",
"notification_audio": "Varslings lyd",
"notification_position": "Varslings posisjon"
"notification_audio": "Varslingslyd",
"notification_position": "Varslingsposisjon"
},
"position": {
"bottom": "Bunn",
"bottom-left": "Bunn-venstre",
"bottom-right": "Bunn-høyre",
"center-left": "Senter-venstre",
"center-right": "Senter-høyre",
"top": "Top",
"top-left": "Top-venstre",
"top-right": "Top-høyre"
"bottom": "Nederst",
"bottom-left": "Nederst til venstre",
"bottom-right": "Nederst til høyre",
"center-left": "Midten venstre",
"center-right": "Midten høyre",
"top": "Øverst",
"top-left": "Øverst til venstre",
"top-right": "Øverst til høyre"
}
},
"open_radial_menu": "Åpne radial menyen",
"open_radial_menu": "Åpne radialmenyen",
"cancel_progress": "Avbryt den nåværende progresjonsbaren",
"txadmin_announcement": "Server annonsering fra %s",
"txadmin_announcement": "Serverannonsering fra %s",
"txadmin_dm": "Direktemelding fra %s",
"txadmin_warn": "Du har fått en advarsel fra %s",
"txadmin_warn_content": "%s \nAction ID: %s",
"txadmin_scheduledrestart": "Planlagt Omstart"
"txadmin_scheduledrestart": "Planlagt omstart"
}

View file

@ -44,7 +44,7 @@ cache = {
if not LoadResourceFile(lib.name, 'web/build/index.html') then
local err =
'^1Unable to load UI. Build ox_lib or download the latest release.\n ^3https://github.com/overextended/ox_lib/releases/latest/download/ox_lib.zip^0'
'^1Unable to load UI. Build ox_lib or download the latest release.\n ^3https://github.com/communityox/ox_lib/releases/latest/download/ox_lib.zip^0'
function lib.hasLoaded() return err end
error(err)

View file

@ -43,4 +43,4 @@ function lib.versionCheck(repository)
end)
end
lib.versionCheck('overextended/ox_lib')
lib.versionCheck('communityox/ox_lib')

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View file

@ -5,8 +5,8 @@
<link rel="icon" type="image/svg+xml" href="/src/favicon.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>NUI React Boilerplate</title>
<script type="module" crossorigin src="./assets/index-Dk9MkoH6.js"></script>
<link rel="stylesheet" crossorigin href="./assets/index-BgkLwDpx.css">
<script type="module" crossorigin src="./assets/index-Bxswoo_8.js"></script>
<link rel="stylesheet" crossorigin href="./assets/index-SonfJNby.css">
</head>
<body>
<div id="root"></div>