JRS COREالوثائق
البدء

التثبيت

ارفع JRS Core على سيرفر RedM

المتطلبات#

  • سيرفر RedM (آخر artifacts) مع txAdmin
  • قاعدة بيانات MariaDB أو MySQL
  • مفتاح السيرفر من portal.cfx.re
  • OneSync مفعّل

txAdmin setup guide

docs.fivem.net - the official step by step guide to install txAdmin and create a server.
  1. افتح txAdmin واختر Remote URL Template.
  2. الصق رابط الـ recipe:
text
https://raw.githubusercontent.com/NQ3Z/jrscore/main/recipe/jrscore.yaml
  1. txAdmin ينزّل السكربتات ويسوي قاعدة البيانات ويكتب server.cfg لوحده.
  2. شغّل السيرفر.
  1. شغّل INSTALL.bat.
  2. اكتب مجلد السيرفر وبيانات MySQL ومفتاح السيرفر.
  3. المثبّت ينسخ السكربتات ويسوي قاعدة البيانات ويكتب server.cfg.
  4. في txAdmin اجعل Server Data Folder نفس المجلد وفعّل OneSync.
  1. انسخ مجلد resources لمجلد السيرفر.
  2. استورد sql/jrscore.sql في قاعدة بيانات فاضية.
  3. انسخ server.cfg وعدّل القيم بين {{ }}.

قاعدة البيانات (XAMPP أو HeidiSQL أو بدون XAMPP)#

يحفظ JRS Core الشخصيات والأغراض والفلوس وكل شي ثاني في قاعدة MariaDB / MySQL. اختر طريقة واحدة لتشغيلها، استورد sql/jrscore.sql، ثم اضبط سلسلة الاتصال.

  1. نزّل وثبّت XAMPP. فيه MariaDB.
  2. افتح XAMPP Control Panel واضغط Start عند MySQL. الـ Apache ما تحتاجه.
  3. نزّل وثبّت HeidiSQL، البرنامج اللي تدير فيه قاعدة البيانات.
  4. في HeidiSQL اضغط New واختر Network type = MariaDB or MySQL (TCP/IP)، المضيف 127.0.0.1، المستخدم root، المنفذ 3306، ثم Open.
  5. كليك يمين في اللوحة اليسار الفاضية، Create new > Database، سمّها jrscore وخلّ الـ collation utf8mb4_general_ci.
  6. اختر jrscore ثم File > Run SQL file... واختر الملف sql/jrscore.sql.
Warning

XAMPP يشتغل بالمستخدم root وبدون كلمة مرور. على جهازك هذا عادي. على سيرفر عام سوِّ مستخدم خاص بكلمة مرور (الأوامر تحت) ولا تفتح المنفذ 3306 للإنترنت أبداً.

  1. ثبّت سيرفر قاعدة بيانات واحد: MariaDB Server (الأفضل) أو MySQL Community Server. اكتب كلمة مرور الـ root اللي تختارها.
  2. سوِّ القاعدة والمستخدم. افتح HeidiSQL أو سطر الأوامر ونفّذ:
sql
CREATE DATABASE jrscore CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'jrs'@'localhost' IDENTIFIED BY 'change_this_password';
CREATE USER 'jrs'@'127.0.0.1' IDENTIFIED BY 'change_this_password';
GRANT ALL PRIVILEGES ON jrscore.* TO 'jrs'@'localhost';
GRANT ALL PRIVILEGES ON jrscore.* TO 'jrs'@'127.0.0.1';
FLUSH PRIVILEGES;
  1. استورد الجداول:
bash
mariadb -u jrs -p jrscore < sql/jrscore.sql

(مع MySQL اسم البرنامج mysql). أو من HeidiSQL: File > Run SQL file.... 4. أدِرها بـ HeidiSQL أو DBeaver (يشتغل على ويندوز ولينكس وماك).

  1. ثبّت Laragon (نسخة Full فيها MySQL). بديل أخف من XAMPP.
  2. اضغط Start All. الـ MySQL يسمع على 127.0.0.1:3306، المستخدم root بدون كلمة مرور.
  3. سوِّ القاعدة jrscore واستورد sql/jrscore.sql من HeidiSQL (في Laragon زر Database يفتحه).
  1. ثبّت Docker ثم شغّل حاوية MariaDB:
bash
docker run -d --name jrs-db --restart unless-stopped \
  -e MARIADB_ROOT_PASSWORD=change_this_password \
  -e MARIADB_DATABASE=jrscore \
  -p 127.0.0.1:3306:3306 \
  -v jrs-db:/var/lib/mysql \
  mariadb:11
  1. استورد الجداول (تشتغل في أي شيل):
bash
docker cp sql/jrscore.sql jrs-db:/jrscore.sql
docker exec jrs-db sh -c "mariadb -uroot -pchange_this_password jrscore < /jrscore.sql"

صفحة الصورة: hub.docker.com/_/mariadb. كلمة 127.0.0.1: في -p تخلي القاعدة خاصة بالجهاز.

أي استضافة MariaDB أو MySQL يقدر السيرفر يوصلها تنفع (قاعدة مُدارة، أو قاعدة على VPS ثاني).

  1. سوِّ قاعدة jrscore ومستخدم لها من لوحة المزوّد.
  2. اسمح بـعنوان IP سيرفر اللعبة فقط.
  3. استورد sql/jrscore.sql من HeidiSQL متصلاً بذاك المضيف.
  4. استخدم اسم المضيف في سلسلة الاتصال تحت بدل 127.0.0.1.

بعدها عرّف السيرفر كيف يتصل. حط هذا السطر في server.cfg فوق ensure oxmysql:

cfg
set mysql_connection_string "mysql://jrs:change_this_password@127.0.0.1:3306/jrscore?charset=utf8mb4"

مع XAMPP والمستخدم root بدون كلمة مرور تصير mysql://root@127.0.0.1:3306/jrscore?charset=utf8mb4. لو كلمة المرور فيها رموز خاصة (@ : / #) بدّلها بكودها (@ = %40) أو اختر كلمة أبسط.

Tip

للتأكد من الاتصال شغّل السيرفر وابحث في الكونسول عن [oxmysql] Database server connection established. ما ظهر؟ تأكد أن MySQL شغّال والمنفذ 3306 واسم القاعدة مضبوط.

خلّ نفسك أونر#

ضع الستيم حقك داخل Config.CoreOwners في ملف jrs_core/config/config.lua:

lua
Config.CoreOwners = {
    ['steam:110000xxxxxxxxx'] = true,
}

أو غيّر عمود group إلى owner أو admin في جدول jrs_users.

ترتيب التشغيل#

cfg
ensure oxmysql
ensure jrs_core
ensure jrs_inventory
ensure jrs_character

ملف server.cfg الجاهز فيه الترتيب الصحيح.

Warning

لا تحط تعليق # في آخر سطر ensure، واحفظ fxmanifest.lua بصيغة UTF-8 بدون BOM.

JRS Core · فريمورك RedM مجاني ومفتوح المصدر · من فريق JRS