Advanced Documentation

Custom Permission Systems

If you view your config.lua you will find a function to be defined with your permissions check. The same function is called to check for permission to receive notifications and to check if they are allowed to place new ATMs. The requests are differentiated through the type argument. It will be equal to 0 if the permissions check is to see if they can place a ATM, 1 to check if they can currently receive notifications, or 2 to check if they are allowed to initiate the stealing of an ATM, The permission check will be called on every attempted placement, every notification sent, and every attempted robbery.

Config.custom = {
    check_perms_server_side = true, -- If true the permission event will be sent out to the server side resource, this is recommended
    permissionCheck = function(source, type) -- This function will always be called server side.
        if type == 0 then -- Check for admin
            return true or false -- Return true if they have admin, return false if they don't
        elseif type == 1 then -- Check for notification perms
            return true or false -- Return true if they have permissions, return false if they don't
        elseif type == 2 then -- Check for perms to steal the ATM
            return true or false -- Return true if they have permissions, return false if they don't
        end
    end
}

If you need assistance setting this up you can hire a dev by going here and selecting “Hire a Developer”.

Developer Documentation

When an ATM is being drilled initially, the sonoran-atmrobbery::ATM::Drilling_s event will fire to the server. The data table can be seen below. Upon completion of the final drilling, if Config.permissionMode is set to ace, the event Sonoran::ATM::Payout will be fired to the server. The data table can be seen below. Example event handlers can also be found below.

Event List

Sonoran::ATM::Payout
sonoran-atmrobbery::ATM::Drilling_s

Data Table Structure For `Sonoran::ATM::Payout`

Index	Description	Example
`money`	This will be the payout amount recieved from drilling into the ATM	`14546`
`type`	This will be the type of money from the `Config.framework.reward.rewardType`	`cash`
`items`	This will contain the items the ATM gives out after drilling. Configurable in the `Config.framework.reward.Items`	`steel`

Data Table Structure For `sonoran-atmrobbery::ATM::Drilling_s`

Index	Description	Example
`street`	This will be the street name the robbery is taking place on	`Mirror Park Blvd`
`postal`	This will be the postal where the robbery is happening	`7054`
`location`	This will be the vector3 coordinates of where the ATM is being stolen	`"x":124, "y": 453, "z":30`
`atm`	This will be the hash of the ATM that is being stolen	`-156843`

Example Handler

AddEventHandler("Sonoran::ATM::Payout", function(data)
	print("Player 1 recieved $" .. data["money"] .. " in " .. data["type"] .. " along with " .. data["items"].amount .. " " .. data["items"].item)
end)

AddEventHandler("sonoran-atmrobbery::ATM::Drilling_s", function(data)
	print("An ATM with the hash " .. data["atm"] .. " is currently being stolen on " .. data["street" .. " (" .. data["postal"] .. "). Exact coordinates: ".. data["location"])
end)

Start here

General

Other

Custom Permission Systems

Developer Documentation

Event List

Data Table Structure For `Sonoran::ATM::Payout`

Data Table Structure For `sonoran-atmrobbery::ATM::Drilling_s`

Example Handler

​Custom Permission Systems

​Developer Documentation

​Event List

​Data Table Structure For Sonoran::ATM::Payout

​Data Table Structure For sonoran-atmrobbery::ATM::Drilling_s

​Example Handler

Custom Permission Systems

Developer Documentation

Event List

Data Table Structure For `Sonoran::ATM::Payout`

Data Table Structure For `sonoran-atmrobbery::ATM::Drilling_s`

Example Handler