alisizm

Alisizm Blackmarket

Alisizm Blackmarket

$5.99

Add to Basket

Türkçe Açıklama (Tebex için)

Alisizm Blackmarket, FiveM sunucuları için geliştirilmiş dinamik bir kara borsa sistemidir. Oyuncular haritadaki satıcı NPC’leri ile etkileşime girerek NUI market arayüzünden ürün satın alabilir. Script, hem QBCore hem de ESX altyapısını destekler ve sunucu ekonomisine göre kolayca özelleştirilebilir.

Öne Çıkan Özellikler

  • Dinamik satıcı sistemi: Satıcı NPC belirli aralıklarla otomatik olarak konum değiştirir (config üzerinden zaman değiştirilebilir.).
  • Modern NUI market: Kategori filtreleme, arama çubuğu, sepet, adet artır/azalt, toplu ödeme akışı.
  • Çift ödeme yöntemi: Oyuncu alışverişi nakit veya banka hesabıyla tamamlayabilir.
  • Framework desteği: qb ve esx arasında konfigürasyonla geçiş yapılabilir.
  • TextUI entegrasyonu: nation-textui için uyumlu gösterim/gizleme çağrıları içerir.
  • Görsel fallback sistemi: Ürün görselleri farklı envanter yollarında otomatik denenir (qb-inventory, ox_inventory, vb.).
  • Sunucu tarafı güvenli işlem: Satın alma doğrulaması, bakiye kontrolü, item teslimi ve hatada geri iade/rollback mekanizması (özellikle QBCore akışında).

Script Ne İşe Yarar?

Bu sistem, RP ekonomisinde yasa dışı veya premium ekipman satışını kontrollü bir şekilde yönetir. Oyuncu NPC’ye yaklaşır, etkileşim tuşuyla marketi açar, sepet oluşturur ve ödemeyi tamamlar. Sunucu tarafı callback satın alımı doğrular, para düşer ve item envantere eklenir.

Teknik Çalışma Mantığı

  • Ürün listesi ve fiyatlar config.lua içindeki CAS.Items tablosundan çekilir.
  • NUI (html/app.js) marketi açtığında ürünler dinamik oluşturulur.
  • Oyuncu “Öde” dediğinde CompleteOrder callback’i server’a gider.
  • Server (server/main.lua) siparişi normalize eder:
    • item key doğrulama,
    • count doğrulama,
    • toplam tutar hesaplama,
    • ödeme yöntemi kontrolü.
  • Framework’e göre satın alma tamamlanır:
    • QBCore: Para düşümü + item ekleme + başarısız eklemede rollback.
    • ESX: Bakiye/canCarry kontrolü + para düşümü + item ekleme.

Konfigüre Edilebilir Alanlar

config.lua üzerinden:

  • Framework seçimi (CAS.Framework)
  • Tamamlandı bildirim metni (CAS.CompleteText)
  • Etkileşim mesafesi (CAS.DrawDistance)
  • Ürün görsel yolu (CAS.ImagePath)
  • Satıcı konumları, ped modeli, text etiketi (CAS.Dealers)
  • Hareket edecek rotasyon noktaları (moveCoords)
  • Tüm ürünler, fiyatlar, tipler (CAS.Items)

Kurulum Notları

  • Resource adı alisizm-blackmarket olarak kalmalıdır (script içinde isim doğrulaması var).
  • fxmanifest.lua içinde client/server dosyaları ve NUI hazır tanımlı.
  • Framework bağımlılığı:
    • QBCore için qb-core
    • ESX için es_extended
  • Opsiyonel olarak nation-textui ile daha iyi etkileşim gösterimi sağlanır.

Kimler İçin Uygun?

  • RP sunucusunda kara borsa / gizli satıcı sistemi isteyenler
  • Ekonomiye item sink ve para dengesi eklemek isteyen yönetimler
  • QBCore veya ESX kullanan ve NUI destekli hazır bir market isteyen ekipler

English Description (For Tebex)

Alisizm Blackmarket is a dynamic black market system for FiveM servers. Players interact with dealer NPCs around the map and purchase items through a modern NUI shop interface. The script supports both QBCore and ESX, and it is easy to customize for your server economy.

Key Features

  • Dynamic dealer system: Dealer NPCs can rotate to different locations on a configurable timer (The time can be changed via the configuration file.).
  • Modern NUI shop UI: Category filters, search bar, cart system, quantity controls, and smooth checkout flow.
  • Dual payment methods: Players can pay via cash or bank.
  • Framework support: Works with both qb and esx via configuration.
  • TextUI compatibility: Built-in safe calls for nation-textui display/hide exports.
  • Image fallback logic: Automatically tries multiple inventory image paths (qb-inventory, ox_inventory, etc.).
  • Server-side purchase validation: Money checks, item validation, delivery logic, and rollback/refund handling (notably robust in QBCore flow).

What This Script Does

The system provides a controlled way to sell illegal/premium items in RP economy. A player approaches a dealer NPC, opens the market, builds a cart, and confirms payment. The server callback validates the order, removes funds, and grants items.

Technical Flow

  • Item catalog/pricing are loaded from CAS.Items in config.lua.
  • NUI (html/app.js) renders products dynamically.
  • On checkout, CompleteOrder is sent to the server.
  • Server (server/main.lua) builds a sanitized order:
    • validates item keys,
    • validates counts,
    • recalculates total price,
    • validates payment method.
  • Purchase completion by framework:
    • QBCore: remove money + add items + rollback/refund on failure.
    • ESX: balance/carry checks + remove money + add items.

Configurable Options

Via config.lua:

  • Framework selection (CAS.Framework)
  • Success notify text (CAS.CompleteText)
  • Interaction distance (CAS.DrawDistance)
  • Image base path (CAS.ImagePath)
  • Dealer definitions (coords, ped hash, display text)
  • Rotating location points (moveCoords)
  • Full item list, prices, and categories (CAS.Items)

Installation Notes

  • Keep resource name as alisizm-blackmarket (name check is enforced).
  • fxmanifest.lua already includes client/server/NUI files.
  • Framework dependency:
    • qb-core for QBCore
    • es_extended for ESX
  • nation-textui is optional but recommended for better interaction prompts.

Best For

  • RP servers needing a configurable black market/dealer system
  • Communities that want additional economy sinks and item circulation
  • QBCore/ESX servers looking for a ready-to-use NUI-based shop experience
Back to category