Chatbot per Minecraft-server
Panelen erbjuder en administratörskonfigurerad chatbot för varje hanterad Minecraft-server, inställd under fliken Inställningar → Chatbot på servern. Den ansluter till en OpenAI-kompatibel chat-completions-slutpunkt, inklusive Ollama på en annan värd i LAN-nätverket. Varje server har sin egen slutpunkt, modell, anropsnamn, persona, transkriptionspolicy, utåtriktade meddelanden och befogenhetspolicy. Standardanropet är @wizard, och standardpersonan demonstrerar en uråldrig, lekfull trollkarl i spelet; båda är redigerbara.

Spelupplevelse
Section titled “Spelupplevelse”- Vilken spelare som helst kan använda
@wizard <meddelande>(eller det konfigurerade anropet) för konversation och deterministiskt, Minecraft-versionsmedvetet hjälp med vanliga recept. - Välkomstmeddelanden vid anslutning och en konfigurerbar engångskontroll av spelsessionen påminner spelare om att chatboten är tillgänglig.
@wizard chatöppnar ett kort fönster för anmälan;@wizard byestänger det. - Grundläggande användare kan anropa aktiverade själv-/världsbefogenheter. Befogenhetskontrollanter kan anropa separat validerade åtgärder som påverkar en annan online-spelare. Spelare i ingen av grupperna förblir endast för konversation.
- Grundläggande användares själv-gåvor använder en tillåten lista för föremål. Kontrollanter kan ge en annan spelare vilket giltigt namnutrymme som helst för vanliga eller modifierade föremål, beroende på kvantitetsgränsen och andra befogenhetsskydd.

Design och säkerhet
Section titled “Design och säkerhet”Konfiguration och transkriptioner är endast för administratörer. Modellen tar aldrig emot rå RCON eller godtycklig kommandokörning. Ett meddelande exponerar endast det enda fasta verktyget som matchar dess explicita avsikt; serverkod validerar auktorisering, argument, flaggor, kvantiteter, nedkylningstider och exakta online-spelarnamn innan en befintlig tjänsteoperation utförs. Minecraft-väljare avvisas, korsspelaråtgärder kan inte rikta sig mot anroparen, befogenheter börjar i torrkörningsläge, och varje försök till befogenhet loggas. Ounderstödda verktygsanropsmodeller återgår till endast konversation.
Svar är begränsade för Minecraft-chatt. Kända vanliga recept kommer från medföljande versionsspecifika receptdata och renderas som stabila 2x2/3x3 rader; LLM:en litar inte på att hitta på receptlayouter. Okända eller modifierade recept hänvisar spelaren till JEI/REI snarare än att fabricera ett svar.
Huvudsakliga implementeringsfiler
Section titled “Huvudsakliga implementeringsfiler”src/services/wizard.js: konfiguration per server, OpenAI-kompatibla förfrågningar, chatt-hantering, utåtriktade meddelanden, transkriptionslagring och svarsgränser.src/services/wizardPowers.js: rollkontroller, avsiktspecifika verktygsscheman, validering, körning, nedkylningstider och loggning av befogenheter.src/services/wizardRecipes.js: deterministiskt versionsspecifikt receptuppslag och rutnätsformatering. Recept- och föremålsdata kommer från det medföljande paketetminecraft-data. (Ett tidigare utkast av detta dokument pekade på ensrc/data/recipes/-mapp som aldrig checkades in; det finns ingen sådan mapp, och datan finns i paketet. Se “Beroendefotavtryck”.)src/analytics/ingest.js: vidarebefordrar parsade anslutningar, frånkopplingar och spelarchatt till chatboten.src/web/routes/wizard.js,public/js/pages/integrations.js, ochviews/partials/server/integrations.hbs(viachatbot.hbs): administratörs-API och fliken Inställningar → Chatbot per server.src/db/migrations/011_wizard_chat.js,013_wizard_invocation_name.js,015_wizard_powers.js,017_wizard_outreach.js, och019_wizard_power_controllers.js: beständig schema.test/wizard.test.js: tester för auktorisering, verktygsgränser, lagring, utåtriktade meddelanden och chattbeteende.
De interna wizard-routnings-/modul-/tabellnamnen behålls för uppgraderings- och API-kompatibilitet; “chatbot” är den användarvända produkttermen. Likaså mappar fältet power_testers_json som lagras till grupperingen Grundläggande användare i gränssnittet.
Beroendefotavtryck (minecraft-data)
Section titled “Beroendefotavtryck (minecraft-data)”Recept-hjälp använder paketet minecraft-data. Det är stort på disk (cirka 429 MB installerat), och det levereras inuti produktionsbilden eftersom det är ett körtidsberoende, inte ett utvecklingsberoende. Vi behåller det avsiktligt så att recept-hjälp fungerar offline för varje Minecraft-utgåva utan nätverksanrop.
Anteckningar för den som tittar på detta härnäst (människa eller AI), så att storleken inte kommer som en överraskning:
- Endast Java (
pc)-data används just nu.wizardRecipes.jsläserminecraftData.versions.pcoch de versionsspecifika tabellernarecipes,itemsochblocks. Filerna som den faktiskt rör vid uppgår till ungefär 15 MB över alla pc-versioner. - Cirka 330 MB av paketet är
data/bedrock, och inget här läser det ännu. Vi lämnar det på plats avsiktligt. Om panelen någonsin lägger till stöd för Bedrock Minecraft, finns Bedrock-recept- och föremålsdata redan här, så receptfunktionen kan växa för att täcka Bedrock-servrar utan att lägga till ett nytt beroende. Börja frånminecraftData.versions.bedrockoch följ samma form som pc-sökvägen. - Om storleken någonsin måste minskas innan Bedrock-stöd kommer, finns det redan ett mönster för det i detta repo.
src/services/itemRegistry.jshämtarminecraft-data-filer från jsDelivr CDN när den behöver dem och cachar dem iapi_cache. Antingen det tillvägagångssättet, eller en liten handplockadsrc/data/recipes/-undergrupp som täcker några vanliga versioner, skulle krympa bilden avsevärt.
Lokal lagring och manuell inspektion
Section titled “Lokal lagring och manuell inspektion”Alla inställningar och lagrade transkriptioner finns i panelens SQLite-databas på /data/panel.db inuti panelcontainern. Med standard Compose-monteringen är värdsökvägen ${DATA_DIR_HOST}/panel.db (till exempel /opt/msm/data/panel.db). Relevanta tabeller är wizard_configs, wizard_transcripts och wizard_outreach; befogenhetsloggar är rader i tabellen events med typen wizard-power. Den valfria LLM API-nyckeln är AES-256-GCM-krypterad med panelens vilande nyckel, .secret-key i datamappen (skild från SESSION_SECRET).
Säkerhetskopiera databasen och stoppa panelen före direkta SQLite-redigeringar så att dess WAL hanteras säkert. Att använda administratörsgränssnittet/API:et är att föredra eftersom det tillämpar validering och kryptering. Behåll filerna panel.db, panel.db-wal och panel.db-shm tillsammans när du kopierar en live-databas.