Installation

Schritt-fuer-Schritt-Anleitung zur Installation und Konfiguration von QuestsTracker auf Ihrem Minecraft-Server.

Voraussetzungen

Voraussetzung	Mindestversion	Empfohlen
Server	Paper 1.21+	Paper neueste Version
Java	Java 21+	Java 21
BetonQuest	3.0+	Neueste Version
Datenbank	MySQL 8.0+ / MariaDB 10.5+	MariaDB neueste Version
Redis	6.0+ (optional)	Redis neueste Version
Lizenz	Gueltiger KGInfoServs-Lizenzschluessel	-

Kompatibilitaet

Das Plugin funktioniert ausschliesslich auf Paper oder dessen Forks (Purpur, Pufferfish). Java 21 ist erforderlich.

Schritt 1: Plugin herunterladen

Laden Sie die JAR-Datei aus Ihrem KGInfoServs-Kundenbereich herunter.

Schritt 2: Auf dem Server installieren

1. Stoppen Sie Ihren Server (empfohlen)

2. Kopieren Sie die JAR in den plugins/-Ordner:

   ihr-server/
   └── plugins/
       ├── BetonQuest.jar
       └── kginfoservs_queststrack-X.X.X.jar

3. Starten Sie den Server

Das Plugin erstellt automatisch seinen Konfigurationsordner:

plugins/kginfoservs_queststrack/
├── config.yml           # Hauptkonfiguration
├── quests_config.yml    # Texte und Quest-Schritte
└── license.key          # Lizenzdatei (auszufuellen)

Schritt 3: Lizenz konfigurieren

1. Oeffnen Sie plugins/kginfoservs_queststrack/license.key
2. Fuegen Sie Ihren Lizenzschluessel ein (eine einzelne Zeile, keine Leerzeichen)
3. Starten Sie den Server neu
4. Ueberpruefen Sie die Logs:

   [QuestsTracker] License validated successfully
   [QuestsTracker] Plugin enabled

Lizenzproblem?

Siehe Fehlerbehebung - Lizenzfehler.

Schritt 4: Datenbank (ERFORDERLICH)

Funktionsweise

QuestsTracker verwendet dieselbe Datenbank wie BetonQuest. Es gibt keine separate Datenbankkonfiguration im Plugin.

Stellen Sie sicher, dass BetonQuest mit MySQL/MariaDB konfiguriert ist in seiner Datei plugins/BetonQuest/config.yml:

# In plugins/BetonQuest/config.yml
mysql:
  enabled: true
  host: "localhost"
  port: "3306"
  base: "betonquest"
  user: "ihr_benutzer"
  pass: "ihr_passwort"

BetonQuest-Konfiguration erforderlich

BetonQuest muss MySQL aktiviert haben. Wenn BetonQuest SQLite verwendet (Standard), kann QuestsTracker nicht funktionieren. Aktivieren Sie MySQL in der BetonQuest-Konfiguration, bevor Sie QuestsTracker starten.

Datenbank erstellen

Falls noch nicht geschehen, erstellen Sie die Datenbank fuer BetonQuest:

CREATE DATABASE betonquest;
CREATE USER 'betonquest'@'localhost' IDENTIFIED BY 'ihr_passwort';
GRANT ALL PRIVILEGES ON betonquest.* TO 'betonquest'@'localhost';
FLUSH PRIVILEGES;

Automatisch erstellte Tabellen

QuestsTracker erstellt seine eigenen Tabellen in der BetonQuest-Datenbank beim ersten Start:

Tabelle	Beschreibung
player_quest_progress	Quest-Fortschritt (aktueller Schritt, abgeschlossene Ziele)
player_tracked_quest	Aktuell verfolgte Quest jedes Spielers
player_preferences	Spielereinstellungen (abgeschlossene Quests anzeigen usw.)

Schritt 5: Redis (optional)

Redis wird nur fuer die Multi-Server-Synchronisierung benoetigt. Wenn Sie nur einen Server haben, ueberspringen Sie diesen Schritt.

Redis installieren

# Ubuntu/Debian
sudo apt install redis-server

# CentOS/RHEL
sudo yum install redis

# Docker
docker run -d --name redis -p 6379:6379 redis:latest

Konfiguration in config.yml

redis:
  enabled: true
  host: "127.0.0.1"
  port: 6379
  password: ""  # Leer lassen, wenn kein Passwort

Einzelner Server?

Wenn Sie nur einen Server haben, lassen Sie redis.enabled: false. Das Plugin funktioniert einwandfrei ohne Redis.

Schritt 6: BetonQuest-Konfiguration

Damit eine Quest im Menue erscheint, muss sie das Template trackedQuest verwenden.

Template zu einer Quest hinzufuegen

In der package.yml-Datei Ihrer BetonQuest-Quest:

templates:
  - trackedQuest

questParameters:
  questCategory: "Story"  # Muss mit dem displayName einer Kategorie uebereinstimmen

Siehe BetonQuest-Integration fuer die vollstaendige Anleitung.

Schritt 7: Erstkonfiguration

1. Menue-Kategorien

Passen Sie die Kategorien in config.yml an. Sie koennen bis zu 4 Kategorien mit benutzerdefinierten Namen, Symbolen und Verhaltensweisen definieren:

defaultCategory: "other"  # Standardkategorie, wenn questCategory nicht angegeben

menuItems:
  categories:
    story:
      displayName: "Story"
      material: WRITABLE_BOOK
      customModelData: 0
      autoTrack: true
    secondary:
      displayName: "Secondary"
      material: BOOK
      customModelData: 0
      autoTrack: false

Siehe Konfiguration fuer die vollstaendige Referenz.

2. Menuesprache

Die Menuesprache wird durch die Einstellung language in plugins/BetonQuest/config.yml bestimmt. Unterstuetzte Sprachen: fr-FR, en-US, pl-PL.

3. Konfiguration neu laden

/questsreload

Schritt 8: Ingame-Test

1. Verbinden Sie sich mit dem Server
2. Oeffnen Sie das Menue: /quests
3. Ueberpruefen Sie, ob das Menue korrekt angezeigt wird
4. Aktivieren Sie eine Quest ueber BetonQuest und pruefen Sie, ob sie in der richtigen Kategorie erscheint

Pruef-Checkliste

• Das Menue oeffnet sich mit /quests
• Die Kategorien werden mit den richtigen Namen und Symbolen angezeigt
• Aktive Quests erscheinen in der richtigen Kategorie
• Das Tracking funktioniert (/quests track <quest_id>)
• Das Scoreboard zeigt die Ziele der verfolgten Quest an
• Die Seitennavigation funktioniert (bei vielen Quests)

Anzeigeprobleme?

Siehe Fehlerbehebung fuer Loesungen haeufiger Probleme.

Plugin aktualisieren

Um auf eine neue Version zu aktualisieren:

1. Stoppen Sie den Server
2. Ersetzen Sie die JAR in plugins/
3. Starten Sie den Server
4. Ueberpruefen Sie die Logs auf die neue Version
5. Fuehren Sie /questsreload aus, falls erforderlich

Automatische Updates

Aktivieren Sie updater.auto-download: true in config.yml, um neue Versionen automatisch in plugins/update/ herunterzuladen.

Sicherung

Sichern Sie vor jedem Update Ihren Ordner plugins/kginfoservs_queststrack/ und Ihre Datenbank.

Naechste Schritte

1. Konfigurieren Sie Ihre Kategorien und Quests: Konfiguration
2. Integrieren Sie Ihre BetonQuest-Quests: BetonQuest-Integration
3. Konfigurieren Sie Redis fuer Multi-Server: Multi-Server
4. Bei Problemen: Fehlerbehebung