Dokumentacja

Pierwsze kroki

Kompletny przewodnik instalacji i konfiguracji MineNova.

Wymagania

Przed instalacją MineNova upewnij się, że Twój serwer spełnia poniższe wymagania:

JavaJava 17 lub nowsza (zalecana Java 21)
SerwerPaper 1.18+ lub Purpur (zalecane)
RAMMinimum 2GB wolnej pamięci RAM
Dysk500MB wolnego miejsca na dysku

Uwaga: MineNova nie współpracuje z Spigot ani CraftBukkit. Używaj Paper lub Purpur dla najlepszej kompatybilności i wydajności.

Instalacja

Zainstaluj MineNova w kilku prostych krokach:

Krok 1: Pobierz plugin

Pobierz najnowszą wersję MineNova z naszego sekcji pluginów lub z Pluginy.

# Przykład pobierania ze strony pluginów
wget https://minenova.eu/plugins/download/latest/MineNova.jar

Krok 2: Umieść w folderze plugins

Skopiuj plik JAR do folderu plugins/ na swoim serwerze:

# Z poziomu konsoli serwera
plugins/
└── MineNova.jar

Krok 3: Restart serwera

Zrestartuj serwer, aby plugin został załadowany:

restart

Krok 4: Weryfikacja

Po restarcie sprawdź, czy plugin został poprawnie załadowany:

pl > mn status
[MineNova] Plugin aktywny - wersja 1.0.0

Konfiguracja

Po pierwszym uruchomieniu plugin utworzy pliki konfiguracyjne w folderze plugins/MineNova/:

plugins/MineNova/
├── config.yml # Główna konfiguracja
├── ai.yml # Ustawienia dostawców AI
├── gui.yml # Konfiguracja interfejsu
├── discord_bot.yml # Integracja z Discord
├── permissions.yml # Uprawnienia
├── ai-instructions.yml # Osobowość AI per rola
├── server-profile.yml # Profil serwera
├── security.yml # Bezpieczeństwo
├── optimizer.yml # Optymalizator wydajności
├── ux.yml # Użytkownik (welcome, scoreboard)
└── data/
    ├── memory.yml # Pamięć NPC
    └── npcs.yml # Definicje NPC

Podstawowa konfiguracja

Otwórz plik ai.yml i dodaj swój klucz API jednego z obsługiwanych dostawców:

providers:
openai:
enabled: true
api-key: "sk-twojy-klucz-api"
model: "gpt-4o"
gemini:
enabled: false

Pierwsze uruchomienie

Po skonfigurowaniu klucza API przetestuj działanie pluginu:

# W grze Minecraft:
/ai Cześć! Jak się masz?

# Odpowiedź AI:
[MineNova] Cześć! Jestem MineNova AI, Twoim asystentem na serwerze. Jak mogę Ci pomóc?

Testowanie

Aby upewnić się, że wszystko działa poprawnie, wykonaj poniższe testy:

1

Test połączenia z AI

Użyj komendy /mn test aby sprawdzić połączenie z dostawcą AI.

2

Test czatu AI

Wyślij wiadomość przez /ai i sprawdź, czy otrzymujesz odpowiedź.

3

Test uprawnień

Sprawdź, czy gracze z odpowiednimi uprawnieniami mogą korzystać z komend AI.

4

Sprawdź logi

Przejrzyj logi serwera w poszukiwaniu błędów związanych z MineNova.

Kolejne kroki

Gratulacje! MineNova jest zainstalowany i gotowy do pracy. Sprawdź nasze przewodniki, aby poznać wszystkie możliwości: