Qbox ile QBCore Sunucularında Oyuncuların Kendi Reklam Panolarını Oluşturması

[TolgaX]

Qbox Nedir ve Nasıl Çalışır?​

Qbox, QBCore sunucularında çalışacak şekilde tasarlanmış bir “yazı‑ve‑görsel kart” sistemidir. Sahte bir billboard nesnesi oluşturur ve sahnedeki bir duvara veya kolona yerleştirilebilir. Oyuncu, ad_board adlı bir öğe veya bir komutla bu kartı yerleştirir. Kartın içeriği, basit bir metin, bir resim veya sunucunuzdaki önceden tanımlı görsellerden seçilebilir.

Enlem‑Boylam Kaydetme​

Oyuncu kartı yerleştirdiğinde, Qbox raycast ile hedef noktanın koordinatını alır ve data.json dosyasına şu yapıyla kaydeder:

{
  "id": 1,
  "x": 123.45,
  "y": -456.78,
  "z": 78.90,
  "heading": 180,
  "content": "Örnek Metin"
}

Sunucu başlatıldığında bu dosya okunur ve her kartın 3D nesnesi CreateObject ile sahneye eklenir.

Konfigürasyon Dosyası (config.lua)​

Config = {}
Config.Price = 5000          -- Kart oluşturma ücreti
Config.MaxBoards = 10        -- Sunucuda aynı anda bulunabilecek maksimum kart sayısı
Config.BoardItem = "ad_board" -- Kart yerleştirmen için gereken öğe
Config.AllowCustomImages = true

Oyuncu Kullanımı​

1. admin veya normal oyuncu olarak ilgili öğeyi elde edin (/giveitem ad_board 1).
2. /adboard komutunu girin; bir menü açılır.
3. Metin girin veya Upload Image seçeneğiyle kendi PNG'nizi seçin.
4. Place tuşuna basın; kart duvara yerleştirilir.

Admin Yönetimi​

• /deleteboardall – Tüm kartları siler
• /boardlist – Tüm kartların konumlarını listeler
• /boarddelete <id> – Belirli bir kartı siler

Örnek Senaryo​

Bir belediye resmi, oyuncuların parkta reklam panoları oluşturmasına izin verir. Oyuncu, ad_board öğesini kullanarak 1000$ ödeyerek bir pano yerleştirir. Pano, data.json içinde x,y,z,heading ile kaydedilir ve sunucu yeniden başlatıldığında otomatik olarak sahneye eklenir. Admin, deleteboardall ile turan yeni reklamları temizler.

Bu yapı, QBCore sunucularında oyuncu katılımını artırır ve gerçekçi bir reklam deneyimi sunar. Oyuncular kendi görsellerini yükleyebildiklerinde, sunucunuzda dinamik bir reklam ağı oluşturmanız mümkün olur.

Qbox ile ilgili deneyimlerinizi paylaşabilir, yeni başlayanlar için hangi ayarların kritik olduğunu tartışabilir misiniz?

İlgili konular​

• Oyunlayici ile FiveM (GTA V Roleplay) Sunucusu Kurmak
• Keyubu ile FiveM (GTA V Roleplay) Sunucusu Kurmak
• Saganetwork ile Multi Theft Auto (MTA) Sunucusu Açmak