MineNova
Dokumentacja

ai.yml

Glowny plik konfiguracyjny systemu AI w MineNova. Znajduje sie w folderze plugins/MineNova/ i kontroluje dostawcow, limity oraz role modeli.

Ustawienia domyslne

Sekcja defaults ustawia globalne parametry generowania odpowiedzi:

defaults:
  temperature: 0.7
  max-tokens: 8192
  timeout: 60
  • temperature - kreatywnosc odpowiedzi (0.0 - 2.0)
  • max-tokens - maksymalna dlugosc odpowiedzi
  • timeout - czas oczekiwania na odpowiedz w sekundach

Aktywny dostawca

Pole active-provider okresla, ktorego dostawce uzywa sie domyslnie. Musi odpowiadac kluczowi z sekcji providers:

active-provider: openai

Dostepni dostawcy

providers:
  openai:
    api-key: "sk-twojy-klucz-api"
  gemini:
    api-key: "twojy-klucz-api"
  # ... pozostali dostawcy
openaihttps://api.openai.com/v1
geminihttps://generativelanguage.googleapis.com/v1beta/openai
claudehttps://api.anthropic.com/v1
deepseekhttps://api.deepseek.com/v1
grokhttps://api.x.ai/v1
mistralhttps://api.mistral.ai/v1
opencodehttps://opencode.ai/zen/v1
localhttp://localhost:11434/v1

Endpointy sa ustawiane automatycznie - wystarczy podac klucz API. Dostawca local nie wymaga klucza i laczy sie z lokalnym serwerem Ollama.

Limity

limits:
  chat-cooldown: 5
  request-queue-size: 50
  history-size: 50
  • chat-cooldown - odstep miedzy wiadomosciami gracza w sekundach
  • request-queue-size - maksymalny rozmiar kolejki zapytan
  • history-size - ile ostatnich wiadomosci pamieci w kontekscie rozmowy

Fallback

Gdy glowny dostawca padnie, MineNova automatycznie przelaczy sie na nastepnego z listy:

fallback:
  enabled: true
  providers:
    - openai
    - gemini
    - claude

Dostawcy sa sprawdzani po kolei - pierwszy dzialajacy przejmuje ruch.

Tools

Konfiguracja wykonywania narzedzi (komend, budowania itp.) przez AI:

tools:
  multi-step:
    enabled: true
    max-iterations: 5
    require-accept: false
  • enabled - wlacza wykonywanie wielu krokow w jednej rozmowie
  • max-iterations - maksymalna liczba krokow narzedzi na jedna odpowiedz
  • require-accept - czy gracz musi potwierdzic wykonanie narzedzia

Role

Role pozwalaja przypisac rozne modele do roznych zadan. Format: dostawca/model:

roles:
  general: openai/gpt-4o-mini
  developer: openai/gpt-4.1
  builder: opencode/big-pickle
  • general - zwykle rozmowy i pytania graczy
  • developer - zadania programistyczne i skrypty
  • builder - budowanie struktur przez AI

Wskazowki

  • Zawsze ustaw active-provider zgodnie z kluczem skonfigurowanego dostawcy
  • Fallback zostaw wlaczony - oszczedza nerwow gdy API padnie w srodku gry
  • Nie podbijaj max-tokens za mocno - wieksze wartosci to wyzsze koszty
  • Dla malych serwerow wystarczy jeden dostawca, reszte sekcji mozna zostawic domyslna