Verschillen

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

--- plugins:tulpencraftrentalstaff [2026/09/09 18:24] – [20. Belangrijkste uitgangspunten] rroethof
+++ plugins:tulpencraftrentalstaff [2026/09/09 18:28] (huidige) – rroethof
@@ Regel 1: / Regel 1: @@
-# TulpenCraft Rentals
-**Status:** Concept / ontwikkeling
-**Doelgroep:** TulpenCraft Staff
-**Plugin:** `TulpenCraft Rentals`
-## 1. Wat is TulpenCraft Rentals?
-TulpenCraft Rentals is het verhuursysteem van TulpenCraft voor verschillende soorten ruimtes en locaties.
-Met het systeem kunnen spelers tijdelijk een vooraf ingerichte **WorldGuard-region** huren.
-Denk hierbij aan:
-* 🏠 Woningen
-* 🏪 Winkels
-* 🛏️ Hotelkamers
-* In de toekomst eventueel andere typen locaties
-De huur wordt centraal geregistreerd en beheerd door de plugin.
-**Belangrijk uitgangspunt:**
-> Een rental is een tijdelijk gebruiksrecht op een vooraf bepaalde WorldGuard-region.
-WorldGuard blijft verantwoordelijk voor de daadwerkelijke gebiedsbeveiliging. TulpenCraft Rentals regelt de huur, betaling, toegang, looptijd, bewoners/medewerkers, ChestShops en het verlopen van de huur.
----
-# 2. Hoe werkt een rental?
-Een rental heeft een vaste WorldGuard-region.
-Bijvoorbeeld:
-```text
-Rental:
-    Shop #12
-WorldGuard:
-    tc_shop_012
-Type:
-    SHOP
-Prijs:
-    €750
-Duur:
-dagen
-ChestShops:
-    maximaal 10
-Medewerkers:
-    maximaal 3
-Rank:
-    VIP vereist
-```
-Een speler huurt vervolgens deze locatie via het rentalsysteem.
-Na een succesvolle betaling wordt de speler gekoppeld aan de WorldGuard-region.
----
-# 3. Soorten rentals
-## 🏠 Woningen
-Een woning is een tijdelijk gehuurd huis.
-Mogelijkheden:
-* Eigenaar/huurder
-* Huisgenoten
-* WorldGuard-toegang
-* Bouwen en aanpassen
-* Eigen inrichting
-* Preview vóór het huren
-* Optionele rank-eis
-* Instelbare huurprijs
-* Instelbare huurduur
-* Automatische reset na definitief einde huur
-## 🏪 Winkels
-Een winkel is een gehuurde commerciële locatie.
-Mogelijkheden:
-* Huurder/eigenaar
-* Medewerkers
-* WorldGuard-toegang
-* ChestShop
-* Maximum aantal ChestShops per winkel
-* Preview
-* Optionele rank-eis
-* Instelbare huurprijs en huurduur
-* Automatische reset
-### ChestShop-regels
-ChestShops zijn gekoppeld aan de specifieke rental.
-Een ChestShop mag alleen worden geplaatst:
-* binnen de gekoppelde shop-region;
-* door de huurder of een geautoriseerde medewerker;
-* wanneer de huur actief is;
-* zolang het maximum aantal ChestShops niet is bereikt.
-Voorbeeld:
-```text
-Shop #12
-ChestShops: 4 / 10
-```
-Wanneer een ChestShop wordt verwijderd, komt die plek weer vrij:
-```text
-/ 10
-↓
-/ 10
-```
-De plugin houdt de ChestShops per rental bij.
-## 🛏️ Hotelkamers
-Hotelkamers werken hetzelfde als woningen, maar zijn bedoeld voor kortdurend verblijf.
-Een hotelkamer kan bijvoorbeeld:
-```text
-Kamer 101
-€75 / 7 dagen
-Maximaal 2 bewoners
-```
-Een suite kan bijvoorbeeld:
-```text
-Suite 301
-€250 / 7 dagen
-VIP vereist
-Maximaal 4 bewoners
-```
-Hotelkamers kunnen dus hun eigen prijs, huurperiode, rank-eis en bewonerslimiet hebben.
----
-# 4. Rank en LuckPerms
-TulpenCraft Rentals gebruikt **LuckPerms-permissions** om te bepalen welke rentals een speler mag huren.
-Er wordt bewust niet rechtstreeks gekeken naar de naam van een rank.
-Voorbeeld:
-```text
-tulpencraft.rent.vip
-```
-Een rental kan deze permission vereisen.
-Heeft een speler deze permission niet, dan kan de speler de rental wel bekijken, maar niet huren.
-### Voorbeeld
-```text
-🏪 Shop #12
-€750 / 30 dagen
-🔒 VIP vereist
-```
-LuckPerms inheritance zorgt ervoor dat hogere ranks automatisch toegang kunnen krijgen wanneer zij de betreffende permission erven.
-Dit maakt het systeem flexibel en voorkomt dat de plugin afhankelijk wordt van specifieke ranknamen.
----
-# 5. Meerdere rentals per speler
-Een speler kan meerdere rentals huren.
-Er kan een limiet worden ingesteld.
-Bijvoorbeeld:
-```text
-Normale speler:
-winkels
-VIP:
-winkels
-Premium:
-winkels
-```
-Deze limieten worden via permissions/configuratie beheerd.
-Hetzelfde principe kan eventueel voor woningen worden gebruikt.
----
-# 6. Medewerkers en huisgenoten
-De eigenaar van een rental kan andere spelers toevoegen.
-### Bij een woning
-Dit zijn bijvoorbeeld:
-* huisgenoten
-* familie
-* vrienden
-Deze spelers krijgen toegang tot de WorldGuard-region en mogen daar bouwen.
-### Bij een winkel
-Dit zijn medewerkers.
-Medewerkers mogen binnen de winkel:
-* de shop betreden;
-* bouwen;
-* ChestShops plaatsen;
-* ChestShops verwijderen;
-* ChestShops beheren.
-De eigenaar blijft verantwoordelijk voor de rental.
----
-# 7. Huurperiode
-Iedere rental heeft een vaste huurperiode.
-Bijvoorbeeld:
-```text
-€750
-dagen
-```
-De einddatum wordt bij het huren automatisch berekend.
-De speler krijgt vooraf waarschuwingen.
-Voorgestelde waarschuwingen:
-```text
-dagen voor einde
-dagen voor einde
-dag voor einde
-```
----
-# 8. Einde van de huur
-Wanneer de huurperiode eindigt, wordt de rental **verlopen**.
-De speler krijgt vervolgens maximaal **3 dagen om de locatie leeg te halen**.
-Dit is geen verlenging van de huurperiode, maar een ontruimingstermijn.
-Tijdens deze periode kan de huurder:
-* spullen ophalen;
-* de locatie leeghalen;
-* de huur alsnog verlengen.
-Nieuwe ChestShops plaatsen is niet toegestaan.
-### Belangrijk
-De huurder is zelf verantwoordelijk voor het verwijderen van spullen.
-TulpenCraft is **niet verantwoordelijk voor achtergebleven items**.
-Na afloop van de drie dagen worden achtergebleven spullen verwijderd tijdens de reset.
----
-# 9. Waarschuwingen bij einde huur
-De plugin waarschuwt de huurder duidelijk.
-Voorbeeld:
-```text
-⚠️ Je huur van Shop #12 verloopt over 3 dagen.
-Zorg dat je winkel tijdig wordt leeggemaakt.
-Achtergebleven spullen worden na de ontruimingsperiode vernietigd.
-```
-Bij het daadwerkelijk verlopen:
-```text
-🔴 Je huur van Shop #12 is verlopen.
-Je hebt maximaal 3 dagen om je spullen op te halen
-of de huur te verlengen.
-Na deze periode wordt de locatie gereset.
-```
-Dit beleid moet ook duidelijk worden opgenomen in de huurvoorwaarden.
----
-# 10. Huur voortijdig beëindigen
-Een speler mag een huur voortijdig beëindigen.
-Er wordt **geen geld terugbetaald**.
-Voorbeeld:
-```text
-Huur:
-€750 / 30 dagen
-Speler beëindigt na:
-dagen
-Restitutie:
-€0
-```
-Dit moet vóór bevestiging duidelijk aan de speler worden getoond.
-De speler krijgt na voortijdige beëindiging eveneens de maximaal drie dagen ontruimingstijd.
----
-# 11. Reset van een rental
-Na afloop van de ontruimingstermijn wordt de locatie gereset.
-De reset brengt de locatie terug naar de oorspronkelijke staat.
-Bijvoorbeeld:
-```text
-Shop #12
-    ↓
-ChestShops verwijderen
-    ↓
-Toegang huurder verwijderen
-    ↓
-Toegang medewerkers verwijderen
-    ↓
-Achtergebleven voorraad verwijderen
-    ↓
-WorldEdit schematic terugplaatsen
-    ↓
-Controle
-    ↓
-Beschikbaar
-```
-Een rental mag pas opnieuw verhuurbaar worden wanneer de reset succesvol is afgerond.
-### Reset mislukt
-Wanneer een reset mislukt:
-```text
-RESETTING
-    ↓
-❌ fout
-    ↓
-STAFF MELDING
-```
-De rental wordt **niet** automatisch beschikbaar gemaakt.
-Staff moet de situatie controleren.
----
-# 12. WorldGuard
-Iedere rental is gekoppeld aan één WorldGuard-region.
-Bijvoorbeeld:
-```text
-Rental:
-Shop #12
-WorldGuard:
-tc_shop_012
-```
-De plugin gebruikt WorldGuard voor toegang en bescherming.
-Staff maakt eerst de region aan met WorldGuard.
-Daarna wordt deze region geregistreerd als rental.
-Een WorldGuard-region mag niet tegelijkertijd aan meerdere rentals gekoppeld zijn.
----
-# 13. Preview
-Spelers kunnen een rental bekijken voordat ze deze huren.
-Dit voorkomt dat iemand een locatie huurt zonder te weten hoe deze eruitziet.
-De speler kan bijvoorbeeld:
-```text
-👁 Preview
-🏪 Huren
-↩ Terug
-```
-De preview geeft geen huurrecht.
-De speler moet de locatie daadwerkelijk huren om toegang te krijgen als eigenaar.
----
-# 14. Staffbeheer
-Staff kan rentals aanmaken, aanpassen, uitschakelen en resetten.
-Een rental begint met een bestaande WorldGuard-region.
-Voorbeeld:
-```text
-/rg define tc_shop_012
-```
-Daarna wordt de region geregistreerd in Rentals.
-De exacte commands worden in de technische documentatie opgenomen.
-Belangrijke staffacties zijn onder andere:
-* rental aanmaken;
-* rental aanpassen;
-* prijs wijzigen;
-* huurduur wijzigen;
-* rank-eis instellen;
-* maximaal aantal ChestShops instellen;
-* maximaal aantal medewerkers instellen;
-* rental uitschakelen;
-* huur handmatig beëindigen;
-* rental resetten;
-* rental vrijgeven.
----
-# 15. Staff moet voorzichtig zijn met handmatige acties
-Een rental kan actief verhuurd zijn.
-Voordat staff een rental handmatig reset of vrijgeeft, moet gecontroleerd worden of dit gewenst is.
-Een handmatige reset kan namelijk:
-* bouwwerken van een speler verwijderen;
-* ChestShops verwijderen;
-* voorraad verwijderen;
-* WorldGuard-toegang wijzigen.
-Gebruik handmatige reset daarom alleen wanneer daar een geldige reden voor is.
-Alle belangrijke acties worden geregistreerd in de auditlog.
----
-# 16. Auditlog
-TulpenCraft Rentals houdt belangrijke gebeurtenissen bij.
-Bijvoorbeeld:
-```text
-Rental #12 aangemaakt
-Rental #12 verhuurd aan Speler
-Rental #12 verlengd
-Medewerker toegevoegd
-ChestShop geplaatst
-ChestShop verwijderd
-Rental verlopen
-Rental gereset
-Rental reset mislukt
-```
-Hiermee kan staff achteraf controleren wat er met een rental is gebeurd.
----
-# 17. Discord-meldingen
-Belangrijke gebeurtenissen kunnen naar Discord worden gestuurd.
-Bijvoorbeeld:
-### Nieuwe huur
-```text
-🏪 Nieuwe rental
-Shop #12
-Huurder: Speler
-Prijs: €750
-Duur: 30 dagen
-Einddatum: 09-10-2026
-```
-### Verlopen
-```text
-🔴 Rental verlopen
-Shop #12
-Huurder: Speler
-Ontruimingstermijn: 3 dagen
-```
-### Reset mislukt
-```text
-🚨 Rental reset mislukt
-Shop #12
-De rental is geblokkeerd en is niet opnieuw verhuurbaar.
-Staff controle vereist.
-```
-Discord moet vooral worden gebruikt voor belangrijke gebeurtenissen en fouten. Het systeem moet geen spamkanaal worden.
----
-# 18. Verantwoordelijkheid van de huurder
-De huurder is verantwoordelijk voor:
-* betaling van de huur;
-* het tijdig verlengen van de huur;
-* het tijdig leeghalen van de rental;
-* eigen voorraad;
-* eigen bouwwerken;
-* medewerkers/huisgenoten;
-* gebruik van de locatie volgens de TulpenCraft-regels.
-Bij het einde van de huur bestaat geen recht op vergoeding voor achtergebleven items.
----
-# 19. Voor staff: kort samengevat
-Het systeem werkt volgens:
-```text
-Beschikbaar
-    ↓
-Huren
-    ↓
-Betaling
-    ↓
-WorldGuard-toegang
-    ↓
-Gebruiken
-    ↓
-Waarschuwingen
-    ↓
-Huur verloopt
-    ↓
-dagen ontruiming
-    ↓
-Reset
-    ↓
-Beschikbaar
-```
-### 🏠 Huis
-**Huren → wonen → huisgenoten → ontruimen → reset**
-### 🏪 Shop
-**Huren → verkopen → medewerkers → ChestShops → ontruimen → reset**
-### 🛏️ Hotelkamer
-**Huren → tijdelijk verblijf → bewoners → ontruimen → reset**
----
-# 20. Belangrijkste uitgangspunten
-. **WorldGuard beschermt de locatie.**
-. **TulpenCraft Rentals beheert het huurcontract.**
-. **LuckPerms bepaalt rank-/permission-toegang.**
-. **ChestShop wordt voor winkels geïntegreerd.**
-. **Iedere shop heeft een eigen ChestShop-limiet.**
-. **Medewerkers kunnen winkelbeheer uitvoeren.**
-. **Een verlopen huur krijgt maximaal 3 dagen ontruimingstijd.**
-. **Achtergebleven spullen worden daarna vernietigd.**
-. **Voortijdig beëindigen mag, maar zonder restitutie.**
-. **Een mislukte reset maakt een rental nooit automatisch beschikbaar.**
-. **Belangrijke acties worden gelogd.**
-. **Belangrijke gebeurtenissen kunnen via Discord worden gemeld.**
 # Staff commands
@@ Regel 1216: / Regel 593: @@
 Alle belangrijke staffacties worden door TulpenCraft Rentals geregistreerd.
-## Status
-Dit document beschrijft de huidige functionele afspraken voor **TulpenCraft Rentals**.
-Technische implementatiedetails, databaseontwerp, API's, configuratie en ontwikkelaarsinformatie worden afzonderlijk gedocumenteerd.