צ'אטבוט Minecraft לכל שרת
הפאנל מציע צ’אטבוט מוגדר על ידי מנהל עבור כל שרת Minecraft מנוהל, המוגדר בלשונית הגדרות → צ’אטבוט של השרת. הוא מתחבר לנקודת קצה תואמת OpenAI עבור השלמת צ’אט, כולל Ollama במארח אחר ברשת המקומית. לכל שרת יש נקודת קצה משלו, מודל, שם הפעלה, פרסונה, מדיניות תמלול, הודעות פנייה ומדיניות כוח. שם ההפעלה ברירת המחדל הוא @wizard, והפרסונה ברירת המחדל מדגימה קוסם עתיק ושובב בתוך המשחק; שניהם ניתנים לעריכה.

חווית שחקן
Section titled “חווית שחקן”- כל שחקן יכול להשתמש ב-
@wizard <הודעה>(או שם ההפעלה שהוגדר) לשיחה ולעזרה מתכונים ונילה דטרמיניסטית, המודעת לגרסת Minecraft. - ברכות הצטרפות ובדיקת נוכחות חד-פעמית ניתנת להגדרה מזכירות לשחקנים שהצ’אטבוט זמין.
@wizard chatפותח חלון שיחה קצר עם אופציה להצטרפות;@wizard byeסוגר אותו. - משתמשים בסיסיים יכולים להפעיל כוחות עצמיים/עולמיים מופעלים. מפעילי כוח יכולים להפעיל פעולות מאומתות בנפרד המשפיעות על שחקן מקוון אחר. שחקנים שאינם בקבוצות אלו נשארים רק לשיחה.
- מתנות עצמיות של משתמשים בסיסיים משתמשות ברשימת פריטים מותרים. מפעילי כוח יכולים לתת לשחקן אחר כל פריט ונילה או מוד מורשה עם שם מרחב, בכפוף למגבלת הכמות ואמצעי בטיחות נוספים.

עיצוב ואבטחה
Section titled “עיצוב ואבטחה”תצורה ותמלולים מיועדים למנהלים בלבד. המודל לעולם לא מקבל RCON גולמי או הרצת פקודות שרירותית. הודעה חושפת רק את הכלי הקבוע היחיד התואם את הכוונה המפורשת שלה; קוד השרת מאמת הרשאה, ארגומנטים, דגלים, כמויות, הגבלות זמן ו שמות שחקנים מקוונים מדויקים לפני ביצוע פעולת שירות קיימת. בוררי Minecraft נדחים, פעולות בין שחקנים אינן יכולות למקד את המתקשר, כוחות מתחילים במצב הדגמה, וכל כוח שניסה מבוקר. מודלים שאינם תומכים בקריאת כלים חוזרים לשיחה בלבד.
תשובות מוגבלות עבור צ’אט 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 ללא קריאת רשת.
הערות למי שיסתכל על זה בפעם הבאה (אנושי או AI), כך שהגודל לא יהיה הפתעה:
- כרגע נעשה שימוש רק בנתוני 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. מפתח ה-API של LLM האופציונלי מוצפן ב-AES-256-GCM עם מפתח ה-at-rest של הפאנל, .secret-key בתיקיית הנתונים (נפרד מ-SESSION_SECRET).
גבה את מסד הנתונים ועצור את הפאנל לפני עריכות SQLite ישירות כדי שמנגנון ה-WAL שלו יטופל בבטחה. שימוש בממשק המנהל/API מועדף מכיוון שהוא מיישם אימות והצפנה. שמור יחד את הקבצים panel.db, panel.db-wal, ו panel.db-shm בעת העתקת מסד נתונים פעיל.