TulpenCraft Rentals

TulpenCraft Rentals is een eigen TulpenCraft-plugin voor het beheren van verhuurbare ruimtes binnen Minecraft.

De plugin maakt het mogelijk om verschillende soorten ruimtes aan spelers te verhuren, waaronder:

• 🏠 Woningen
• 🏪 Winkels
• 🛏️ Kamers
• 🏢 Kantoren
• 🧱 Bouwkavels
• 🔧 Werkplaatsen
• Andere verhuurbare ruimtes in de toekomst

De plugin koppelt een verhuurbaar object aan een bestaande WorldGuard-region.

WorldGuard blijft verantwoordelijk voor de daadwerkelijke bescherming van het gebied. TulpenCraft Rentals beheert daarbovenop het huurcontract, de huurder, huurperiode, betaling, toegangsrechten, eventuele medewerkers en het automatisch verlopen van de huur.

Een speler ziet een woning:

🏠 Huis #001

Huurprijs:
€250 / 30 dagen

Status:
🟢 Beschikbaar

[ HUREN ] 

Na het huren:

🏠 Huis #001

Huurder:
Speler

Verloopt:
09-10-2026

Status:
🔴 Verhuurd 

Bij het verlopen van de huur kan de woning automatisch worden vrijgegeven en, indien ingesteld, worden teruggezet naar de oorspronkelijke staat.

De eerste versie ondersteunt:

Nieuwe types kunnen later worden toegevoegd zonder het complete systeem opnieuw te ontwerpen.

Een woning kan tijdelijk aan een speler worden verhuurd.

Voorbeeld:

Huis #001
€250 / 30 dagen
🟢 Beschikbaar

Na verhuur wordt de speler eigenaar van de gekoppelde WorldGuard-region.

De huurder kan binnen de region bouwen, breken en de woning gebruiken volgens de ingestelde WorldGuard-flags.

Bij het verlopen van de huur:

• De huurder verliest toegang.
• De WorldGuard-owner wordt verwijderd.
• Eventuele medewerkers worden verwijderd.
• De woning kan automatisch worden gereset.
• De woning wordt opnieuw beschikbaar.

Een winkel werkt vergelijkbaar met een woning, maar ondersteunt daarnaast medewerkers.

Voorbeeld:

🏪 TulpenShop

Huur:
€500 / 30 dagen

Eigenaar:
Speler

Medewerkers:
2 

De eigenaar kan medewerkers toevoegen en verwijderen.

/tc shop employee add winkel-001 Speler
/tc shop employee remove winkel-001 Speler

Medewerkers krijgen toegang tot de WorldGuard-region, maar zijn niet de huurder/eigenaar van het huurcontract.

Kamers kunnen bijvoorbeeld worden gebruikt voor een hotel.

Een kamer kan dezelfde verhuurfunctionaliteit gebruiken als een woning.

Daarnaast kan per kamer een LuckPerms-permission worden ingesteld.

Voorbeeld:

Kamer 201
€250 / 7 dagen

⭐ VIP+ vereist 

Een speler zonder de benodigde permission kan de kamer niet huren.

Per verhuurobject kan een optionele LuckPerms-permission worden ingesteld.

Voorbeeld:

tulpencraft.rent.vip

Heeft een rental geen permission requirement, dan kan iedere speler de rental huren.

Voorbeeld:

tulpencraft.rent.vip

tulpencraft.rent.vip

tulpencraft.rent.premium

tulpencraft.rent.staff

De plugin controleert de permission server-side voordat een huurcontract kan worden afgesloten.

De daadwerkelijke rangnaam wordt niet in TulpenCraft Rentals opgeslagen.

De plugin gebruikt permissions, waardoor de rankstructuur volledig door LuckPerms wordt beheerd.

Jar-bestand:

TulpenCraftRentals.jar

Locatie:

/srv/minecraft/survival/plugins/TulpenCraftRentals.jar

De plugin vereist toegang tot de volgende systemen:

• Paper API
• WorldGuard
• WorldEdit
• Vault
• MariaDB
• LuckPerms
• Discord webhook (optioneel)

Configuratiebestand:

/srv/minecraft/survival/plugins/TulpenCraftRentals/config.yml

plugin:
  name: "TulpenCraft Rentals"

database:
type: mariadb
host: "127.0.0.1"
port: 3306
database: "tulpencraft_rentals"
username: "tulpencraft"
password: "${TULPENCRAFT_RENTALS_DB_PASSWORD}"

economy:
enabled: true
provider: vault

rentals:
default-duration-days: 30
minimum-duration-days: 1
maximum-duration-days: 365

limits:
houses-per-player: 1
shops-per-player: 1

expiration:
check-interval-seconds: 60

reset:
enabled: true
delay-seconds: 5

notifications:
expiry-warning-days:
- 7
- 3
- 1

gui:
enabled: true

signs:
enabled: true

discord:
enabled: true

webhooks:
rentals:
url: "${TC_DISCORD_RENTALS_WEBHOOK}"
 
```
transactions:
  url: "${TC_DISCORD_TRANSACTIONS_WEBHOOK}"

alerts:
  url: "${TC_DISCORD_ALERTS_WEBHOOK}"
```

Deze permissions worden gebruikt om bepaalde rentals uitsluitend voor bepaalde spelers beschikbaar te maken.

tulpencraft.rent.vip

tulpencraft.rent.premium

tulpencraft.rent.staff

tulpencraft.rent.special

De exacte koppeling tussen ranks en permissions wordt door LuckPerms geregeld.

De plugin koppelt geen functionaliteit rechtstreeks aan de naam van een rank. LuckPerms permissions bepalen de toegang.

TulpenCraft Rentals gebruikt MariaDB als centrale database.

Database:

tulpencraft_rentals

Belangrijkste tabellen:

rentals

rental_members

rental_transactions

rental_notifications

De database bevat UUID's in plaats van spelersnamen waar mogelijk.

Dit voorkomt problemen wanneer een speler zijn Minecraft-naam verandert.

Wanneer een speler een rental huurt:

Speler
  ↓
Rental selecteren
  ↓
Status controleren
  ↓
LuckPerms permission controleren
  ↓
Aantal actieve rentals controleren
  ↓
Prijs controleren
  ↓
Vault / Economy
  ↓
Betaling
  ↓
WorldGuard ownership
  ↓
MariaDB
  ↓
Huur actief

De plugin moet bij fouten voorkomen dat een speler betaalt zonder daadwerkelijk toegang tot de rental te krijgen.

De plugin controleert periodiek op verlopen huurcontracten.

Voorbeeld:

Huur gestart:
09-09-2026

Duur:
30 dagen

Verloopt:
09-10-2026 

Voor het verlopen kunnen waarschuwingen worden verstuurd:

• 7 dagen vooraf
• 3 dagen vooraf
• 1 dag vooraf

Bij het verlopen:

1. Huurcontract wordt EXPIRED.
2. WorldGuard-toegang wordt verwijderd.
3. Winkelmedewerkers worden verwijderd.
4. Indien geconfigureerd wordt de region gereset.
5. Rental wordt opnieuw AVAILABLE.
6. Discord-notificatie wordt verstuurd.

Woningen en winkels kunnen optioneel automatisch worden hersteld met een WorldEdit-schematic.

Voorbeeld:

schematics/
├── houses/
│   ├── huis-001.schem
│   └── huis-002.schem
│
└── shops/
    ├── shop-001.schem
    └── shop-002.schem

Een rental kan bijvoorbeeld bevatten:

reset:
  enabled: true
  schematic: "houses/huis-001.schem"

Bij een reset wordt de rental tijdelijk op:

RESETTING

gezet.

Wanneer de reset mislukt blijft de rental in deze status staan en wordt deze niet automatisch opnieuw verhuurbaar gemaakt.

Dit voorkomt dat spelers een half geresette of beschadigde ruimte huren.

TulpenCraft Rentals ondersteunt Discord-webhooks.

Discord wordt gebruikt voor beheer-, transactie- en foutmeldingen.

Voorbeeld:

🏠 RENTAL VERHUURD

Object: Huis #001
Type: Woning
Huurder: Speler
Prijs: €250
Duur: 30 dagen
Verloopt: 09-10-2026

Rental ID: huis-001 

⚠️ HUUR VERLOOPT BINNENKORT

Object: Huis #001
Huurder: Speler
Verloopt over: 3 dagen

Huur: €250 / 30 dagen 

🔴 RENTAL VERLOPEN

Object: Huis #001
Huurder: Speler

Status: EXPIRED
Reset: gestart 

✅ RENTAL RESET VOLTOOID

Object: Huis #001
Schematic: houses/huis-001.schem
Status: AVAILABLE 

🚨 RENTAL RESET MISLUKT

Object: Huis #001
Schematic: houses/huis-001.schem

Status: RESETTING

⚠️ Rental is NIET opnieuw beschikbaar gemaakt. 

Discord-notificaties worden via webhooks verstuurd. Webhook-URL's worden niet in Git opgeslagen en kunnen via environment variables worden aangeleverd.

TulpenCraft Rentals gebruikt WorldGuard voor de fysieke bescherming van rentals.

Een administrator maakt eerst een region:

/rg define tc_huis_001

Daarna wordt deze gekoppeld:

/tc rental create tc_huis_001 house

De plugin controleert of de region bestaat en voorkomt dat dezelfde WorldGuard-region meerdere keren aan rentals wordt gekoppeld.

WorldGuard blijft verantwoordelijk voor:

• Bouwrechten
• Breekrechten
• Toegang
• Region flags
• Owners
• Members

TulpenCraft Rentals beheert de eigenaar en medewerkers gedurende de huurperiode.

Betalingen verlopen via Vault.

De plugin heeft geen eigen economy.

Hierdoor blijft TulpenCraft Rentals onafhankelijk van de gebruikte economy-plugin.

Voorbeeld:

Saldo speler:
€1.200

Huur:
€250

Nieuw saldo:
€950 

Alle transacties worden geregistreerd in MariaDB.

• Paper
• WorldGuard
• WorldEdit
• Vault
• MariaDB
• LuckPerms
• Discord Webhook (optioneel)

Proxy-plugin: Nee

TulpenCraft Rentals draait op de backend-server waarop de WorldGuard-regions en verhuurbare gebieden aanwezig zijn.

Velocity hoeft geen TulpenCraft Rentals-plugin te draaien.

Wanneer TulpenCraft later meerdere backend-servers met rentals gebruikt, kan dezelfde MariaDB-database worden gebruikt met een unieke server-identificatie per rental.

TulpenCraft Rentals heeft toegang tot:

• WorldGuard regions
• WorldEdit
• Economy
• LuckPerms permissions
• MariaDB
• Discord webhook

Belangrijke beveiligingsmaatregelen:

• Databasewachtwoord niet in Git.
• Discord webhook URL niet in Git.
• Gebruik van UUID's in plaats van namen.
• Geldbedragen worden als exacte decimalen verwerkt.
• Databasewerk gebeurt niet op de Minecraft main thread.
• Spelers kunnen permissiechecks niet omzeilen via commands.
• Verlopen rentals worden niet opnieuw beschikbaar gemaakt voordat eventuele reset succesvol is afgerond.
• Fouten tijdens betalingen of WorldGuard-wijzigingen moeten veilig worden afgehandeld.
• Adminfuncties worden via permissions beschermd.

Normale lifecycle:

AVAILABLE
    ↓
RENTED
    ↓
EXPIRED
    ↓
RESETTING
    ↓
AVAILABLE

Naast commands krijgt de plugin een GUI.

🌷 TULPENCRAFT VERHUUR

🏠 Woningen

🏪 Winkels

🛏️ Kamers

📋 Mijn huur 

🏠 Huis #001
€250 / 30 dagen
🟢 Beschikbaar

🏠 Huis #002
€350 / 30 dagen
⭐ VIP

🏠 Huis #003
€500 / 30 dagen
🔴 Verhuurd 

Wanneer een speler niet over de vereiste LuckPerms-permission beschikt:

🏨 Kamer 201

€250 / 7 dagen

⭐ VIP vereist

🔒 Je hebt geen toegang. 

De daadwerkelijke huuractie blijft ook server-side geblokkeerd.

Rentals kunnen optioneel via fysieke borden worden weergegeven.

Voorbeeld:

┌─────────────────┐
│  🏠 HUIS #001   │
│                 │
│  €250 / 30d     │
│                 │
│ 🟢 BESCHIKBAAR  │
└─────────────────┘

Klikken op het bord opent de rentalinformatie of huur-GUI.

Hetzelfde systeem kan worden gebruikt voor winkels en hotelkamers.

De architectuur houdt rekening met toekomstige functionaliteit.

Mogelijke uitbreidingen:

• Webinterface
• TulpenCraft website-integratie
• REST API
• Rental-statistieken
• Borgsom
• Kortingen
• VIP-kortingen
• Verschillende huurperiodes
• Automatische prijsmodellen
• Meerdere medewerkers
• Hotelmodus
• Veilingen
• Permanente aankoop van objecten
• Meerdere Minecraft-servers
• Admin dashboard
• Discord-adminacties

De website kan later bijvoorbeeld beschikbare woningen en winkels rechtstreeks uit MariaDB/API-data tonen.

• MariaDB moet beschikbaar zijn voordat de plugin kan functioneren.
• WorldGuard-regions moeten correct worden aangemaakt.
• WorldEdit-schematics moeten zorgvuldig worden getest voordat automatische resets worden ingeschakeld.
• Discord-webhooks mogen niet publiek worden gedeeld.
• LuckPerms permissions moeten correct worden gekoppeld aan de gewenste ranks.
• Huurcontracten moeten altijd UUID-gebaseerd zijn.
• Een reset die mislukt mag nooit automatisch leiden tot status AVAILABLE.
• Economy-transacties moeten veilig worden afgehandeld.
• Databasebewerkingen mogen de Minecraft main thread niet blokkeren.
• De plugin moet duidelijk loggen wanneer een huurcontract wordt aangemaakt, verlengd, beëindigd of gereset.

Rental kan niet worden gehuurd.

/tc rental info huis-001

Controleer vervolgens:

• Status
• Prijs
• Huurperiode
• LuckPerms permission
• Economy
• WorldGuard-region

Controleer of de rental AVAILABLE is en of de speler over de vereiste permission beschikt.

Speler krijgt geen toegang tot de woning.

/rg info tc_huis_001

Controleer de WorldGuard owner/member-configuratie.

Controleer of TulpenCraft Rentals de huurder correct als WorldGuard-owner heeft geregistreerd.

Rental blijft op RESETTING staan.

/tc rental info huis-001

Controleer daarnaast de serverconsole.

Controleer of de gekoppelde schematic bestaat en geldig is.

De rental wordt bewust niet automatisch beschikbaar gemaakt totdat het resetprobleem is opgelost.

Discord-notificaties komen niet aan.

Controleer de Discord webhook-configuratie en serverconsole.

grep -i "discord" /srv/minecraft/survival/logs/latest.log

Controleer:

• Webhook URL
• Environment variable
• Discord-kanaal
• Internetverbinding
• Pluginconfiguratie

Laatste wijziging: 09-09-2026

Wijziging: Eerste technisch/functioneel ontwerp opgesteld.

Status: ⚠️ Ontwikkeling gepland

• Paper
• WorldGuard
• WorldEdit
• Vault
• LuckPerms
• MariaDB
• Discord Webhooks