8000
Skip to content

czmenz/cz_targetX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cz_targetX

A clean and modern 3D world-positioned targeting system for FiveM.
Lightweight. Expandable. Developer-friendly.


✨ Features

  • 🎯 Floating 3D world UI
  • 📚 Multiple stacked targets
  • 🔄 Dynamic expand animation
  • 🧩 Export support for other resources
  • 🔔 Optional GitHub update checker
  • 🧠 Optimized performance logic

🧱 Framework

  • ✅ Standalone

📦 Installation

  1. Place resource in:
resources/cz_targetX
  1. Add to server.cfg:
ensure cz_targetX
  1. Run:
refresh
start cz_targetX

⚙️ Configuration

File: config.lua

Config.BuildId = "1.0.0" -- Never change this setting
Config.CheckForUpdates = true

Config.DefaultButtonId = 38
Config.DefaultDrawDistance = 15.0
Config.DefaultInteractDistance = 2.0

Config Notes

  • DefaultButtonId: fallback key if target does not define buttonId (38 = E)
  • DefaultDrawDistance: prompt visibility range
  • DefaultInteractDistance: key interaction range
  • CheckForUpdates: true / false
  • BuildId: used for release comparison (do not modify)

🧩 Exports

AddTarget(id, data)

exports.cz_targetX:AddTarget("example_target", {
    coords = vec3(0.0, 0.0, 0.0),
    label = "Example"
})

UpdateTarget(id, data)

exports.cz_targetX:UpdateTarget("example_target", {
    label = "New label"
})

RemoveTarget(id)

exports.cz_targetX:RemoveTarget("example_target")

📄 Target Data

Field Type Required Description
coords vector3 World position
label string Display text
drawDistance number Visibility range
interactDistance number Interaction range
buttonId number Key control
event string Trigger event
eventType string "client" or "server"
args any Custom arguments

🎨 UI Design Philosophy

  • Clean minimal 3D layout
  • Soft expand animation on active target
  • Slight glow on selected row
  • Button left, text right
  • No over-designed effects
  • Performance-first logic

📜 License & Usage Rules

This project is open source for learning, modifying, and use on servers.

✔ You are allowed to:

  • Use it in private/public servers
  • Modify it for your own needs
  • Share improvements with credit

❌ You are not allowed to:

  • Sell this resource (original or modified)
  • Reupload and claim authorship
  • Remove original author credit

Author: Czmenz

About

3D World Dynamic Targeting system supporting any framework available.

Topics

Resources

Stars

Watchers

Forks

Contributors

0