رفتن به محتوا

چت‌بات اختصاصی ماینکرفت برای هر سرور

← بازگشت به فهرست مستندات

این پنل یک چت‌بات پیکربندی‌شده توسط مدیر برای هر سرور Minecraft مدیریت‌شده ارائه می‌دهد که در تب تنظیمات → چت‌بات سرور راه‌اندازی می‌شود. این سیستم به یک نقطه پایانی سازگار با OpenAI برای تکمیل چت متصل می‌شود، از جمله Ollama روی یک میزبان دیگر در شبکه محلی (LAN). هر سرور نقطه پایانی، مدل، نام فراخوانی، شخصیت، خط‌مشی رونوشت، پیام‌های اطلاع‌رسانی و خط‌مشی قدرت مخصوص به خود را دارد. فراخوانی پیش‌فرض @wizard است و شخصیت پیش‌فرض یک جادوگر باستانی و بازیگوش در دنیای بازی را نمایش می‌دهد؛ هر دو قابل ویرایش هستند.

تنظیمات چت‌بات

  • هر بازیکنی می‌تواند از @wizard <پیام> (یا نام فراخوانی پیکربندی‌شده) برای گفتگو و راهنمایی دستور پخت و پز اصلی (Vanilla) که وابسته به نسخه Minecraft است، استفاده کند.
  • پیام‌های خوش‌آمدگویی هنگام ورود و یک یادآوری یک‌باره قابل پیکربندی برای بررسی وضعیت جلسه بازی، در دسترس بودن چت‌بات را به بازیکنان یادآوری می‌کند. @wizard chat پنجره گفتگوی کوتاه اختیاری را باز می‌کند؛ @wizard bye آن را می‌بندد.
  • کاربران عادی می‌توانند از قدرت‌های فعال‌شده خود/جهان استفاده کنند. کنترل‌کننده‌های قدرت می‌توانند اقدامات تأیید شده جداگانه را که بر بازیکن آنلاین دیگری تأثیر می‌گذارد، اجرا کنند. بازیکنانی که در هیچ‌کدام از این گروه‌ها نیستند، فقط می‌توانند گفتگو کنند.
  • هدایای خودکار کاربران عادی از یک لیست مجاز آیتم استفاده می‌کنند. کنترل‌کننده‌ها می‌توانند هر آیتم معتبر نام‌گذاری شده (namespaced) اصلی (Vanilla) یا مد شده را به بازیکن دیگری بدهند، مشروط بر محدودیت مقدار و سایر تدابیر امنیتی قدرت.

رونوشت‌های چت‌بات

پیکربندی و رونوشت‌ها فقط برای مدیران قابل دسترسی هستند. مدل هرگز به RCON خام یا اجرای دستورات دلخواه دسترسی ندارد. یک پیام فقط ابزار ثابت و مشخصی را که با هدف صریح آن مطابقت دارد، افشا می‌کند؛ کد سرور قبل از اجرای یک عملیات سرویس موجود، مجوز، آرگومان‌ها، پرچم‌ها، مقادیر، زمان‌های خنک‌سازی (cooldowns) و نام دقیق بازیکنان آنلاین را تأیید می‌کند. انتخابگرهای Minecraft رد می‌شوند، اقدامات بین بازیکنان نمی‌توانند تماس‌گیرنده را هدف قرار دهند، قدرت‌ها در حالت آزمایشی (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): API مدیر و تب تنظیمات → چت‌بات برای هر سرور.
  • 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 برای سازگاری ارتقا و API حفظ می‌شوند؛ “chatbot” اصطلاح محصول رو به کاربر است. به همین ترتیب، فیلد ذخیره شده power_testers_json به گروه کاربران عادی در رابط کاربری نگاشت می‌شود.

ردپای وابستگی (minecraft-data)

Section titled “ردپای وابستگی (minecraft-data)”

راهنمای دستور پخت از بسته minecraft-data استفاده می‌کند. این بسته روی دیسک بزرگ است (حدود 429 مگابایت نصب شده) و چون یک وابستگی زمان اجرا است، نه یک وابستگی توسعه، در تصویر تولید گنجانده شده است. ما آن را به عمد نگه می‌داریم تا راهنمای دستور پخت به صورت آفلاین برای هر نسخه Minecraft بدون فراخوانی شبکه کار کند.

یادداشت‌هایی برای هر کسی که این را در آینده بررسی می‌کند (انسان یا هوش مصنوعی)، تا اندازه آن غافلگیرکننده نباشد:

  • در حال حاضر فقط داده‌های جاوا (pc) استفاده می‌شود. wizardRecipes.js جداول minecraftData.versions.pc و دستور پخت‌ها، آیتم‌ها و بلوک‌های مخصوص هر نسخه را می‌خواند. فایل‌هایی که در واقع لمس می‌کند، در مجموع حدود 15 مگابایت در بین تمام نسخه‌های pc هستند.
  • حدود 330 مگابایت از بسته data/bedrock است و هیچ بخشی از اینجا هنوز آن را نمی‌خواند. ما آن را به عمد در جای خود باقی می‌گذاریم. اگر پنل در آینده از Minecraft Bedrock پشتیبانی کند، داده‌های دستور پخت و آیتم Bedrock از قبل در اینجا وجود دارد، بنابراین ویژگی دستور پخت می‌تواند بدون افزودن وابستگی جدید برای پوشش سرورهای Bedrock رشد کند. از minecraftData.versions.bedrock شروع کنید و همان شکل مسیر pc را دنبال کنید.
  • اگر اندازه لازم باشد کاهش یابد قبل از اینکه پشتیبانی Bedrock فعال شود، الگویی برای آن در این مخزن وجود دارد. src/services/itemRegistry.js فایل‌های minecraft-data را از CDN jsDelivr زمانی که به آنها نیاز دارد واکشی می‌کند و آنها را در 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 هستند. کلید API اختیاری LLM با کلید در حال استراحت پنل، .secret-key در پوشه داده (جدا از SESSION_SECRET)، با AES-256-GCM رمزگذاری شده است.

قبل از ویرایش مستقیم SQLite، از پایگاه داده پشتیبان تهیه کنید و پنل را متوقف کنید تا WAL آن به درستی مدیریت شود. استفاده از رابط کاربری/API مدیر ترجیح داده می‌شود زیرا اعتبارسنجی و رمزگذاری را اعمال می‌کند. هنگام کپی کردن یک پایگاه داده زنده، فایل‌های panel.db, panel.db-wal, و panel.db-shm را با هم نگه دارید.