Dokumentation

# Framework (nur das, was du verwendest)
ensure oxmysql
ensure es_extended          # oder qb-core

# Optional: ox_inventory, qs-inventory, etc.
ensure ox_inventory

# Nebula — genau in dieser Reihenfolge!
ensure nebula_core
ensure nebula_notify
ensure nebula_shop

-- Send notification
exports['nebula_notify']:Notify('Purchase successful!', 'success', 3500)
exports['nebula_notify']:Notify('Not enough money.', 'error', 4000)

-- TextUI interaction hint
exports['nebula_notify']:TextUI('~INPUT_CONTEXT~ Open Shop')
exports['nebula_notify']:HideTextUI()

NebulaCore = {}

-- Debug output in server console (set false in production!)
NebulaCore.Debug = true

NebulaCore.Price = {
  Enabled = true,          -- Enable dynamic pricing?
  Scope   = 'global',      -- 'global' = shared price across shops
                              -- 'shop'   = each shop has its own price
  UpdateIntervalSeconds = 60,  -- How often prices are recalculated
  MaxStepPercent  = 0.15,    -- Max 15% price change per update
  RandomRange     = 0.08,    -- ±8% random market fluctuation
  DemandWeight    = 0.35,    -- Influence of purchase demand (last hour)
  DefaultTrend    = 1.0
}

NebulaCore.Security = {
  MaxPurchasesPer10s = 50,  -- Rate limiting: max purchases in 10 seconds
  MaxQtyPerTxn       = 200, -- Max quantity per single purchase
  LockTimeoutMs      = 500  -- Minimum pause between purchases (ms)
}

NebulaCore.Logging = {
  DiscordWebhook = '',      -- Discord webhook URL for purchase logs
  LogPurchases   = true,
  LogSuspicious  = true
}

NebulaShop = {}

NebulaShop.OpenKey          = 38    -- E key to open shop
NebulaShop.DrawDistance     = 15.0  -- Marker visible from this distance
NebulaShop.InteractDistance = 2.0   -- Interaction hint at this distance

NebulaShop.Shops = {
  {
    key    = '247_grove',        -- Unique key (must be unique!)
    name   = '24/7 (Grove)',
    type   = 'shop',
    coords = vector3(25.7, -1346.6, 29.5),
    marker = { enabled = true, type = 2, scale = 0.65 },
    blip   = { enabled = true, sprite = 52, scale = 0.75, colour = 2, label = '24/7' },
    items  = {
      { name = 'bread', label = 'Bread', base_price = 50, min_price = 30, max_price = 120, tax = 0.05 },
      { name = 'water', label = 'Water', base_price = 35, min_price = 20, max_price = 100, tax = 0.05 },
    }
  },

  -- Black market example (no blip, hidden location)
  {
    key    = 'black_market_grove',
    name   = 'Black Market',
    type   = 'shop',
    coords = vector3(318.6, -197.5, 53.5),
    marker = { enabled = true, type = 2, scale = 0.5 },
    blip   = { enabled = false },  -- No blip on the map!
    items  = {
      { name = 'weed_brick', label = 'Weed', base_price = 800, min_price = 500, max_price = 1800 },
    }
  },
}

-- Get current price of an item
local price = exports['nebula_core']:getPrice('bread', shopId)

-- Ensure/create a shop (returns shopId)
local shopId = exports['nebula_core']:dbEnsureShop({ name = 'My Shop', ... })

-- Register/update an item in the database
exports['nebula_core']:dbUpsertItem({ name = 'bread', label = 'Bread', base_price = 50, ... })

-- Assign item to a shop
exports['nebula_core']:dbUpsertShopItem(shopId, 'bread', { stock_mode = 'infinite' })

-- Get all items of a shop
local items = exports['nebula_core']:dbGetShopItems(shopId)

-- Calculate price via pricing engine
local price = exports['nebula_core']:pricingGetPrice('bread', shopId)