Dokumentacja

Czat AI

Rozmawiaj z AI bezposrednio na czacie serwera przez komende /ai.

Uzywanie

Podstawowa komenda

Wystarczy wpisac /ai i twoja wiadomosc. AI odpowie na czacie serwera.

/ai jak zrobic farme zelaza?
/ai opowiedz dowcip
/ai przetlumacz "hello world" na polski

Odpowiedz AI

Odpowiedz pojawia sie na czacie w formie sformatowanej wiadomosci z prefixem MineNova. Dluzsze odpowiedzi sa dzielone na kilka linijek, zeby nic nie ucieklo poza ekran.

Kontekst konwersacji

AI pamietuje historie rozmowy osobno dla kazdego gracza. Do kontekstu trafia 20 ostatnich wiadomosci, dzieki czemu mozesz zadawac pytania nawiazujace do poprzedniej rozmowy.

Gracz: /ai jak naprawic kilof?
AI: Uzyj kowadla i diamentow...
Gracz: /ai a ile to kosztuje?
AI: Naprawa kilofa diamentami kosztuje...

Historia jest per gracz, wiec rozmowy innych graczy nie mieszaja sie z twoimi.

Role AI

AI moze miec rozna osobowosc w zaleznosci od rangi gracza. Konfigurujesz to w ai.yml:

ownerPelna swoboda, dostep do wszystkich narzedzi i informacji o serwerze
adminDostep do narzedzi administracyjnych i statystyk
vipPrzyjazna osobowosc z dodatkowymi uprawnieniami czatu
playerStandardowa osobowosc, podstawowe odpowiedzi
roles:
  owner:
    personality: "Jestes pomocnym asystentem admina..."
  vip:
    personality: "Jestes wesolym przewodnikiem po serwerze..."

Personalizacja

Plik ai-instructions.yml

W pliku ai-instructions.yml definiujesz jak AI ma sie zachowywac: ton, zasady, zakazane tematy, informacje o twoim serwerze (nazwa, eventy, reguly).

instructions:
  - "Jestes asystentem serwera NovaCraft"
  - "Mow po polsku"
  - "Nie podawaj informacji o koordynatach bazy adminow"
  - "Eventy odbywaja sie w soboty o 19:00"

Limity

Cooldown

Miedzy wiadomosciami obowiazuje cooldown, zeby nikt nie spamowal API. Czas cooldownu ustawiasz w konfiguracji i moze byc rozny dla poszczegolnych rang.

Limit znakow

Maksymalna dlugosc wiadomosci to 500 znakow. Dluzsze wiadomosci zostana odrzucone.

chat:
  max-message-length: 500
  cooldown-seconds: 10

Wskazowki

  • Zadawaj konkretne pytania, AI lepiej odpowiada na precyzyjne wiadomosci
  • Wykorzystuj kontekst - mozesz sie dopytywac o poprzednia odpowiedz
  • Ustaw rozne osobowosci per ranga, zeby VIP-y mialy cos ekstra