====== 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:** 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: * [[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: 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 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 ---- ===== 🔗 Externe links ===== * [[https://github.com/TulpenCraft/TulpenCraftPVP|GitHub repository]] * [[https://github.com/TulpenCraft/TulpenCraftPVP#tulpencraftpvp|README / officiële documentatie]]