plugins:tulpencraftpvp [TulpenCraft Wiki]

Deze pagina is alleen-lezen. Je kan de broncode bekijken maar niet veranderen. Neem contact op met de beheerder als je denkt dat dit niet klopt.
====== TulpenCraftPVP ======

~~NOTOC~~

===== 📌 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:**

<code>
TulpenCraftPVP-1.0.4.jar
</code>

**Locatie:**

<code>
/srv/minecraft/survival/plugins/TulpenCraftPVP-1.0.4.jar
</code>

----

===== ⚙️ Configuratie =====

**Configuratiebestand:**

<code>
/srv/minecraft/survival/plugins/TulpenCraftPVP/config.yml
</code>

==== 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 ====

<code yaml>
mode: shared
default: false
greeter:
    enabled: true
</code>

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 ^
| <code>/pvp</code> | `tulpenpvp.use` | Toont de huidige PvP-status |
| <code>/pvp aan</code> | `tulpenpvp.use` | Schakelt eigen PvP in |
| <code>/pvp on</code> | `tulpenpvp.use` | Schakelt eigen PvP in |
| <code>/pvp uit</code> | `tulpenpvp.use` | Schakelt eigen PvP uit |
| <code>/pvp off</code> | `tulpenpvp.use` | Schakelt eigen PvP uit |
| <code>/pvp aan &lt;speler&gt;</code> | `tulpenpvp.edit` | Schakelt PvP in voor een online speler |
| <code>/pvp uit &lt;speler&gt;</code> | `tulpenpvp.edit` | Schakelt PvP uit voor een online speler |
| <code>/pvptoggle</code> | `tulpenpvp.use` | Alias voor het PvP-commando |

----

===== 🔗 Afhankelijkheden =====

  * **Paper 1.21+**
  * **Java 25**

Optioneel:

  * [[plugins:placeholderapi|PlaceholderAPI]]
  * [[plugins:luckperms|LuckPerms]]

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:

<code>
tulpenpvp=&cAAN
</code>

Daarnaast wordt een suffix met priority `100` gebruikt:

<code>
 &c⚔
</code>

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:

<code bash>
/lp user <speler> permission check tulpenpvp.use
</code>

==== PvP-gevecht start niet ====

Controleer of beide spelers PvP hebben ingeschakeld wanneer `mode: shared` actief is:

<code>
/pvp
</code>

Controleer vervolgens de configuratie:

<code yaml>
mode: shared
</code>

==== PvP-status verschijnt niet in een scoreboard ====

Controleer of PlaceholderAPI is geïnstalleerd en actief is.

Gebruik de beschikbare placeholders:

<code>
%tulpenpvp_status%
%tulpenpvp_enabled%
</code>

==== 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:

<code>
tulpenpvp
</code>

----

===== 📝 Onderhoud =====

**Laatste wijziging:** {{DATUM}}

**Wijziging:** Documentatie aangemaakt voor TulpenCraftPVP 1.0.4.

**Status:** ✅ Actief

----

===== 🔗 Externe links =====

  * [[https://github.com/TulpenCraft/TulpenCraftPVP|GitHub repository]]
  * [[https://github.com/TulpenCraft/TulpenCraftPVP#tulpencraftpvp|README / officiële documentatie]]