demigod916 / object_gizmo

Object Gizmo Module

This module exports a useGizmo function that enables manipulation of entity position and rotation.

Installation

1. Download the object_gizmo resource.
2. Extract the object_gizmo folder into your server's resources directory.
3. Add start object_gizmo to your server's server.cfg file.

Export

exports.object_gizmo:useGizmo(handle)

Usage

Ensure the object_gizmo module script is running on your server.

The useGizmo export can be used in any Lua script on the client side as follows:

local handle = --[[Your target entity]]
local result = exports.object_gizmo:useGizmo(handle)

result will contain the entity handle, final position, and final rotation.

Test Command

This module includes a test command testGizmo that demonstrates how to use the gizmo.

The command creates an object at the player's location and then activates the gizmo for that object.

local model = `prop_mp_cone_02`
RegisterCommand('testGizmo', function()
    local offset = GetEntityCoords(cache.ped) + GetEntityForwardVector(cache.ped) * 3
    lib.requestModel(model)
    local obj = CreateObject(model, offset.x, offset.y, offset.z, false, false, false)
    local data = exports.object_gizmo:useGizmo(obj)

    lib.print.info(data)
end)

Controls

While using the gizmo, the following controls apply:

• [W]: Switch to Translate Mode
• [R]: Switch to Rotate Mode
• [S]: Switch to Scale Mode (if enabled)
• [Q]: Switch between Relative and World
• [LAlt]: Snap To Ground
• [Enter]: Finish Editing

The current mode (Translate/Rotate) will be displayed on the screen.

Note

The gizmo only works on entities that you have sufficient permissions to manipulate. Make sure you have the correct permissions to move or rotate the entity you are working with.

object_gizmo's Issues

[Bug] Set on ground

When set on ground, the gizmo do not follow sadly.

[Feature] UI showing the Coords

Possibly a UI that shows the Coordinates and Rotation being able to put in coordinates that's configurable to toggle on and off in the config or keybinding

[Feature] export setCoords, setRotation, setGround, getCoords

Exports you can send over manually added data like Coords, rotation, ground, and then get coords of an object.

[Feature] Move Camera

Move camera and ped while placing props like dolu tools

[Feature] export to alter object

This might be possible already but alter a already placed object in the world.