Kurulum ve bağlantı

Bu sayfa, FiveM sunucunun https://fivem.nodx.org paneline doğru bağlandığını kontrol etmek için kullanılır.

Plugin’i sunucuya kur

Satın alma ve hesap aktivasyonu tamamlandıktan sonra Panel’e giriş yap. Plugin sayfasından sunucuna özel plugin paketini indir.

Plugin paketini indir

Panelde doğru sunucuyu seç, Plugin sayfasını aç ve güncel paketi indir.

Resource klasörüne yükle

İndirdiğin paketin içindeki nodx-fivem-panel klasörünü FiveM sunucunun resources klasörüne yükle.

Config bilgilerini kontrol et

nodx-fivem-panel/config.lua dosyasındaki API adresi, lisans ve Server ID alanlarını kontrol et.

server.cfg satırlarını ekle

Aşağıdaki örneği kendi server.cfg dosyana ekle.

Resource'u başlat

Sunucuyu yeniden başlat veya konsolda ensure nodx-fivem-panel komutunu çalıştır.

Klasör adı nodx-fivem-panel olarak kalmalıdır. Klasör adını değiştirirsen ensure ve ACE izinlerindeki resource adı da eşleşmez.

config.lua nasıl doldurulur?

Panelden sunucuna özel indirilen plugin paketinde Lisans Anahtarı ve Server ID otomatik doldurulmuş olabilir. Genel Tebex paketini kullanıyorsan bu değerleri Panel’deki Plugin veya Sunucu sayfasından alarak kendin girmelisin.

Config = {}
Config.ApiUrl = 'https://fivemapi.nodx.org'
Config.PublicApiUrl = Config.ApiUrl
Config.LicenseKey = 'PANELDEN_ALDIĞIN_LİSANS'
Config.ServerId = 'PANELDEN_ALDIĞIN_SERVER_ID'
Config.Framework = 'auto'

Alan	Kullanılacak değer
`Config.ApiUrl`	`https://fivemapi.nodx.org`
`Config.PublicApiUrl`	Canlı görüntü için oyuncuların erişebileceği API adresi; varsayılan değer doğru
`Config.LicenseKey`	Panelde seçili sunucuya ait lisans anahtarı
`Config.ServerId`	Panelde seçili sunucunun benzersiz Server ID değeri
`Config.Framework`	Otomatik algılama için `auto`; gerekirse `qb`, `esx` veya `standalone`

Lisans anahtarını başka biriyle paylaşma ve aynı lisansı birden fazla FiveM sunucusunda kullanma. Her lisans yalnızca bağlı olduğu Server ID ile çalışır.

server.cfg nasıl doldurulur?

NODX resource’unu framework, veritabanı ve envanter gibi temel resource’lardan sonra başlat. Canlı görüntü özelliği için screenshot-basic, NODX resource’undan önce çalışmalıdır.

## Framework ve veritabanı
ensure oxmysql
ensure qb-core

## Canlı görüntü desteği
ensure screenshot-basic

## NODX FiveM Web Panel
ensure nodx-fivem-panel

## Panelden resource başlatma, durdurma ve yeniden başlatma kullanacaksan ekle
add_ace resource.nodx-fivem-panel command.start allow
add_ace resource.nodx-fivem-panel command.stop allow
add_ace resource.nodx-fivem-panel command.restart allow

ESX kullanıyorsan ensure qb-core yerine kendi ESX resource’unu kullan. Veritabanı resource’un farklıysa ensure oxmysql satırını kendi veritabanı resource’una göre düzenle.

Özellik	Gerekli satır
Temel Panel bağlantısı	`ensure nodx-fivem-panel`
Canlı oyuncu görüntüsü	`ensure screenshot-basic`
Resource kontrolleri	Üç `add_ace` izni
Veritabanı özellikleri	Desteklenen veritabanı resource’u NODX’ten önce başlamalı
Framework özellikleri	QBCore veya ESX resource’u NODX’ten önce başlamalı

Resource başlatma ve durdurma özelliklerini kullanmayacaksan add_ace satırlarını eklemek zorunda değilsin. Daha sınırlı yetki daha güvenlidir.

İlk başlatma ve doğrulama

Sunucu konsolunda resource’u başlattıktan sonra hata olmadığını kontrol et:

ensure nodx-fivem-panel

Ardından Panel’de:

Plugin sayfasını aç.
Son bağlantı değerinin güncellendiğini kontrol et.
Health check çalıştır.
Framework, veritabanı ve desteklenen resource’ların algılandığını kontrol et.
Oyuncular ve Resource’lar sayfalarını açarak veri geldiğini doğrula.

ensure nodx-fivem-panel sonrasında bağlantı gelmiyorsa ilk kontrol edeceğin alanlar Config.ApiUrl, Config.LicenseKey, Config.ServerId ve sunucunun internete çıkış erişimidir.

Kurulumdan sonra kontrol etmen gerekenler

Doğru panel adresini kullan

FiveM paneline https://fivem.nodx.org üzerinden giriş yap.

Sunucunu seç

Panelde üst bölümden veya sunucu seçiciden işlem yapmak istediğin sunucuyu seç.

Plugin bağlantısını kontrol et

Sunucu durumu, Son bağlantı ve Plugin versiyonu alanlarına bak.

Health check çalıştır

Paneldeki Health check veya Test et butonu ile bağlantının güncel olup olmadığını doğrula.

Oyuncu ve resource listesini kontrol et

Oyuncular, resource’lar veya entegrasyonlar boş görünüyorsa önce bağlantı ve yetki testlerini incele.

Bağlantı durumu alanları

Alan	Ne anlatır?
Son bağlantı	Plugin’in panele en son ne zaman ulaştığını gösterir
Plugin versiyonu	Sunucudaki panel plugin sürümünü gösterir
Sunucu ID	İşlemlerin hangi sunucuya ait olduğunu ayırmak için kullanılır
Lisans durumu	Sunucunun aktif pakete bağlı olup olmadığını gösterir
Capability durumu	Sunucunun hangi panel özelliklerini desteklediğini gösterir

Yeni kurulumdan sonra bazı bilgiler birkaç dakika içinde senkron olur. Çok beklemeden işlem yapmak istersen Test et butonu en hızlı kontrol yoludur.

Yeni sunucu eklediğinde ne olur?

Yeni bir FiveM sunucusu kurduğunda panel otomatik olarak o sunucuyu ayrı kayıt gibi görmelidir. Böylece test sunucusundaki dosyalar, oyuncular veya entegrasyonlar canlı sunucuda görünmez. Görmen gereken beklenen davranış:

Durum	Beklenen sonuç
Yeni sunucu bağlandı	Panelde ayrı sunucu olarak görünür
Eski sunucu seçili	Eski sunucunun oyuncuları ve entegrasyonları görünür
Yeni sunucu seçili	Sadece yeni sunucuya ait veriler görünür
Lisans eşleşmiyor	İşlem engellenir ve test ekranında uyarı çıkar

Plugin güncelleme akışı

Panelde güncelleme destekleniyorsa önerilen sıra şöyledir:

Mevcut durumu kontrol et

Plugin versiyonu ve Son bağlantı alanlarını incele.

Yedek al

Güncelleme öncesi panelin sunduğu yedekleme adımını tamamla.

Güncellemeyi başlat

Güncelle butonunu kullan. Panel güncelleme durumunu işlem geçmişinde gösterir.

Resource yeniden başlatılsın

Güncelleme sonrası plugin tekrar başlatılır ve bağlantı doğrulanır.

Health check çalıştır

Versiyon, bağlantı ve capability durumlarının güncellendiğini doğrula.

Bağlantı yoksa hızlı kontrol listesi

Belirti	Kontrol
Oyuncular boş	Sunucu seçimi, plugin bağlantısı ve son bağlantı zamanı
Resource listesi boş	Plugin yetkileri ve sunucudaki resource durumu
Market veya kapı yok	İlgili entegrasyonun aktifliği ve test sonucu
Canlı görüntü gelmiyor	Oyuncu client erişimi ve screenshot desteği
Test sonucu bekliyor	Capability senkronu ve agent bağlantısı
`license.invalid`	Lisans anahtarı veya Server ID yanlış ya da başka sunucuya ait
`screenshot-basic` hatası	`screenshot-basic`, NODX resource’undan önce başlamamış
Resource başlamıyor	Klasör adı veya `ensure nodx-fivem-panel` satırı yanlış

Aynı lisansı veya aynı sunucu bilgisini birden fazla müşteride kullanma. Panel işlemleri sunucu, workspace ve lisans eşleşmesine göre ayrılmalıdır.

Genel

Discord Bot

FiveM Web Panel

Fatura & Ödeme

Kurulum ve bağlantı

Plugin’i sunucuya kur

config.lua nasıl doldurulur?

server.cfg nasıl doldurulur?

İlk başlatma ve doğrulama

Kurulumdan sonra kontrol etmen gerekenler

Bağlantı durumu alanları

Yeni sunucu eklediğinde ne olur?

Plugin güncelleme akışı

Bağlantı yoksa hızlı kontrol listesi

​Plugin’i sunucuya kur

​config.lua nasıl doldurulur?

​server.cfg nasıl doldurulur?

​İlk başlatma ve doğrulama

​Kurulumdan sonra kontrol etmen gerekenler

​Bağlantı durumu alanları

​Yeni sunucu eklediğinde ne olur?

​Plugin güncelleme akışı

​Bağlantı yoksa hızlı kontrol listesi

Plugin’i sunucuya kur

config.lua nasıl doldurulur?

server.cfg nasıl doldurulur?

İlk başlatma ve doğrulama

Kurulumdan sonra kontrol etmen gerekenler

Bağlantı durumu alanları

Yeni sunucu eklediğinde ne olur?

Plugin güncelleme akışı

Bağlantı yoksa hızlı kontrol listesi