plugins:tulpencraftrentalstaff [TulpenCraft Wiki]

Deze pagina is alleen-lezen. Je kan de broncode bekijken maar niet veranderen. Neem contact op met de beheerder als je denkt dat dit niet klopt.
# Staff commands

> **Let op:** de exacte commandostructuur kan tijdens de ontwikkeling nog wijzigen. Onderstaande commands zijn de voorgestelde staff-interface.

## 1. Permissions

Voor staffbeheer worden aparte permissions gebruikt.

```text
tulpencraft.rentals.admin
tulpencraft.rentals.create
tulpencraft.rentals.edit
tulpencraft.rentals.reset
tulpencraft.rentals.force
tulpencraft.rentals.members
```

`tulpencraft.rentals.admin` geeft toegang tot het volledige staffbeheer.

---

# 2. Rentals bekijken

### Alle rentals

```text
/tc rental list
```

Toont alle geregistreerde rentals.

Voorbeeld:

```text
ID   TYPE    NAAM          HUURDER      STATUS
1    HOUSE   Huis #01      Ronny_NL     RENTED
2    HOUSE   Huis #02      -            AVAILABLE
3    SHOP    Shop #01      Lijpie       RENTED
4    HOTEL   Kamer 101     -            AVAILABLE
```

### Filteren

```text
/tc rental list available
/tc rental list rented
/tc rental list expired
/tc rental list resetting
/tc rental list house
/tc rental list shop
/tc rental list hotel
```

---

# 3. Rental aanmaken

Een WorldGuard-region moet eerst bestaan.

Bijvoorbeeld:

```text
/rg define tc_shop_012
```

Daarna:

```text
/tc rental create tc_shop_012 shop
```

De plugin controleert:

* bestaat de WorldGuard-region?
* bestaat de wereld?
* is de region al gekoppeld?
* is het rental-type geldig?
* heeft staff voldoende rechten?

Na het aanmaken krijgt de rental een uniek ID.

Bijvoorbeeld:

```text
Rental #12 aangemaakt.
Type: SHOP
Region: tc_shop_012
Status: DISABLED
```

Een nieuwe rental wordt bewust niet automatisch verhuurbaar gemaakt.

---

# 4. Rental configureren

### Informatie bekijken

```text
/tc rental info <id>
```

Voorbeeld:

```text
/tc rental info 12
```

Toont onder andere:

```text
Naam
Type
WorldGuard-region
Status
Prijs
Huurduur
Huurder
Startdatum
Einddatum
Rank/permission
Maximum aantal ChestShops
Maximum aantal medewerkers/bewoners
Reset-configuratie
```

---

### Naam wijzigen

```text
/tc rental name <id> <naam>
```

Voorbeeld:

```text
/tc rental name 12 Dorpswinkel
```

---

### Prijs instellen

```text
/tc rental price <id> <bedrag>
```

Voorbeeld:

```text
/tc rental price 12 750
```

Betekent:

> €750 per huurperiode.

---

### Huurduur instellen

```text
/tc rental duration <id> <dagen>
```

Voorbeeld:

```text
/tc rental duration 12 30
```

---

### Rank/permission instellen

```text
/tc rental permission <id> <permission>
```

Voorbeeld:

```text
/tc rental permission 12 tulpencraft.rent.vip
```

Iedereen zonder deze permission kan de rental bekijken, maar niet huren.

Permission verwijderen:

```text
/tc rental permission <id> none
```

---

# 5. Shop-instellingen

Deze instellingen zijn alleen relevant voor `SHOP` rentals.

### Maximum ChestShops

```text
/tc rental chestshops <id> <aantal>
```

Voorbeeld:

```text
/tc rental chestshops 12 10
```

Betekent:

> Shop #12 mag maximaal 10 ChestShops bevatten.

### Maximum medewerkers

```text
/tc rental members <id> <aantal>
```

Voorbeeld:

```text
/tc rental members 12 3
```

---

# 6. Bewoners en medewerkers

## Bewoner toevoegen

Voor woningen/hotelkamers:

```text
/tc rental member add <id> <speler>
```

## Bewoner verwijderen

```text
/tc rental member remove <id> <speler>
```

Bij een woning of hotelkamer krijgt de speler hierdoor toegang tot de betreffende WorldGuard-region.

---

## Winkelmedewerker toevoegen

Voor shops kan dezelfde functionaliteit worden gebruikt:

```text
/tc shop employee add <id> <speler>
```

## Winkelmedewerker verwijderen

```text
/tc shop employee remove <id> <speler>
```

Een medewerker mag binnen de winkel onder andere:

* bouwen;
* ChestShops plaatsen;
* ChestShops verwijderen;
* ChestShops beheren.

---

# 7. Rental beschikbaar maken

Na het volledig configureren:

```text
/tc rental enable <id>
```

De rental wordt:

```text
AVAILABLE
```

en kan door spelers worden gehuurd.

---

# 8. Rental uitschakelen

```text
/tc rental disable <id>
```

Een uitgeschakelde rental kan niet opnieuw worden verhuurd.

Een bestaande huurder wordt hiermee **niet automatisch verwijderd**.

Dit kan bijvoorbeeld worden gebruikt wanneer:

* de locatie tijdelijk dicht moet;
* er onderhoud nodig is;
* een WorldGuard-region aangepast moet worden;
* staff problemen met de locatie onderzoekt.

---

# 9. Huur handmatig beëindigen

```text
/tc rental expire <id>
```

Hiermee beëindigt staff de actieve huur.

Dit moet een bevestiging vereisen:

```text
⚠️ Rental #12 is momenteel verhuurd.

Huurder: Lijpie
Einddatum: 09-10-2026

Weet je zeker dat je deze huur wilt beëindigen?
```

Na bevestiging gaat de rental naar de ontruimingsfase.

---

# 10. Rental vrijgeven

```text
/tc rental release <id>
```

Hiermee kan staff een rental handmatig vrijgeven wanneer deze klaar is voor een nieuwe huurder.

Gebruik dit alleen wanneer:

* de vorige huurder verwijderd is;
* de locatie gecontroleerd is;
* eventuele ChestShops verwijderd zijn;
* de WorldGuard-toegang klopt;
* de locatie klaar is voor verhuur.

---

# 11. Rental resetten

### Handmatige reset

```text
/tc rental reset <id>
```

Hiermee wordt de rental handmatig teruggezet naar de oorspronkelijke staat.

De reset kan onder andere:

* ChestShops verwijderen;
* rental members verwijderen;
* WorldGuard-toegang herstellen;
* achtergebleven voorraad verwijderen;
* de WorldEdit schematic terugplaatsen.

> **WAARSCHUWING:** een reset kan bouwwerken en items definitief verwijderen.

Gebruik dit daarom alleen wanneer je zeker weet dat de rental hiervoor klaar is.

---

# 12. Reset status controleren

```text
/tc rental reset status <id>
```

Geeft bijvoorbeeld:

```text
Rental #12
Status: RESETTING

Schematic: shop_012.schem
ChestShops verwijderd: 10
WorldGuard access verwijderd: OK
Schematic restore: BEZIG
```

Bij een fout:

```text
Rental #12
Status: RESETTING
Restore: FAILED

De rental is niet beschikbaar voor verhuur.
Staff intervention required.
```

---

# 13. Huurder opzoeken

```text
/tc rental player <speler>
```

Voorbeeld:

```text
/tc rental player Lijpie
```

Geeft:

```text
Lijpie

Woningen:
1 / 2

Winkels:
2 / 2

Hotelkamers:
0

Actieve rentals:
#12 Shop
#21 Huis
#22 Shop
```

Dit is vooral handig voor staffcontrole.

---

# 14. Rental geschiedenis

```text
/tc rental history <id>
```

Geeft de auditlog van een rental.

Voorbeeld:

```text
09-09-2026 18:42
Lijpie
RENTED

09-09-2026 18:43
Lijpie
EMPLOYEE_ADDED
Niensje

10-09-2026 12:31
Lijpie
CHESTSHOP_CREATED

09-10-2026 18:42
SYSTEM
EXPIRED

12-10-2026 18:42
SYSTEM
RESET_COMPLETED
```

---

# 15. ChestShops bekijken

Voor een shop:

```text
/tc shop info <id>
```

Voorbeeld:

```text
Shop #12

ChestShops: 7 / 10

#1  -120 72 450
#2  -116 72 450
#3  -112 72 450
#4  -108 72 450
#5  -104 72 450
#6  -100 72 450
#7  -096 72 450
```

Hiermee kan staff controleren hoeveel ChestShops een winkel gebruikt.

---

# 16. Alle belangrijke staff commands

| Command                                   | Functie                      |
| ----------------------------------------- | ---------------------------- |
| `/tc rental list`                         | Rentals bekijken             |
| `/tc rental info <id>`                    | Rental details               |
| `/tc rental create <region> <type>`       | Rental aanmaken              |
| `/tc rental name <id> <naam>`             | Naam wijzigen                |
| `/tc rental price <id> <bedrag>`          | Prijs instellen              |
| `/tc rental duration <id> <dagen>`        | Huurduur instellen           |
| `/tc rental permission <id> <permission>` | Rank-eis instellen           |
| `/tc rental chestshops <id> <aantal>`     | ChestShop-limiet instellen   |
| `/tc rental members <id> <aantal>`        | Bewoners/medewerkers-limiet  |
| `/tc rental enable <id>`                  | Rental beschikbaar maken     |
| `/tc rental disable <id>`                 | Rental uitschakelen          |
| `/tc rental expire <id>`                  | Huur handmatig beëindigen    |
| `/tc rental release <id>`                 | Rental vrijgeven             |
| `/tc rental reset <id>`                   | Rental resetten              |
| `/tc rental reset status <id>`            | Resetstatus bekijken         |
| `/tc rental player <speler>`              | Rentals van speler bekijken  |
| `/tc rental history <id>`                 | Auditlog bekijken            |
| `/tc rental member add <id> <speler>`     | Bewoner toevoegen            |
| `/tc rental member remove <id> <speler>`  | Bewoner verwijderen          |
| `/tc shop employee add <id> <speler>`     | Medewerker toevoegen         |
| `/tc shop employee remove <id> <speler>`  | Medewerker verwijderen       |
| `/tc shop info <id>`                      | ChestShops van shop bekijken |

---

# 17. Voorbeeld: nieuwe winkel opzetten

Een stafflid wil een nieuwe winkel toevoegen.

### Stap 1 — WorldGuard

```text
/rg define tc_shop_025
```

### Stap 2 — Rental maken

```text
/tc rental create tc_shop_025 shop
```

### Stap 3 — Instellingen

```text
/tc rental name 25 Bloemenmarkt
/tc rental price 25 750
/tc rental duration 25 30
/tc rental permission 25 tulpencraft.rent.vip
/tc rental chestshops 25 10
/tc rental members 25 3
```

### Stap 4 — Controleren

```text
/tc rental info 25
```

### Stap 5 — Beschikbaar maken

```text
/tc rental enable 25
```

De winkel is nu beschikbaar voor spelers die aan de voorwaarden voldoen.

---

# 18. Belangrijk voor staff

**Gebruik `reset`, `expire` en `release` zorgvuldig.**

Deze commands kunnen directe gevolgen hebben voor spelers en hun bezittingen.

Bij twijfel:

1. Controleer de rental.
2. Controleer de huurder.
3. Controleer de einddatum.
4. Controleer de ChestShops.
5. Controleer de WorldGuard-region.
6. Controleer de auditlog.
7. Voer pas daarna een handmatige actie uit.

Alle belangrijke staffacties worden door TulpenCraft Rentals geregistreerd.