Custom APPs

Custom APPs are only available for customers who bought the complete laptop bundle, if you don't own it please ignore this guide.

Startup order

## Make sure to start ox_lib and your framework first.
ensure ox_lib
ensure your_framework

ensure av_laptop
ensure av_apps
## your custom app(s):
ensure app_template

Restart Order

## When testing in game you probably will need to restart your custom app
## To do this you will need to restart the scripts in the following order:
ensure av_laptop
ensure av_apps
ensure your_custom_app

Other Info

# Plase DON'T try to register a custom APP using av_laptop files
# You need to create your own resource folder and register the app from there,
# that's why a template exists so u can copy/paste and add all the apps u want

For React TS template:
Navigate to app_template/ui folder using your terminal.
Run command yarn to install dependencies.
Once all dependencies are fully loaded run yarn dev to start the project.
To build just run command yarn build or yarn build --w

If you don't want to build an APP but just to trigger a website to be shown in the laptop window, make sure to follow the template from config/_config.lua:

local resourceName = GetCurrentResourceName()
Config = {}
Config.App = { -- This config will open a website, you don't need the UI folder at all
    name = "template", -- You can modify this just make sure don't use duplicated app names
    label = "App Template", -- You can modify this
    resource = resourceName, -- don't modify this
    icon = resourceName..'/icon.png', -- don't modify this?
    website = "https://uwucatcafe.com/", -- custom website
    isEnabled = function()
        -- this check runs when the player opens the laptop, return true/false to enable/disable app
        return true
    end
}

If you don't want to open any window in laptop but you want to trigger an event from an external resource you can trigger a NUI Callback, check the config from config/_config.lua:

local resourceName = GetCurrentResourceName()
Config = {}
Config.App = { -- This config will trigger a NUIEvent (check client/nui/example)
    name = "template", -- You can modify this just make sure don't use duplicated app names
    label = "App Template", -- You can modify this
    resource = resourceName, -- don't modify this
    icon = resourceName..'/icon.png', -- don't modify this?
    event = "doSomething", -- trigger a nui event
    isEnabled = function()
        -- this check runs when the player opens the laptop, return true/false to enable/disable app
        return true
    end
}

This will trigger the NUI Callback from client/nui/example.lua

RegisterNUICallback("doSomething", function(data,cb)
    TriggerEvent("av_laptop:notification", Config['app_title'], "Event triggered from laptop", "success")
    cb("ok")
end)

The resource where the NUI callback is located needs to be the same resource that is used to register the APP using the registerApp export from client/editable/app.lua

Note: If you choose to just trigger a nui event you can delete the UI folder and all ui references from fxmanifest.lua

I don't provide any support for custom APPs, if you don't know how React or JS works, please hire a dev from Fiverr or any other platform, I won't do any custom commission at all, refrain from opening a ticket about custom apps.

Last updated 2 months ago