प्रति-सर्वर Minecraft चैटबॉट
यह पैनल प्रत्येक प्रबंधित Minecraft सर्वर के लिए एक एडमिन-कॉन्फ़िगर किया गया चैटबॉट प्रदान करता है, जिसे सर्वर के सेटिंग्स → चैटबॉट टैब पर सेट किया गया है। यह Ollama जैसे किसी अन्य LAN होस्ट पर भी, OpenAI-संगत चैट-कम्प्लीशन एंडपॉइंट से जुड़ता है। प्रत्येक सर्वर का अपना एंडपॉइंट, मॉडल, इनवोकेशन नाम, पर्सोना, ट्रांसक्रिप्ट नीति, आउटरीच संदेश और पावर नीति होती है। डिफ़ॉल्ट इनवोकेशन @wizard है, और डिफ़ॉल्ट पर्सोना एक प्राचीन, चंचल इन-वर्ल्ड विज़ार्ड का प्रदर्शन करता है; दोनों संपादन योग्य हैं।

खिलाड़ी अनुभव
Section titled “खिलाड़ी अनुभव”- कोई भी खिलाड़ी बातचीत और नियतात्मक, Minecraft-संस्करण-जागरूक वैनिला रेसिपी सहायता के लिए
@wizard <संदेश>(या कॉन्फ़िगर किया गया इनवोकेशन) का उपयोग कर सकता है। - जॉइन ग्रीटिंग्स और एक कॉन्फ़िगर करने योग्य एक-बार प्ले-सेशन चेक-इन खिलाड़ियों को चैटबॉट की उपलब्धता की याद दिलाते हैं।
@wizard chatएक छोटी ऑप्ट-इन बातचीत विंडो खोलता है;@wizard byeइसे बंद कर देता है। - बुनियादी उपयोगकर्ता सक्षम स्व/विश्व शक्तियों को इनवोक कर सकते हैं। पावर कंट्रोलर दूसरे ऑनलाइन खिलाड़ी को प्रभावित करने वाली अलग से मान्य क्रियाओं को इनवोक कर सकते हैं। इन दोनों समूहों में नहीं आने वाले खिलाड़ी केवल बातचीत तक ही सीमित रहते हैं।
- बुनियादी उपयोगकर्ता स्व-गिफ्ट आइटम अनुमति सूची का उपयोग करते हैं। कंट्रोलर किसी अन्य खिलाड़ी को मात्रा सीमा और अन्य पावर सुरक्षा उपायों के अधीन, किसी भी मान्य नेम्स्पेस वैनिला या मॉडेड आइटम दे सकते हैं।

डिज़ाइन और सुरक्षा
Section titled “डिज़ाइन और सुरक्षा”कॉन्फ़िगरेशन और ट्रांसक्रिप्ट केवल एडमिन के लिए हैं। मॉडल को कभी भी रॉ RCON या मनमाना कमांड निष्पादन प्राप्त नहीं होता है। एक संदेश केवल उसके स्पष्ट इरादे से मेल खाने वाले एकल निश्चित टूल को उजागर करता है; सर्वर कोड किसी मौजूदा सेवा ऑपरेशन को निष्पादित करने से पहले प्राधिकरण, तर्क, फ़्लैग, मात्रा, कूलडाउन और सटीक ऑनलाइन खिलाड़ी नामों को मान्य करता है। Minecraft चयनकर्ताओं को अस्वीकार कर दिया जाता है, क्रॉस-प्लेयर क्रियाएं कॉलर को लक्षित नहीं कर सकती हैं, शक्तियां ड्राई-रन मोड में शुरू होती हैं, और हर प्रयास की गई शक्ति का ऑडिट किया जाता है। असमर्थित टूल-कॉलिंग मॉडल केवल बातचीत पर वापस आ जाते हैं।
Minecraft चैट के लिए प्रतिक्रियाएं सीमित हैं। ज्ञात वैनिला रेसिपी बंडल किए गए संस्करणित रेसिपी डेटा से आती हैं और स्थिर 2x2/3x3 पंक्तियों के रूप में प्रस्तुत की जाती हैं; एलएलएम को रेसिपी लेआउट का आविष्कार करने पर भरोसा नहीं किया जाता है। अज्ञात या मॉडेड रेसिपी खिलाड़ी को उत्तर गढ़ने के बजाय 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 रूट/मॉड्यूल/टेबल नाम अपग्रेड और एपीआई संगतता के लिए बनाए रखे जाते हैं; “चैटबॉट” उपयोगकर्ता-सामना करने वाला उत्पाद शब्द है। इसी तरह, संग्रहीत power_testers_json फ़ील्ड UI के बुनियादी उपयोगकर्ता समूह से मेल खाता है।
निर्भरता फ़ुटप्रिंट (minecraft-data)
Section titled “निर्भरता फ़ुटप्रिंट (minecraft-data)”रेसिपी सहायता minecraft-data पैकेज का उपयोग करती है। यह डिस्क पर बड़ा है (लगभग 429 MB स्थापित), और यह उत्पादन छवि के अंदर शिप होता है क्योंकि यह एक रनटाइम निर्भरता है, न कि एक डेव। हम इसे जानबूझकर रख रहे हैं ताकि रेसिपी सहायता हर Minecraft रिलीज़ के लिए बिना किसी नेटवर्क कॉल के ऑफ़लाइन काम करे।
जो कोई भी इसे अगली बार देखेगा (मानव या AI) उसके लिए नोट्स, ताकि आकार कोई आश्चर्य न हो:
- अभी केवल जावा (
pc) डेटा का उपयोग किया जा रहा है।wizardRecipes.jsminecraftData.versions.pcऔर प्रति-संस्करणrecipes,items, औरblocksतालिकाओं को पढ़ता है। जिन फ़ाइलों को यह वास्तव में छूता है, वे हर पीसी संस्करण में लगभग 15 MB तक जुड़ जाती हैं। - पैकेज का लगभग 330 MB
data/bedrockहै, और यहां कुछ भी इसे अभी तक नहीं पढ़ता है। हम इसे जानबूझकर जगह पर छोड़ रहे हैं। यदि पैनल कभी बेडॉक Minecraft समर्थन जोड़ता है, तो बेडॉक रेसिपी और आइटम डेटा पहले से ही यहां है, इसलिए रेसिपी सुविधा एक नई निर्भरता जोड़े बिना बेडॉक सर्वर को कवर करने के लिए बढ़ सकती है।minecraftData.versions.bedrockसे शुरू करें और पीसी पथ के समान आकार का पालन करें। - यदि बेडॉक समर्थन आने से पहले आकार कभी कम करना पड़े, तो इस रिपॉजिटरी में पहले से ही इसके लिए एक पैटर्न है।
src/services/itemRegistry.jsjsDelivrCDN सेminecraft-dataफ़ाइलों को तब प्राप्त करता है जब उसे उनकी आवश्यकता होती है और उन्हेंapi_cacheमें कैश करता है। या तो वह दृष्टिकोण, या कुछ सामान्य संस्करणों को कवर करने वाला एक छोटा हाथ से चुना हुआsrc/data/recipes/सबसेट, छवि को बहुत सिकोड़ देगा।
स्थानीय भंडारण और मैन्युअल निरीक्षण
Section titled “स्थानीय भंडारण और मैन्युअल निरीक्षण”सभी सेटिंग्स और बनाए रखी गई ट्रांसक्रिप्ट पैनल कंटेनर के अंदर /data/panel.db पर पैनल SQLite डेटाबेस में रहती हैं। मानक कंपोज़ माउंट के साथ, होस्ट पथ ${DATA_DIR_HOST}/panel.db है (उदाहरण के लिए /opt/msm/data/panel.db)। प्रासंगिक तालिकाएँ wizard_configs, wizard_transcripts, और wizard_outreach हैं; पावर ऑडिट events तालिका में टाइप wizard-power वाली पंक्तियाँ हैं। वैकल्पिक एलएलएम एपीआई कुंजी पैनल की एट-रेस्ट कुंजी, डेटा फ़ोल्डर में .secret-key ( SESSION_SECRET से अलग) के साथ AES-256-GCM एन्क्रिप्टेड है।
डेटाबेस का बैकअप लें और सीधे SQLite संपादन से पहले पैनल को रोकें ताकि इसके WAL को सुरक्षित रूप से संभाला जा सके। एडमिन UI/API का उपयोग करना बेहतर है क्योंकि यह सत्यापन और एन्क्रिप्शन लागू करता है। लाइव डेटाबेस की प्रतिलिपि बनाते समय panel.db, panel.db-wal, और panel.db-shm फ़ाइलों को एक साथ रखें।