Dit is een oude revisie van het document!
TulpenCraftEssentials
📌 Status
| Eigenschap | Waarde |
|---|---|
| Plugin | TulpenCraftEssentials |
| Status | 🟢 Actief |
| Versie | 1.1.1 |
| Buildsysteem | Maven |
| Platform | Paper |
| Server(s) | Survival |
| Onderdeel van netwerk | Ja |
| Laatste controle | datum |
| Server | Actief |
|---|---|
| Velocity | ❌ |
| Lobby | ❌ |
| Survival | ✅ |
| Events | ❌ |
🎯 Doel
TulpenCraftEssentials is de algemene utility-plugin van TulpenCraft.
De plugin bundelt algemene serverfunctionaliteit die niet specifiek genoeg is voor een afzonderlijke gespecialiseerde plugin. Hieronder vallen onder andere configureerbare serverlinks, een starterkit, welkomstberichten en persoonlijke begroetingen.
De plugin is bewust lichtgewicht opgezet en heeft geen afhankelijkheid van andere plugins.
📦 Installatie
Jar-bestand:
TulpenCraftEssentials-1.1.1.jar
Locatie:
/srv/minecraft/survival/plugins/TulpenCraftEssentials-1.1.1.jar
Builden:
Het project gebruikt Maven.
mvn clean package
De gebouwde JAR wordt aangemaakt in:
target/TulpenCraftEssentials-1.1.1.jar
⚙️ Configuratie
Configuratiebestand:
/srv/minecraft/survival/plugins/TulpenCraftEssentials/config.yml
Persoonlijke begroetingen worden opgeslagen in:
/srv/minecraft/survival/plugins/TulpenCraftEssentials/greetings.yml
Belangrijke instellingen
| Instelling | Waarde | Betekenis |
|---|---|---|
| Website | Configureerbaar | URL van de TulpenCraft-website |
| Wiki | Configureerbaar | URL van de TulpenCraft-wiki |
| Prijzen | Configureerbaar | URL naar de prijzenpagina |
| Discord | Configureerbaar | URL naar de Discord-community |
| Regels | Configureerbaar | URL naar de serverregels |
| Vote | Configureerbaar | URL naar de vote-pagina |
| Starterkit | Configureerbaar | Inhoud van de starterkit |
| Welkomstberichten | Configureerbaar | Berichten voor nieuwe en terugkerende spelers |
| Begroetingen | Configureerbaar | Functionaliteit voor persoonlijke begroetingen |
TulpenCraft-configuratie
De plugin gebruikt een config.yml voor de algemene instellingen. De exacte configuratie wordt door de plugin zelf aangemaakt en kan worden aangepast aan de TulpenCraft-infrastructuur.
# Zie de gegenereerde config.yml # voor de actuele TulpenCraft-configuratie.
🔐 Rechten
| Permission | Rank | Beschrijving |
|---|---|---|
tulpenessentials.customgreeting | Speler | Persoonlijke begroeting gebruiken en beheren |
tulpenessentials.customgreeting.color | rank | Kleurcodes gebruiken in persoonlijke begroetingen |
tulpenessentials.customgreeting.others | rank | Begroetingen van andere spelers beheren |
tulpenessentials.admin | Admin | Administratieve functionaliteit |
tulpenessentials.* | Admin | Volledige toegang tot TulpenCraftEssentials |
Rankverdeling
| Rank | Rechten |
|---|---|
| Speler | tulpenessentials.customgreeting |
| VIP | tulpenessentials.customgreeting |
| VIP+ | tulpenessentials.customgreeting |
| Helper | tulpenessentials.customgreeting + tulpenessentials.customgreeting.others |
| Bouwer | tulpenessentials.customgreeting + tulpenessentials.customgreeting.others |
| Moderator | Zie Bouwer + staffrechten |
| Developer | Zie Moderator + administratieve rechten indien nodig |
| Admin | tulpenessentials.admin, tulpenessentials.* |
| Owner | tulpenessentials.* |
💬 Commando's
| Commando | Permission | Beschrijving |
|---|---|---|
/website | — | Opent de geconfigureerde TulpenCraft-website |
/wiki | — | Opent de geconfigureerde TulpenCraft-wiki |
/prijzen | — | Opent de geconfigureerde prijzenpagina |
/discord | — | Opent de geconfigureerde Discord-link |
/regels | — | Opent de geconfigureerde regels |
/vote | — | Opent de geconfigureerde vote-pagina |
/starterkit | — | Claimt de eenmalige starterkit |
/kit | — | Alias voor /starterkit |
/begroeting | tulpenessentials.customgreeting | Persoonlijke begroeting bekijken of instellen |
/begroeting <tekst> | tulpenessentials.customgreeting | Persoonlijke begroeting instellen |
/begroeting reset | tulpenessentials.customgreeting | Persoonlijke begroeting verwijderen |
/begroeting speler <naam> | tulpenessentials.customgreeting.others | Begroeting van een speler bekijken |
/begroeting speler <naam> <tekst> | tulpenessentials.customgreeting.others | Begroeting van een speler instellen |
/begroeting speler <naam> reset | tulpenessentials.customgreeting.others | Begroeting van een speler verwijderen |
🔗 Afhankelijkheden
Verplichte afhankelijkheden
- Paper API 1.21.x
- Java 21
Plugin-afhankelijkheden
Geen.
TulpenCraftEssentials heeft geen runtime-afhankelijkheid van:
- LuckPerms
- Vault
- PlaceholderAPI
- WorldGuard
- GriefPrevention
- ProtocolLib
- PacketEvents
Optionele integraties
Geen.
🌐 Netwerk / Proxy
Proxy-plugin: Nee
TulpenCraftEssentials draait als backend-plugin op de Survival-server en bevat geen Velocity-component.
🛡️ Beveiliging
TulpenCraftEssentials is een relatief eenvoudige backend-plugin zonder externe database of externe plugin-integraties.
De plugin gebruikt Bukkit/Paper-permissions voor functionaliteit waarvoor verhoogde rechten nodig zijn.
Persoonlijke begroetingen worden opgeslagen in greetings.yml. Gebruikersinvoer wordt verwerkt voordat deze als begroeting wordt gebruikt. Onder andere regeleinden worden verwijderd en het gebruik van kleurcodes wordt gecontroleerd via een afzonderlijke permission.
De starterkit gebruikt Bukkit's PersistentDataContainer om per speler vast te leggen of de starterkit al is geclaimd.
Er wordt geen externe database gebruikt.
⚠️ Aandachtspunten
- De plugin vereist Java 21.
- De plugin is bedoeld voor Paper 1.21.x.
- De plugin heeft geen externe plugin-afhankelijkheden.
- De starterkit kan per speler slechts eenmaal worden geclaimd.
- Persoonlijke begroetingen worden opgeslagen in
greetings.yml. - Wijzigingen in de configuratie moeten worden gecontroleerd na een serverrestart.
- De plugin gebruikt Maven als buildsysteem.
🧪 Troubleshooting
Plugin wordt niet geladen
Controleer eerst of de plugin succesvol is geladen:
/plugins
Controleer vervolgens de serverlog:
grep -i "TulpenCraftEssentials" logs/latest.log
Controleer daarnaast de Java-versie:
java -version
De plugin vereist Java 21.
Commando's zijn niet beschikbaar
Controleer of TulpenCraftEssentials als geladen wordt weergegeven in /plugins.
Wanneer de plugin niet geladen is, controleer dan logs/latest.log op fouten tijdens het initialiseren.
Starterkit kan niet worden geclaimd
Controleer of de speler de starterkit al eerder heeft ontvangen.
De plugin slaat de claimstatus op via Bukkit's PersistentDataContainer.
Persoonlijke begroeting werkt niet
Controleer of de speler beschikt over:
tulpenessentials.customgreeting
Controleer daarnaast:
plugins/TulpenCraftEssentials/greetings.yml
Kleurcodes werken niet
Voor het gebruik van kleurformattering is de volgende permission nodig:
tulpenessentials.customgreeting.color
📝 Onderhoud
Laatste wijziging: datum
Wijziging: Documentatie aangemaakt / bijgewerkt op basis van TulpenCraftEssentials 1.1.1.
Status: 🟢 Actief