Verschillen

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

--- plugins:tulpencraftrentals [2026/09/10 08:16] – [Rankverdeling] rroethof
+++ plugins:tulpencraftrentals [2026/09/11 17:16] (huidige) – rroethof
@@ Regel 1: / Regel 1: @@
-====== TulpenCraftEssentials ======
+# TulpenCraftRentals — interne wiki
-~~NOTOC~~
+## Inhoud
-===== 📌 Status =====
+- Installatie
+- Configuratie
+- Permissies
+- Rentals aanmaken
+- Verhuurproces
+- Verhuurborden
+- ChestShop
+- Evacuatie
+- Reset
+- WorldGuard
+- Admin-GUI
+- Commando-overzicht
+- Database
+- Probleemoplossing
-^ Eigenschap ^ Waarde ^
+## Overzicht
-| **Plugin** | TulpenCraftEssentials |
-| **Status** | 🟢 Actief |
-| **Versie** | 1.1.1 |
-| **Buildsysteem** | Maven |
-| **Platform** | Paper |
-| **Server(s)** | Survival |
-| **Onderdeel van netwerk** | Ja |
-| **Laatste controle** | {{DATUM}} |
-^ Server ^ Actief ^
+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.
-| **Velocity** | ❌ |
-| **Lobby** | ❌ |
-| **Survival** | ✅ |
-| **Events** | ❌ |
-----
+| 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 |
-===== 🎯 Doel =====
+## Permissies
-TulpenCraftEssentials is de algemene utility-plugin van TulpenCraft.
+Verhuurtoegang:
-De plugin bundelt algemene serverfunctionaliteit die niet specifiek genoeg is voor een afzonderlijke gespecialiseerde plugin. Hieronder vallen onder andere configureerbare serverlinks, een starterkit, welkomstberichten en persoonlijke begroetingen.
+```text
+tulpencraft.rent.<type>.<naam>
+```
-De plugin is bewust lichtgewicht opgezet en heeft geen afhankelijkheid van andere plugins.
+Voorbeelden:
-----
+```text
+tulpencraft.rent.house.small
+tulpencraft.rent.house.medium
+tulpencraft.rent.shop.small
+tulpencraft.rent.shop.special001
+```
-===== 📦 Installatie =====
+Gebruik bij bijzondere sleutels geen extra punt:
-**Jar-bestand:**
+```text
+FOUT: tulpencraft.rent.house.special.003
+GOED: tulpencraft.rent.house.special003
+```
-<code>
+Een rental zonder toegangspermissie is niet verhuurbaar.
-TulpenCraftEssentials-1.1.1.jar
-</code>
-**Locatie:**
+Huurlimieten:
-<code>
+```text
-/srv/minecraft/survival/plugins/TulpenCraftEssentials-1.1.1.jar
+tulpencraft.rent.limit.house.2
-</code>
+tulpencraft.rent.limit.shop.1
+tulpencraft.rent.limit.hotel.1
+```
-**Builden:**
+Admin:
-Het project gebruikt Maven.
+```text
+tulpencraft.rentals.admin
+```
-<code bash>
+## Rentals aanmaken
-mvn clean package
-</code>
-De gebouwde JAR wordt aangemaakt in:
+. Maak de WorldGuard-regio aan.
+. Controleer dat de regio niet overlapt met een andere rental-regio.
+. Kies de toegangspermissie.
+. Geef de rental een zichtbare naam.
+. Stel prijs, ledenlimiet en ChestShoplimiet in.
+. Koppel eventueel een schematic.
+. Koppel eventueel een bord.
+. Activeer de rental.
-<code>
+Voorbeeld:
-target/TulpenCraftEssentials-1.1.1.jar
-</code>
-----
+```text
+/rg define testshop02
+/huur aanmaken testshop02 tulpencraft.rent.shop.small Shop001
+```
-===== ⚙️ Configuratie =====
+## Verhuurproces
-**Configuratiebestand:**
+Bij het huren controleert de plugin de permissie, huurlimiet, beschikbaarheid, het saldo via Vault en de geldigheid van de WorldGuard-regio.
-<code>
+Daarna worden betaling, huurder, status, regio en bord bijgewerkt. Een fout mag niet leiden tot geld afgeschreven zonder toegekende huur.
-/srv/minecraft/survival/plugins/TulpenCraftEssentials/config.yml
-</code>
-Persoonlijke begroetingen worden opgeslagen in:
+Verlengen betaalt opnieuw de weekprijs en verlengt de einddatum met één week.
-<code>
+## Verhuurborden
-/srv/minecraft/survival/plugins/TulpenCraftEssentials/greetings.yml
-</code>
-==== Belangrijke instellingen ====
+```text
+/huur bord shop001
+/huur bord shop001 ontkoppelen
+/huur bordactie shop001 aan
+/huur bordactie shop001 uit
+```
-^ Instelling ^ Waarde ^ Betekenis ^
+Beschikbaar:
-| Website | Configureerbaar | URL van de TulpenCraft-website |
-| Wiki | Configureerbaar | URL van de TulpenCraft-wiki |
-| Prijzen | Configureerbaar | URL naar de prijzenpagina |
-| Discord | Configureerbaar | URL naar de Discord-community |
-| Regels | Configureerbaar | URL naar de serverregels |
-| Vote | Configureerbaar | URL naar de vote-pagina |
-| Starterkit | Configureerbaar | Inhoud van de starterkit |
-| Welkomstberichten | Configureerbaar | Berichten voor nieuwe en terugkerende spelers |
-| Begroetingen | Configureerbaar | Functionaliteit voor persoonlijke begroetingen |
-==== TulpenCraft-configuratie ====
+```text
+Shop001
+Beschikbaar
+,00 ƒ/week
+Rechtsklik
+```
-De plugin gebruikt een `config.yml` voor de algemene instellingen. De exacte configuratie wordt door de plugin zelf aangemaakt en kan worden aangepast aan de TulpenCraft-infrastructuur.
+Verhuurd:
-<code yaml>
+```text
-# Zie de gegenereerde config.yml
+Shop001
-# voor de actuele TulpenCraft-configuratie.
+Ronny_NL
-</code>
+t/m 18-09-2026
+VERHUURD
+```
-----
+Evacuatie:
-===== 🔐 Rechten =====
+```text
+Shop001
+Ronny_NL
+t/m 21-09-2026
+EVACUATIE
+```
-^ Permission ^ Rank ^ Beschrijving ^
+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.
-| `tulpenessentials.customgreeting` | Speler | Persoonlijke begroeting gebruiken en beheren |
-| `tulpenessentials.customgreeting.color` | {{RANK}} | Kleurcodes gebruiken in persoonlijke begroetingen |
-| `tulpenessentials.customgreeting.others` | {{RANK}} | Begroetingen van andere spelers beheren |
-| `tulpenessentials.admin` | Admin | Administratieve functionaliteit |
-| `tulpenessentials.*` | Admin | Volledige toegang tot TulpenCraftEssentials |
-==== Rankverdeling ====
+## ChestShop
-^ Rank ^ Rechten ^
+ChestShops zijn uitsluitend toegestaan binnen een actieve `SHOP`-rental.
-| **Speler** | `tulpenessentials.customgreeting` |
-| **VIP** | `tulpenessentials.customgreeting` |
-| **VIP+** | `tulpenessentials.customgreeting` |
-| **Helper** | `tulpenessentials.customgreeting` + `tulpenessentials.customgreeting.others` |
-| **Bouwer** | `tulpenessentials.customgreeting` + `tulpenessentials.customgreeting.others` |
-| **Moderator** | Zie Bouwer + staffrechten |
-| **Developer** | Zie Moderator + administratieve rechten indien nodig |
-| **Admin** | `tulpenessentials.admin`, `tulpenessentials.*` |
-| **Owner** | `tulpenessentials.*` |
-----
+De huurder en geautoriseerde medewerkers mogen ChestShops plaatsen, gebruiken en verwijderen, zolang het maximum niet is bereikt.
-===== 💬 Commando's =====
+```text
+/huur chestshops shop001 6
+```
-^ Commando ^ Permission ^ Beschrijving ^
+Buiten een actieve SHOP-rental zijn ChestShops niet toegestaan. Tijdens evacuatie mogen bestaande ChestShops eventueel nog worden gebruikt, maar nieuwe plaatsen is verboden.
-| <code>/website</code> | — | Opent de geconfigureerde TulpenCraft-website |
-| <code>/wiki</code> | — | Opent de geconfigureerde TulpenCraft-wiki |
-| <code>/prijzen</code> | — | Opent de geconfigureerde prijzenpagina |
-| <code>/discord</code> | — | Opent de geconfigureerde Discord-link |
-| <code>/regels</code> | — | Opent de geconfigureerde regels |
-| <code>/vote</code> | — | Opent de geconfigureerde vote-pagina |
-| <code>/starterkit</code> | — | Claimt de eenmalige starterkit |
-| <code>/kit</code> | — | Alias voor `/starterkit` |
-| <code>/begroeting</code> | `tulpenessentials.customgreeting` | Persoonlijke begroeting bekijken of instellen |
-| <code>/begroeting &lt;tekst&gt;</code> | `tulpenessentials.customgreeting` | Persoonlijke begroeting instellen |
-| <code>/begroeting reset</code> | `tulpenessentials.customgreeting` | Persoonlijke begroeting verwijderen |
-| <code>/begroeting speler &lt;naam&gt;</code> | `tulpenessentials.customgreeting.others` | Begroeting van een speler bekijken |
-| <code>/begroeting speler &lt;naam&gt; &lt;tekst&gt;</code> | `tulpenessentials.customgreeting.others` | Begroeting van een speler instellen |
-| <code>/begroeting speler &lt;naam&gt; reset</code> | `tulpenessentials.customgreeting.others` | Begroeting van een speler verwijderen |
-----
+## Evacuatie
-===== 🔗 Afhankelijkheden =====
+Na afloop van de huurperiode start een evacuatieperiode van maximaal 72 uur.
-==== Verplichte afhankelijkheden ====
+```text
+/huur evacuatie shop001
+/huur ontruimen shop001
+```
-  * Paper API 1.21.x
+Tijdens evacuatie kan de huurder spullen ophalen en eventueel verlengen. Nieuwe ChestShops mogen niet worden geplaatst.
-  * Java 21
-==== Plugin-afhankelijkheden ====
+Na afloop worden toegang, ChestShops en achtergebleven inhoud opgeruimd, waarna de schematic wordt geplaatst en de rental weer `AVAILABLE` wordt.
-Geen.
+## Rental verwijderen
-TulpenCraftEssentials heeft geen runtime-afhankelijkheid van:
+```text
+/huur verwijderen shop001
+```
-  * LuckPerms
+Verwijderen vereist bevestiging. De databasekoppelingen worden verwijderd, maar de fysieke WorldGuard-regio blijft bestaan.
-  * Vault
-  * PlaceholderAPI
-  * WorldGuard
-  * GriefPrevention
-  * ProtocolLib
-  * PacketEvents
-==== Optionele integraties ====
+## WorldGuard-richtlijnen
-Geen.
+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.
-===== 🌐 Netwerk / Proxy =====
+Bij problemen:
-**Proxy-plugin:** Nee
+```text
+/rg info <regio>
+/rg flags <regio>
+```
-^ Onderdeel ^ Waarde ^
+Controleer members, buildflags, parent-regio's, prioriteiten, gamemode en andere plugins.
-| Proxy | Velocity |
-| Backend | Survival |
-| Poort | {{POORT}} |
-| Publieke host | {{HOST}} |
-TulpenCraftEssentials draait als backend-plugin op de Survival-server en bevat geen Velocity-component.
+## Probleemoplossing
-----
+### Speler kan niet bouwen
-===== 🛡️ Beveiliging =====
+Controleer:
-TulpenCraftEssentials is een relatief eenvoudige backend-plugin zonder externe database of externe plugin-integraties.
+. Juiste regio.
+. Speler is member.
+. Geen overlap met andere rental.
+. Geen beperkende parent-flags.
+. Speler staat in Survival.
+. Geen andere plugin blokkeert bouwen.
-De plugin gebruikt Bukkit/Paper-permissions voor functionaliteit waarvoor verhoogde rechten nodig zijn.
+### ChestShop kan niet worden geplaatst
-Persoonlijke begroetingen worden opgeslagen in `greetings.yml`. Gebruikersinvoer wordt verwerkt voordat deze als begroeting wordt gebruikt. Onder andere regeleinden worden verwijderd en het gebruik van kleurcodes wordt gecontroleerd via een afzonderlijke permission.
+Controleer:
-De starterkit gebruikt Bukkit's `PersistentDataContainer` om per speler vast te leggen of de starterkit al is geclaimd.
+- actieve SHOP-rental;
+- huurder of medewerker;
+- juiste regio;
+- maximum niet bereikt;
+- geen evacuatie- of resetstatus.
-Er wordt geen externe database gebruikt.
+### Bord toont verkeerde gegevens
-----
+Controleer:
-===== ⚠️ Aandachtspunten =====
+- juiste rentalkoppeling;
+- huurder;
+- `expires_at`;
+- `evacuation_until`;
+- rentalstatus;
+- serverconsole.
-  * De plugin vereist Java 21.
+### Rental blijft op RESETTING
-  * De plugin is bedoeld voor Paper 1.21.x.
-  * De plugin heeft geen externe plugin-afhankelijkheden.
-  * De starterkit kan per speler slechts eenmaal worden geclaimd.
-  * Persoonlijke begroetingen worden opgeslagen in `greetings.yml`.
-  * Wijzigingen in de configuratie moeten worden gecontroleerd na een serverrestart.
-  * De plugin gebruikt Maven als buildsysteem.
-----
+Controleer schematic, wereld, resetcoördinaten, WorldEdit-toegang en consolefouten.
-===== 🧪 Troubleshooting =====
-==== Plugin wordt niet geladen ====
-Controleer eerst of de plugin succesvol is geladen:
-<code>
-/plugins
-</code>
-Controleer vervolgens de serverlog:
-<code bash>
-grep -i "TulpenCraftEssentials" logs/latest.log
-</code>
-Controleer daarnaast de Java-versie:
-<code bash>
-java -version
-</code>
-De plugin vereist Java 21.
-==== Commando's zijn niet beschikbaar ====
-Controleer of `TulpenCraftEssentials` als geladen wordt weergegeven in `/plugins`.
-Wanneer de plugin niet geladen is, controleer dan `logs/latest.log` op fouten tijdens het initialiseren.
-==== Starterkit kan niet worden geclaimd ====
-Controleer of de speler de starterkit al eerder heeft ontvangen.
-De plugin slaat de claimstatus op via Bukkit's `PersistentDataContainer`.
-==== Persoonlijke begroeting werkt niet ====
-Controleer of de speler beschikt over:
-<code>
-tulpenessentials.customgreeting
-</code>
-Controleer daarnaast:
-<code>
-plugins/TulpenCraftEssentials/greetings.yml
-</code>
-==== Kleurcodes werken niet ====
-Voor het gebruik van kleurformattering is de volgende permission nodig:
-<code>
-tulpenessentials.customgreeting.color
-</code>
-----
-===== 📝 Onderhoud =====
-**Laatste wijziging:** {{DATUM}}
-**Wijziging:** Documentatie aangemaakt / bijgewerkt op basis van TulpenCraftEssentials 1.1.1.
-**Status:** 🟢 Actief
-----
-===== 🔗 Externe links =====
-  * [[https://github.com/TulpenCraft/TulpenCraftEssentials|GitHub repository]]
-  * [[https://tulpencraft.nl|TulpenCraft]]
-  * [[https://wiki.tulpencraft.nl|TulpenCraft Wiki]]