Files

237 lines
7.4 KiB
Markdown
Raw Permalink Normal View History

2026-09-16 16:55:06 +05:45
![Alt Text](https://r2.fivemanage.com/H1SqBZ45uplVJGDBtNj6D/demo.png)
2026-09-16 16:51:51 +05:45
# ilv-interact
A **NoPixel 5 (NoPixel V) inspired** interaction system for FiveM.
2026-09-16 16:56:01 +05:45
Walk up to something, look at it, press **E**. No third-eye menus, no clutter – just the same minimal in-world prompts you've seen on NoPixel V. Leave Stars on Github ⭐
2026-09-16 16:51:51 +05:45
**Author:** Iloveyou.scripts
2026-09-16 16:52:19 +05:45
2026-09-16 16:51:51 +05:45
**Discord:** https://discord.gg/SYTCVXqTcs
2026-09-16 16:52:19 +05:45
2026-09-16 16:51:51 +05:45
**Tebex:** https://iloveyou.tebex.io/
2026-09-16 16:53:32 +05:45
**Streamables:** https://streamable.com/p2criy
2026-09-16 16:51:51 +05:45
---
## Features
- **Ring dots** on every nearby interaction point, so players can see everything they can interact with.
- **Crosshair hover** – a small centre-screen dot picks the in-range point closest to it. Move the camera to switch between points.
- **`[E] LABEL` prompt** in a condensed italic HUD font, drawn in-game (no NUI) so it stays locked to the world with no lag.
- **Multiple options per point** – scroll with the arrow keys or mouse wheel; the selected option carries the key badge.
- **`canInteract` filtering** – options that fail their check are hidden; points with nothing to show disappear.
- Coords, local entities, networked entities, entity bones and model-wide interactions.
- Auto-disables on death, NUI focus, in vehicles and while cuffed (configurable).
- Lightweight: ~44 KB of assets downloaded once, zero server-side work, a few sprite draws per frame.
## Installation
1. Place the folder in your resources directory and **name it `ilv-interact`** (the folder name is the resource name used by exports).
2. Make sure [ox_lib](https://github.com/overextended/ox_lib) starts first.
3. Add to your `server.cfg`:
```cfg
ensure ox_lib
ensure ilv-interact
```
## Controls
| Key | Action |
| --- | --- |
| Camera / mouse | Hover the crosshair over a point |
| `E` | Use the selected option |
| `↑` / `↓` or mouse wheel | Change option when a point has several |
## How distances work
| Field | Meaning | Default |
| --- | --- | --- |
| `distance` | How close the player must be for the **dot** to appear | `8.0` (`10.0` for networked entities / bones) |
| `interactDst` | How close the player must be for the **prompt** to appear and `E` to work | `1.0` |
| `offset` | `vec3` offset from the entity the point is placed at | `vec3(0, 0, 0)` |
---
## Options
Every export takes an `options` list. Each option supports:
```lua
{
name = 'my:option', -- optional, used by RemoveInteractionOption and to replace an existing option
label = 'Pickup Hot Dog - $25',
canInteract = function(entity, coords, args)
return true -- return false to hide this option
end,
-- Pick ONE of the following (checked in this order):
action = function(entity, coords, args) end,
serverEvent = 'my:server:event', -- TriggerServerEvent(serverEvent, args)
event = 'my:client:event', -- TriggerEvent(event, option)
args = { any = 'data' },
}
```
## Exports
All `Add*` exports take a single table. Because the resource name contains a hyphen, call exports with brackets: `exports['ilv-interact']`.
### AddInteraction
Adds a point at fixed coords. Returns the interaction id.
```lua
local id = exports['ilv-interact']:AddInteraction({
coords = vec3(55.869, -1545.9351, 29.8501),
distance = 2.0,
interactDst = 1.0,
name = 'laundromat_hack',
options = {
{
label = 'Hack Security',
event = 'sizan-robbery:client:UseBlueLaptop',
canInteract = function()
return true
end,
},
},
})
```
### AddLocalEntityInteraction
Adds a point on a client-side (non-networked) entity. Returns the interaction id.
```lua
local id = exports['ilv-interact']:AddLocalEntityInteraction({
entity = ped,
offset = vec3(0.0, 0.0, 0.3),
distance = 4.0,
interactDst = 1.5,
options = {
{
label = 'Talk',
action = function(entity)
print(('Talking to %s'):format(entity))
end,
},
},
})
```
### AddEntityInteraction
Adds a point on a networked entity. `netId` accepts a network id or an entity handle; non-networked entities fall back to `AddLocalEntityInteraction`. Returns the interaction id.
```lua
local id = exports['ilv-interact']:AddEntityInteraction({
netId = NetworkGetNetworkIdFromEntity(vehicle),
distance = 5.0,
interactDst = 1.5,
options = {
{ label = 'Search Vehicle', serverEvent = 'my:server:searchVehicle' },
},
})
```
### AddEntityBoneInteraction
Adds a point on an entity bone.
```lua
exports['ilv-interact']:AddEntityBoneInteraction({
entity = vehicle,
bone = 'boot',
distance = 3.0,
interactDst = 1.5,
options = {
{ label = 'Open Trunk', action = function(entity) SetVehicleDoorOpen(entity, 5, false, false) end },
},
})
```
### AddModelInteraction
Adds a point to every spawned object of the given models.
```lua
exports['ilv-interact']:AddModelInteraction({
modelData = {
{ model = 'p_dumpster_t', offset = vec3(0.0, 0.0, 1.0) },
{ model = 'prop_dumpster_02a', offset = vec3(0.0, 0.0, 1.0) },
},
distance = 8.0,
interactDst = 1.0,
options = {
{
label = 'Search Trash',
action = function(entity, coords, args)
SearchTrash(entity)
end,
},
},
})
```
### Removing and updating
```lua
exports['ilv-interact']:RemoveInteraction(id) -- remove by id
exports['ilv-interact']:RemoveInteractionByEntity(entity) -- remove everything on an entity
exports['ilv-interact']:RemoveInteractionOption(id, 'my:option') -- remove a single named option
exports['ilv-interact']:UpdateInteraction(id, newOptions) -- replace the options list
```
Interactions are removed automatically when the resource that created them stops.
### Disable
```lua
exports['ilv-interact']:Disable(true) -- hide and block all interactions
exports['ilv-interact']:Disable(false)
```
---
## Configuration
Everything lives in [`shared/settings.lua`](shared/settings.lua).
### Prompt
Sizes are fractions of screen height – divide the pixel size you want at 1080p by 1080.
| Setting | Default | Description |
| --- | --- | --- |
| `key` | `'E'` | Letter shown in the key badge |
| `uppercase` | `true` | Render labels in uppercase |
| `textHeight` | `0.0125` | Label cap height (~13px) |
| `keySize` | `0.0167` | Key badge size (~18px) |
| `keyTextHeight` | `0.0095` | Letter size inside the badge |
| `keyGap` | `0.0075` | Space between badge and label |
| `dotSize` | `0.0155` | Interaction dot size (~16px) |
| `crosshairSize` | `0.0055` | Crosshair dot size |
| `crosshair` | `true` | Show the crosshair while points are nearby |
| `hoverRadius` | `0.06` | How close the crosshair must be to a point to select it |
| `rowSpacing` | `0.024` | Spacing between options on the same point |
| `textColor` / `keyColor` / `keyTextColor` | white / white / near-black | RGBA colours |
| `dimmedAlpha` | `140` | Opacity of non-selected options |
| `shadowAlpha` | `110` | Label drop shadow strength (`0` to disable) |
### Disable
| Setting | Default | Description |
| --- | --- | --- |
| `onDeath` | `true` | Disable while dead |
| `onNuiFocus` | `true` | Disable while NUI has focus |
| `onVehicle` | `true` | Disable while in a vehicle |
| `onHandCuff` | `true` | Disable while cuffed |
---
## Credits & License
- Prompt font: [Barlow Condensed](https://github.com/jpt/barlow) SemiBold Italic, SIL Open Font License 1.1.
- Licensed under [CC BY-NC-SA 4.0](LICENSE).