Status: Concept / ontwikkeling Doelgroep: TulpenCraft Staff Plugin: 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.

Een rental heeft een vaste WorldGuard-region.

Bijvoorbeeld:

Rental:
    Shop #12
 
WorldGuard:
    tc_shop_012
 
Type:
    SHOP
 
Prijs:
    €750
 
Duur:
    30 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.

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

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

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:

Shop #12
ChestShops: 4 / 10

Wanneer een ChestShop wordt verwijderd, komt die plek weer vrij:

4 / 10
↓
3 / 10

De plugin houdt de ChestShops per rental bij.

Hotelkamers werken hetzelfde als woningen, maar zijn bedoeld voor kortdurend verblijf.

Een hotelkamer kan bijvoorbeeld:

Kamer 101
€75 / 7 dagen
Maximaal 2 bewoners

Een suite kan bijvoorbeeld:

Suite 301
€250 / 7 dagen
VIP vereist
Maximaal 4 bewoners

Hotelkamers kunnen dus hun eigen prijs, huurperiode, rank-eis en bewonerslimiet hebben.

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:

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.

🏪 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.

Een speler kan meerdere rentals huren.

Er kan een limiet worden ingesteld.

Bijvoorbeeld:

Normale speler:
2 winkels
 
VIP:
3 winkels
 
Premium:
5 winkels

Deze limieten worden via permissions/configuratie beheerd.

Hetzelfde principe kan eventueel voor woningen worden gebruikt.

De eigenaar van een rental kan andere spelers toevoegen.

Dit zijn bijvoorbeeld:

• huisgenoten
• familie
• vrienden

Deze spelers krijgen toegang tot de WorldGuard-region en mogen daar bouwen.

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.

Iedere rental heeft een vaste huurperiode.

Bijvoorbeeld:

€750
30 dagen

De einddatum wordt bij het huren automatisch berekend.

De speler krijgt vooraf waarschuwingen.

Voorgestelde waarschuwingen:

7 dagen voor einde
3 dagen voor einde
1 dag voor einde

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.

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.

De plugin waarschuwt de huurder duidelijk.

Voorbeeld:

⚠️ 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:

🔴 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.

Een speler mag een huur voortijdig beëindigen.

Er wordt geen geld terugbetaald.

Voorbeeld:

Huur:
€750 / 30 dagen
 
Speler beëindigt na:
10 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.

Na afloop van de ontruimingstermijn wordt de locatie gereset.

De reset brengt de locatie terug naar de oorspronkelijke staat.

Bijvoorbeeld:

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.

Wanneer een reset mislukt:

RESETTING
    ↓
❌ fout
    ↓
STAFF MELDING

De rental wordt niet automatisch beschikbaar gemaakt.

Staff moet de situatie controleren.

Iedere rental is gekoppeld aan één WorldGuard-region.

Bijvoorbeeld:

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.

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:

👁 Preview
🏪 Huren
↩ Terug

De preview geeft geen huurrecht.

De speler moet de locatie daadwerkelijk huren om toegang te krijgen als eigenaar.

Staff kan rentals aanmaken, aanpassen, uitschakelen en resetten.

Een rental begint met een bestaande WorldGuard-region.

Voorbeeld:

/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.

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.

TulpenCraft Rentals houdt belangrijke gebeurtenissen bij.

Bijvoorbeeld:

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.

Belangrijke gebeurtenissen kunnen naar Discord worden gestuurd.

Bijvoorbeeld:

🏪 Nieuwe rental
 
Shop #12
Huurder: Speler
Prijs: €750
Duur: 30 dagen
Einddatum: 09-10-2026

🔴 Rental verlopen
 
Shop #12
Huurder: Speler
Ontruimingstermijn: 3 dagen

🚨 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.

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.

Het systeem werkt volgens:

Beschikbaar
    ↓
Huren
    ↓
Betaling
    ↓
WorldGuard-toegang
    ↓
Gebruiken
    ↓
Waarschuwingen
    ↓
Huur verloopt
    ↓
3 dagen ontruiming
    ↓
Reset
    ↓
Beschikbaar

Huren → wonen → huisgenoten → ontruimen → reset

Huren → verkopen → medewerkers → ChestShops → ontruimen → reset

Huren → tijdelijk verblijf → bewoners → ontruimen → reset

1. WorldGuard beschermt de locatie.
2. TulpenCraft Rentals beheert het huurcontract.
3. LuckPerms bepaalt rank-/permission-toegang.
4. ChestShop wordt voor winkels geïntegreerd.
5. Iedere shop heeft een eigen ChestShop-limiet.
6. Medewerkers kunnen winkelbeheer uitvoeren.
7. Een verlopen huur krijgt maximaal 3 dagen ontruimingstijd.
8. Achtergebleven spullen worden daarna vernietigd.
9. Voortijdig beëindigen mag, maar zonder restitutie.
10. Een mislukte reset maakt een rental nooit automatisch beschikbaar.
11. Belangrijke acties worden gelogd.
12. Belangrijke gebeurtenissen kunnen via Discord worden gemeld.

Dit document beschrijft de huidige functionele afspraken voor TulpenCraft Rentals.

Technische implementatiedetails, databaseontwerp, API's, configuratie en ontwikkelaarsinformatie worden afzonderlijk gedocumenteerd.