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.

1MB

app_template.zip

archive

unzip and install like any other resource

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

Custom APPs

• 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

Using Websites

• 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
}

NUI Events

• 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 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.