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

Onderdeel	Waarde
Proxy	Velocity
Backend	Survival
Poort	poort
Publieke host	host

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.edit geeft de mogelijkheid om PvP voor andere spelers te wijzigen.
tulpenpvp.edit.invisible wijzigt 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