txAdmin, FiveM ve RedM sunucularını yönetmek ve izlemek için geliştirilmiş, tarayıcıdan kullanılan bir web paneli ve oyun içi menüdür. 2020'nin başından beri FXServer'ın bir bileşeni olarak gelir; yani ayrıca indirip kurmanız gerekmez. Sunucuyu kurmaktan oyuncu yasaklamaya, zamanlanmış yeniden başlatmalardan canlı konsola kadar pek çok işi tek yerden yaparsınız.
Bu rehberde txAdmin nedir, nasıl kurulur ve nasıl kullanılır sorularını resmî txAdmin GitHub belgelerine ve Cfx dokümantasyonuna dayanarak yanıtlıyoruz: kurulum akışı, recipe sistemi, yönetici ve izin yönetimi, zamanlanmış restart, ban/whitelist ve izleme özellikleri.
txAdmin neler yapabilir?
txAdmin'in GitHub README'sinde listelenen başlıca özellikler şunlardır:
- Recipe tabanlı sunucu kurulumu: Hazır şablonlarla sunucuyu dakikalar içinde ayağa kaldırma.
- Sunucu kontrolü: Sunucuyu ve tek tek kaynakları başlatma, durdurma, yeniden başlatma.
- İzleme: Çökme veya donma durumunda otomatik yeniden başlatma, CPU/RAM takibi, canlı konsol, performans grafikleri ve aktivite günlüğü.
- Oyuncu yönetimi: Uyarı ve ban sistemi, whitelist, oyuncu notları, oynama süresi takibi. MySQL gerektirmeyen kendi veritabanını kullanır.
- Zamanlanmış restart: Duyurulu ve özel event'li zamanlanmış yeniden başlatmalar.
- Yönetici sistemi: Cfx.re veya şifre ile giriş, izin sistemi ve işlem günlüğü.
- Discord entegrasyonu: Otomatik güncellenen durum mesajı, whitelist ve oyuncu bilgisi komutları.
- Oyun içi menü: NoClip, ışınlanma, araç, iyileştirme, duyuru gibi yönetici araçları.
- Diğer:
server.cfgdüzenleyici ve doğrulayıcı, 30'dan fazla dil desteği.
txAdmin nasıl kurulur?
txAdmin'i başlatmak için FXServer'ı +exec server.cfg parametresi olmadan çalıştırmanız yeterlidir. İlk açılışta bir txData klasörü oluşturulur ve konsolda kurulum için açmanız gereken adres yazılır. FXServer'ın kendisini nasıl indireceğinizi FiveM sunucu kurulumu rehberimizde anlattık.
Windows kurulum akışı
FXServer.exedosyasını çalıştırın (FiveM for GTAV Enhanced sunucularındacfx-server.exe).- Tarayıcıda açılan sayfada gösterilen PIN'i girin ve Link Account ile Cfx.re hesabınıza giriş yapıp erişimi onaylayın.
- txAdmin paneli için bir yönetici şifresi oluşturun.
- Sunucunuza bir ad verin ve dağıtım türünü seçin. Sade bir başlangıç için Popular Recipes altındaki "CFX Default FiveM" şablonu önerilir.
- Veri klasörünü onaylayın, Recipe Deployer'da Cfx.re Portal'dan aldığınız lisans anahtarını girip Run Recipe deyin.
- Save & Run Server ile sunucuyu başlatın.
Linux'ta txAdmin
cd ~/FXServer/server
bash run.sh
# +exec verilmediği için txAdmin başlar; konsoldaki adresi ve PIN'i kullanınLinux'ta sunucuyu terminal kapandığında da çalışır tutmak için tmux veya screen ya da systemd kullanabilirsiniz.
txAdmin portu ve ortam değişkenleri
Bazı ayarlar web panelinde değil, yalnızca ortam değişkenleriyle (environment variable) yapılır. Resmî env-config.md belgesindeki önemli değişkenler:
| Değişken | Varsayılan | Açıklama |
|---|---|---|
TXHOST_TXA_PORT | 40120 | txAdmin'in dinlediği port. 30120 olarak ayarlanamaz. |
TXHOST_FXS_PORT | tanımsız | FXServer'ı belirli bir porta zorlar. 40120 olamaz. |
TXHOST_INTERFACE | 0.0.0.0 | txAdmin'in bağlandığı ve FXServer'a uyguladığı arayüz. |
TXHOST_DATA_PATH | Windows: <fxserver_root>/../txData | txData klasörünün konumu. Linux varsayılanı farklıdır. |
TXHOST_GAME_NAME | tanımsız | fivem veya redm; kurulumdaki recipe listesini o oyunla sınırlar. |
TXHOST_MAX_SLOTS | tanımsız | sv_maxClients değerinin bu sınırı aşmamasını zorunlu kılar. |
TXHOST_QUIET_MODE | false | FXServer çıktısını txAdmin stdout'una aktarmaz. Hosting sağlayıcılarına önerilir. |
Recipe sistemi nasıl çalışır?
Recipe, sunucunun nasıl kurulacağını tanımlayan bir YAML dosyasıdır. Üst bilgiler (metadata), değişkenler (variables) ve sırayla çalışan görevlerden (tasks) oluşur. Bir görev başarısız olursa zincir durur. ESX, QBCore ve Qbox gibi framework'lerin hazır recipe'leri txAdmin kurulumunda Popular Recipes altında listelenir.
name: OrnekRecipe
version: v1.0.0
author: sizin-adiniz
description: Basit bir örnek
$onesync: on
variables:
dbHost: localhost
tasks:
- action: download_file
url: https://github.com/citizenfx/cfx-server-data/archive/master.zip
path: ./tmp/cfx-server-data.zip| Görev (action) | Ne yapar |
|---|---|
download_github | Bir GitHub deposunu indirir (ref, subpath, dest). |
download_file | Bir URL'den dosya indirir. |
unzip | ZIP arşivini açar (tar desteklenmez). |
move_path / copy_path / remove_path | Dosya veya klasör taşır, kopyalar, siler. |
ensure_dir | Klasör oluşturur. |
write_file / replace_string | Dosyaya yazar veya içinde metin değiştirir. |
connect_database / query_database | MySQL/MariaDB'ye bağlanır ve SQL çalıştırır. |
load_vars | JSON dosyasından değişken yükler. |
Değişkenler {{dbHost}} biçiminde kullanılır. svLicense, dbHost, dbName, maxClients gibi hazır bağlam değişkenleri vardır; svLicense kurulumun sonunda server.cfg'ye otomatik eklenir.
Yönetici ve izin yönetimi
txAdmin'de ilk hesabı oluşturan kişi Master yöneticidir. Diğer yöneticiler Admin Manager sayfasından eklenir. İzinler txData/admins.json dosyasında tutulur. Master yönetici ile all_permissions veya manage.admins iznine sahip yöneticiler izinleri düzenleyebilir.
| İzin | Açıklama |
|---|---|
all_permissions | Her şeye izin veren kök izin; seçilince diğer izinleri kaldırır. |
manage.admins | Yönetici hesabı oluşturma, düzenleme, silme. |
console.view / console.write | Konsolu görme / konsola komut yazma. |
control.server | Sunucuyu başlatma, durdurma, yeniden başlatma. |
commands.resources | Kaynak başlatma/durdurma. |
server.cfg.editor | server.cfg okuma/yazma. |
players.kick / players.warn / players.ban | Atma, uyarma, banlama/ban kaldırma. |
players.whitelist | Oyuncuyu whitelist'e ekleme. |
players.spectate / players.teleport | İzleme ve ışınlanma. |
Zamanlanmış restart
txAdmin, belirlediğiniz saatlerde sunucuyu duyuru yaparak yeniden başlatabilir. Resmî event belgesine göre txAdmin:events:scheduledRestart event'i restarttan 30, 15, 10, 5, 4, 3, 2 ve 1 dakika önce otomatik tetiklenir; kalan saniye ve çevrilmiş mesajı içerir. Bir yönetici yaklaşan restartı atlarsa txAdmin:events:scheduledRestartSkipped tetiklenir. Kapanmadan hemen önce ise txAdmin:events:serverShuttingDown gönderilir.
Bu event'ler sayesinde kendi kaynaklarınızda restarttan önce oyuncu verilerini kaydetmek gibi işler yapabilirsiniz.
-- server tarafı Lua örneği
AddEventHandler('txAdmin:events:serverShuttingDown', function(eventData)
-- burada oyuncu verilerini kaydedin
end)Ban, uyarı ve whitelist
txAdmin'in oyuncu yöneticisi uyarı ve ban sistemini, oyuncu notlarını ve oynama süresi takibini içerir. Ban'lar txAdmin'in kendi veritabanında saklanır, ayrı bir MySQL gerekmez. Whitelist için README'de dört mod listelenir:
- Discord sunucusu üyeliği
- Belirli bir Discord rolü
- Onaylanmış lisans (Approved License)
- Yalnızca yöneticiler (Admin-only)
Bu işlemler de event üretir: txAdmin:events:playerBanned, playerWarned, playerKicked, whitelistPlayer, whitelistRequest gibi. Belgede playerWhitelisted, healedPlayer ve skippedNextScheduledRestart event'leri deprecated olarak işaretlidir; yeni kodda bunların yerine geçenleri kullanın.
İzleme ve sorun tespiti
txAdmin sunucu çöktüğünde veya donduğunda otomatik olarak yeniden başlatır, CPU ve RAM kullanımını gösterir ve canlı konsol sunar. Bir sorun yaşadığınızda ilk bakmanız gereken yer canlı konsol ve sunucu günlükleridir. Sık karşılaşılan FiveM sunucu hatalarını ayrı bir rehberde topladık.
Pterodactyl gibi panellerde txAdmin
Hosting sağlayıcıları txAdmin'i farklı biçimlerde sunabilir. txAdmin, sağlayıcılar için TXHOST_QUIET_MODE, TXHOST_MAX_SLOTS, TXHOST_PROVIDER_NAME ve TXHOST_DEFAULT_CFXKEY gibi ortam değişkenleri tanımlar. Panelde txAdmin portu ve oyun portu sağlayıcının size ayırdığı portlara göre ayarlanır. Genel panel kullanımı için Pterodactyl rehberimize bakabilirsiniz.
Sık Sorulan Sorular
txAdmin ücretli mi, ayrıca indirmem gerekir mi?
Hayır. txAdmin FXServer ile birlikte gelir ve MIT lisanslı açık kaynaklı bir projedir.
txAdmin varsayılan portu nedir?
TXHOST_TXA_PORT değişkeninin varsayılanı 40120'dir. Bu değer 30120 olarak ayarlanamaz.
txAdmin şifremi unuttum, ne yapmalıyım?
Kurulumda Cfx.re hesabınızı bağladıysanız Cfx.re ile giriş yapabilirsiniz. Yönetici bilgileri txData/admins.json içinde tutulur; bu dosyayı düzenlemeden önce mutlaka yedeğini alın.
txAdmin olmadan FiveM sunucusu çalışır mı?
Evet. FXServer'ı +exec server.cfg ile başlattığınızda txAdmin devreye girmez ve sunucu doğrudan çalışır.
Oyun ve yazılım adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen geliştiricilerle ortaklık ilişkisi bulunduğu anlamına gelmez.
İlgili içerikler: FiveM sunucu kurulumu · FiveM sunucu hataları · ESX, QBCore ve Qbox farkı · Pterodactyl rehberi · systemd servis yönetimi