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 configureerbare serverlinks, een eenmalige starterkit, welkomstberichten en persoonlijke begroetingen.
De plugin is bewust lichtgewicht opgezet en heeft geen runtime-afhankelijkheid van andere plugins.
📦 Installatie
Jar-bestand:
TulpenCraftEssentials-1.1.1.jar
Locatie:
/srv/minecraft/survival/plugins/TulpenCraftEssentials-1.1.1.jar
Buildsysteem:
Maven
Buildcommando:
mvn clean package
Build-output:
target/TulpenCraftEssentials-1.1.1.jar
⚙️ Configuratie
Configuratiebestand:
/srv/minecraft/survival/plugins/TulpenCraftEssentials/config.yml
Opslag persoonlijke begroetingen:
/srv/minecraft/survival/plugins/TulpenCraftEssentials/greetings.yml
Belangrijke instellingen
| Instelling | Waarde | Betekenis |
|---|---|---|
links.website | Configureerbaar | URL van de TulpenCraft-website |
links.wiki | Configureerbaar | URL van de TulpenCraft-wiki |
links.prijzen | Configureerbaar | URL naar de actuele prijslijst |
links.discord | Configureerbaar | URL naar de TulpenCraft Discord |
links.regels | Configureerbaar | URL naar de serverregels |
links.vote | Configureerbaar | URL naar de vote-pagina |
welcome.enabled | true | Schakelt welkomstfunctionaliteit in |
welcome.first_join.enabled | true | Schakelt het first-join bericht in |
welcome.returning.enabled | true | Schakelt het terugkeerbericht in |
welcome.custom_greeting.enabled | true | Schakelt persoonlijke begroetingen in |
welcome.custom_greeting.show_on_join | true | Toont de persoonlijke begroeting bij het joinen |
welcome.custom_greeting.max_length | 48 | Maximale lengte van een persoonlijke begroeting |
starterkit.enabled | true | Schakelt de starterkit in |
starterkit.one_time | true | Zorgt dat de starterkit slechts eenmaal kan worden ontvangen |
starterkit.items | Configureerbaar | Inhoud van de starterkit |
TulpenCraft-configuratie
links: website: "https://tulpencraft.nl" wiki: "https://wiki.tulpencraft.nl" prijzen: "https://wiki.tulpencraft.nl/algemene-informatie/economie/pricelimits" discord: "https://discord.gg/VERVANG-DIT" regels: "https://wiki.tulpencraft.nl/algemene-informatie/regels" vote: "https://wiki.tulpencraft.nl/algemene-informatie/voten" welcome: enabled: true first_join: enabled: true returning: enabled: true custom_greeting: enabled: true show_on_join: true max_length: 48 starterkit: enabled: true one_time: true
🔐 Rechten
| Permission | Rank | Beschrijving |
|---|---|---|
tulpenessentials.starterkit | Standaard: iedereen | Mag de starterkit gebruiken |
tulpenessentials.admin | Standaard: Operator | Mag TulpenCraftEssentials beheren |
tulpenessentials.customgreeting | Standaard: niemand | Mag een eigen begroeting instellen |
tulpenessentials.customgreeting.color | Standaard: Operator | Mag kleurcodes gebruiken in de eigen begroeting |
tulpenessentials.customgreeting.others | Standaard: Operator | Mag begroetingen van andere spelers beheren |
Rankverdeling
De plugin koppelt permissions niet rechtstreeks aan TulpenCraft-ranks. De daadwerkelijke rankverdeling wordt centraal beheerd, bijvoorbeeld via LuckPerms.
| Rank | Rechten |
|---|---|
| Speler | tulpenessentials.starterkit |
| VIP | Afhankelijk van centrale permissionconfiguratie |
| VIP+ | Afhankelijk van centrale permissionconfiguratie |
| Helper | Afhankelijk van centrale permissionconfiguratie |
| Bouwer | Afhankelijk van centrale permissionconfiguratie |
| Moderator | Afhankelijk van centrale permissionconfiguratie |
| Developer | Afhankelijk van centrale permissionconfiguratie |
| Admin | tulpenessentials.admin indien toegewezen |
| Owner | tulpenessentials.admin indien toegewezen |
💬 Commando's
| Commando | Permission | Beschrijving |
|---|---|---|
/website | — | Opent de geconfigureerde TulpenCraft-website |
/wiki | — | Opent de geconfigureerde TulpenCraft-wiki |
/prijzen | — | Opent de actuele TulpenCraft-prijslijst |
/discord | — | Opent de geconfigureerde Discord-link |
/regels | — | Opent de geconfigureerde serverregels |
/vote | — | Opent de geconfigureerde vote-pagina |
/voten | — | Alias voor /vote |
/starterkit | tulpenessentials.starterkit | Ontvangt de eenmalige starterkit |
/kit | tulpenessentials.starterkit | Alias voor /starterkit |
/tulpen reload | tulpenessentials.admin | Herlaadt de pluginconfiguratie |
/begroeting | tulpenessentials.customgreeting | Bekijk de eigen begroeting |
/begroeting <tekst> | tulpenessentials.customgreeting | Stel een eigen begroeting in |
/begroeting reset | tulpenessentials.customgreeting | Verwijder de eigen begroeting |
/greeting | tulpenessentials.customgreeting | Alias voor /begroeting |
/begroeting speler <naam> | tulpenessentials.customgreeting.others | Bekijk de begroeting van een andere speler |
/begroeting speler <naam> <tekst> | tulpenessentials.customgreeting.others | Stel een begroeting voor een andere speler in |
/begroeting speler <naam> reset | tulpenessentials.customgreeting.others | Verwijder de begroeting van een andere speler |
🔗 Afhankelijkheden
Verplichte afhankelijkheden
- Paper API
1.21.8-R0.1-SNAPSHOT - Java 21
Plugin-afhankelijkheden
Geen.
TulpenCraftEssentials vereist geen:
- LuckPerms
- Vault
- PlaceholderAPI
- WorldGuard
- GriefPrevention
- ProtocolLib
- PacketEvents
- andere TulpenCraft-plugin
Optionele integraties
Geen.
🌐 Netwerk / Proxy
Proxy-plugin: Nee
TulpenCraftEssentials draait als backend-plugin op de Survival-server en bevat geen Velocity-component.
🛡️ Beveiliging
TulpenCraftEssentials heeft geen externe database en heeft geen runtime-afhankelijkheid van andere plugins.
Administratieve functionaliteit wordt beschermd via Bukkit/Paper-permissions.
Persoonlijke begroetingen worden opgeslagen in greetings.yml. Gebruikersinvoer wordt opgeschoond voordat deze wordt opgeslagen en weergegeven. Regeleinden worden verwijderd en kleurcodes worden gecontroleerd via een afzonderlijke permission.
De maximale lengte van een persoonlijke begroeting is standaard 48 Unicode-tekens. De plugin telt hierbij Unicode codepoints.
De starterkit gebruikt Bukkit's PersistentDataContainer om per speler vast te leggen of de starterkit al is ontvangen.
Links worden vanuit de configuratie geladen en als klikbare Adventure Components aan spelers aangeboden.
⚠️ Aandachtspunten
- De plugin vereist Java 21.
- De plugin is gebouwd tegen Paper API
1.21.8-R0.1-SNAPSHOT. - De plugin heeft geen externe plugin-afhankelijkheden.
- De starterkit kan standaard slechts eenmaal per speler worden geclaimd.
- De starterkit-status wordt opgeslagen in de speler-PersistentDataContainer.
- Persoonlijke begroetingen worden opgeslagen in
greetings.yml. - Een persoonlijke begroeting vervangt bij terugkerende spelers het normale terugkeerbericht.
- Bij een eerste join blijft het uitgebreide first-join bericht actief.
- De standaard Discord-URL in de huidige configuratie is nog een placeholder en moet worden vervangen.
- Configuratiewijzigingen kunnen worden toegepast met
/tulpen reload.
🧪 Troubleshooting
Plugin wordt niet geladen
Controleer of de plugin actief is:
/plugins
Controleer vervolgens de serverlog:
grep -i "TulpenCraftEssentials" logs/latest.log
Controleer ook de Java-versie:
java -version
De plugin vereist Java 21.
Commando's zijn niet beschikbaar
Controleer of TulpenCraftEssentials succesvol is geladen.
Controleer daarna logs/latest.log op fouten tijdens het starten.
Configuratiewijzigingen worden niet toegepast
Gebruik:
/tulpen reload
Controleer vervolgens of de wijziging correct in config.yml staat.
Starterkit kan niet worden geclaimd
Controleer of de speler de starterkit al eerder heeft ontvangen.
Wanneer starterkit.one_time is ingeschakeld, wordt de status per speler opgeslagen via 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 kleurcodes is de volgende permission nodig:
tulpenessentials.customgreeting.color
Een URL werkt niet
Controleer de betreffende instelling in:
plugins/TulpenCraftEssentials/config.yml
Een URL die nog VERVANG-DIT bevat wordt door de plugin als niet-ingesteld beschouwd.
📝 Onderhoud
Laatste wijziging: datum
Wijziging: Documentatie opgesteld op basis van TulpenCraftEssentials 1.1.1 en de actuele broncode.
Status: 🟢 Actief