Μετάβαση στο περιεχόμενο

Chatbot ανά διακομιστή Minecraft

← Επιστροφή στο ευρετήριο τεκμηρίωσης

Το πάνελ προσφέρει ένα chatbot διαμορφωμένο από τον διαχειριστή για κάθε διαχειριζόμενο διακομιστή Minecraft, το οποίο ρυθμίζεται στην καρτέλα Ρυθμίσεις → Chatbot του διακομιστή. Συνδέεται σε ένα συμβατό με το OpenAI endpoint για συνομιλίες (chat-completions), συμπεριλαμβανομένου του Ollama σε άλλη συσκευή του τοπικού δικτύου. Κάθε διακομιστής έχει το δικό του endpoint, μοντέλο, όνομα κλήσης, περσόνα, πολιτική απομαγνητοφώνησης, μηνύματα προσέγγισης και πολιτική ισχύος. Η προεπιλεγμένη κλήση είναι @wizard και η προεπιλεγμένη περσόνα παρουσιάζει έναν αρχαίο, παιχνιδιάρικο μάγο εντός του παιχνιδιού· και τα δύο είναι επεξεργάσιμα.

Ρυθμίσεις Chatbot

  • Οποιοσδήποτε παίκτης μπορεί να χρησιμοποιήσει @wizard <μήνυμα> (ή την καθορισμένη κλήση) για συνομιλία και για βοήθεια με συνταγές vanilla, οι οποίες είναι ντετερμινιστικές και γνωρίζουν την έκδοση του Minecraft.
  • Οι χαιρετισμοί κατά την είσοδο και μια διαμορφώσιμη, εφάπαξ υπενθύμιση ελέγχου κατά τη διάρκεια της συνεδρίας παιχνιδιού ενημερώνουν τους παίκτες ότι το chatbot είναι διαθέσιμο. Η εντολή @wizard chat ανοίγει ένα σύντομο παράθυρο συνομιλίας opt-in· η εντολή @wizard bye το κλείνει.
  • Οι Βασικοί χρήστες μπορούν να ενεργοποιήσουν ενεργοποιημένες δυνάμεις (self/world powers). Οι Ελεγκτές ισχύος μπορούν να ενεργοποιήσουν ξεχωριστά επικυρωμένες ενέργειες που επηρεάζουν άλλον διαδικτυακό παίκτη. Οι παίκτες που δεν ανήκουν σε καμία από τις δύο ομάδες παραμένουν μόνο για συνομιλία.
  • Οι δωρεές βασικών χρηστών (self-gifts) χρησιμοποιούν μια λίστα επιτρεπόμενων αντικειμένων. Οι ελεγκτές μπορούν να δώσουν σε άλλον παίκτη οποιοδήποτε έγκυρο αντικείμενο vanilla ή modded με namespace, υπό την προϋπόθεση του ορίου ποσότητας και άλλων διασφαλίσεων ισχύος.

Απομαγνητοφωνήσεις Chatbot

Η διαμόρφωση και οι απομαγνητοφωνήσεις είναι μόνο για διαχειριστές. Το μοντέλο δεν λαμβάνει ποτέ ακατέργαστο RCON ή αυθαίρετη εκτέλεση εντολών. Ένα μήνυμα εκθέτει μόνο το μοναδικό, σταθερό εργαλείο που ταιριάζει με την ρητή του πρόθεση· ο κώδικας του διακομιστή επικυρώνει την εξουσιοδότηση, τα ορίσματα, τις σημαίες, τις ποσότητες, τις περιόδους επαναφοράς (cooldowns) και τα ακριβή ονόματα διαδικτυακών παικτών πριν εκτελέσει μια υπάρχουσα λειτουργία υπηρεσίας. Οι επιλογείς του Minecraft απορρίπτονται, οι ενέργειες μεταξύ παικτών δεν μπορούν να στοχεύουν τον καλούντα, οι δυνάμεις ξεκινούν σε λειτουργία δοκιμής (dry-run) και κάθε προσπάθεια χρήσης ισχύος καταγράφεται. Τα μη υποστηριζόμενα μοντέλα κλήσης εργαλείων επιστρέφουν σε απλή συνομιλία.

Οι απαντήσεις περιορίζονται για τη συνομιλία του Minecraft. Οι γνωστές συνταγές vanilla προέρχονται από ενσωματωμένα δεδομένα συνταγών με εκδόσεις και αποδίδονται ως σταθερές σειρές 2x2/3x3· το LLM δεν εμπιστεύεται την εφεύρεση διατάξεων συνταγών. Άγνωστες ή τροποποιημένες συνταγές κατευθύνουν τον παίκτη στο JEI/REI αντί να επινοήσουν μια απάντηση.

  • src/services/wizard.js: διαμόρφωση ανά διακομιστή, αιτήματα συμβατά με OpenAI, διαχείριση συνομιλίας, προσέγγιση, διατήρηση απομαγνητοφωνήσεων και όρια απαντήσεων.
  • src/services/wizardPowers.js: έλεγχοι ρόλων, σχήματα εργαλείων ανά πρόθεση, επικύρωση, εκτέλεση, cooldowns και έλεγχος ισχύος.
  • src/services/wizardRecipes.js: ντετερμινιστική αναζήτηση συνταγών με εκδόσεις και μορφοποίηση πλέγματος. Τα δεδομένα συνταγών και αντικειμένων προέρχονται από το ενσωματωμένο πακέτο minecraft-data. (Μια προηγούμενη έκδοση αυτού του εγγράφου έδειχνε έναν φάκελο src/data/recipes/ που δεν έγινε ποτέ commit· δεν υπάρχει τέτοιος φάκελος και τα δεδομένα βρίσκονται στο πακέτο. Δείτε “Dependency footprint”.)
  • src/analytics/ingest.js: προωθεί τις αναλυόμενες εισόδους, εξόδους και συνομιλίες παικτών στο chatbot.
  • src/web/routes/wizard.js, public/js/pages/integrations.js, και views/partials/server/integrations.hbs (μέσω chatbot.hbs): API διαχειριστή και η καρτέλα Ρυθμίσεις → Chatbot ανά διακομιστή.
  • 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 αντιστοιχεί στην ομάδα Βασικοί χρήστες του UI.

Η βοήθεια συνταγών χρησιμοποιεί το πακέτο minecraft-data. Είναι μεγάλο στον δίσκο (περίπου 429 MB εγκατεστημένο) και αποστέλλεται εντός της εικόνας παραγωγής επειδή είναι εξάρτηση χρόνου εκτέλεσης, όχι ανάπτυξης. Το διατηρούμε επίτηδες, ώστε η βοήθεια συνταγών να λειτουργεί εκτός σύνδεσης για κάθε έκδοση του Minecraft χωρίς κλήση δικτύου.

Σημειώσεις για όποιον δει αυτό στη συνέχεια (άνθρωπος ή AI), ώστε το μέγεθος να μην αποτελεί έκπληξη:

  • Χρησιμοποιούνται μόνο τα δεδομένα Java (pc) αυτή τη στιγμή. Το wizardRecipes.js διαβάζει minecraftData.versions.pc και τους πίνακες recipes, items και blocks ανά έκδοση. Τα αρχεία που αγγίζει στην πραγματικότητα ανέρχονται σε περίπου 15 MB σε όλες τις εκδόσεις pc.
  • Περίπου 330 MB του πακέτου είναι data/bedrock και τίποτα εδώ δεν τα διαβάζει ακόμα. Το αφήνουμε επίτηδες. Εάν το πάνελ προσθέσει ποτέ υποστήριξη για Bedrock Minecraft, τα δεδομένα συνταγών και αντικειμένων του Bedrock είναι ήδη εδώ, οπότε η λειτουργία συνταγών μπορεί να επεκταθεί για να καλύψει διακομιστές Bedrock χωρίς να προστεθεί νέα εξάρτηση. Ξεκινήστε από το minecraftData.versions.bedrock και ακολουθήστε το ίδιο σχήμα με τη διαδρομή pc.
  • Εάν το μέγεθος πρέπει κάποτε να μειωθεί πριν φτάσει η υποστήριξη Bedrock, υπάρχει ήδη ένα μοτίβο για αυτό σε αυτό το αποθετήριο. Το src/services/itemRegistry.js ανακτά αρχεία minecraft-data από το CDN jsDelivr όταν τα χρειάζεται και τα αποθηκεύει στην προσωρινή μνήμη api_cache. Είτε αυτή η προσέγγιση, είτε ένα μικρό, επιλεγμένο υποσύνολο src/data/recipes/ που καλύπτει μερικές κοινές εκδόσεις, θα συρρίκνωναν την εικόνα πολύ.

Τοπική αποθήκευση και χειροκίνητη επιθεώρηση

Ενότητα με τίτλο «Τοπική αποθήκευση και χειροκίνητη επιθεώρηση»

Όλες οι ρυθμίσεις και οι αποθηκευμένες απομαγνητοφωνήσεις βρίσκονται στην βάση δεδομένων 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 του να χειρίζεται με ασφάλεια. Η χρήση του UI/API διαχειριστή προτιμάται, επειδή εφαρμόζει επικύρωση και κρυπτογράφηση. Διατηρήστε τα αρχεία panel.db, panel.db-wal και panel.db-shm μαζί κατά την αντιγραφή μιας ζωντανής βάσης δεδομένων.