Owned Shops - Exports & Events - SMX Docs
SMX logo

SMX Documentation

Production-grade Script Knowledge Base

Build 2026.04 Live Docs



Owned Shops

Job Scripts · FiveM Ready

API Design Notes

Pattern: External integration is event-first. Public exports are not provided as stable integration API in this build.

Commands and Quick Actions

/shopcreator

Open creator panel (permission-gated).

Scope: Client CommandAuth: Required
/deliverycancel

Cancel active delivery/restock operation and clean local mission state.

Scope: Client CommandUse: Recovery
/canceldelivery

Alias to /deliverycancel.

/lieferungabbrechen

Alias to /deliverycancel.

/pickupcancel

Alias to /deliverycancel.

Most Important Server Events

smx-ownedshops:requestOpenShop

Fetches and opens shop UI payload for a given type/id.

Direction: C -> SParams: shopType, shopId
smx-ownedshops:buyItem

Processes item purchase with stock, carry and payment checks.

Direction: C -> SParams: shopType, shopId, item, category, amount, itemType, payment
smx-ownedshops:buyShop

Purchases shop and initializes owner/staff/upgrades baseline state.

Direction: C -> SParams: shopId, payment
smx-ownedshops:requestOwnerPanel

Loads owner panel data including finance, stock, staff and upgrades.

Direction: C -> SParams: shopId
smx-ownedshops:startDelivery

Creates delivery mission from supplier job selection.

Direction: C -> SParams: shopId, itemName, jobId
smx-ownedshops:completeDeliveryMission

Validates and finalizes delivery mission rewards/stock updates.

Direction: C -> SParams: missionId
smx-ownedshops:reorderItem

Places direct restock or pickup-based restock order.

Direction: C -> SParams: shopId, itemName, amount, method
smx-ownedshops:purchaseUpgrade

Buys next level of storage/truck/maxJobs/restock upgrade track.

Direction: C -> SParams: shopId, upgradeType

Client Push Events

smx-ownedshops:openShopUi

Open buyer-facing shop interface with payload.

smx-ownedshops:openOwnerPanel

Open owner management UI payload.

smx-ownedshops:openDeliveryJobs

Open supplier delivery jobs view.

smx-ownedshops:startDeliveryMission

Client receives mission coordinates/vehicle model and begins route flow.

smx-ownedshops:startRestockPickup

Client receives pickup mission state for stock acquisition.

smx-ownedshops:syncOwnedState

Synchronizes ownership and shop runtime state to current player.

smx-ownedshops:syncRuntimeConfig

Synchronizes creator runtime config overrides.

smx-ownedshops:notify

Displays typed user notification.

NUI Callback Surface

buyItem

Bridges UI checkout to server purchase logic.

buyShop

Bridges UI shop purchase to server ownership logic.

ownerDeposit / ownerWithdraw

Bridges finance actions to owner account operations.

startDelivery / reorderItem

Bridges operational logistics actions.

addEmployee / updateEmployee / removeEmployee

Bridges staff management actions.

saveRoleProfile / deleteRoleProfile

Bridges role-profile management actions.

createSupplierJob / updateSupplierJob / deleteSupplierJob

Bridges supplier job management actions.

creatorUpsert* / creatorDelete* / creatorSaveSettings

Bridges creator panel CRUD and settings operations.