تنزيل retrom - تنزيل رمز مصدر retrom

retrom

شفرة المصدر الأخرى

v0.4.1

تنزيل

ريتروم

مكتبة ألعاب مركزية/خدمة إدارة المجموعات مع التركيز على المحاكاة. قم بتكوينها مرة واحدة، والعب في أي مكان.

تحذير

في ظل التطوير الشديد: توقع حدوث تغييرات متكررة، وقم بتحديث التثبيت الخاص بك بعناية.

ملخص

Retrom هي خدمة إدارة مكتبة ألعاب مركزية تتيح لك استضافة ألعابك على جهاز واحد، وتوصيل العملاء على أي عدد من الأجهزة الأخرى لـ (إلغاء) تثبيت/تنزيل الألعاب المذكورة محليًا وبالتالي تشغيلها.

ريتروم

تحضير
الخادم
عميل
IGDB
ألعاب متعددة الملفات (مستحسن)
ألعاب الملف الواحد

هيكل المكتبة
موفري البيانات الوصفية
عامل ميناء (مستحسن)

عميل سطح المكتب
عميل الويب
ملخص
الميزات الأساسية
لقطات الشاشة والتسجيلات
خريطة الطريق
تثبيت

الميزات الأساسية

استضافة خدمة مكتبة الألعاب السحابية الخاصة بك
قم بفحص نظام الملفات الخاص بك بحثًا عن الألعاب/المنصات وقم بإضافتها تلقائيًا إلى مكتبتك
تثبيت/إلغاء تثبيت وتشغيل الألعاب من الخدمة على أي عدد من عملاء سطح المكتب.

دعم أنظمة التشغيل Windows وMacOS وLinux!

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

لقطات الشاشة والتسجيلات

الشاشة الرئيسية

عرض اللعبة

خريطة الطريق

تثبيت

نصيحة

بعد التثبيت، تأكد من مراجعة دليل البدء السريع للبدء والتشغيل بسرعة.

حذر

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

تحضير

هيكل المكتبة

يدعم Retrom حاليًا المكتبات ذات الهياكل التالية:

ألعاب متعددة الملفات (مستحسن)

يجب أن يتم تمثيل كل لعبة بدليل يحتوي على ملفات اللعبة (حتى بالنسبة للألعاب/المنصات ذات الملف الواحد). يجب أيضًا تضمين كل لعبة داخل دليل يمثل النظام الأساسي الذي يتم تشغيلها عليه، ويجب أن تكون أدلة النظام الأساسي موجودة في جذر دليل library .

مثال:

افترض أن لديك الألعاب:

سباك المتأنق
سباك المتأنق 2

بالنسبة لمنصة Game Guy والألعاب:

سباك المتأنق العالم
سباك المتأنق وأخ سباك المتأنق

لمنصة Game Guy Advance. يجب أن تبدو مكتبتك كما يلي:

library/
  game_guy/
    plumber_dude/
      plumber_dude.gg
    plumber_dude_2/
      plumber_dude_2_part_1.gg
      plumber_dude_2_part_2.gg
  game_guy_advance/
    plumber_dude_world/
      plumber_dude_world.gga
    plumber_dude_and_plumber_dudes_brother/
      plumber_dude_and_plumber_dudes_brother.gga

ألعاب الملف الواحد

بدلاً من تمثيل كل لعبة بواسطة دليل، قد يكون لديك مكتبة تكون فيها كل لعبة بسيطة في ملف واحد في دليل النظام الأساسي المعني.

مثال:

افترض نفس الألعاب والأنظمة الأساسية كما في المثال الموجود في Multi-File Games. يجب أن تبدو مكتبتك كما يلي:

library/
  game_guy/
    plumber_dude.gg
    plumber_dude_2.gg
  game_guy_advance/
    plumber_dude_world.gga
    plumber_dude_and_plumber_dudes_brother.gga

موفري البيانات الوصفية

يستخدم Retrom موفري البيانات الوصفية لتنزيل البيانات التعريفية لألعابك. حاليًا، الموفر الوحيد المدعوم هو IGDB. ومن المقرر دعم المزيد من مقدمي الخدمات.

IGDB

لاستخدام موفر البيانات التعريفية IGDB، ستحتاج إلى إنشاء حساب على موقع IGDB وإنشاء تطبيق جديد للحصول على معرف العميل الخاص بك وسرّه. يمكنك القيام بذلك باتباع التعليمات هنا.

الخادم

ملحوظة

متطلبات

عامل ميناء
Docker Compose (اختياري، ولكن يوصى به)
قاعدة بيانات PostgreSQL (يمكن اختياريًا استخدام المثال الموضح أدناه)
مكتبة ألعاب منظمة بطريقة يمكن لـ Retrom فهمها
مفاتيح API لموفري البيانات الوصفية

يتم تكوين الخادم عبر ملف التكوين. فيما يلي مثال لملف التكوين:

نصيحة

يمكنك استبدال db_url بعنوان URL لقاعدة البيانات الخاصة بك

حذر

يجب أن يكون path الموجود في content_directories هو المسار الموجود داخل الحاوية . إذا كنت تستخدم Docker، فيجب عليك تحميل أدلة مكتبتك على هذه المسارات. راجع قسم Docker لمزيد من المعلومات.

 { "اتصال": {"المنفذ": 5101،"db_url": "postgres://minecraft_steve:super_secret_password@retrom-db/retrom"
  }، "أدلة_المحتوى": [
    { "path": "path/to/my/library/", "storage_type": "MultiFileGame"},
    { "path": "path/to/my/library/with/single_file_games/", "storage_type": "SingleFileGame"}
  ], "igdb": {"client_secret": "super_secret_client_secret!!!1"، "client_id": "my_IGDB_ID_1234"
  }
}

عامل ميناء (مستحسن)

الطريقة الموصى بها حاليًا لتشغيل الخادم هي عبر Docker، ومن الأفضل باستخدام docker compose .

نصيحة

إذا لم تكن على دراية بـ Docker Compose، فيمكنك قراءة الوثائق هنا.

دعونا نضبط المثال أعلاه config.json لحاوية الإرساء الخاصة بنا، ونحفظه في مكان آمن. في هذا المثال، سنفترض أنه تم حفظه في /home/minecraft_steve/config_dir/config.json . لاحظ أننا بحاجة إلى دليل التكوين لتثبيته في الحاوية، وليس فقط الملف نفسه.

لنفترض أيضًا أن لدينا مكتبات في /home/minecraft_steve/library1/ وفي /home/minecraft_steve/library2/ .

فيما يلي مثال لملف التكوين:

 { "اتصال": {"المنفذ": 5101،"db_url": "postgres://minecraft_steve:super_secret_password@retrom-db/retrom"
  }، "أدلة_المحتوى": [
    { "المسار": "/library1", "storage_type": "MultiFileGame"},
    { "المسار": "/library2"، "storage_type": "SingleFileGame"}
  ], "igdb": {"client_secret": "super_secret_client_secret!!!1"، "client_id": "my_IGDB_ID_1234"
  }
}

بعد ذلك، سيساعدك هذا المثال لملف docker-compose.yml على البدء:

 الخدمات: ريتروم: الصورة: ghcr.io/jmberesford/retrom-service: أحدث الرياضات:
      - 5101:5101 - 3000:3000 # للوصول إلى مجلدات عميل الويب:
      - /home/minecraft_steve/config_dir:/config/ # الدليل الذي يحتوي على ملف التكوين الخاص بك - /home/minecraft_steve/library1:/library1 # الدليل الذي يحتوي على مكتبتك الأولى - /home/minecraft_steve/library2:/library2 # الدليل الذي يحتوي على مكتبتك الثانية

  # اختياري: قم بتدوير حاوية postgres لاستخدامها كقاعدة بيانات، إذا كنت
  # ليس لديك واحدة بالفعل.
  #
  # اقرأ المستندات هنا: https://hub.docker.com/_/postgres
  retrom-db:container_name: retrom-dbhostname: retrom-db # يجب أن يتطابق هذا مع db_url في ملف التكوين الخاص بك image: postgres:16restart: ما لم يتم إيقاف المجلدات: # لتخزين بيانات قاعدة البيانات على المضيف، قم بتغيير هذا المسار إلى أي دليل تريده - /home/minecraft_steve/retrom_data/:/var/lib/postgresql/dataenvironment: POSTGRES_USER: يجب أن يتطابق مستخدم minecraft_steve # db، المستخدم للاتصال بقاعدة البيانات، مع db_user في ملف التكوين الخاص بك POSTGRES_PASSWORD: super_secret_password # كلمة مرور db للمستخدم أعلاه، يجب أن تتطابق مع كلمة مرور db_password في ملف التكوين الخاص بك POSTGRES_DB: اسم retrom # db، يجب أن يتطابق مع db_name في ملف التكوين الخاص بك

يمكنك بعد ذلك تشغيل docker-compose up في الدليل الذي يحتوي على ملف docker-compose.yml الخاص بك لبدء الخدمة.

سيتم الوصول إلى عميل الويب عبر المنفذ 3000، والخدمة نفسها على المنفذ 5101 - والذي يمكن الوصول إليه بواسطة أي عميل لسطح المكتب.

البضائع

خدمة Retrom متاحة أيضًا عبر Cargo. سيؤدي التثبيت عبر البضائع إلى إنشاء الملف الثنائي على نظامك، لذا ستحتاج إلى تثبيت سلسلة أدوات Rust.

يُقترح استخدام Rust لتثبيت سلسلة أدوات Rust. ستحتاج أيضًا إلى التأكد من تثبيت بعض التبعيات على نظامك:

libssl-dev (أو ما يعادله لنظامك)
libpq-dev (أو ما يعادله لنظامك)

حذر

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

إذا تم استيفاء المتطلبات المسبقة، يمكنك تثبيت Retrom عبر Cargo باستخدام الأمر التالي:

 خدمة تثبيت البضائع الرجعية

يمكنك بعد ذلك تشغيل الخدمة باستخدام الأمر التالي:

 RETROM_CONFIG=/path/to/your/config.json retrom-service

عميل

عميل سطح المكتب

ما عليك سوى التوجه إلى صفحة الإصدارات وتنزيل أحدث إصدار لمنصتك. العميل متاح لنظام التشغيل Windows وMacOS (شرائح سلسلة Intel وM) وLinux.

في بعض الأحيان، قد تكون هناك إصدارات تصحيحية موجودة في الإصدار. يجب عليك بشكل عام أن تفضل الإصدارات التي لا تتضمن تصحيح الأخطاء، إلا إذا تم إرشادك لاستخدام إصدار تصحيح الأخطاء بواسطة أحد المطورين لأغراض تصحيح الأخطاء. سيكون هناك دائمًا إصدار غير قابل للتصحيح لأي إصدار معين، ما عليك سوى البحث عن ملف يحمل نفس الاسم بدون اللاحقة -debug .

قد يساعدك ما يلي في التمييز بين الإصدارات المختلفة:

ملفات *-setup.exe مخصصة لنظام التشغيل Windows (يفضل هذا على الإصدار .msi، إلا إذا كان لديك سبب وجيه لعدم القيام بذلك)
ملفات *.msi مخصصة لنظام التشغيل Windows (تفضل إصدار .exe على هذا)
*-x64.dmg مخصصة لنظام التشغيل MacOS على شرائح Intel
*-aarch64.dmg مخصصة لنظام التشغيل MacOS على شرائح سلسلة M
*-x64.AppImage مخصصة لنظام التشغيل Linux
*-x64.deb مخصصة لنظام Linux (التوزيعات المستندة إلى Debian)
*-x64.rpm مخصصة لنظام التشغيل Linux (التوزيعات المستندة إلى Red Hat)