Ultimate Odycer

الوثائق وأول اختبار للعب

جهّز خادمًا، وصِل عميل اللعبة، واختبر عالمك الأول عبر الإنترنت.

اقرأ الأسئلة الشائعة

  1. تثبيت خادم للتقييم

    اقرأ ملاحظات الإصدار، وتحقق من بصمة SHA-256 واتبع دليل الإصدار. اضبط PostgreSQL وTLS ونفّذ عمليات الترحيل المطلوبة. أبقِ PostgreSQL وWebAdmin ضمن شبكة خاصة أو على واجهة خاصة.

    نزّل الخادمدليل VPS (بالفرنسية)
  2. ربط أول عميلين

    استخدم مشروع Godot/C# متوافقًا. اضبط عناوين Login وGame. أنشئ حسابين للاختبار وتحقق من أن العميلين يدخلان العالم نفسه.

    الوثائق التقنية (بالإنجليزية)
  3. إنشاء أول تجربة لعب بمساعدة الذكاء الاصطناعي

    اطلب من Codex أو Claude Code تغييرًا واحدًا قابلًا للمراجعة في كل مرة. ابدأ بخريطة صغيرة وشخصية غير لاعبة ومهمة ومكافأة. استورد مخرجات الأدوات المتاحة مع تسجيل إصدارها، واختبرها في Godot وعلى الخادم.

    أدوات Codex
  4. تهيئة بيئة ما قبل الإنتاج

    تحقق من بقاء الشخصية والمكافأة بعد إعادة الاتصال وإعادة التشغيل. استعد نسخة احتياطية في بيئة معزولة، وافحص السجلات وقِس الحمل. انشر الإصدار نفسه بعد اجتياز معايير الاختبار.

تثبيت الخادم على VPS

أعدّ بيئة تقييم على VPS بنظام Linux x86-64 باستخدام PostgreSQL وTLS. جهّز عميلًا متوافقًا بشكل منفصل. توضح الأوامر مثالًا على Debian أو Ubuntu. راجع متطلبات الحزمة المختارة.

  1. إعداد VPS والشبكة الخاصة

    استخدم حساب SSH عاديًا بصلاحية sudo. تحقق من x86_64 وglibc وثبّت PostgreSQL والتبعيات. أبقِ قاعدة البيانات وواجهة API وWebAdmin في النطاق المحلي. جهّز شبكة خاصة أو VPN يمكن لجهازي الاختبار الوصول إليها.

    uname -m
    getconf GNU_LIBC_VERSION
    sudo apt update
    sudo apt install postgresql libpq5 openssl ca-certificates
    pg_isready
  2. التنزيل والتحقق وفك الضغط

    نزّل حزمة Linux x86-64 وملف .sha256 من صفحة الإصدارات. استبدل اسم المثال باسم الملف الفعلي. قارن البصمة بالقيمة الرسمية وتوقف عند الاختلاف. ادخل المجلد المستخرج وتحقق من المكتبات الناقصة.

    archive=ultimate-odycer-server-dev-20261106.2-linux-x86_64.tar.gz
    sha256sum -c "$archive.sha256" && tar -xzf "$archive" &&
      cd "${archive%.tar.gz}" && ldd ./bin/mmorpg-server && ldd ./bin/login-server
    نزّل الخادم
  3. إنشاء قاعدة بيانات مخصصة

    أنشئ دورًا مخصصًا وقاعدة بيانات على PostgreSQL المخصص للتقييم. اختر كلمة مرور فريدة عند الطلب. يتحقق الأمر الأخير من تسجيل الدخول محليًا عبر TCP.

    sudo -u postgres createuser --pwprompt odycer_test
    sudo -u postgres createdb --owner=odycer_test ultimate_odycer_test
    psql -h 127.0.0.1 -U odycer_test -d ultimate_odycer_test -c "SELECT current_user;"
  4. ضبط الخادم وTLS

    انسخ config.example.json إلى config.json وقيّد الوصول إليه. اضبط db_host وdb_port وdb_name وdb_user وdb_password ضمن server. أبقِ network.enable_tls على true. ضع الشهادة والمفتاح في المسارين network.tls_cert_path وtls_key_path. يجب أن يثق العملاء بالشهادة وأن تطابق اسم الاتصال أو عنوان IP. استخدم JWT_SECRET نفسه في Game وLogin. فك الحزمة بالحساب الذي سيشغّل البرامج أو امنحه الوصول اللازم. استخدم مسارات TLS مطلقة وتحقق من أن العمليتين تستطيعان قراءة الشهادة والمفتاح.

    cp -n config.example.json config.json
    chmod 600 config.json
    (umask 077; set -C; printf "JWT_SECRET=%s
    " "$(openssl rand -hex 32)" > .odycer-runtime.env)
  5. شغّل Game ثم Login بعد اكتمال الترحيل

    افتح جلستي SSH في مجلد الاستخراج وحمّل ملف البيئة نفسه من دون عرض محتواه. على قاعدة فارغة شغّل Game وحده. انتظر اكتمال ترحيل PostgreSQL وبدء الاستماع في Game وWebAdmin. ثم شغّل Login في الجلسة الثانية. قد يؤدي التشغيل المتزامن إلى خطأ في علاقات قاعدة البيانات والرجوع إلى SQLite. إذا ظهر ذلك في السجل فأصلح PostgreSQL قبل المتابعة.

    Game

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/mmorpg-server
    ss -ltn

    Login

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/login-server
  6. فتح WebAdmin والسماح لأجهزة الاختبار

    شغّل bootstrap-admin بعد الترحيل وغيّر كلمة المرور المؤقتة عند الدخول عبر نفق SSH. عيّن server.login_ip وserver.server_ip إلى عنوان خاص يمكن الوصول إليه، وأعد التشغيل واسمح لشبكة الاختبار فقط بالوصول إلى TCP 2106 و7777. يرسل Login عنوان Game إلى العميل، فتحقق من إمكانية الوصول إليه ومن مطابقته لشهادة TLS. أبقِ 5432 و8080 و8082 خارج الشبكة العامة. شغّل برنامج التهيئة بحساب النظام ومجلد العمل وإعدادات PostgreSQL نفسها المستخدمة في Game. عند تبديل المستخدم، استخدم المجلد الرئيسي لحساب الخدمة.

    VPS

    set -a; . ./.odycer-runtime.env; set +a
    ./bin/bootstrap-admin

    SSH → WebAdmin

    ssh -N -L 8082:127.0.0.1:8082 operator@vps.example.com
    # http://127.0.0.1:8082/
  7. تسجيل النتيجة والنسخ الاحتياطي

    تحقق من تسجيل الدخول ودخول العالم من جهاز اختبار. عند تعذر دخول العالم، تحقق من عنوان Game المعلن وجدار الحماية والثقة بالشهادة. احفظ القاعدة والإعدادات والإصدار، وتحقق من الاستعادة في بيئة معزولة قبل الفتح للعامة.

    umask 077
    pg_dump -h 127.0.0.1 -U odycer_test -Fc -f odycer-test.dump ultimate_odycer_test
    pg_restore --list odycer-test.dump

بناء أول تجربة MMORPG قابلة للعب باستخدام Codex أو Claude Code

هدف النموذج الأولي هو وجود لاعبين في العالم نفسه مع مهمة واحدة ومكافأة محفوظة. جهّز مشروع Godot متوافقًا مع الخادم المختار. يُجهّز العميل بشكل منفصل عن حزمة الخادم.

  1. إعداد مشروع Godot

    افتح العميل المتوافق باستخدام Godot 4 .NET و.NET SDK المطلوبين للمشروع. سجّل إصدارات الخادم والعميل والبروتوكول. استخدم Git وفرعًا مخصصًا وخادمًا وحسابات للاختبار.

    Godot .NET / C#
  2. إسناد المهمة الأولى إلى المساعد

    افتح مجلد المشروع في Codex أو Claude Code وقدّم مواصفات الاتصال والإعدادات الخالية من الأسرار والنتيجة المتوقعة. اطلب تغييرًا قابلًا للتحقق في كل مرة وراجع الفرق. يمكنك طلب تحديد إعدادات Login وGame واقتراح أقل تغيير للاتصال وشرح طريقة الاختبار.

    CodexClaude Code
  3. توصيل عميل واحد أولًا

    اضبط عنوان Login بآلية المشروع وتحقق من عنوان Game الذي يستلمه العميل. أنشئ حسابين بالطريقة التي يدعمها الإصدار. أنشئ شخصية أو اخترها بالحساب الأول وادخل منطقة الاختبار. عالج مشكلات الإصدار والشهادة والاتصال أولًا. تحقق أيضًا من سجل الأصول الذي يحتاجه العميل والخادم. لا تحتوي حزمة الخادم dev-20261106.2 على asset_registry.json. إذا طلب العميل بصمة، فاستخدم السجل المرفق بمشروعه أو أنشئه بأداة المشروع من قوالب الخادم وأصول العميل. حمّله على بيئة الاختبار وأعد تشغيل Game قبل ضبط البصمة نفسها في العميل.

  4. بناء دورة لعب واحدة

    أنشئ خريطة صغيرة ونقطة ظهور وشخصية غير لاعبة ومهمة بسيطة. تحدث إليها، واجمع عنصرًا، ثم عد لتسلم المكافأة. استورد مخرجات الأدوات بالصيغ المدعومة وتحقق في Godot وعلى الخادم. اطلب إعادة استخدام مسارات الخادم للأهداف والمخزون والمكافآت.

    أدوات Codex
  5. تشغيل عميلَي Godot

    في Godot اختر Debug → Customize Run Instances وحدد نسختين، أو شغّل نسختين مكتبيتين على جهازين. استخدم ملفات تعريف أو مجلدات مستخدم منفصلة إذا حفظ العميل الحساب. سجّل الدخول بالحسابين A وB إلى الخادم والمنطقة نفسيهما. للاختبار الرسومي، اختر إصدار C# كاملًا يتضمن موارده ويدعم نظام التشغيل وبرنامج تشغيل الرسومات على أجهزة الاختبار. عند التشغيل من المشروع المصدري، استخدم إصداري Godot .NET و.NET SDK اللذين يحددهما المشروع. يمكن تشغيل الإصدار المصدّر لـ Windows على جهاز Windows بسطح مكتب والاتصال بالخادم على VPS يعمل بنظام Linux. يمكن استخدام شاشة X11 افتراضية مع إصدار Linux يدعم برنامج تشغيل الرسومات على VPS. احتفظ بملف البيان المرفق بالإصدار، وتحقق من سلامة ملفاته واسمح ببصمته في سجل Game. إذا أبلغ العميل المشغّل من المصدر عن تغيّر قائمة الملفات، فأعد إنشاء ملف البيان بأداة المشروع وحدّث سجل خادم الاختبار. يحتاج حساب التشغيل إلى صلاحية قراءة الملفات والكتابة في ملفه الشخصي. التقط صورة لكل نافذة قبل إعادة التشغيل وبعدها.

    Godot · Customize Run Instances
  6. اختبار اللعب الجماعي وحفظ الحالة

    تحقق من أن كل شخصية ترى الأخرى وأن B يرى حركة A. أكمل المهمة بواسطة A وتأكد من حصوله على المكافأة مرة واحدة وبقاء B من دون مكافأة. أعد توصيل A ثم أعد تشغيل الخادم بشكل سليم وتحقق من الشخصية والمخزون والمكافأة.

  7. تسجيل النتائج ومعالجة الإخفاقات

    دوّن الإصدارات وحسابات الاختبار والخطوات والنتائج المتوقعة والفعلية من دون أسرار. إذا تعذر رؤية الشخصيتين، فقارن المنطقة والنسخة والإصدار. إذا اختفت المكافأة، فتحقق من حفظها على الخادم. باجتياز الاختبارات يصبح النموذج الأولي قابلًا للعب الجماعي. تم التحقق من بقاء حالة المهمة ومكافأتها بعد إعادة تشغيل Game وLogin على VPS باستخدام عميلَي اختبار. باستخدام نافذتين من الإصدار الكامل المصدّر من Ultody2 لنظام Windows، تم التحقق من قتل الغوبلن ومن بقاء تقدّم المهمة ومخزون الشخصيتين في قاعدة البيانات بعد إعادة التشغيل. يبقى التحقق من جمع الغنيمة ومنح مكافأة المهمة في هذا الإصدار. قبل بدء المهمة، تأكد من أن واجهة الإصدار تتيح جميع الإجراءات المطلوبة، بما في ذلك جمع الغنيمة من الجثة إذا كان الهدف يتطلب ذلك. بعد إعادة تشغيل Game وLogin، أعد الاتصال بكلا الحسابين وقارن سجل المهام ومخزون كل شخصية.