ديسكورس فوترز 🧙

[merefield (Robert)]

واو، إضافة جديدة! هذه الإضافة أقل جدية قليلاً.

Discourse Frotz

\u003csup\u003eلم يعد من الضروري ذكر البوت (@mention) في كل خطوة. بمجرد بدء اللعب، ما عليك سوى الرد عليه.

مستودع Git: GitHub - merefield/discourse-frotz: A plugin that uses Frotz to give you an interactive fiction experience on your Discourse forum · GitHub

ما هي هذه الإضافة؟

إنها ‘بوت’ يتيح لك لعب القصص التفاعلية (أي ألعاب المغامرات النصية الكلاسيكية) على منتدى Discourse الخاص بك، وهي في الأساس أداة ربط لمفسر Z-machine القياسي والمذهل المسمى ‘frotz’ الموجود في David Griffith / frotz · GitLab

كيفية الاستخدام

تضيف الإعدادات لعبتين، ويمكنك إضافة المزيد من خلال الإعدادات.

تحتوي كل إدخال على عنوان واسم ملف القصة.

لبدء التفاعل، تحتاج إلى ذكر البوت المحدد في الإعدادات (@mention). بعد ذلك، يكفي الرد على منشور من منشورات البوت.

للعرض قائمة بالألعاب المتاحة، يجب عليك أولاً ذكر البوت وطرح السؤال التالي:

@mybot list games

سيظهر لك هذا مجموعة الخيارات المتاحة.

لبدء لعبة، اكتب:

start game x مع استبدال x برقم الخيار.

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

لمتابعة لعبة قائمة، اكتب:

continue game x مع استبدال x برقم الخيار.

ملاحظة: إعادة البناء الكاملة ستدمر جميع ملفات الحفظ. هذا حل وسط ضروري.

كيف ألعب لعبة قصص تفاعلية (IF)؟

كثير من “الميتات” (Meta’s) نشأوا مع هذه الألعاب. لأولئك الأقل دراية بها، تحقق من هذه ورقة الغش: Play Some Interactive Fiction

الإعداد

إنشاء مستخدم البوت

(عذراً، أتمتة هذا الإجراء مدرجة في قائمتي!)

في جلسة SSH، أدخل الحاوية الخاصة بك وافتح وحدة تحكم Rails:

\n./launcher enter app\nrails c\n\n

ثم قم بما يلي:

\nu = User.create!(username: "Frotz", name: "FrotzBot", id:-5, email: "not@really.valid")\nu.activate\n\n

سيصبح البوت الجديد متاحاً للإعداد من خلال واجهة المستخدم. انتقل إلى إعدادات المستخدم في الواجهة عبر زر المسؤول وقم بإيقاف جميع عمليات الإرسال عبر البريد الإلكتروني. قم بتحديث الصورة الرمزية حسب رغبتك.

تثبيت Discourse Frotz

تحديث ملف app.yml الخاص بك

هذا الإجراء أكثر تدخلاً من الإضافات المعتادة.

أضف التالي إلى ملف app.yml:

\nhooks:\n after_code:\n - exec:\n cd: $home\n cmd:\n - git clone https://gitlab.com/DavidGriffith/frotz\n - exec:\n cd: $home/frotz\n cmd:\n - make dfrotz\n - exec:\n cd: $home/frotz\n cmd:\n - mkdir savegames\n - exec:\n cd: $home/frotz\n cmd:\n - mkdir stories\n - exec:\n cd: $home/frotz/stories\n cmd:\n - wget -O zork1.z3 https://eblong.com/infocom/gamefiles/zork1-r119-s880429.z3\n - exec:\n cd: $home/frotz/stories\n cmd:\n - wget --no-check-certificate http://www.douglasadams.com/creations/hhgg.z3\n - exec:\n cd: $home/plugins\n cmd:\n - git clone https://github.com/merefield/discourse-frotz\n\n

قبل إدخالات الإضافات الأخرى الخاصة بك.

ستحتاج أيضاً إلى إضافة إضافة Discourse BBCode!!

أعد البناء باستخدام الأمر المعتاد ./launcher rebuild app

الآن انتقل إلى إعدادات الإضافة واختر مستخدم البوت الذي أضفته سابقاً:

القصص

ستلاحظ أنني أضفت بضع قصص. يمكنك العثور على المزيد في https://ifdb.tads.org/.
ومع ذلك، انتبه لحدود المعدل هنا! قد يؤدي الحصول على عدد كبير جداً من القصص من نفس الموقع إلى حدوث خطأ.

لاحظ أيضاً أن القصص ليست مستضافة على خوادم محمية بـ HTTPS (توت توت).

إذا أصررت على تحميل المزيد، أضفها إلى ملف app.yml. يمكنك أيضاً إضافتها يدوياً من موجه الأوامر، لكن اعلم أن هذه ستُحذف عند إعادة البناء الكاملة التالية.

تمكين FrotzBot للرسائل الخاصة (يُنصح بالحذر)

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

الافتراضي: OFF

إذا لم يكن البوت مفعلًا هناك، فسيحصل المستخدم على رسالة مهذبة:

تقييد FrotzBot حسب الفئة

يمكنك تقييد البوت على (قائمة) فئة لتجنب ملء المناطق الأخرى:

اختصارات لوحة المفاتيح!

هذا أمر بالغ الأهمية لتحسين تجربة “اللعب”. وفي الواقع، ما عليك سوى تذكر اختصارين:

• \u003ckbd\u003eShift\u003c/kbd\u003e-\u003ckbd\u003eR\u003c/kbd\u003e للرد على البوت

• \u003ckbd\u003eCtrl\u003c/kbd\u003e-\u003ckbd\u003eEnter\u003c/kbd\u003e لتقديم حركتك التالية

القيود والاعتبارات

لا يتم دعم جميع صيغ القصص والألعاب بعد، ومن غير المرجح أن يتم دعمها. هناك العديد من الألعاب التي لا تعمل بسبب طبيعة بروتوكولات الاستدعاء والاستجابة الخاصة بها. وبسبب الطريقة التي نتفاعل بها عبر المنشورات، يجب أن نطلب من Frotz حفظ الحالة بعد كل حركة. إذا لم تؤدي إحدى خطوات اللعبة إلى موجه يمكن للنظام عندها الحفظ (مع تجاهل موجهات “اضغط أي مفتاح” أو “المزيد” التي يجب معالجتها)، فلن تعمل القصة. على سبيل المثال، في لعبة “Act of Murder” (لعبة رائعة!)، تسأل السيدة عند الباب عما إذا كنت شرطيًا. للأسف، هذه حالة في اللعبة لا يمكن حفظها، وبالتالي تفشل في هذا الشرط، ولا أرى طريقة لجعل ذلك يعمل.

ملاحظة: وضع قائمة البريد الإلكتروني هو كارثة مع هذا، لذا تأكد من عدم استخدامه قبل محاولة استخدام هذه الإضافة!

يمكن القول إنها تهدر موارد المنتدى قليلاً لأنها تتطلب منشورين على الأقل لكل “حركة”. من الواضح أنه غالباً ما يكون أكثر ملاءمة للعب هذه الأنواع من الألعاب باستخدام واجهة دردشة بدلاً من منتدى، لكن يمكنك القول إن هذا يمكن استخدامه لإنشاء أدلة الحل (Walkthroughs)؟

لحل أقل تدخلاً، ضع في اعتبارك: Turning a topic into interactive fiction ;)

التعليقات

كل التعليقات موضع ترحيب!

الاعتمادات

تستغل هذه الإضافة David Griffith / frotz · GitLab وهو مفسر Z الخاص بـ Frotz والذي يتم نسخه وإنشاؤه بواسطة برنامج الإعداد.

شكراً لـ @P16 على السماح لي باستخدام مقتطفات من كود لبوت دردشة مغلق المصدر عملنا عليه معاً.

[merefield (Robert)]

Wooah, back again!

New Feature-rettes

Enable FrotzBot for private messages (at your peril! )

Allows users to play in private, but usage will be less transparent. If you have a big enough server this may not be an issue for you.

various fixes, code improvements and new feature to control use in private messages

default: OFF

If (s)he is not enabled there, the user will get a polite message:

Restrict to a list of Categories, or allow all:

FEATURE: restrict public games by Category

default: ON for all Categories

[Benjamin_D (Benjamin Decotte)]

Hi Robert! Thank you, I really like this plugin !
I tried to install it on dev environment (without docker) and my system asked for the ncursesw lib when making dfrotz, after installing that it worked, will it be the case with a prod env with docker?

[merefield (Robert)]

I tested on Production and building on Docker (to my surpirse) worked out of the box. Feel free to deploy to a Production instance and let me know how you get on.

Glad you like it!!

[Benjamin_D (Benjamin Decotte)]

For those like me, who might loose their last few hairs about that:

@merefield

Each entry contains a Title, name of the story file, and three calibration settings to cull the returned text to remove the housekeeping text so users see just the story text.

hhgg.z3,9,7,3
that’s :

  story_header_lines = 9
  story_load_lines = 7
  story_save_lines = 3

and now, how to adapt it… , that’s an adventure inside an adventure…!

[merefield (Robert)]

I’m currently working with the maintainer of Frotz to see if we can do away with those. It’s an approach I ported from restful-Frotz but hardly perfect

[Benjamin_D (Benjamin Decotte)]

Yes ! found it !
kheper.z8,20,15,4 almost works
for this one :

Kheper – Une aventure égyptienne – Fiction-interactive.fr

it’s nothing, but there is something weird

) Line-type display OFF
Compression mode MAX, hiding top 0 lines

is displayed once by Pause() with

[Pause notNeeded;
@read_char 1 notNeeded;
rtrue;
];

[merefield (Robert)]

Ha, yeah, there are lots of quirks and a considerable amount of variety in the stories. I cannot promise to support all.

Right now my focus is on:

1. simplifying code
2. making the code more secure
3. adding formatting where pragmatic.

#3 is surprisingly hard.

[merefield (Robert)]

I’ve pushed some improvements to a feature branch:

GitHub - merefield/discourse-frotz at formatting_security_and_simplification

This does away with the silly suppression settings, introduces translation to BBCode to support formatting and colour, leverages the Dumb Frotz command line options better, obviates the need to write to a text stream and squashes a vulnerability.

This branch requires the official BBCode plugin to be installed.

I’m still experimenting with it. Feel free to do so too.

I’ll probably merge after some significant trials.

[elijah (Eli the Bearded)]

Does the plugin need the whole frotz repo clone or does it just need $home/frotz/dfrotz to exist? Because I’d rather just compile it once and save the binary between rebuilds.

[merefield (Robert)]

Not sure why you would care? The resources we are talking about are comparatively tiny. (6MB for the entire repo post make versus Gigabytes for the forum?). It clones the whole repo, then just makes dfrotz. Perhaps that is slightly wasteful, but the simplicity and repeatability is more important I feel. I could go into greater detail and perform a sparse clone, but that would make the build script more complex and less robust. Would it be worth it? Feel free to suggest an optimisation. This is all building inside the container, so will get cleaned whenever the container does.

[elijah (Eli the Bearded)]

I’m just trying to optimize for my tiny server, not asking you to change the general install.

[Chaboi_3000]

This is a really cool plugin! This reminds me of a “classic” computer game that was created years ago(I forgot the name).

[merefield (Robert)]

It’s a great suggestion for a future optimisation if I can keep it simple and robust. Thanks!

[merefield (Robert)]

Yes there are many playable classics. More via the link in the OP.

[merefield (Robert)]

تحديث كبير:

(استغرق هذا شهورًا من العمل الخلفي المتقطع والتنسيق مع فريق Frotz).

تقديم تنسيق الألوان الكامل والنص أحادي المسافة للقصص

Bbcode frotz (#2)

يأتي هذا التحديث الكبير مع مجموعة من التحسينات:

• أُضِيف دعم تنسيق الألوان والنص أحادي المسافة
• تحسّنت الإعدادات المبسّطة: لم تعد تتطلب معاينة الرأس والتذييل، بل فقط العنوان المطلوب وملف القصة، هورا!
• تحسّنت استخدامات مكتبة Open3 gem لأوامر النظام، مما يقلل من خطر الإساءة/الثغرات الأمنية.
• تحسّنت التفاعلات الداخلية مع سطر الأوامر لإزالة الحاجة إلى ملفات التدفق، وتتعامل الآن مع مطالبات “المزيد/اضغط أي مفتاح”

يتطلب الآن إضافة Discourse BBCode!!

تطلب هذا التعاون مع مُصان Frotz، ديفيد غريفيثز، وأحد الأعضاء النشطين جدًا في تلك المجتمع، Borg323، الذي كتب إضافات BBCode وفقًا لمعيار BBCode الخاص بـ Discourse. شكرًا جزيلاً لهما! اضطررنا إلى الإبداع قليلاً لجعل النص أحادي المسافة يعمل، لكن الحل رائع حقًا!

بعض الأمثلة على التنسيق الجديد (لم أختبر هذه القصص بالكامل، هذه مجرد أمثلة على التنسيق)

ولاحظ البوصلة الملونة هنا:

المشاكل المعروفة: هناك العديد من الألعاب التي لا تعمل بسبب طبيعة بروتوكولات الاستدعاء والاستجابة الخاصة بها. إذا لم تؤدّ خطوة واحدة في اللعبة إلى مطالبة يمكنك فيها الحفظ (متجاهلًا مطالبات “اضغط أي مفتاح” أو “المزيد” التي يجب معالجتها)، فلن تعمل القصة. على سبيل المثال، في لعبة Act of Murder (لعبة رائعة!)، تسأل السيدة عند الباب عما إذا كنت شرطيًا. للأسف، هذه حالة في اللعبة لا يمكن حفظها، لذا تفشل في هذا الشرط، ولا أرى طريقة يمكننا من خلالها جعل ذلك يعمل.

من المرجح أن تكون هناك ألعاب أصبحت الآن متوافقة مع Discourse Frotz بينما لم تكن كذلك من قبل… يُرجى التجربة، ولكن لاحظ القيد المذكور أعلاه!

أخبرني إذا واجهت أي مشاكل في جعل هذا يعمل، وسأقوم بتحسين التعليمات حسب الحاجة.

[merefield (Robert)]

تذكير: يمكنك استخدام اختصارات لوحة المفاتيح لتحسين تجربتك مع هذه الإضافة:

• Shift+R للرد على البوت

• Ctrl+Enter لتقديم حركتك التالية

(اختصارات لوحة المفاتيح القياسية الافتراضية).

[Benjamin_D (Benjamin Decotte)]

مرحبًا روبرت!
أخيرًا توفرت لي الوقت للمتابعة، حتى الآن كل شيء على ما يرام، لقد عملت مباشرة في بيئة الإنتاج

بشكل غريب، لا يستطيع frotz الرد على الرسائل الخاصة إلا إذا قمت بضبطه في أي فئة أيضًا
الخطوة التالية: اللعب

[merefield (Robert)]

شكرًا على التقرير!

لقد قمت بإصلاحه: FIX: behaviour of private messages playing permission setting · merefield/discourse-frotz@34b022e · GitHub

ملاحظة: يجب إضافة بعض اختبارات الوحدة!

[Benjamin_D (Benjamin Decotte)]

حاولت إضافة :grin: في المصدر،

سيكون الأمر ممتعًا!