# TulpenCraftRentals — interne wiki

## Inhoud

- Installatie
- Configuratie
- Permissies
- Rentals aanmaken
- Verhuurproces
- Verhuurborden
- ChestShop
- Evacuatie
- Reset
- WorldGuard
- Admin-GUI
- Commando-overzicht
- Database
- Probleemoplossing

## Overzicht

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.

| Onderdeel | Functie |
|---|---|
| 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:

```text
tulpencraft.rent.<type>.<naam>
```

Voorbeelden:

```text
tulpencraft.rent.house.small
tulpencraft.rent.house.medium
tulpencraft.rent.shop.small
tulpencraft.rent.shop.special001
```

Gebruik bij bijzondere sleutels geen extra punt:

```text
FOUT: tulpencraft.rent.house.special.003
GOED: tulpencraft.rent.house.special003
```

Een rental zonder toegangspermissie is niet verhuurbaar.

Huurlimieten:

```text
tulpencraft.rent.limit.house.2
tulpencraft.rent.limit.shop.1
tulpencraft.rent.limit.hotel.1
```

Admin:

```text
tulpencraft.rentals.admin
```

## Rentals aanmaken

1. Maak de WorldGuard-regio aan.
2. Controleer dat de regio niet overlapt met een andere rental-regio.
3. Kies de toegangspermissie.
4. Geef de rental een zichtbare naam.
5. Stel prijs, ledenlimiet en ChestShoplimiet in.
6. Koppel eventueel een schematic.
7. Koppel eventueel een bord.
8. Activeer de rental.

Voorbeeld:

```text
/rg define testshop02
/huur aanmaken testshop02 tulpencraft.rent.shop.small Shop001
```

## Verhuurproces

Bij het huren controleert de plugin de permissie, huurlimiet, beschikbaarheid, het saldo via Vault en de geldigheid van de WorldGuard-regio.

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.

## Verhuurborden

```text
/huur bord shop001
/huur bord shop001 ontkoppelen
/huur bordactie shop001 aan
/huur bordactie shop001 uit
```

Beschikbaar:

```text
Shop001
Beschikbaar
10,00 ƒ/week
Rechtsklik
```

Verhuurd:

```text
Shop001
Ronny_NL
t/m 18-09-2026
VERHUURD
```

Evacuatie:

```text
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.

## ChestShop

ChestShops zijn uitsluitend toegestaan binnen een actieve `SHOP`-rental.

De huurder en geautoriseerde medewerkers mogen ChestShops plaatsen, gebruiken en verwijderen, zolang het maximum niet is bereikt.

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

## Evacuatie

Na afloop van de huurperiode start een evacuatieperiode van maximaal 72 uur.

```text
/huur evacuatie shop001
/huur ontruimen shop001
```

Tijdens evacuatie kan de huurder spullen ophalen en eventueel verlengen. Nieuwe ChestShops mogen niet worden geplaatst.

Na afloop worden toegang, ChestShops en achtergebleven inhoud opgeruimd, waarna de schematic wordt geplaatst en de rental weer `AVAILABLE` wordt.

## Rental verwijderen

```text
/huur verwijderen shop001
```

Verwijderen vereist bevestiging. De databasekoppelingen worden verwijderd, maar de fysieke WorldGuard-regio blijft bestaan.

## WorldGuard-richtlijnen

TulpenCraftRentals maakt geen fysieke WorldGuard-regio's aan. Regio's worden handmatig aangemaakt.

Rental-regio's mogen niet onderling overlappen. Een algemene bovenliggende gebiedsregio is toegestaan.

Bij problemen:

```text
/rg info <regio>
/rg flags <regio>
```

Controleer members, buildflags, parent-regio's, prioriteiten, gamemode en andere plugins.

## Probleemoplossing

### Speler kan niet bouwen

Controleer:

1. Juiste regio.
2. Speler is member.
3. Geen overlap met andere rental.
4. Geen beperkende parent-flags.
5. Speler staat in Survival.
6. Geen andere plugin blokkeert bouwen.

### ChestShop kan niet worden geplaatst

Controleer:

- actieve SHOP-rental;
- huurder of medewerker;
- juiste regio;
- maximum niet bereikt;
- geen evacuatie- of resetstatus.

### Bord toont verkeerde gegevens

Controleer:

- juiste rentalkoppeling;
- huurder;
- `expires_at`;
- `evacuation_until`;
- rentalstatus;
- serverconsole.

### Rental blijft op RESETTING

Controleer schematic, wereld, resetcoördinaten, WorldEdit-toegang en consolefouten.