Skip to main content

DistanceBetweenCoords3d

Description​

Returns the 3D distance between two coordinate points, taking into account the X, Y, and Z values.

function DistanceBetweenCoords3d(x1, y1, z1, x2, y2, z2) --[[ ... ]] end

Parameters​

  • x1: number - X coordinate of the first point.
  • y1: number - Y coordinate of the first point.
  • z1: number - Z coordinate of the first point.
  • x2: number - X coordinate of the second point.
  • y2: number - Y coordinate of the second point.
  • z2: number - Z coordinate of the second point.

Return Values​

None.

Example​

function main()
    print("Creating character and monitoring distance...")
    
    -- Get position 1 meter in front of the player
    local char_x, char_y, char_z = PedGetOffsetInWorldCoords(gPlayer, 0, 1, 0)
    
    -- Create a character at that position (model ID 75)
    local character = PedCreateXYZ(75, char_x, char_y, char_z)
    
    print("Character created at position: (" .. char_x .. ", " .. char_y .. ", " .. char_z .. ")")
    
    -- Continuous distance monitoring loop
    while true do
        -- Get player's current position
        local player_x, player_y, player_z = PedGetPosXYZ(gPlayer)
        
        -- Get character's current position
        local char_x, char_y, char_z = PedGetPosXYZ(character)
        
        -- Calculate 3D distance between player and character
        local distance = DistanceBetweenCoords3d(player_x, player_y, player_z, char_x, char_y, char_z)
        
        print("Distance between player and character: " .. string.format("%.2f", distance) .. " meters")
        
        -- Example distance checks
        if distance < 2.0 then
            print("Character is very close to player")
        elseif distance < 5.0 then
            print("Character is nearby")
        else
            print("Character is far from player")
        end

        Wait(1000)
    end
end

See Also​