TulpenCraftPVP
📌 Status
| Eigenschap | Waarde |
|---|---|
| Plugin | TulpenCraftPVP |
| Status | 🟢 Actief |
| Versie | 1.0.4 |
| Platform | Paper 1.21+ |
| Server(s) | Survival |
| Onderdeel van netwerk | Ja |
| Laatste controle | datum |
| Server | Actief |
|---|---|
| Velocity | ❌ |
| Lobby | ❌ |
| Survival | ✅ |
| Events | ❌ |
🎯 Doel
TulpenCraftPVP beheert de persoonlijke PvP-status van spelers binnen TulpenCraft.
Spelers kunnen zelf bepalen of zij PvP willen inschakelen. Nieuwe spelers beginnen standaard met PvP uit.
In de standaardmodus (shared) kan een PvP-gevecht alleen plaatsvinden wanneer beide spelers PvP hebben ingeschakeld.
De plugin biedt daarnaast mogelijkheden voor beheerders om de PvP-status van andere spelers te wijzigen.
📦 Installatie
Jar-bestand:
TulpenCraftPVP-1.0.4.jar
Locatie:
/srv/minecraft/survival/plugins/TulpenCraftPVP-1.0.4.jar
⚙️ Configuratie
Configuratiebestand:
/srv/minecraft/survival/plugins/TulpenCraftPVP/config.yml
Belangrijke instellingen
| Instelling | Waarde | Betekenis |
|---|---|---|
mode | shared | Beide spelers moeten PvP ingeschakeld hebben |
default | false | Nieuwe spelers beginnen met PvP uit |
greeter.enabled | true | Toont nieuwe spelers een korte uitleg over PvP |
PvP-modi
| Modus | Werking |
|---|---|
shared | Beide spelers moeten PvP aan hebben |
receiving | Alleen de PvP-status van de ontvangende speler wordt gecontroleerd |
TulpenCraft-configuratie
mode: shared default: false greeter: enabled: true
Alle pluginberichten kunnen eveneens via config.yml worden aangepast.
🔐 Rechten
| Permission | Rank | Beschrijving |
|---|---|---|
tulpenpvp.use | Speler | Eigen PvP-status wijzigen |
tulpenpvp.edit | Operator | PvP-status van andere spelers wijzigen |
tulpenpvp.edit.invisible | Operator | PvP-status wijzigen zonder de doelspeler te informeren |
tulpenpvp.manage | Operator | TulpenCraftPVP beheren |
Rankverdeling
| Rank | Rechten |
|---|---|
| Speler | tulpenpvp.use |
| VIP | tulpenpvp.use |
| VIP+ | tulpenpvp.use |
| Helper | tulpenpvp.use |
| Bouwer | tulpenpvp.use |
| Moderator | tulpenpvp.use, tulpenpvp.edit, tulpenpvp.edit.invisible |
| Developer | tulpenpvp.use, tulpenpvp.edit, tulpenpvp.edit.invisible, tulpenpvp.manage |
| Admin | tulpenpvp.use, tulpenpvp.edit, tulpenpvp.edit.invisible, tulpenpvp.manage |
| Owner | tulpenpvp.use, tulpenpvp.edit, tulpenpvp.edit.invisible, tulpenpvp.manage |
💬 Commando's
| Commando | Permission | Beschrijving |
|---|---|---|
/pvp | tulpenpvp.use | Toont de huidige PvP-status |
/pvp aan | tulpenpvp.use | Schakelt eigen PvP in |
/pvp on | tulpenpvp.use | Schakelt eigen PvP in |
/pvp uit | tulpenpvp.use | Schakelt eigen PvP uit |
/pvp off | tulpenpvp.use | Schakelt eigen PvP uit |
/pvp aan <speler> | tulpenpvp.edit | Schakelt PvP in voor een online speler |
/pvp uit <speler> | tulpenpvp.edit | Schakelt PvP uit voor een online speler |
/pvptoggle | tulpenpvp.use | Alias voor het PvP-commando |
🔗 Afhankelijkheden
- Paper 1.21+
- Java 25
Optioneel:
PlaceholderAPI en LuckPerms zijn niet vereist voor de basiswerking van de plugin.
🌐 Netwerk / Proxy
Proxy-plugin: Nee
TulpenCraftPVP draait als backend-plugin op de Survival-server en heeft geen eigen Velocity-component.
🏷️ PlaceholderAPI
Wanneer PlaceholderAPI is geïnstalleerd, zijn de volgende placeholders beschikbaar:
| Placeholder | Resultaat |
|---|---|
%tulpenpvp_status% | Gekleurde status AAN of UIT |
%tulpenpvp_enabled% | Booleanwaarde true of false |
Deze placeholders kunnen bijvoorbeeld worden gebruikt in scoreboards, tablists of andere plugins die PlaceholderAPI ondersteunen.
🔑 LuckPerms
Wanneer LuckPerms is geïnstalleerd, synchroniseert TulpenCraftPVP de PvP-status van spelers naar LuckPerms-meta.
Bij PvP aan:
tulpenpvp=&cAAN
Daarnaast wordt een suffix met priority 100 gebruikt:
&c⚔
Bij PvP uit wordt de door TulpenCraftPVP beheerde tulpenpvp-meta en suffix met priority 100 verwijderd.
De plugin verwijdert hierbij uitsluitend de eigen tulpenpvp-meta en het door de plugin beheerde suffix.
🛡️ Beveiliging
Nieuwe spelers starten standaard met PvP uit.
In de standaard shared-modus wordt een PvP-gevecht alleen toegestaan wanneer beide betrokken spelers PvP hebben ingeschakeld.
Beheerdersfuncties zijn afgeschermd via afzonderlijke permissions.
De permission tulpenpvp.edit.invisible maakt het mogelijk om de PvP-status van een speler te wijzigen zonder deze speler hierover te informeren. Deze permission dient daarom uitsluitend aan vertrouwde staffleden te worden toegekend.
⚠️ Aandachtspunten
- Nieuwe spelers beginnen standaard met PvP uit.
- In
shared-modus moeten beide spelers PvP aan hebben. - In
receiving-modus wordt alleen de PvP-status van de ontvangende speler gecontroleerd. tulpenpvp.editgeeft de mogelijkheid om PvP voor andere spelers te wijzigen.tulpenpvp.edit.invisiblewijzigt PvP zonder de doelspeler te informeren.- PlaceholderAPI is uitsluitend nodig voor de PvP-placeholders.
- LuckPerms is uitsluitend nodig voor de synchronisatie van PvP-status naar LuckPerms-meta.
- Bij het uitschakelen van PvP worden alleen de door TulpenCraftPVP beheerde LuckPerms-meta en suffix verwijderd.
- De standaard Paper API-build is
26.2.build.119-stable.
🧪 Troubleshooting
`/pvp` werkt niet
Controleer of de speler de benodigde permission heeft:
/lp user <speler> permission check tulpenpvp.use
PvP-gevecht start niet
Controleer of beide spelers PvP hebben ingeschakeld wanneer mode: shared actief is:
/pvp
Controleer vervolgens de configuratie:
mode: shared
PvP-status verschijnt niet in een scoreboard
Controleer of PlaceholderAPI is geïnstalleerd en actief is.
Gebruik de beschikbare placeholders:
%tulpenpvp_status% %tulpenpvp_enabled%
PvP-status wordt niet weergegeven via LuckPerms
Controleer of LuckPerms actief is en of de plugin de PvP-status correct kan synchroniseren.
Controleer de betreffende meta:
tulpenpvp
📝 Onderhoud
Laatste wijziging: datum
Wijziging: Documentatie aangemaakt voor TulpenCraftPVP 1.0.4.
Status: ✅ Actief