Best Buds - Weed Store (Only Map)

The resource includes the interior, elevator, doors, panels and chairs, with its own configuration and standalone operation.

1. Extract the ZIP into a new folder named tiutoxico_weed inside resources, preserving the resource name.
2. OneSync is required. No framework is mandatory. If you use ox_target, start it before the resource: it is detected automatically (modo = 'auto'). Without it the script uses marker mode.
3. Edit config.lua (texts, keys, hooks, volumes), locales/ and bridges/ as needed. Before starting, set private four-digit passwords in passwords.lua.
4. Add ensure tiutoxico_weed to your server.cfg and start the resource. After any change: restart tiutoxico_weed.

When updating, back up the current folder and preserve your configuration, passwords and integrations.

The map starts with standard lighting. The same package includes optional files to enable performance mode or restore the original lighting.

All paths below are inside the tiutoxico_weed folder. Each optional folder contains these five files:

tiutoxico_weed_floorlight.ydr
tiutoxico_weed_floorlight_vol.ydr
tiutoxico_weed_int_proxy_green.ydr
tiutoxico_weed_growrig.ydr
tiutoxico_weed_tunel_2.ydr

How to enable performance mode

1. Stop the server and back up the five current files from stream/[addon]/, keeping the copies outside stream.
2. Open optional/performance/ and copy the five files into stream/[addon]/, replacing the files with matching names.
3. Start the server and have players reconnect to load the new files.

How to restore standard mode

With the server stopped, copy the five files from optional/original/ into stream/[addon]/, replacing the files with matching names. Start the server and have players reconnect.

This switch does not change your settings, passwords or scripts.

How players use the panels and the cabin screen.

How marker mode works

On the floor in front of each panel a marker is drawn. Standing on it, the prompt with the key and text appears (E Access); press the key and the keypad opens as usual. The prompt is a small on-screen card pinned to the marker; colours and size come from marcador.fundo / tecla / texto / escala. On the cabin screen the options follow the state: Open only with the door closed, Up or Down depending on where the cabin is.

Built-in notifications — Config.Notification

By default, the resource displays its own on-screen notifications. In config.lua, adjust the position, display duration and visible count:

Config.Notification = {
    position = 'top-right',
    durationMs = 4200,
    maxVisible = 4,
}
Config.Notificar = nil -- Uses the built-in notification

Titles and the accessible name use notificacao = { success, error, info, region } in the language file under locales/ selected by Config.Locale. Customize them through Config.Textos.notificacao; you can override only the keys you need. Message bodies remain in the corresponding Textos.avisos entries.

Config.Notificar(texto, tipo)

Optional adapter called on the client for every notification. tipo is 'sucesso', 'erro' or 'info'. Leave Config.Notificar = nil to use the built-in default, or choose one of the examples below to use your system:

-- ox_lib
Config.Notificar = function(texto, tipo)
    lib.notify({ description = texto, type = (tipo == 'erro') and 'error' or (tipo == 'sucesso') and 'success' or 'inform' })
end
-- ESX
Config.Notificar = function(texto, tipo) ESX.ShowNotification(texto) end
-- QBCore
Config.Notificar = function(texto, tipo)
    QBCore.Functions.Notify(texto, (tipo == 'erro') and 'error' or 'success')
end
-- Classic vRP (Proxy)
Config.Notificar = function(texto, tipo)
    local Proxy = module('vrp', 'lib/Proxy')
    local vRP = Proxy.getInterface('vRP')
    vRP.notify({texto})
    return true
end

If the adapter returns nil (including no return) or true, the notification is considered handled and the built-in notification is not displayed. Return false to display the built-in notification. If the function fails, the resource records a diagnostic and displays the built-in notification.

To choose the classic vRP (Proxy) example, start vrp before this resource and add '@vrp/lib/utils.lua' before 'config.lua' in the shared_scripts block of fxmanifest.lua. This loads module, which the adapter uses. The notification uses the presentation provided by your vRP base; to use your city's custom notification system, replace vRP.notify({texto}) with that system's API or event. The example passes arguments in a table, following the official Proxy reference; vRP2 and forks with different APIs require adaptation.

The screen texts (ZONA, CLIMA, AUTO, SUCCESS...) live in Config.paineis.textos, below.

An open door always closes by itself after 10 s, with or without people inside; from inside, the screen offers Open to reopen it.

Six panels in the map (two call the elevator, two on the vault door, two on the secret door) plus the cabin screen. Doors: vault and secreta.

textos — what is written on the screens (disguise)

The default pretends to be an air-conditioning panel: no “elevator” or “vault” in sight.

Chairs in the map can be sat on, with the same interaction as the panels: target with ox_target, or the floating prompt with the key in marker mode. While seated, a discreet card in the screen corner shows the keys: F stands up and H changes the pose (seven poses); with ox_target, Stand up and Change pose also appear in the target menu. Each chair takes one person at a time. Texts, keys, poses and extra seats are configurable. See Optional seated interaction integration.

Replace each CHANGE_ME with a private password of 4 digits as a string (keeps leading zeros, preserve any leading zero).

ConfigServer.senhas = {
    elevador = 'CHANGE_ME',   -- elevator call panels (top and bottom)
    vault    = 'CHANGE_ME',   -- vault door panels (inside and outside)
    secreta  = 'CHANGE_ME',   -- secret door panels (inside and outside)
}

Functions you write and the script calls at the important moments. Those starting with pode decide: return false to deny (the player gets Textos.avisos.negado). Those starting with ao only notify. Permission hooks must return true explicitly; false, nil or errors deny the operation. The ao... hooks notify and never grant access.

Server (Config.Hooks)

Client (Config.HooksCliente)

Examples: panel access by job or permission

Choose one permission adapter and apply it in bridges/server.lua. ESX and QBCore check the 'weed' job; for classic vRP, add the 'weed.acesso' permission to authorized groups or replace it with your base's permission. For vRP, also follow the @vrp/lib/utils.lua and start-order setup in Texts and notification. Forks using Passport, HasGroup or getUserId with direct arguments require adapting these calls.

-- ESX
Config.Hooks.podeUsarPainel = function(src, painelId, painel)
    local xPlayer = exports['es_extended']:getSharedObject().GetPlayerFromId(src)
    return xPlayer and xPlayer.job.name == 'weed'
end
-- QBCore
Config.Hooks.podeUsarPainel = function(src, painelId, painel)
    local Player = exports['qb-core']:GetCoreObject().Functions.GetPlayer(src)
    return Player and Player.PlayerData.job.name == 'weed'
end
-- Classic vRP (Proxy, server only)
local Proxy = module('vrp', 'lib/Proxy')
local vRP = Proxy.getInterface('vRP')
Config.Hooks.podeUsarPainel = function(src, painelId, painel)
    if not src then return false end
    local user_id = vRP.getUserId({src})
    return user_id ~= nil and vRP.hasPermission({user_id, 'weed.acesso'}) == true
end
-- log wrong passwords
Config.Hooks.aoSenha = function(src, painelId, acertou)
    if not acertou then print(('player %d failed the password on %s'):format(src, painelId)) end
end

To tie the script to your own resources without editing it.

Events fired by the script

-- in another resource (server)
AddEventHandler('tiutoxico_weed:tranca', function(porta, trancada, src)
    print(('door %s %s'):format(porta, trancada and 'locked' or 'unlocked'))
end)

Exports — server

Exports — client

-- server: unlock the vault from your own item or command
exports['tiutoxico_weed']:TrancarPorta('vault', false)
-- client: open the top panel keypad
exports['tiutoxico_weed']:AbrirTeclado('elev_cima')

Chair keys are set in Config.sentar.controls: F stands up (stand) and H changes pose (pose). The optional integration coordinates these transitions with an external smoking system.

To integrate tiutoxico_narguile, check Config.Hookah.resource = 'tiutoxico_narguile' in this resource; false disables the integration. The public adapter is bridges/hookah.lua. In the integrated resource, Config.Cooperation.seating.resource should point to tiutoxico_weed; state lets you adapt the state lookup. Smoke/drop/take-hose keys belong to that resource's Config.Hookah.controls (smoke/drop/takeHose), with defaults of E/X/G. Check for conflicts with your city's custom key mappings.

An active chair/panel interaction takes priority with E and interrupts the puff until E is released. Standing/changing pose suspends smoking during transitions without dropping the hose. Smoking uses an upper-body animation over the seated pose.

This resource's client export SeatState() exposes seated/busy/controls/transitionUntil/interacting. The adapter queries HookahInteractionState(), falls back to HookahHoseInHand() and calls HookahSuspendSmoking(ms) on the configured resource. Config.Hookah.suspendMs sets the suspension interval, defaulting to 700 ms.

Config.Locale = 'pt-br' selects PT-BR; en/es/template are in locales/. Copy template for another language, translate values and preserve keys/placeholders %d, {seconds}, {digit}. Config.Textos recursively overrides locale; Config.paineis.textos and textosPorPainel override panel text, including NUI instructions, states, buttons, titles and accessible names.

Config.Systems enables elevator/panels/doors/seating. Config.Buckets = { policy='single', allowedBucket=0 } selects one allowed bucket for MLO state; it does not create independent instances. Other buckets and missing peds are denied. OneSync is required for authoritative position/passenger checks.

Config.Elevator: travelTimeMs, doorOpenMaxMs, cabinVolume, doorVolume. Config.categories supplies higher-priority advanced overrides. Property tables merge recursively; numeric lists replace the whole list. Config.sentar: cadeiras, animacoes, raio, controls and extraSeats with id/model/pos in the server catalogue. Reservations use leaseMs=15000/renewMs=4000; position, death, bucket and expiry are checked. Do not use arbitrary IDs outside the catalogue.

bridges/target.lua adapts target (default ox_target), with paired addition/removal. Config.Interacao.targetResource selects it; auto falls back to markers and reattaches after restart. Config.Doorlock.mode: internal/bridge/disabled. In bridge mode implement WeedDoorlock.Apply(id, locked, definition) and return true only after success; the false default does not control external doors. Avoid two systems owning a door.

bridges/server.lua adapts server-only permissions. Explicit true passes the hook without bypassing ped, bucket, proximity, password/cabin or rate checks. Client elevator calls require a validated cabin passenger; outside use password panels. Server exports are trusted: never relay them through unauthorized public events.

ChamarElevador(chave, andar) accepts an optional key and optional destination from configuration. Event tiutoxico_weed:chamada: src/chave/andar. Elevator/door exports use the allowed bucket's single state. Doors receive current state when returning to range.

Config.Logging.errors controls operational errors; dedupeMs=60000 reduces repetition. Config.Diagnostics = {enabled=true, handler=nil} translates/routes technical messages: handler(key, detail) returns true when handled; errors/other returns retain the default diagnostic. It does not log every key or reveal passwords. These logs differ from optional audits implemented through hooks.