Votifier Plugin für Hytale
Modernes Abstimmungs-Plugin für Hytale-Server, entwickelt von Top-Games. Belohnen Sie Ihre Spieler automatisch, wenn sie abstimmen, mit einem konfigurierbaren Stufensystem.
Voraussetzungen
- Funktionierender Hytale-Server
- Java 25 oder höher
- WebServer-Plugin installiert (von Hytale empfohlenes Plugin)
- Zugriff auf Server-Konfigurationsdateien
SimpleVotifier Installation
SimpleVotifier herunterladen
Laden Sie die neueste Version des Plugins von Modtale herunter.
Auf Modtale herunterladenPlugin installieren
Kopieren Sie die SimpleVotifier.jar-Datei in den mods/-Ordner Ihres Hytale-Servers.
mods/SimpleVotifier.jar
WebServer überprüfen
Stellen Sie sicher, dass das WebServer-Plugin (von Hytale empfohlenes Plugin) installiert ist und funktioniert.
Server starten
Starten Sie Ihren Hytale-Server, damit SimpleVotifier automatisch seine Konfiguration generiert.
Plugin konfigurieren
Bearbeiten Sie die generierte Konfigurationsdatei nach Ihren Bedürfnissen (siehe Abschnitt Konfiguration).
Konfiguration
Nach dem ersten Start erstellt SimpleVotifier automatisch die Konfigurationsdatei mods/SimpleVotifier/config.json.
Standardkonfiguration
mods/SimpleVotifier/config.json
{
"language": "de",
"token": "AbCdEfGh123456789XyZ0123",
"allowedIps": [],
"logVotes": true,
"broadcastVotes": true,
"rewards": {
"enabled": false,
"monthlyReset": true,
"everyVoteCommands": [
"give {player} Plant_Crop_Carrot_Item"
],
"tiers": [
{
"votesRequired": 10,
"commands": ["give {player} Container_Bucket"]
},
{
"votesRequired": 50,
"commands": ["give {player} Armor_Iron_Head"]
},
{
"votesRequired": 100,
"commands": ["give {player} Rock_Gem_Diamond"]
}
]
},
"leaderboard": {
"enabled": true,
"format": "html",
"showVoteSites": true
},
"voteSites": [
{
"service": "Top-Games",
"url": "https://top-games.net/hytale/my-server"
}
]
}
Konfigurationsoptionen
| Option | Typ | Beschreibung |
|---|---|---|
language |
string | Sprachcode (en, fr, es, de, it, pt, ru, uk, zh, ja) |
token |
string | Sicherer Token für HMAC-Authentifizierung (automatisch generiert) |
allowedIps |
array | IP-Whitelist (leer = alle erlauben) |
logVotes |
boolean | Abstimmungen in der Konsole protokollieren |
broadcastVotes |
boolean | Abstimmungen an alle Spieler ankündigen |
Top-Games Konfiguration
Token abrufen
SimpleVotifier generiert automatisch einen Token, den Sie aus der Konfigurationsdatei abrufen müssen.
mods/SimpleVotifier/config.json
In Top-Games konfigurieren
Gehen Sie zu Ihrem Top-Games-Panel, Abschnitt "Votifier" Ihres Hytale-Servers.
- "SimpleVotifier" aktivieren
- Geben Sie Ihre Server-IP ein
- Port: standardmäßig Ihr Server-Port + 3 (Beispiel:
5523) - Geben Sie Ihren Token aus config.json ein
Verbindung testen
Verwenden Sie die Schaltfläche "Testen" in Ihrem Top-Games-Panel, um zu überprüfen, ob die Kommunikation korrekt funktioniert.
Belohnungssystem (optional)
SimpleVotifier enthält ein integriertes Belohnungssystem mit Befehlen für jede Abstimmung und Stufenbelohnungen.
Belohnungskonfiguration
config.json (rewards section)
{
"rewards": {
"enabled": true,
"monthlyReset": true,
"everyVoteCommands": ["give {player} Plant_Crop_Carrot_Item"],
"tiers": [
{
"votesRequired": 10,
"commands": ["give {player} Container_Bucket"]
},
{
"votesRequired": 50,
"commands": ["give {player} Armor_Iron_Head"]
},
{
"votesRequired": 100,
"commands": ["give {player} Rock_Gem_Diamond"]
}
]
}
}
Spielerbefehle
| Befehl | Beschreibung |
|---|---|
/rewards |
Ausstehende Abstimmungsbelohnungen einfordern |
/vote |
Konfigurierte Abstimmungsseiten auflisten |
/voteinfo |
Ihre Abstimmungsstatistiken und Stufenfortschritt anzeigen |
Entwickler-API
Drittanbieter-Plugins können Abstimmungsereignisse über den Hytale EventBus abhören.
MyPlugin.java
import com.hypixel.hytale.server.core.HytaleServer;
import net.top_games.hytale.plugins.simplevotifier.VoteEvent;
public class MyPlugin extends JavaPlugin {
@Override
protected void setup() {
HytaleServer.get().getEventBus()
.listenFor(VoteEvent.class, null)
.listen(this::onVote);
}
private void onVote(VoteEvent event) {
String username = event.getUsername();
String service = event.getServiceName();
getLogger().atInfo().log(username + " voted on " + service);
// Add your custom logic here
}
}
Bestenliste (optional)
SimpleVotifier enthält einen Bestenlisten-Endpunkt, um die Top-Wähler auf Ihrem Server anzuzeigen.
Bestenlisten-Konfiguration
config.json (leaderboard section)
{
"leaderboard": {
"enabled": true,
"format": "html",
"showVoteSites": true
}
}
Bestenlisten-Optionen
| Option | Typ | Beschreibung |
|---|---|---|
enabled |
boolean | Bestenlisten-Endpunkt aktivieren/deaktivieren (standardmäßig deaktiviert) |
format |
string | Standard-Ausgabeformat: "html" oder "json" (standardmäßig html) |
showVoteSites |
boolean | Abstimmungsseiten-Bereich in der Bestenliste anzeigen/ausblenden |
Bestenlisten-Endpunkt
GET https://your-server:port/Top-Games/SimpleVotifier/leaderboard
Fehlerbehebung
- Überprüfen Sie, ob das WebServer-Plugin installiert ist
- Überprüfen Sie die Server-Logs auf Fehlermeldungen
- Überprüfen Sie, ob die HMAC-Signatur korrekt generiert wird
- Überprüfen Sie die allowedIps-Konfiguration
- Überprüfen Sie die Server-Logs auf Fehlermeldungen
- Stellen Sie sicher, dass rewards.enabled auf true gesetzt ist
- Überprüfen Sie die Befehlssyntax in der Konfiguration
- Überprüfen Sie, ob der Spieler online ist, oder verwenden Sie /rewards zum Einfordern
- Bestätigen Sie, dass monthlyReset aktiviert ist
- Überprüfen Sie die last_reset.txt-Datei für das letzte Reset-Datum
- Der Reset wird bei der ersten Abstimmung des neuen Monats ausgelöst
Informationen
Funktionen
- Sichere HMAC-SHA256-Authentifizierung
- Integriertes Belohnungssystem
- Unterstützung für 10 Sprachen
- Abstimmungsankündigungen an alle Spieler
- Monatliche Abstimmungs-Resets
- Ereignisbasierte API für Drittanbieter-Plugins
- Bestenlisten-Endpunkt (HTML/JSON)
Konfigurationsübersicht
- WebServer-Plugin installieren
- SimpleVotifier installieren
- config.json konfigurieren
- In Top-Games konfigurieren
- Verbindung testen
- Belohnungen konfigurieren
- Bestenliste konfigurieren
Support
Benötigen Sie Hilfe bei der Konfiguration von SimpleVotifier? Unser Team hilft Ihnen gerne.
Entdecken Sie Hytale-Server
Erkunden Sie unser Ranking der besten Hytale-Server und treten Sie der Community bei!
Hytale-Server ansehen