Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

--- permissions [2026/09/11 17:15] – rroethof
+++ permissions [2026/09/11 17:15] (huidige) – oude revisie hersteld (2026/08/26 09:28) rroethof
@@ Regel 1: / Regel 1: @@
-# TulpenCraftRentals — interne wiki
+# 🔐 Rechten & Rangen
-## Inhoud
+LuckPerms verzorgt binnen Tulpencraft het centrale rechtenbeheer.
-- Installatie
+De rechtenstructuur is gebaseerd op **rangen**. Een permission die zonder servercontext aan een groep wordt gekoppeld, geldt standaard voor het volledige netwerk.
-- Configuratie
-- Permissies
-- Rentals aanmaken
-- Verhuurproces
-- Verhuurborden
-- ChestShop
-- Evacuatie
-- Reset
-- WorldGuard
-- Admin-GUI
-- Commando-overzicht
-- Database
-- Probleemoplossing
-## Overzicht
+Een permission kan daarnaast bewust server-specifiek worden gemaakt met een context, bijvoorbeeld:
-TulpenCraftRentals beheert tijdelijke verhuur van vooraf gedefinieerde WorldGuard-regio's. WorldGuard beschermt de fysieke regio; TulpenCraftRentals beheert contracten, betalingen, huurders, leden, ChestShops, verloopdatums, evacuatie en reset.
+`server=survival`
-| Onderdeel | Functie |
+Hierdoor kunnen uitzonderingen worden gemaakt zonder de algemene rankstructuur aan te passen.
-|---|---|
-| WorldGuard | Fysieke regiobescherming |
-| TulpenCraftRentals | Huurcontract en verhuurregels |
-| Vault | Betalingen in florijnen |
-| LuckPerms | Toegang en huurlimieten |
-| WorldEdit | Schematic-reset |
-| ChestShop | Winkeltransacties |
-| MariaDB | Centrale opslag |
-| Discord-webhook | Optionele meldingen |
-## Permissies
+---
-Verhuurtoegang:
+# 👥 Rangen
-```text
+De huidige rangen binnen Tulpencraft zijn:
-tulpencraft.rent.<type>.<naam>
-```
-Voorbeelden:
+^ Rang ^ Weight ^ Zichtbare prefix ^ Erft van ^
+| **Speler** | 1 | `&7[Speler] &f` | — |
+| **VIP** | 10 | `&a[VIP] &f` | Speler |
+| **VIP+** | 20 | `&b[VIP+] &f` | VIP |
+| **Helper** | 30 | `&9[Helper] &f` | Speler |
+| **Bouwer** | 40 | `&2[Bouwer] &f` | Speler |
+| **Moderator** | 50 | `&c[Moderator] &f` | Helper |
+| **Dev** | 70 | `&d[Dev] &f` | Moderator |
+| **Admin** | 80 | `&4[Admin] &f` | Dev |
+| **Owner** | 100 | `&6[Owner] &f` | Admin |
-```text
+De groepsnamen `builder` en dergelijke zijn technische LuckPerms-groepsnamen. De zichtbare prefix voor spelers is Nederlands.
-tulpencraft.rent.house.small
-tulpencraft.rent.house.medium
-tulpencraft.rent.shop.small
-tulpencraft.rent.shop.special001
-```
-Gebruik bij bijzondere sleutels geen extra punt:
+---
-```text
+# 🎨 Prefixen
-FOUT: tulpencraft.rent.house.special.003
-GOED: tulpencraft.rent.house.special003
-```
-Een rental zonder toegangspermissie is niet verhuurbaar.
+De prefix bestaat uit twee onderdelen:
-Huurlimieten:
+`[RANK]`
-```text
+gevolgd door de spelersnaam in de normale kleur.
-tulpencraft.rent.limit.house.2
-tulpencraft.rent.limit.shop.1
-tulpencraft.rent.limit.hotel.1
-```
-Admin:
+Voorbeeld:
-```text
+`[VIP] Speler123`
-tulpencraft.rentals.admin
-```
-## Rentals aanmaken
+De rank krijgt een eigen kleur. De spelersnaam blijft standaard wit.
-. Maak de WorldGuard-regio aan.
+^ Rang ^ Kleur ^ Voorbeeld ^
-. Controleer dat de regio niet overlapt met een andere rental-regio.
+| Speler | Grijs | `&7[Speler] &fSpeler123` |
-. Kies de toegangspermissie.
+| VIP | Groen | `&a[VIP] &fSpeler123` |
-. Geef de rental een zichtbare naam.
+| VIP+ | Aqua | `&b[VIP+] &fSpeler123` |
-. Stel prijs, ledenlimiet en ChestShoplimiet in.
+| Helper | Blauw | `&9[Helper] &fSpeler123` |
-. Koppel eventueel een schematic.
+| Bouwer | Donkergroen | `&2[Bouwer] &fSpeler123` |
-. Koppel eventueel een bord.
+| Moderator | Rood | `&c[Moderator] &fSpeler123` |
-. Activeer de rental.
+| Dev | Lichtpaars | `&d[Dev] &fSpeler123` |
+| Admin | Donkerrood | `&4[Admin] &fSpeler123` |
+| Owner | Goud | `&6[Owner] &fSpeler123` |
+---
+# 🌐 Contextmodel
+Tulpencraft gebruikt standaard **global permissions** voor rangen.
+Een permission zonder context geldt dus overal.
+Bijvoorbeeld:
+`essentials.home`
+betekent dat de speler deze permission op het volledige netwerk heeft.
+Een server-specifieke uitzondering wordt expliciet voorzien van een context:
+`server=survival`
+Bijvoorbeeld:
+`essentials.somepermission = true`
+met context:
+`server=survival`
+geldt alleen op Survival.
+Dit voorkomt dat dezelfde permissions onnodig per server moeten worden gedupliceerd.
+---
+# 🧬 Rank inheritance
+Rangen kunnen van elkaar erven.
+De huidige structuur is:
+Speler
+↓
+VIP
+↓
+VIP+
+Voor staff:
+Speler
+↓
+Helper
+↓
+Moderator
+↓
+Dev
+↓
+Admin
+↓
+Owner
+Bouwer staat als zelfstandige staff-/bouwgroep naast deze stafflijn.
+Door inheritance hoeven algemene permissions maar één keer te worden ingesteld.
+---
+# 👤 Speler
+De basisrang voor iedere speler is **Speler**.
+De speler krijgt de algemene Survival-QoL:
+^ Permission ^ Functie ^
+| `essentials.home` | Eigen home gebruiken |
+| `essentials.sethome` | Home instellen |
+| `essentials.delhome` | Home verwijderen |
+| `essentials.tpa` | Teleportverzoek sturen |
+| `essentials.tpa.accept` | Teleportverzoeken accepteren |
+| `essentials.spawn` | Naar spawn teleporteren |
+De speler krijgt **geen**:
+* `/warp`
+* `/back`
+* `/repair`
+* `/enderchest`
+* `/craftingtable`
+De standaard speler heeft één home.
+---
+# ⭐ VIP
+VIP is de eerste betaalde spelersrang.
+VIP erft alle rechten van **Speler** en krijgt daarnaast extra QoL-functionaliteit.
+^ Permission ^ Functie ^
+| `essentials.back` | Terugkeren naar vorige locatie |
+| `essentials.repair` | Item repareren |
+| `essentials.enderchest` | Ender Chest openen |
+| `essentials.craftingtable` | Crafting Table openen |
+VIP is daarmee vooral gericht op **gemak**, zonder directe gameplayvoordelen.
+---
+# 💎 VIP+
+VIP+ erft alle rechten van **VIP**.
+VIP+ is bedoeld als uitgebreidere betaalde spelersrang en krijgt aanvullende QoL-functionaliteit.
+Het exacte aanvullende rechtenpakket van VIP+ wordt op deze pagina bijgewerkt zodra dit definitief is vastgesteld.
+De geplande homecapaciteit voor VIP+ is:
+**5 homes**
+---
+# 🧑‍💼 Helper
+Helper is de eerste staffrang.
+Helper erft de algemene spelersrechten van Speler.
+Aanvullende Helper-permissions worden centraal vastgelegd zodra de staffrechten definitief zijn vastgesteld.
+---
+# 🧱 Bouwer
+De groep `builder` wordt gebruikt voor bouwers.
+De zichtbare prefix is:
+`&2[Bouwer] &f`
+Bouwrechten worden bij voorkeur **server- of wereldspecifiek** toegekend.
+Een Bouwer krijgt dus niet automatisch alle beheerrechten van een Moderator.
+---
+# 🛡️ Moderator
+Moderator is verantwoordelijk voor moderatie en het handhaven van de serverregels.
+Moderator erft de rechten van Helper en krijgt aanvullende moderatierechten.
+Voorbeelden van deze rechten zijn onder andere:
+* spelers aanspreken;
+* chatmoderatie;
+* waarschuwingen;
+* beperkte punishments;
+* ondersteuning bij meldingen.
+De exacte ControlBans-permissions worden op de ControlBans-pluginpagina bijgehouden.
+---
+# 💻 Dev
+De technische staffrang is:
+`dev`
+Zichtbare prefix:
+`&d[Dev] &f`
+Developers krijgen technische rechten die noodzakelijk zijn voor ontwikkeling en onderhoud.
+Deze rechten worden zo veel mogelijk beperkt tot noodzakelijke systemen en servers.
+---
+# 🔴 Admin
+Admin is verantwoordelijk voor het dagelijkse technische en operationele beheer van Tulpencraft.
+Zichtbare prefix:
+`&4[Admin] &f`
+Admins kunnen aanvullende beheerfuncties krijgen voor:
+* serverbeheer;
+* moderatie;
+* plugins;
+* configuratie;
+* onderhoud;
+* technische troubleshooting.
+Kritieke netwerkrechten worden niet automatisch aan de volledige Admin-groep toegekend wanneer dit niet noodzakelijk is.
+---
+# 👑 Owner
+Owner is de hoogste rang binnen Tulpencraft.
+Zichtbare prefix:
+`&6[Owner] &f`
+Owner erft van Admin.
+Niet iedere centrale beheerfunctie hoeft echter automatisch aan de groep `owner` te worden gekoppeld.
+Voor kritieke proxyrechten kunnen individuele gebruikers rechtstreeks worden gemachtigd.
+---
+# 🔧 Persoonsgebonden rechten
+Niet alle rechten worden aan een groep toegekend.
+Kritieke beheerrechten kunnen rechtstreeks aan individuele gebruikers worden toegekend.
 Voorbeeld:
-```text
+`maintenance.admin`
-/rg define testshop02
-/huur aanmaken testshop02 tulpencraft.rent.shop.small Shop001
-```
-## Verhuurproces
+Deze permission is uitsluitend bedoeld voor de aangewezen beheerders.
-Bij het huren controleert de plugin de permissie, huurlimiet, beschikbaarheid, het saldo via Vault en de geldigheid van de WorldGuard-regio.
+Dit voorkomt dat een gebruiker automatisch een zeer gevoelig proxyrecht krijgt alleen omdat hij of zij de rang Owner heeft.
-Daarna worden betaling, huurder, status, regio en bord bijgewerkt. Een fout mag niet leiden tot geld afgeschreven zonder toegekende huur.
+---
-Verlengen betaalt opnieuw de weekprijs en verlengt de einddatum met één week.
+# 🌐 Server-specifieke rechten
-## Verhuurborden
+Server-specifieke permissions worden alleen gebruikt wanneer een recht daadwerkelijk van een server afhankelijk is.
-```text
+Voorbeeld:
-/huur bord shop001
-/huur bord shop001 ontkoppelen
-/huur bordactie shop001 aan
-/huur bordactie shop001 uit
-```
-Beschikbaar:
+`server=survival`
-```text
+Een speler kan daardoor bijvoorbeeld een bepaalde permission op Survival hebben zonder dat deze permission ook op Lobby actief is.
-Shop001
-Beschikbaar
-,00 ƒ/week
-Rechtsklik
-```
-Verhuurd:
+De standaard voor ranks blijft echter:
-```text
+**Global tenzij anders aangegeven.**
-Shop001
-Ronny_NL
-t/m 18-09-2026
-VERHUURD
-```
-Evacuatie:
+---
-```text
+# 🎮 Servercontexten
-Shop001
-Ronny_NL
-t/m 21-09-2026
-EVACUATIE
-```
-Rechtermuisklik opent altijd een GUI. Een normale speler krijgt huur- en informatieopties, de huurder krijgt eigen huurdetails en staff met adminrechten krijgt de admin-GUI.
+De momenteel gebruikte servercontexten zijn:
-## ChestShop
+^ Context ^ Server ^
+| `server=lobby` | Lobby |
+| `server=survival` | Survival |
+| `server=events` | Events, indien actief |
+| `server=skyblock` | SkyBlock, indien actief |
-ChestShops zijn uitsluitend toegestaan binnen een actieve `SHOP`-rental.
+Niet iedere context hoeft permanent actief te zijn.
-De huurder en geautoriseerde medewerkers mogen ChestShops plaatsen, gebruiken en verwijderen, zolang het maximum niet is bereikt.
+---
+# 🧩 Permissionbeheer
+Permissions worden beheerd met LuckPerms.
+Voorbeelden:
-```text
+`/lp group speler permission set essentials.home true`
-/huur chestshops shop001 6
-```
-Buiten een actieve SHOP-rental zijn ChestShops niet toegestaan. Tijdens evacuatie mogen bestaande ChestShops eventueel nog worden gebruikt, maar nieuwe plaatsen is verboden.
+`/lp group vip permission set essentials.back true`
-## Evacuatie
+`/lp group vip parent set speler`
-Na afloop van de huurperiode start een evacuatieperiode van maximaal 72 uur.
+`/lp group vipplus parent set vip`
-```text
+Server-specifiek:
-/huur evacuatie shop001
-/huur ontruimen shop001
-```
-Tijdens evacuatie kan de huurder spullen ophalen en eventueel verlengen. Nieuwe ChestShops mogen niet worden geplaatst.
+`/lp group example permission set example.permission true server=survival`
-Na afloop worden toegang, ChestShops en achtergebleven inhoud opgeruimd, waarna de schematic wordt geplaatst en de rental weer `AVAILABLE` wordt.
+---
-## Rental verwijderen
+# 🔍 Controleren van rechten
-```text
+Een permission kan worden gecontroleerd met:
-/huur verwijderen shop001
-```
-Verwijderen vereist bevestiging. De databasekoppelingen worden verwijderd, maar de fysieke WorldGuard-regio blijft bestaan.
+`/lp group <groep> permission check <permission>`
-## WorldGuard-richtlijnen
+of voor een speler:
-TulpenCraftRentals maakt geen fysieke WorldGuard-regio's aan. Regio's worden handmatig aangemaakt.
+`/lp user <speler> permission check <permission>`
-Rental-regio's mogen niet onderling overlappen. Een algemene bovenliggende gebiedsregio is toegestaan.
+Voor complexe situaties kan LuckPerms Verbose worden gebruikt:
-Bij problemen:
+`/lp verbose on`
-```text
+Na het testen:
-/rg info <regio>
-/rg flags <regio>
-```
-Controleer members, buildflags, parent-regio's, prioriteiten, gamemode en andere plugins.
+`/lp verbose off`
-## Probleemoplossing
+---
-### Speler kan niet bouwen
+# 📋 Huidige rankstructuur
-Controleer:
+^ Weight ^ Groep ^ Zichtbare rang ^
+| 100 | `owner` | Owner |
+| 80 | `admin` | Admin |
+| 70 | `dev` | Dev |
+| 50 | `moderator` | Moderator |
+| 40 | `builder` | Bouwer |
+| 30 | `helper` | Helper |
+| 20 | `vipplus` | VIP+ |
+| 10 | `vip` | VIP |
+| 1 | `speler` | Speler |
+| — | `default` | Geen zichtbare rank |
-. Juiste regio.
+---
-. Speler is member.
-. Geen overlap met andere rental.
-. Geen beperkende parent-flags.
-. Speler staat in Survival.
-. Geen andere plugin blokkeert bouwen.
-### ChestShop kan niet worden geplaatst
+# ⚠️ Belangrijke uitgangspunten
-Controleer:
+* Algemene rankpermissions zijn standaard **global**.
+* Gebruik servercontext alleen wanneer dit daadwerkelijk nodig is.
+* Vermijd onnodige duplicatie van permissions per server.
+* Kritieke proxyrechten worden zo beperkt mogelijk toegekend.
+* Betaalde rangen krijgen vooral QoL-functionaliteit en geen onbeperkte beheerrechten.
+* Staffrechten worden gescheiden van spelersrechten.
+* De rangnaam die spelers zien hoeft niet gelijk te zijn aan de technische LuckPerms-groepsnaam.
+* Wijzigingen aan de rankstructuur moeten ook in deze documentatie worden bijgewerkt.
-- actieve SHOP-rental;
+---
-- huurder of medewerker;
-- juiste regio;
-- maximum niet bereikt;
-- geen evacuatie- of resetstatus.
-### Bord toont verkeerde gegevens
+# 📚 Gerelateerde pagina's
-Controleer:
+* [[plugins:luckperms|LuckPerms]]
+* [[plugins:modernessentials|Modern Essentials]]
+* [[plugins:controlbans|ControlBans]]
+* [[serverinfrastructuur:lobby|Lobby]]
+* [[serverinfrastructuur:survival|Survival]]
+* [[serverinfrastructuur:proxy|Velocity Proxy]]
-- juiste rentalkoppeling;
+---
-- huurder;
-- `expires_at`;
-- `evacuation_until`;
-- rentalstatus;
-- serverconsole.
-### Rental blijft op RESETTING
+> **Laatste update:** augustus 2026
+>
+> Deze pagina beschrijft de centrale rang- en permissionstructuur van Tulpencraft. Wijzigingen in groepen, inheritance, prefixes, servercontexts of kritieke permissions moeten ook hier worden bijgewerkt.
-Controleer schematic, wereld, resetcoördinaten, WorldEdit-toegang en consolefouten.