Edit README.md via Git Manager GUI
This commit is contained in:
262
README.md
262
README.md
@@ -1,131 +1,131 @@
|
|||||||
# TitleManager
|
# TitleManager
|
||||||
**Version 3.0.0**
|
**Version 3.0.0**
|
||||||
|
|
||||||
Ein umfassendes Title/Subtitle-Manager-Plugin für Bukkit/Spigot-Server.
|
Ein umfassendes Title/Subtitle-Manager-Plugin für Bukkit/Spigot-Server.
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
- 📜 Titel und Untertitel mit Animationen
|
- 📜 Titel und Untertitel mit Animationen
|
||||||
- 📢 Action Bar Messages
|
- 📢 Action Bar Messages
|
||||||
- 👥 Player List Header/Footer
|
- 👥 Player List Header/Footer
|
||||||
- 📊 Scoreboard Management
|
- 📊 Scoreboard Management
|
||||||
- 🎬 Umfangreiche Animations-Unterstützung
|
- 🎬 Umfangreiche Animations-Unterstützung
|
||||||
- 🔌 PlaceholderAPI Integration
|
- 🔌 PlaceholderAPI Integration
|
||||||
- 🎨 Farbunterstützung (Hex-Farben, Chat-Farben)
|
- 🎨 Farbunterstützung (Hex-Farben, Chat-Farben)
|
||||||
- 🔄 Hot-Reload Funktionalität
|
- 🔄 Hot-Reload Funktionalität
|
||||||
- 🌐 BungeeCord Support
|
- 🌐 BungeeCord Support
|
||||||
- 📝 Konfigurierbar
|
- 📝 Konfigurierbar
|
||||||
|
|
||||||
## Anforderungen
|
## Anforderungen
|
||||||
- **Java**: 21 oder höher
|
- **Java**: 21 oder höher
|
||||||
- **Minecraft Server**: 1.21.x (Spigot/Paper)
|
- **Minecraft Server**: 1.21.x (Spigot/Paper)
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
### Aus Quelle bauen
|
### Aus Quelle bauen
|
||||||
```bash
|
```bash
|
||||||
mvn clean package
|
mvn clean package
|
||||||
```
|
```
|
||||||
|
|
||||||
Die fertige JAR-Datei befindet sich in `target/titlemanager-3.0.0.jar`
|
Die fertige JAR-Datei befindet sich in `target/titlemanager-3.0.0.jar`
|
||||||
|
|
||||||
### Plugin installieren
|
### Plugin installieren
|
||||||
1. Kopiere die JAR-Datei in den `plugins/` Ordner deines Servers
|
1. Kopiere die JAR-Datei in den `plugins/` Ordner deines Servers
|
||||||
2. Starte deinen Server neu
|
2. Starte deinen Server neu
|
||||||
3. Das Plugin erstellt automatisch die Konfigurationsdatei
|
3. Das Plugin erstellt automatisch die Konfigurationsdatei
|
||||||
4. Konfiguriere das Plugin in `plugins/TitleManager/config.yml`
|
4. Konfiguriere das Plugin in `plugins/TitleManager/config.yml`
|
||||||
5. Lade das Plugin mit `/tm reload` neu
|
5. Lade das Plugin mit `/tm reload` neu
|
||||||
|
|
||||||
## Befehle
|
## Befehle
|
||||||
```
|
```
|
||||||
/tm reload - Plugin neu laden und Konfiguration erneuern
|
/tm reload - Plugin neu laden und Konfiguration erneuern
|
||||||
/tm help - Zeige Hilfe an
|
/tm help - Zeige Hilfe an
|
||||||
/titlemanager - Alias für /tm
|
/titlemanager - Alias für /tm
|
||||||
```
|
```
|
||||||
|
|
||||||
## Permissions
|
## Permissions
|
||||||
```
|
```
|
||||||
titlemanager.command.main - Zugriff auf TitleManager Befehle
|
titlemanager.command.main - Zugriff auf TitleManager Befehle
|
||||||
titlemanager.command.reload - Darf Plugin neu laden
|
titlemanager.command.reload - Darf Plugin neu laden
|
||||||
titlemanager.* - Alle Permissions
|
titlemanager.* - Alle Permissions
|
||||||
```
|
```
|
||||||
|
|
||||||
## Konfiguration
|
## Konfiguration
|
||||||
Die Hauptkonfiguration befindet sich in `plugins/TitleManager/config.yml`
|
Die Hauptkonfiguration befindet sich in `plugins/TitleManager/config.yml`
|
||||||
|
|
||||||
Beispiel:
|
Beispiel:
|
||||||
```yaml
|
```yaml
|
||||||
# Globale Einstellungen
|
# Globale Einstellungen
|
||||||
settings:
|
settings:
|
||||||
debug: false
|
debug: false
|
||||||
update-check: true
|
update-check: true
|
||||||
|
|
||||||
# Animation Einstellungen
|
# Animation Einstellungen
|
||||||
animations:
|
animations:
|
||||||
enabled: true
|
enabled: true
|
||||||
default-duration: 100
|
default-duration: 100
|
||||||
```
|
```
|
||||||
|
|
||||||
## Entwicklung
|
## Entwicklung
|
||||||
|
|
||||||
### Projektstruktur
|
### Projektstruktur
|
||||||
```
|
```
|
||||||
TitleManager/
|
TitleManager/
|
||||||
├── src/
|
├── src/
|
||||||
│ ├── main/
|
│ ├── main/
|
||||||
│ │ ├── java/io/mviper/mc/titlemanager/
|
│ │ ├── java/io/mviper/mc/titlemanager/
|
||||||
│ │ │ ├── api/v2/ # Öffentliche API
|
│ │ │ ├── api/v2/ # Öffentliche API
|
||||||
│ │ │ ├── internal/ # Interne Komponenten
|
│ │ │ ├── internal/ # Interne Komponenten
|
||||||
│ │ │ └── TitleManagerPlugin.java
|
│ │ │ └── TitleManagerPlugin.java
|
||||||
│ │ └── resources/
|
│ │ └── resources/
|
||||||
│ │ └── plugin.yml
|
│ │ └── plugin.yml
|
||||||
│ └── test/
|
│ └── test/
|
||||||
├── pom.xml # Maven-Konfiguration
|
├── pom.xml # Maven-Konfiguration
|
||||||
└── README.md
|
└── README.md
|
||||||
```
|
```
|
||||||
|
|
||||||
### API Nutzung für Plugin-Entwickler
|
### API Nutzung für Plugin-Entwickler
|
||||||
```java
|
```java
|
||||||
import io.mviper.mc.titlemanager.api.v2.TitleManagerAPI;
|
import io.mviper.mc.titlemanager.api.v2.TitleManagerAPI;
|
||||||
import org.bukkit.Bukkit;
|
import org.bukkit.Bukkit;
|
||||||
import org.bukkit.entity.Player;
|
import org.bukkit.entity.Player;
|
||||||
|
|
||||||
public class MyPlugin extends JavaPlugin {
|
public class MyPlugin extends JavaPlugin {
|
||||||
@Override
|
@Override
|
||||||
public void onEnable() {
|
public void onEnable() {
|
||||||
// TitleManager API erhalten
|
// TitleManager API erhalten
|
||||||
TitleManagerAPI api = (TitleManagerAPI) Bukkit.getPluginManager()
|
TitleManagerAPI api = (TitleManagerAPI) Bukkit.getPluginManager()
|
||||||
.getPlugin("TitleManager");
|
.getPlugin("TitleManager");
|
||||||
|
|
||||||
if (api != null) {
|
if (api != null) {
|
||||||
// Titel an Spieler senden
|
// Titel an Spieler senden
|
||||||
Player player = Bukkit.getPlayer("PlayerName");
|
Player player = Bukkit.getPlayer("PlayerName");
|
||||||
if (player != null) {
|
if (player != null) {
|
||||||
api.sendTitle(player, "§6Willkommen!");
|
api.sendTitle(player, "§6Willkommen!");
|
||||||
api.sendSubtitle(player, "§eZum Server!");
|
api.sendSubtitle(player, "§eZum Server!");
|
||||||
api.sendActionbar(player, "§aGuten Spieltag!");
|
api.sendActionbar(player, "§aGuten Spieltag!");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### API Methoden
|
### API Methoden
|
||||||
- **Titel/Untertitel**: `sendTitle()`, `sendSubtitle()`, `sendTitles()`
|
- **Titel/Untertitel**: `sendTitle()`, `sendSubtitle()`, `sendTitles()`
|
||||||
- **Action Bar**: `sendActionbar()`
|
- **Action Bar**: `sendActionbar()`
|
||||||
- **Player List**: `setHeader()`, `setFooter()`, `setHeaderAndFooter()`
|
- **Player List**: `setHeader()`, `setFooter()`, `setHeaderAndFooter()`
|
||||||
- **Scoreboard**: `giveScoreboard()`, `setScoreboardTitle()`, `setScoreboardValue()`
|
- **Scoreboard**: `giveScoreboard()`, `setScoreboardTitle()`, `setScoreboardValue()`
|
||||||
- **Animationen**: `containsAnimations()`, `getRegisteredAnimations()`, `addAnimation()`
|
- **Animationen**: `containsAnimations()`, `getRegisteredAnimations()`, `addAnimation()`
|
||||||
- **Platzhalter**: `replaceText()`, `containsPlaceholders()`
|
- **Platzhalter**: `replaceText()`, `containsPlaceholders()`
|
||||||
|
|
||||||
## Lizenz
|
## Lizenz
|
||||||
TitleManager ist unter der MIT License lizenziert. Siehe [LICENSE.md](LICENSE.md) für Details.
|
TitleManager ist unter der MIT License lizenziert. Siehe [LICENSE.md](LICENSE.md) für Details.
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
- 🐛 Bug Reports:
|
- 🐛 Bug Reports: https://git.viper.ipv64.net/M_Viper/TitleManager
|
||||||
- 💬 Diskussionen: GitHub Discussions
|
- 💬 Diskussionen: GitHub Discussions
|
||||||
- 📖 Dokumentation: Siehe Wiki
|
- 📖 Dokumentation: Siehe Wiki
|
||||||
|
|
||||||
## Danksagungen
|
## Danksagungen
|
||||||
- Bukkit/Spigot Community
|
- Bukkit/Spigot Community
|
||||||
- PlaceholderAPI
|
- PlaceholderAPI
|
||||||
- Alle Contributors
|
- Alle Contributors
|
||||||
|
|||||||
Reference in New Issue
Block a user