Chatbot pr. Minecraft-server
Panelet tilbyder en admin-konfigureret chatbot til hver administreret Minecraft-server, opsat på serverens faneblad Indstillinger → Chatbot. Den forbinder til et
OpenAI-kompatibelt chat-completions-endepunkt, herunder Ollama på en anden LAN-vært. Hver server har
sit eget endepunkt, model, invocationsnavn, persona, transskriptionspolitik, opsøgende beskeder og
strømpolitik. Standardinvokationen er @wizard, og standardpersonaen demonstrerer en ældgammel,
legende troldmand i spillet; begge kan redigeres.

Spilleroplevelse
Sektion kaldt “Spilleroplevelse”- Enhver spiller kan bruge
@wizard <besked>(eller den konfigurerede invokation) til samtale og deterministisk, Minecraft-versionsbevidst vanilla opskriftshjælp. - Velkomstbeskeder ved tilslutning og en konfigurerbar engangs-tjek-ind minder spillere om, at chatbotten er
tilgængelig.
@wizard chatåbner et kort opt-in samtalevindue;@wizard byelukker det. - Grundlæggende brugere kan invokere aktiverede selv-/verdenskræfter. Power controllers kan invokere separat validerede handlinger, der påvirker en anden online spiller. Spillere i ingen af grupperne forbliver kun til samtale.
- Grundlæggende brugeres selv-gaver bruger en tilladt liste over genstande. Controllers kan give en anden spiller enhver gyldig navngivet vanilla eller modded genstand, underlagt mængdebegrænsningen og andre strømsikkerhedsforanstaltninger.

Design og sikkerhed
Sektion kaldt “Design og sikkerhed”Konfiguration og transskriptioner er kun for administratorer. Modellen modtager aldrig rå RCON eller vilkårlig kommandoeksekvering. En besked afslører kun det enkelte faste værktøj, der matcher dens eksplicitte hensigt; serverkode validerer autorisation, argumenter, flag, mængder, cooldowns og præcise online spillernavne, før en eksisterende serviceoperation udføres. Minecraft-selektorer afvises, krydsspillerhandlinger kan ikke målrette den, der kalder, kræfter starter i dry-run-tilstand, og hver forsøgt kraft bliver revideret. Ikke-understøttede værktøjsopkaldsmodeller falder tilbage til kun samtale.
Svar er begrænsede for Minecraft-chat. Kendte vanilla opskrifter kommer fra medfølgende versionsspecifikke opskriftsdata og vises som stabile 2x2/3x3 rækker; LLM’en er ikke betroet til at opfinde opskriftslayouts. Ukendte eller modded opskrifter henviser spilleren til JEI/REI i stedet for at fabrikere et svar.
Vigtigste implementeringsfiler
Sektion kaldt “Vigtigste implementeringsfiler”src/services/wizard.js: per-server konfiguration, OpenAI-kompatible anmodninger, chat-håndtering, opsøgende arbejde, transskriptionsopbevaring og svargrænser.src/services/wizardPowers.js: rolletjek, hensigts-specifikke værktøjsskemaer, validering, eksekvering, cooldowns og kraftrevision.src/services/wizardRecipes.js: deterministisk versionsspecifik opskriftsopslag og gitterformatering. Opskrift og genstandsdata kommer fra den medfølgendeminecraft-datapakke. (Et tidligere udkast til dette dokument pegede på ensrc/data/recipes/mappe, der aldrig blev committet; der er ingen sådan mappe, og dataene ligger i pakken. Se “Afhængighedsaftryk”.)src/analytics/ingest.js: videresender parsede joins, leaves og spillerchat til chatbotten.src/web/routes/wizard.js,public/js/pages/integrations.js, ogviews/partials/server/integrations.hbs(viachatbot.hbs): admin API og den per-server Indstillinger → Chatbot faneblad.src/db/migrations/011_wizard_chat.js,013_wizard_invocation_name.js,015_wizard_powers.js,017_wizard_outreach.js, og019_wizard_power_controllers.js: persistent skema.test/wizard.test.js: autorisation, værktøjsgrænse, opbevaring, opsøgende arbejde og chatadfærdstests.
De interne wizard rute/modul/tabelnavne bevares for opgraderings- og API-kompatibilitet;
“chatbot” er den brugerrettede produktterm. Ligeledes svarer det gemte power_testers_json felt til
UI’ens Grundlæggende brugere gruppe.
Afhængighedsaftryk (minecraft-data)
Sektion kaldt “Afhængighedsaftryk (minecraft-data)”Opskriftshjælp bruger minecraft-data pakken. Den er stor på disken (ca. 429 MB installeret), og den
leveres inde i produktionsbilledet, fordi det er en runtime-afhængighed, ikke en udviklingsafhængighed. Vi beholder den
med vilje, så opskriftshjælp fungerer offline for enhver Minecraft-udgivelse uden netværkskald.
Noter til den, der ser på dette næste (menneske eller AI), så størrelsen ikke kommer som en overraskelse:
- Kun Java (
pc) data bruges lige nu.wizardRecipes.jslæserminecraftData.versions.pcog de per-versionrecipes,itemsogblockstabeller. De filer, den rent faktisk rører ved, udgør ca. 15 MB på tværs af alle pc-versioner. - Omkring 330 MB af pakken er
data/bedrock, og intet her læser det endnu. Vi lader det være på plads med vilje. Hvis panelet nogensinde tilføjer Bedrock Minecraft-understøttelse, er Bedrock opskrifts- og genstandsdata allerede her, så opskriftsfunktionen kan udvides til at dække Bedrock-servere uden at tilføje en ny afhængighed. Start framinecraftData.versions.bedrockog følg samme form som pc-stien. - Hvis størrelsen nogensinde skal reduceres, før Bedrock-understøttelse lander, er der allerede et mønster for det
i dette repo.
src/services/itemRegistry.jshenterminecraft-datafiler fra jsDelivr CDN når den har brug for dem og cacher dem iapi_cache. Enten den tilgang, eller en lille håndplukketsrc/data/recipes/delmængde, der dækker et par almindelige versioner, ville reducere billedet meget.
Lokal lagring og manuel inspektion
Sektion kaldt “Lokal lagring og manuel inspektion”Alle indstillinger og gemte transskriptioner ligger i panelets SQLite-database på /data/panel.db inde i
panelets container. Med standard Compose-mountet er værtsstien
${DATA_DIR_HOST}/panel.db (f.eks. /opt/msm/data/panel.db). Relevante tabeller er
wizard_configs, wizard_transcripts og wizard_outreach; kraftrevisioner er rækker i events
tabellen med typen wizard-power. Den valgfrie LLM API-nøgle er AES-256-GCM krypteret med panelets
at-rest nøgle, .secret-key i data-mappen (separat fra SESSION_SECRET).
Sikkerhedskopier databasen og stop panelet før direkte SQLite-redigeringer, så dens WAL håndteres sikkert.
Brug af admin UI/API foretrækkes, da det anvender validering og kryptering. Behold
panel.db, panel.db-wal og panel.db-shm filerne samlet, når du kopierer en live database.