Jeikobu Interact

A modern, framework-independent interaction system built for FiveM servers that need a reliable, flexible and highly optimized way to handle world, entity and vehicle interactions.

Jeikobu Interact provides a complete interaction API with support for multiple target types, framework-based permissions, secure server-side actions, legacy compatibility and a built-in administration panel.

Whether you are building a small standalone server or a large-scale Qbox, QBCore, ESX or ox_core server, Jeikobu Interact gives your resources a clean and consistent interaction layer without forcing you to depend on a third-party targeting or UI resource.

✦ WHY JEIKOBU INTERACT?

• Framework-independent architecture
• Qbox, QBCore, ESX Legacy and ox_core support
• Full standalone support
• Built-in interaction UI
• Multiple world and entity target types
• Secure server-side actions
• Legacy targeting API compatibility
• Job, gang and group-based access control
• Built-in vehicle interaction support
• Configurable interaction distances and runtime limits
• Automatic cleanup when resources stop
• Multi-language support
• Built with performance and security in mind

🎯 TARGET TYPES

Create interactions exactly where and how you need them.

• Point
• Sphere
• Box
• Polygon
• Local Entity
• Network Entity
• Model
• Global Ped
• Global Player
• Global Vehicle
• Global Object

Entity interactions can also use:

• Entity bones
• Custom offsets
• Custom position resolvers
• Network entity IDs
• Model-based targeting

This allows you to create precise interactions for everything from NPCs and props to vehicle doors, trunks, bonnets and other specific entity parts.

🚗 VEHICLE INTERACTIONS

Jeikobu Interact includes an optional built-in vehicle interaction module.

When enabled, your server can provide interactions for:

• Vehicle doors
• Bonnet
• Trunk

Vehicle interactions can use specific vehicle bones and are protected by configurable distance and cooldown limits.

The vehicle module is disabled by default so servers only enable the functionality they actually need.

👥 GROUP & JOB ACCESS

Control who can see and use individual interactions.

Access rules support:

• Jobs
• Gangs
• Groups
• Minimum grades
• Any / All access modes
• Option-level permissions
• Target-level permissions

Examples:

• Police-only interactions
• Mechanic-only vehicle options
• EMS services
• Gang-controlled areas
• Admin-only interactions

Standalone servers can also provide their own player groups through the included API.

🔐 SECURE SERVER ACTIONS

Security is built directly into the interaction architecture.

Jeikobu Interact provides dedicated secure server actions with validation for:

• Player distance
• Network entities
• Entity types
• Group permissions
• Action cooldowns
• Payload size
• Payload depth
• String length
• Custom server-side validation

Sensitive operations should be handled through secure server actions rather than trusting client-side data.

Server handlers are executed only after the configured validation rules have passed.

This makes Jeikobu Interact suitable for interactions involving:

• Money
• Inventory
• Ownership
• Permissions
• Persistent data
• Other sensitive server-side operations

⚡ PERFORMANCE

Jeikobu Interact is designed around controlled scanning and runtime limits.

The system separates interaction checks from world scanning and provides configurable limits for:

• Interaction probe interval
• World scan interval
• World scan range
• Aim distance
• Aim radius
• Option cooldowns
• Maximum options per target
• Maximum visible interaction pins

Default configuration is designed to provide a balance between responsiveness and client performance.

Production limits can be adjusted depending on your server's needs.

🎯 AIM-BASED ENTITY INTERACTIONS

Entity interactions can require the player to aim directly at the target.

The system includes dedicated entity aiming logic with configurable:

• Aim distance
• Aim radius
• Entity targeting requirements

This allows interactions to behave naturally without displaying every available interaction around the player at once.

🧩 DEVELOPER API

Jeikobu Interact is designed to be integrated into other resources through a clean export-based API.

Developers can:

• Register interactions
• Remove interactions
• Update interaction options
• Enable / disable individual targets
• Enable / disable the interaction system
• Check interaction visibility
• Set player groups
• Detect the active framework
• Register secure server actions
• Remove secure server actions

Each interaction can also define:

• Custom titles
• Client events
• Server events
• Secure server actions
• Client callbacks
• Conditional visibility
• Vehicle usage behavior
• Access requirements

🔄 LEGACY COMPATIBILITY

Already using an older interaction API?

Jeikobu Interact includes compatibility support for legacy-style interaction exports and automatically converts common legacy fields.

Supported compatibility fields include:

• label
• action
• onSelect
• event
• serverEvent
• canInteract
• distance
• interactDst
• groups
• job
• bone
• bones
• offset

Legacy exports are supported directly through Jeikobu Interact, making migration easier for existing resources.

🖥️ ADMIN PANEL

Jeikobu Interact includes a built-in administration panel for configuring interaction appearance settings.

The panel can be opened with:

/interactadmin

Admin access can be controlled through:

• ACE permissions
• Framework permissions
• Qbox
• QBCore
• ESX
• ox_core

The dedicated ACE permission is:

jeikobu_interact.admin

The system supports both ACE and framework-based authorization, allowing server owners to choose the permission method that fits their server.

🌍 FRAMEWORK SUPPORT

Jeikobu Interact supports:

• Qbox
• QBCore
• ESX Legacy
• ox_core
• Standalone

Automatic framework detection is included.

When using automatic detection, the resource checks frameworks in the following order:

Qbox → QBCore → ESX → ox_core → Standalone

An explicit framework can also be selected through the configuration.

🌐 MULTI-LANGUAGE

Built-in language support includes:

• English
• Turkish
• German
• Spanish
• Arabic

Individual texts can also be overridden without modifying the original language files.

⚙️ CONFIGURATION

A centralized configuration system gives server owners control over:

• Framework selection
• Language
• Key bindings
• Interaction distances
• Scan intervals
• Runtime limits
• Cooldowns
• Entity aiming
• Player state restrictions
• Vehicle interactions
• Security limits
• Admin permissions
• Admin appearance limits

Interactions can also be temporarily disabled automatically when the player is:

• Dead
• Using NUI
• Cuffed
• Inside a vehicle

📦 REQUIREMENTS

• FiveM Server
• Current FiveM Server Artifact
• OneSync

Framework support is optional.

Supported frameworks:

• Qbox
• QBCore
• ESX Legacy
• ox_core

Standalone servers require no framework.

❌ NO THIRD-PARTY TARGETING REQUIRED

Jeikobu Interact does not require a third-party targeting, UI or utility resource.

The interaction system, UI and core functionality are included within the resource itself.

🔧 INSTALLATION

1. Extract the resource into your server's resources folder.
2. Keep the resource folder name as jeikobu_interact.
3. Configure Config.Framework if required, or use automatic detection.
4. Make sure OneSync is enabled.
5. Start Jeikobu Interact after your framework when using Qbox, QBCore, ESX or ox_core.
6. Configure the resource through config.lua.
7. Restart your server.

Example:

ensure qbx_core
ensure jeikobu_interact

🛡️ SECURITY NOTES

Client-side data should never be trusted for sensitive operations.

When creating integrations involving money, inventory, permissions, ownership or persistent data, use the included secure server action system and perform the necessary server-side validation.

Keep Config.Debug disabled on production servers.

📚 DOCUMENTATION

The resource includes API documentation covering:

• Interaction registration
• Target definitions
• Options
• Access control
• Secure server actions
• Legacy compatibility
• Interaction context
• Available exports

💬 SUPPORT

Need help with installation, configuration or integration?

Contact GOD Studios through our official support channels.

We provide support for the resource, installation and configuration-related issues.

Jeikobu Interact

A flexible interaction foundation for modern FiveM servers.

One interaction system. Multiple frameworks. Full control.