[PHYSICS - DeleteRope]: Added Native Documentation

[JayPaulinCodes]

Summary

Added documentation to the DeleteRope native with inspiration from the DeleteEntity native due to their similar function.

Validating Example(s)

• Video showcasing the different types of ropes being spawned and deleted: https://youtu.be/hATpDNbu3bc
• Video showcasing the deleting portion of the documented Lua example: https://youtu.be/sCmscpspFIU
• Code used for the validating examples:

local rope1 = nil
local rope2 = nil

local function spawnRopeOfType(ropeType)
    -- Get the handle for the player's ped
    local pedHandle = PlayerPedId()

    -- Ensure that the rope textures are loaded
    RopeLoadTextures()
    while not RopeAreTexturesLoaded() do
        Citizen.Wait(0)
    end

    -- Get the coordinates for where the rope will be
    local ropePos = GetOffsetFromEntityInWorldCoords(pedHandle, 0.0, 2.0, 0.5)

    -- Create the rope
    local newRopeHandle = AddRope(ropePos.x, ropePos.y, ropePos.z, 0.0, 0.0, 0.0, 10.0, ropeType, 10.0, 0.0, 1.0, false, false, false, 1.0, false, 0)

    return newRopeHandle
end

RegisterCommand("deleterope_dev_spawn_1", function(soruce, args)
    rope1 = spawnRopeOfType(0)
    print("deleterope_dev_spawn_1 - post", rope1)
end)

RegisterCommand("deleterope_dev_delete_1", function(soruce, args)
    print("deleterope_dev_delete_1 - pre", rope1)
    local delResult = DeleteRope(rope1)
    print("deleterope_dev_delete_1 - post", rope1, delResult)
    rope1 = nil
end)

RegisterCommand("deleterope_dev_spawn_2", function(soruce, args)
    rope2 = spawnRopeOfType(3)
    print("deleterope_dev_spawn_2 - post", rope2)
end)

RegisterCommand("deleterope_dev_delete_2", function(soruce, args)
    print("deleterope_dev_delete_2 - pre", rope2)
    local delResult = DeleteRope(rope2)
    print("deleterope_dev_delete_2 - post", rope2, delResult)
    rope2 = nil
end)

RegisterCommand("deleterope_example", function()
    
    Citizen.CreateThread(function()
    
        -- Get the handle for the player's ped
        local pedHandle = PlayerPedId()

        -- Ensure that the rope textures are loaded
        RopeLoadTextures()
        while not RopeAreTexturesLoaded() do
            Citizen.Wait(0)
        end

        -- Get the coordinates for where the rope will be
        local ropePos = GetOffsetFromEntityInWorldCoords(pedHandle, 0.0, 2.0, 0.5)

        -- Create the rope
        local newRopeHandle = AddRope(ropePos.x, ropePos.y, ropePos.z, 0.0, 0.0, 0.0, 10.0, ropeType, 10.0, 0.0, 1.0, false, false, false, 1.0, false, 0)

        -- Delay so we can see the rope for a bit
        Citizen.Wait(1000)

        -- Check if the rope exists.
        if not DoesRopeExist(newRopeHandle) then 
            -- If the rope does not exist, end the execution of the code here.
            return 
        end
    
        -- If the rope does exist, delete the rope.
        DeleteRope(newRopeHandle)

    end)

end)

Contribution Guidelines Acknowledgement

Before you submit this PR, please make sure:

• You have read the contribution guidelines
• You include an example that validates your change
• Your English is grammatically correct

[AvarianKnight]

Some things to get the examples to work out of the box