🤝nova_interactions

NOVA Framework player and vehicle interaction system. Provides contextual actions for player-to-player and player-to-vehicle interactions.

Features

• Rob Player — Hold up and rob another player (timed action)

• Loot Inventory — Loot a downed player's inventory

• Give ID — Show your ID card to another player

• Give Keys — Hand over vehicle keys to another player

• Vehicle Lock — Lock/unlock your vehicle

• Open Trunk — Access vehicle trunk inventory

Configuration

Edit config.lua:

Config.PlayerDistance = 2.0      -- Max distance for player interactions
Config.VehicleDistance = 3.0     -- Max distance for vehicle interactions
Config.RobTime = 10000          -- Rob duration (ms)
Config.LootTime = 5000          -- Loot duration (ms)
Config.PushForce = 50.0         -- Vehicle push force

Configuration Options

Option	Type	Default	Description
PlayerDistance	number	2.0	Max range for player interactions
VehicleDistance	number	3.0	Max range for vehicle interactions
RobTime	number	10000	Duration of rob action (ms)
LootTime	number	5000	Duration of loot action (ms)
PushForce	number	50.0	Force applied when pushing vehicle

Player Interactions

Rob Player

• Target a player using nova_target

• Progress bar runs for RobTime duration

• On success, opens the target's inventory for item selection

• Victim receives a notification

Loot Inventory

• Target a downed player

• Progress bar runs for LootTime

• Opens the victim's inventory

Give ID / Give Keys

• Quick actions via target menu

• Transfers ID card display or vehicle keys to the target player

Vehicle Interactions

Lock/Unlock

• Target your own vehicle

• Toggles lock state with key animation

• Uses nova_core vehicle keys system

Open Trunk

• Target vehicle trunk area

• Opens a separate inventory for the trunk

Dependencies

• nova_core — Player data, vehicle keys

• nova_target — Targeting system for interaction menus

• nova_inventory — Item transfer, trunk system

Notes

• Rob action requires the victim to have their hands up or be restrained

• Vehicle key transfers are validated server-side

• Trunk inventory is separate from player inventory

• All interactions use nova_target for the context menu

Security

• All actions are validated server-side with permission checks

• Event names and internal implementation details are not disclosed in this documentation for security purposes

• Unauthorized access attempts are logged