TitleManager

Version 3.0.0

Ein umfassendes Title/Subtitle-Manager-Plugin für Bukkit/Spigot-Server.

Features

• 📜 Titel und Untertitel mit Animationen
• 📢 Action Bar Messages
• 👥 Player List Header/Footer
• 📊 Scoreboard Management
• 🎬 Umfangreiche Animations-Unterstützung
• 🔌 PlaceholderAPI Integration
• 🎨 Farbunterstützung (Hex-Farben, Chat-Farben)
• 🔄 Hot-Reload Funktionalität
• 🌐 BungeeCord Support
• 📝 Konfigurierbar

Anforderungen

• Java: 21 oder höher
• Minecraft Server: 1.21.x (Spigot/Paper)

Installation

Aus Quelle bauen

mvn clean package

Die fertige JAR-Datei befindet sich in target/titlemanager-3.0.0.jar

Plugin installieren

1. Kopiere die JAR-Datei in den plugins/ Ordner deines Servers
2. Starte deinen Server neu
3. Das Plugin erstellt automatisch die Konfigurationsdatei
4. Konfiguriere das Plugin in plugins/TitleManager/config.yml
5. Lade das Plugin mit /tm reload neu

Befehle

/tm reload          - Plugin neu laden und Konfiguration erneuern
/tm help            - Zeige Hilfe an
/titlemanager       - Alias für /tm

Permissions

titlemanager.command.main       - Zugriff auf TitleManager Befehle
titlemanager.command.reload     - Darf Plugin neu laden
titlemanager.*                  - Alle Permissions

Konfiguration

Die Hauptkonfiguration befindet sich in plugins/TitleManager/config.yml

Beispiel:

# Globale Einstellungen
settings:
  debug: false
  update-check: true
  
# Animation Einstellungen
animations:
  enabled: true
  default-duration: 100

Entwicklung

Projektstruktur

TitleManager/
├── src/
│   ├── main/
│   │   ├── java/io/mviper/mc/titlemanager/
│   │   │   ├── api/v2/                  # Öffentliche API
│   │   │   ├── internal/                # Interne Komponenten
│   │   │   └── TitleManagerPlugin.java
│   │   └── resources/
│   │       └── plugin.yml
│   └── test/
├── pom.xml                              # Maven-Konfiguration
└── README.md

API Nutzung für Plugin-Entwickler

import io.mviper.mc.titlemanager.api.v2.TitleManagerAPI;
import org.bukkit.Bukkit;
import org.bukkit.entity.Player;

public class MyPlugin extends JavaPlugin {
    @Override
    public void onEnable() {
        // TitleManager API erhalten
        TitleManagerAPI api = (TitleManagerAPI) Bukkit.getPluginManager()
            .getPlugin("TitleManager");
        
        if (api != null) {
            // Titel an Spieler senden
            Player player = Bukkit.getPlayer("PlayerName");
            if (player != null) {
                api.sendTitle(player, "§6Willkommen!");
                api.sendSubtitle(player, "§eZum Server!");
                api.sendActionbar(player, "§aGuten Spieltag!");
            }
        }
    }
}

API Methoden

• Titel/Untertitel: sendTitle(), sendSubtitle(), sendTitles()
• Action Bar: sendActionbar()
• Player List: setHeader(), setFooter(), setHeaderAndFooter()
• Scoreboard: giveScoreboard(), setScoreboardTitle(), setScoreboardValue()
• Animationen: containsAnimations(), getRegisteredAnimations(), addAnimation()
• Platzhalter: replaceText(), containsPlaceholders()

Lizenz

TitleManager ist unter der MIT License lizenziert. Siehe LICENSE.md für Details.

Support

• 🐛 Bug Reports: https://git.viper.ipv64.net/M_Viper/TitleManager
• 💬 Diskussionen: GitHub Discussions
• 📖 Dokumentation: Siehe Wiki

Danksagungen

• Bukkit/Spigot Community
• PlaceholderAPI
• Alle Contributors