FiveM Sunucu Şablonunuzu Yükleme ve Ayarlama

Hoş geldiniz! Şu an ürünlerimizden birini satın aldınız premium FiveM sunucu şablonları – Topluluğunuzu özelliklerle dolu, önceden yapılandırılmış bir deneyimle harekete geçirmek için harika bir seçim. İster deneyimli bir sunucu sahibi olun, ister yeni başlıyor olun, bu kapsamlı kılavuz, sunucu şablonunuzu indirme, yükleme ve başlatma sürecinin her adımında size yol gösterecektir.

If you’ve purchased a complete server package from us and are wondering “What next?”, you’re in the exact right place. We’ll turn that downloaded .zip file into a living, breathing FiveM sunucusu oyunculara hazır.

Neden FiveMX.com'dan Tam Sunucu Şablonu Seçmelisiniz?

Before we dive in, let’s quickly recap why starting with a FiveMX template accelerates your journey:

• Zaman Tasarrufu: Sıfırdan istikrarlı bir FiveM sunucusu oluşturmak, kaynakları kurmak, betikleri yapılandırmak, çakışmaları gidermek ve veritabanlarını kurmak için sayısız saat harcamayı gerektirir. Şablonlarımız tüm bu işleri bir araya getirerek size haftalar hatta aylar kazandırabilir.

• Önceden Yapılandırılmış Temel Özellikler: Şablona bağlı olarak ESX veya QBCore gibi önemli çerçeveleri, temel komut dosyalarını (işler, envanterler, araçlar, hile önleme temelleri), optimize edilmiş haritaları ve temel ayarları dahil ediyor ve yapılandırıyoruz.

• Stabilite Test Edildi: Dahil edilen kaynakların birlikte iyi çalışmasını sağlamak, gelişigüzel bir araya getirilmiş sunucularda görülen komut dosyası çakışmaları ve performans sorunlarının neden olduğu yaygın baş ağrılarını azaltmak için çabalıyoruz.

• Büyüme İçin Temel: Kullanıma hazır şablonlarımız tamamen özelleştirilebilir. Topluluğunuzun vizyonuna özel benzersiz özellikler, araçlar veya komut dosyaları ekleyebileceğiniz sağlam bir temele sahip olursunuz.

• Özel Destek: Yalnız değilsiniz. FiveMX, satın alınan şablonlar için sürekli güncellemeler ve sorun giderme ve tavsiyeler için destek kanallarımıza (Discord gibi) erişim sağlar.

Başlamadan Önce: Ön Koşullar Kontrol Listesi

Aşağıdakilerin hazır olduğundan emin olun:

1. FiveMX Sunucu Şablonunuz: FiveMX.com hesabınızdan indirildi.

2. Sunucu Barındırma (karşılaştırmamıza bakın): Sunucunuzu çalıştırabileceğiniz bir yer. Bu şunlar olabilir:

   • VPS (Sanal Özel Sunucu) veya Dedicated Sunucu: Genel sunucular için önerilir. Zap-Hosting (genellikle FiveM ile ortaklık yapar), OVH, Hetzner veya Contabo gibi sağlayıcılar popüler seçeneklerdir. FiveM'in önerdiği özellikleri karşıladığından emin olun (güncel öneriler için CFX.re belgelerine bakın).

   • Windows PC (Yerel Ana Bilgisayar): Yerel olarak test etmek veya arkadaşlarınızla oynamak için uygundur, ancak genellikle geniş bir kamu topluluğu için yeterince güçlü veya güvenilir değildir.

3. FiveM Sunucu Eserleri: Çekirdek FiveM sunucu dosyaları (Windows için). – Eğer açıksa Linux, Buraya tıklayın

4. Veritabanı Yazılımı: MySQL veya MariaDB (MariaDB (genellikle MySQL'in yerine geçecek bir alternatif olarak önerilir).

5. Veritabanı Yönetim Aracı: HeidiSQL (Ücretsiz, Tavsiye Edilir), phpMyAdmin (Web tabanlı) veya MySQL Workbench.

6. Metin Düzenleyici: İyi bir metin düzenleyici gibi Görsel Stüdyo Kodu (Free, Recommended), Notepad++, or Sublime Text. Avoid Windows Notepad as it can mess up file encodings.

7. FiveM Lisans Anahtarı: FiveM anahtar yöneticisinden edinilebilir

8. (Pencereler) Visual C++ Yeniden Dağıtılabilir: Son versiyon çok önemli. Microsoft'un resmi sitesinden indirin.

Adım 1: Sunucu Şablonunuzu İndirme

İşte en kolay kısmı!

1. FiveMX.com'a giriş yapın: Web sitemizdeki hesabınıza erişin.

2. İndirilenlere gidin: “Hesabım” veya “İndirilenler” bölümünü bulun.

3. Satın Aldığınız Ürünü İndirin: Locate the server template you bought and click the download button. It will arrive as a .zip archive. Save it somewhere easily accessible, like your Desktop or a dedicated “FiveM Server” folder.

Önemli: Satın aldığınız sunucu dosyaları aynı zamanda size e-posta (link) yoluyla da gönderilmektedir!

Adım 2: Sunucu Ortamınızı Hazırlama

Sorunsuz bir kurulum için bu adım çok önemlidir. Sakın atlamayın!

1. Temel FiveM Sunucunuzu Kurun:

   • Download Artifacts: Go to the official FiveM documentation (docs.cfx.re) and find the link for the latest recommended server artifacts for your operating system (Windows or Linux). Download these.

   • Sunucu Dizini Oluştur: Create a main folder for your server (e.g., C:FXServer or /home/user/FXServer).

   • Eserleri Çıkar: İndirdiğiniz sunucu dosyalarını doğrudan bu klasöre çıkartın.

   • Create server-data Directory: Inside your main server directory, create a sub-folder named server-data. This is where your resources and configuration will live, keeping things organized and separate from the core server files. Our template files will go inside this server-data folder.

2. Veritabanı Yazılımını Kurun (MySQL/MariaDB):

   • Neden? FiveM servers, especially roleplay servers using frameworks like ESX or QBCore, rely heavily on databases to store persistent data: player accounts, character information, inventory, vehicle ownership, business statuses, logs, etc. Without a database, none of this information can be saved between sessions.

   • Nasıl?

     • Pencereler: Download the MySQL Community Server installer or MariaDB installer from their official websites. Follow the installation wizard. During installation, securely note down the root password you set.

     • Linux (Debian/Ubuntu): Use the package manager: sudo apt update && sudo apt install mariadb-server. Run sudo mysql_secure_installation afterwards to set the root password and secure the installation.

     • Linux (CentOS/RHEL): Use the package manager: sudo yum update && sudo yum install mariadb-server. Start the service sudo systemctl start mariadb and enable it on boot sudo systemctl enable mariadb. Run sudo mysql_secure_installation.

   • Doğrulama: Ensure the database service is running (services.msc on Windows, sudo systemctl status mariadb on Linux).

3. Install Database Management Tool (HeidiSQL Recommended):

   • Neden? While you can manage MySQL/MariaDB via the command line, a graphical tool makes creating databases, importing data, and browsing tables much easier.

   • Nasıl? HeidiSQL'i resmi web sitesinden indirip kurun. Hafif ve kullanıcı dostudur.

4. (Yalnızca Windows) Visual C++ Redistributable'ı yükleyin:

   • Neden? Many FiveM resources, and FiveM itself, rely on Microsoft’s Visual C++ libraries. Missing these is a very common cause of server startup failures or script errors.

   • Nasıl? En son x64 sürümünü doğrudan Microsoft'tan indirin ve yükleyiciyi çalıştırın. İstendiğinde makinenizi yeniden başlatın.

Adım 3: Sunucu Şablonunu Yükleme

Şimdi indirdiğiniz şablonu hazırladığınız sunucu ortamıyla birleştiriyoruz.

1. Şablon Dosyalarını Çıkarın:

   • Open the .zip file you downloaded from FiveMX.com.

   • Extract its entire contents directly into the server-data folder you created in Step 2.

   • Hayati: Ensure the file structure is correct. You should see folders like resources and potentially files like server.cfg directly inside server-data, not nested within an extra folder named after the template (e.g., NOT server-data/MyTemplateName/resources, but server-data/resources).

2. Veritabanını Kurun:

   • SQL Dosyasını Bulun: Inside the extracted template files (likely within the main server-data directory or a dedicated _INSTALL folder), find the database file. It usually ends with .sql (e.g., database.sql, install.sql, esx_legacy.sql).

   • HeidiSQL'i (veya aracınızı) açın: Veritabanı yönetim aracınızı başlatın.

   • Veritabanına Bağlan: Yeni bir bağlantı oturumu oluşturun.

     • Hostname/IP: 127.0.0.1 (or localhost) if the database is on the same machine as HeidiSQL. If your database is hosted elsewhere, use its IP address.

     • User: root (or the specific user you created, though root is fine for local setups).

     • Şifre: MySQL/MariaDB kurulumu sırasında belirlediğiniz şifre.

     • Port: Usually 3306.

     • “Aç” veya “Bağlan”a tıklayın.

   • Veritabanını Oluşturun:

     • Sol bölmede (sunucu bağlantılarının listelendiği yer) sağ tıklayın veya “Sorgu” sekmesine gidin.

     • Execute the command: CREATE DATABASE IF NOT EXISTS your_database_name; (Replace your_database_name with a name you choose, e.g., fivemx_server. Bu ismi unutmayın!). Açıklayıcı bir ad kullanın. F9 tuşuna basın veya "Çalıştır" düğmesine tıklayın.

     • Veritabanı listesini yenileyin (F5). Yeni, boş veritabanınızı görmelisiniz.

   • SQL Dosyasını İçe Aktarın:

     • Sol bölmeden yeni oluşturduğunuz veritabanını seçerek aktif hale getirin.

     • Go to File -> Run SQL file….

     • Navigate to and select the .sql file from your template.

     • "Aç"a tıklayın. HeidiSQL, dosyadaki tüm komutları çalıştıracak, gerekli tabloları oluşturacak ve şablonun betikleri için gereken varsayılan verileri ekleyecektir. Bu işlem, şablonun karmaşıklığına bağlı olarak birkaç saniyeden bir dakikaya kadar sürebilir. Herhangi bir hata olup olmadığını görmek için alttaki günlük çıktısını kontrol edin.

3. Sunucu Dosyalarında Veritabanı Bağlantısını Yapılandırın:

   • Neden? FiveM sunucunuzun az önce kurduğunuz veritabanına nasıl bağlanacağını bilmesi gerekir. Şablon, bu kimlik bilgilerini gerektiren betikleri içerir.

   • Yapılandırmayı bulun: The exact location varies between templates and frameworks (ESX, QBCore). Common places include:

     • Directly in server-data/server.cfg.

     • In a specific resource’s config file, like server-data/resources/[esx]/es_extended/config.lua or server-data/resources/[qb]/qb-core/config.lua.

     • Sometimes in a dedicated database connection script like ghmattimysql or oxmysql. Check the template’s documentation or server.cfg for start or ensure lines related to mysql async/oxmysql.

   • Ayarları Düzenle: İlgili dosyayı/dosyaları metin düzenleyicinizle (VS Code, Notepad++) açın. Buna benzer satırları arayın (sözdizimi Lua/JS/JSON arasında biraz farklılık gösterebilir):

     -- Example for ESX/QBCore style Lua configs
     Config.MySQLConnection = "mysql://root:YourPassword@127.0.0.1/your_database_name?charset=utf8mb4"
     -- or separate fields:
     set mysql_connection_string "server=127.0.0.1;database=your_database_name;userid=root;password=YourPassword;" -- Often found directly in server.cfg for older setups or specific resources
     -- or in JSON format for some resources:
     // { "host": "127.0.0.1", "user": "root", "password": "YourPassword", "database": "your_database_name" }

      

   • Değerleri Güncelle: Replace “YourPassword” with your actual database root password and “your_database_name” with the exact database name you created in HeidiSQL. Ensure the host (127.0.0.1 or localhost) and user (root) are correct.

   • Dosyayı/dosyaları kaydedin. Birden fazla bağlantı dizesi varsa, gerekli tüm bağlantı dizelerini güncellediğinizden emin olun.

4. Review and Configure server.cfg:

   • Open the server-data/server.cfg file with your text editor. This is the main configuration file for your FiveM server.

   • Temel Ayarlar:

     • sv_licenseKey “your_license_key”: Replace “your_license_key” with the key you generated from the FiveM Keymaster. Sunucunun listelenmesi ve doğru bir şekilde çalışması için bu zorunludur.

     • sv_hostname “My Awesome FiveMX Server”: Change this to your desired server name as it will appear in the server list. Use colors and emojis if you like (using FiveM’s formatting codes).

     • sv_maxclients 48: Set the maximum player slots (ensure your license type supports this number – standard keys support up to 48, higher tiers via Patreon).

     • sv_projectDesc “A description of my server.”: Set a short description that appears in some server lists or details panels.

     • sets steam_webApiKey “YOUR_STEAM_API_KEY”: Birçok framework/script için gereklidir. Steam Geliştirici web sitesinden bir tane edinin. Eğer eksikse ve framework'ünüz gerektiriyorsa bu satırı ekleyin.

     • ensure …: These lines load your resources. The FiveMX template should have these pre-configured. The order can sometimes matter, especially for frameworks (e.g., ensure es_extended before ESX addons). Don’t change the order unless you know what you’re doing or following specific instructions.

   • Diğer Ayarları İnceleyin: Look through the file for any other settings specific to the template (like locale, starting money, script-specific convars) and adjust as needed. Comments (# or — at the start of a line) often explain what settings do.

   • Save the server.cfg file.

Şimdilik bu kadar.

Adım 4: Sunucunuzu Başlatma

Artık bunu çevrimiçi ortama taşımanın zamanı geldi!

• Doğru Dizin'e Git: Open your server’s main directory (e.g., C:FXServer or /home/user/FXServer), the one containing the FXServer.exe or run.sh file, OLUMSUZ the server-data directory.

• Windows Kullanıcıları İçin:

  1. Find run.cmd or similar: Look for a batch file typically named run.cmd or sometimes start.bat. Often it will reference the server-data directory, like +exec server.cfg +set txAdminPort 40120.

  2. Çift Tıklama: Double-click the run.cmd (or equivalent) file.

  3. Konsol Penceresi: Bir komut istemi penceresi (veya TxAdmin kullanıyorsanız birden fazla) görünecektir. Bu sizin sunucu konsolunuzdur. Dikkatlice izleyin!

• Linux Kullanıcıları İçin:

  1. Terminali açın: Ana sunucu dizininizde bir terminal penceresi açın.

  2. Çalıştırılabilir hale getirin (gerekirse): Ensure the start script is executable: chmod +x run.sh.

  3. Komut Dosyasını Çalıştırın: Execute the start script: ./run.sh +exec server.cfg. (The +exec server.cfg part might already be inside the run.sh script itself).

  4. Konsol Çıktısı: Sunucu konsol çıktısı doğrudan terminalinizde görünecektir.

Sunucunun Çalıştığını Doğrulayın:

• Konsolu İzle: Look for messages indicating resources are starting (often green text like Started resource MyResource).

• Hataları Kontrol Et: Eleştirel bir şekilde arayın KIRMIZI hata mesajları. Yaygın hatalar şunlardır:

  • Authentication failure: Could not connect to database. (Check Step 3.3 – Database Credentials).

  • Could not find resource X. (Check if the resource folder exists in resources and the ensure X line in server.cfg matches the folder name exactly).

  • Script ERROR: … (Indicates a problem within a specific script’s code. May require debugging or checking for compatibility issues).

  • Eksik bağımlılıklarla ilgili hatalar (örneğin Windows'taki Visual C++ Yeniden Dağıtılabilir).

• Başarı Mesajı: İdeal olarak, tüm kaynakları yükledikten sonra sunucunun açık olduğunu, bir portu dinlediğini ve FiveM hizmetleriyle kimlik doğrulaması yapıldığını belirten mesajlar göreceksiniz.

• Oyun İçinde Bağlan:

  1. Oyun bilgisayarınızda FiveM'i başlatın.

  2. İstemci konsolunu açmak için F8 tuşuna basın.

  3. Type connect 127.0.0.1:30120 (if running the server on the same machine you’re playing on) or connect YOUR_SERVER_IP:30120 (if the server is hosted elsewhere, use its public IP address). The default port is 30120 unless changed in your startup script or server.cfg.

  4. Eğer her şey doğruysa sunucunuza bağlanmaya başlamalısınız!

Adım 5: Temel Özelleştirme (Yükleme Sonrası)

Your server is running, but now you want to make it yours.

• Önce Yedekleyin! Before making major changes, stop the server and make a backup of your server-data folder and your database (use HeidiSQL’s export feature).

• Logoları/Yükleme Ekranlarını Değiştir: Look for resources related to visuals (e.g., loadingscreen, scoreboard) and check their html, css, js files or config.lua for customization options. Replace image files (like logo.png) with your own, keeping dimensions similar.

• İşleri/Etkinlikleri Yapılandırın: Explore the configuration files (config.lua is common) within specific resource folders (e.g., resources/[jobs]/policejob/config.lua) to adjust job payouts, locations, required ranks, etc.

• Araç Ekle/Çıkar: To add custom vehicles, you typically place the vehicle resource folder into your resources directory and add ensure vehicle_resource_name to your server.cfg. Consult guides specific to adding vehicles. Removing is the reverse (delete folder, remove ensure line).

• Ekonomiyi Ayarla: Çerçeve yapılandırmaları (ESX/QBCore) genellikle başlangıç nakitlerini, maaş aralıklarını ve temel ürün fiyatlarını kontrol eder. Bunları dikkatlice ayarlayın.

Adım 6: Sunucunuzu Yönetme ve Bakımını Yapma

Bir sunucuyu çalıştırmak devam eden bir süreçtir:

• Düzenli Yedeklemeler: Seriously, automate this if possible. Back up your server-data folder (especially the resources subfolder and server.cfg) and your database (.sql dump) daily or at least several times a week. Store backups off-site if possible. Check out our dedicated backup tutorial [Link to your backup tutorial here]!

• Güncel Kalın:

  • FiveM Eserleri: Periodically check the FiveM documentation for new recommended server builds and update your core server files (usually involves replacing the files outside server-data). Read changelogs first!

  • FiveMX Şablon Güncellemeleri: Belirli şablonunuza yönelik güncellemeler için FiveMX.com'u takip edin. Güncellemeler hata düzeltmeleri, yeni özellikler veya uyumluluk iyileştirmeleri içerebilir. Güncelleme talimatlarımızı dikkatlice izleyin.

  • Kaynak Güncellemeleri: Individual script creators often update their resources on platforms like GitHub. Updating requires replacing the resource folder and checking for configuration changes. Be cautious, as updates can sometimes break things or conflict with other scripts.

• Performansı İzle: Use server monitoring tools (like txAdmin included with FiveM, or resource monitors like htop on Linux / Task Manager on Windows) to check CPU/RAM usage. High usage might indicate poorly optimized scripts.

• Topluluğunuzla İletişime Geçin: Hata raporları ve öneriler için oyuncu geri bildirimlerini dinleyin.

• Destek Kanallarını Kullanın: FiveMX şablonuyla ilgili sorunlarla karşılaşırsanız Discord veya destek forumlarımızı kullanmaktan çekinmeyin.

Yaygın Sorunların Giderilmesi

Sorunlar olur. İşte onlara nasıl yaklaşacağınız:

1. Sunucu Başlamıyor / Hemen Çöküyor:

   • Konsolu Kontrol Edin: Scroll up in the server console window/log file. Look for the first error message. This often points to the root cause.

   • Check server.cfg: Sözdizimi hataları (eksik tırnak işaretleri, virgüller), hatalı lisans anahtarı.

   • Veritabanı Bağlantısı: Yapılandırma dosyalarındaki kimlik bilgilerini iki kez kontrol edin (Adım 3.3). MySQL/MariaDB servisinin çalıştığından emin olun.

   • Eksik Bağımlılıklar: (Windows) Reinstall Visual C++ Redistributable. Ensure all required base resources (like mysql-async or oxmysql, es_extended, qb-core) are present and started before dependent resources in server.cfg.

   • Liman Çatışması: Başka hiçbir uygulamanın 30120 portunu (veya yapılandırdığınız portu) kullanmadığından emin olun.

2. Bağlantı Kurulamıyor / Bağlantı Reddedildi:

   • Sunucu Çalışıyor mu? Sunucunun kritik hatalar olmadan başlatıldığından emin olmak için konsolu iki kez kontrol edin.

   • Güvenlik Duvarı: Ensure your server’s firewall (Windows Firewall, ufw on Linux, or your hosting provider’s firewall) allows incoming TCP and UDP traffic on port 30120 (and 30110 if using server list features, plus TxAdmin port if used e.g. 40120).

   • Doğru IP/Port: Are you using the correct public IP address and port in the FiveM client? (Use 127.0.0.1 only if connecting from the same machine).

   • İSS Port Engelleme: Bazı konut tipi İSS'ler, barındırma için yaygın olarak kullanılan portları engeller.

3. Kaynaklar Yüklenmiyor / Oyun İçi Hatalar:

   • Konsol Hataları: Check the server console (F8 console in-game often shows client-side errors, but server console shows loading issues). Look for Could not find resource or Script ERROR related to specific resources.

   • ensure Name: Ensure the name in server.cfg (ensure resource_name) exactly matches the folder name in the resources directory (case-sensitive on Linux!).

   • Bağımlılıklar: Did you forget to ensure a required resource before the one that’s erroring? (e.g., trying to use an ESX (es_extended'dan önceki fonksiyon).

   • Veritabanı Tabloları Eksik: If scripts complain about nil values or unknown tables, your database import might have failed, or the script expects tables that weren’t included. Check the script’s documentation.

• Daha Fazla Yardıma Mı İhtiyacınız Var? Ayrıntılı sorun giderme bölümümüze göz atın.

Sunucu Kuruldu – Şimdi Ne Olacak?

Tebrikler! Başarıyla kurulumunuzu yaptınız ve başlattınız. FiveM sunucusu FiveMX şablonu kullanılarak. Temel atıldı.

Şimdi asıl eğlence başlıyor: Detayları özelleştirmek, oyuncuları davet etmek, topluluğunuzu oluşturmak ve benzersiz deneyimler yaratmak.

Sunucu sahipliğinin bir öğrenme süreci olduğunu unutmayın. Denemekten korkmayın (ile) yedekler!), belgelere başvurun (FiveM'in, betiğe özgü ve bizim) ve daha geniş FiveM ve FiveMX topluluklarıyla etkileşim kurun.