روبوت محادثة Minecraft لكل خادم
توفر اللوحة واجهة دردشة آلية (chatbot) قابلة للتكوين من قبل المسؤول لكل خادم Minecraft مُدار، ويتم إعدادها في علامة التبويب الإعدادات ← الدردشة الآلية (Settings → Chatbot) الخاصة بالخادم. تتصل بنقطة نهاية متوافقة مع OpenAI لإنهاء المحادثات (chat-completions)، بما في ذلك Ollama على مضيف آخر في الشبكة المحلية (LAN). كل خادم له نقطة النهاية الخاصة به، والنموذج، واسم الاستدعاء، والشخصية، وسياسة النسخ، ورسائل التواصل، وسياسة القوة. اسم الاستدعاء الافتراضي هو @wizard، والشخصية الافتراضية تمثل ساحرًا قديمًا ومرحًا داخل اللعبة؛ كلاهما قابل للتعديل.

تجربة اللاعب
Section titled “تجربة اللاعب”- يمكن لأي لاعب استخدام
@wizard <رسالة>(أو اسم الاستدعاء المُكوّن) للمحادثة والحصول على مساعدة وصفات Minecraft الأصلية (vanilla) مع مراعاة إصدار اللعبة. - تذكّر تحيات الانضمام وفحص لمرة واحدة قابل للتكوين اللاعبين بتوفر الدردشة الآلية.
@wizard chatيفتح نافذة محادثة قصيرة اختيارية؛@wizard byeيغلقها. - يمكن للمستخدمين الأساسيين استدعاء قوى ذاتية/عالمية مُفعّلة. يمكن لمتحكمي القوى استدعاء إجراءات مُصادق عليها بشكل منفصل تؤثر على لاعب آخر متصل بالإنترنت. يظل اللاعبون في أي من المجموعتين مقتصرين على المحادثة فقط.
- تستخدم الهدايا الذاتية للمستخدمين الأساسيين قائمة مسموح بها للعناصر. يمكن للمتحكمين منح لاعب آخر أي عنصر أصلي (vanilla) أو مُعدّل (modded) صالح ومُعرّف بالاسم (namespaced)، مع مراعاة حد الكمية وضمانات القوة الأخرى.

التصميم والأمان
Section titled “التصميم والأمان”التكوين والنسخ مخصصان للمسؤول فقط. لا يتلقى النموذج أبدًا بيانات RCON خام أو أوامر تنفيذ عشوائية. يكشف الرسالة فقط عن الأداة الثابتة الوحيدة التي تطابق نيتها الصريحة؛ يتحقق كود الخادم من التفويض، والحجج، والأعلام، والكميات، وفترات التهدئة، وأسماء اللاعبين المتصلين بالإنترنت بدقة قبل تنفيذ عملية خدمة موجودة. يتم رفض مُحدّدات Minecraft (selectors)، ولا يمكن لإجراءات اللاعبين المتعددين استهداف المتصل، وتبدأ القوى في وضع التشغيل التجريبي (dry-run)، ويتم تدقيق كل قوة مُحاولة. النماذج غير المدعومة التي تستدعي الأدوات تعود إلى المحادثة فقط.
الردود محدودة لدردشة Minecraft. تأتي الوصفات الأصلية المعروفة من بيانات الوصفات المُجمّعة والمُصنّفة حسب الإصدار وتُعرض كصفوف ثابتة 2x2/3x3؛ لا يُعتمد على LLM لاختراع تخطيطات الوصفات. الوصفات غير المعروفة أو المُعدّلة توجه اللاعب إلى JEI/REI بدلاً من اختلاق إجابة.
ملفات التنفيذ الرئيسية
Section titled “ملفات التنفيذ الرئيسية”src/services/wizard.js: تكوين لكل خادم، طلبات متوافقة مع OpenAI، معالجة الدردشة، التواصل، الاحتفاظ بالنسخ، وحدود الاستجابة.src/services/wizardPowers.js: فحوصات الأدوار، مخططات الأدوات الخاصة بالنية، التحقق، التنفيذ، فترات التهدئة، وتدقيق القوى.src/services/wizardRecipes.js: بحث وصفي مُصنّف حسب الإصدار وتنسيق الشبكة. تأتي بيانات الوصفات والعناصر من حزمةminecraft-dataالمُجمّعة. (مسودة سابقة لهذه الوثيقة أشارت إلى مجلدsrc/data/recipes/لم يتم تثبيته أبدًا؛ لا يوجد مثل هذا المجلد، والبيانات موجودة في الحزمة. انظر “حجم التبعية”.)src/analytics/ingest.js: يوجه الانضمامات والمغادرات ودردشة اللاعبين المُحلّلة إلى الدردشة الآلية.src/web/routes/wizard.js،public/js/pages/integrations.js، وviews/partials/server/integrations.hbs(عبرchatbot.hbs): واجهة برمجة تطبيقات المسؤول وعلامة تبويب الإعدادات ← الدردشة الآلية لكل خادم.src/db/migrations/011_wizard_chat.js،013_wizard_invocation_name.js،015_wizard_powers.js،017_wizard_outreach.js، و019_wizard_power_controllers.js: مخطط قاعدة البيانات الدائم.test/wizard.test.js: اختبارات التفويض، حدود الأدوات، الاحتفاظ، التواصل، وسلوك الدردشة.
يتم الاحتفاظ بأسماء مسارات/وحدات/جداول wizard الداخلية لتوافق الترقية وواجهة برمجة التطبيقات؛ “chatbot” هو المصطلح المُستخدم للمنتج الذي يراه المستخدم. وبالمثل، فإن حقل power_testers_json المُخزّن يتوافق مع مجموعة المستخدمين الأساسيين في واجهة المستخدم.
حجم التبعية (minecraft-data)
Section titled “حجم التبعية (minecraft-data)”تستخدم مساعدة الوصفات حزمة minecraft-data. إنها كبيرة على القرص (حوالي 429 ميجابايت مُثبّتة)، وتشحن داخل صورة الإنتاج لأنها تبعية وقت تشغيل، وليست تبعية تطوير. نحتفظ بها عن قصد حتى تعمل مساعدة الوصفات دون اتصال بالإنترنت لكل إصدار Minecraft بدون استدعاء شبكة.
ملاحظات لمن يطلع على هذا لاحقًا (بشريًا أو آليًا)، حتى لا يكون الحجم مفاجئًا:
- يتم استخدام بيانات Java (
pc) فقط حاليًا. يقرأwizardRecipes.jsجداولminecraftData.versions.pcوالجداول الخاصة بكل إصدارrecipesوitemsوblocks. الملفات التي يلمسها فعليًا تُضاف إلى حوالي 15 ميجابايت عبر كل إصدار pc. - حوالي 330 ميجابايت من الحزمة هي
data/bedrock، ولا يقرأ أي شيء هنا حاليًا. نتركها في مكانها عن قصد. إذا أضافت اللوحة دعمًا لـ Bedrock Minecraft في أي وقت، فإن بيانات وصفات وعناصر Bedrock موجودة بالفعل هنا، لذا يمكن لميزة الوصفات أن تنمو لتشمل خوادم Bedrock دون إضافة تبعية جديدة. ابدأ منminecraftData.versions.bedrockواتبع نفس الشكل مثل مسار pc. - إذا كان يجب تقليل الحجم في أي وقت قبل وصول دعم Bedrock، فهناك بالفعل نمط لذلك في هذا المستودع. يجلب
src/services/itemRegistry.jsملفاتminecraft-dataمن jsDelivr CDN عندما يحتاجها ويخزنها مؤقتًا فيapi_cache. إما هذا النهج، أو مجموعة فرعية صغيرة مُختارة يدويًا منsrc/data/recipes/تغطي بعض الإصدارات الشائعة، من شأنها تقليص الصورة كثيرًا.
التخزين المحلي والفحص اليدوي
Section titled “التخزين المحلي والفحص اليدوي”جميع الإعدادات والنسخ المُحتفظ بها تعيش في قاعدة بيانات SQLite الخاصة باللوحة في /data/panel.db داخل حاوية اللوحة. مع التركيب القياسي لـ Compose، يكون مسار المضيف هو ${DATA_DIR_HOST}/panel.db (على سبيل المثال /opt/msm/data/panel.db). الجداول ذات الصلة هي wizard_configs و wizard_transcripts و wizard_outreach؛ تدقيق القوى هو صفوف في جدول events من النوع wizard-power. مفتاح LLM API الاختياري مُشفر بـ AES-256-GCM باستخدام مفتاح اللوحة في حالة السكون (at-rest key)، .secret-key في مجلد البيانات (منفصل عن SESSION_SECRET).
قم بعمل نسخة احتياطية لقاعدة البيانات وأوقف اللوحة قبل إجراء تعديلات SQLite مباشرةً حتى يتم التعامل مع WAL الخاص بها بأمان. يُفضل استخدام واجهة المستخدم/واجهة برمجة التطبيقات للمسؤول لأنها تطبق التحقق والتشفير. احتفظ بملفات panel.db و panel.db-wal و panel.db-shm معًا عند نسخ قاعدة بيانات حية.