====== TulpenCraftRegion ======

~~NOTOC~~

===== 📌 Status =====

^ Eigenschap ^ Waarde ^
| **Plugin** | TulpenCraftRegion |
| **Status** | 🟢 Actief |
| **Versie** | 1.0.2 |
| **Platform** | Paper 1.21.11+ |
| **Server(s)** | Survival |
| **Onderdeel van netwerk** | Ja |
| **Laatste controle** | {{DATUM}} |

^ Server ^ Actief ^
| **Velocity** | ❌ |
| **Lobby** | ❌ |
| **Survival** | ✅ |
| **Events** | ❌ |

----

===== 🎯 Doel =====

TulpenCraftRegion registreert locatie-afhankelijke **PlaceholderAPI-placeholders** voor Paper.

De plugin bepaalt de huidige locatie van een online speler en vertaalt deze naar een bruikbare naam, omschrijving en aanvullende locatiegegevens.

De locatie wordt bepaald aan de hand van:

  * WorldGuard-regio's;
  * GriefPrevention-claims;
  * geconfigureerde standaardwaarden voor de wildernis.

TulpenCraftRegion vormt daarmee de vertaallaag tussen de technische locatiegegevens van WorldGuard/GriefPrevention en plugins die via PlaceholderAPI locatie-informatie willen tonen.

Een belangrijk gebruik binnen TulpenCraft is het tonen van de huidige locatie van een speler in bijvoorbeeld [[plugins:simplescore|SimpleScore]].

----

===== 📦 Installatie =====

**Jar-bestand:**

<code>
TulpenCraftRegion-1.0.2.jar
</code>

**Locatie:**

<code>
/srv/minecraft/survival/plugins/TulpenCraftRegion-1.0.2.jar
</code>

----

===== ⚙️ Configuratie =====

**Configuratiebestand:**

<code>
/srv/minecraft/survival/plugins/TulpenCraftRegion/config.yml
</code>

==== Belangrijke instellingen ====

^ Instelling ^ Waarde ^ Betekenis ^
| `regions` | WorldGuard-regio mappings | Koppelt WorldGuard-region-ID's aan gebruikersvriendelijke namen |
| `default.name` | `Wildernis` | Standaardnaam wanneer geen regio of claim van toepassing is |
| `default.description` | `Wildernis` | Standaardomschrijving wanneer geen regio of claim van toepassing is |

==== TulpenCraft-configuratie ====

<code yaml>
regions:
  spawn: "Spawn"
  markt: "Markt"

default:
  name: "Wildernis"
  description: "Wildernis"
</code>

Wanneer een WorldGuard-region-ID niet voorkomt in `regions`, wordt de region-ID zelf als omschrijving gebruikt.

De globale WorldGuard-regio `__global__` wordt overgeslagen.

----

===== 🔐 Rechten =====

^ Permission ^ Rank ^ Beschrijving ^
| `tulpencraft.region.admin` | Admin | Configuratie van TulpenCraftRegion beheren en reload uitvoeren |

==== Rankverdeling ====

^ Rank ^ Rechten ^
| **Speler** | Geen administratieve rechten |
| **VIP** | Geen administratieve rechten |
| **VIP+** | Geen administratieve rechten |
| **Helper** | Geen administratieve rechten |
| **Bouwer** | Geen administratieve rechten |
| **Moderator** | Geen administratieve rechten |
| **Developer** | `tulpencraft.region.admin` |
| **Admin** | `tulpencraft.region.admin` |
| **Owner** | `tulpencraft.region.admin` |

----

===== 💬 Commando's =====

^ Commando ^ Permission ^ Beschrijving ^
| <code>/tcregion reload</code> | `tulpencraft.region.admin` | Configuratie opnieuw laden zonder de server te herstarten |

----

===== 🔗 Afhankelijkheden =====

  * **PlaceholderAPI** — verplicht
  * **WorldGuard** — optionele soft dependency
  * **GriefPrevention** — optionele soft dependency

Zonder WorldGuard en GriefPrevention kan de plugin starten, maar worden alleen de geconfigureerde standaardwaarden gebruikt.

----

===== 🌐 Netwerk / Proxy =====

**Proxy-plugin:** Nee

^ Onderdeel ^ Waarde ^
| Proxy | Velocity |
| Backend | Survival |

TulpenCraftRegion draait als backend-plugin op de Survival-server en heeft geen eigen Velocity-component.

----

===== 🛡️ Beveiliging =====

TulpenCraftRegion leest locatiegegevens uit WorldGuard en GriefPrevention en stelt deze beschikbaar via PlaceholderAPI.

De plugin wijzigt zelf geen WorldGuard-regio's en geen GriefPrevention-claims.

De administratieve functionaliteit is afgeschermd via `tulpencraft.region.admin`.

De plugin levert geen locatiegegevens voor offline spelers.

----

===== ⚠️ Aandachtspunten =====

  * WorldGuard en GriefPrevention zijn optionele dependencies.
  * De globale WorldGuard-regio `__global__` wordt niet gebruikt.
  * Niet-geconfigureerde WorldGuard-regio's gebruiken de region-ID als omschrijving.
  * Placeholders leveren geen waarde voor offline spelers.
  * Bij wijzigingen aan WorldGuard-regio's moeten de gewenste weergaven indien nodig worden bijgewerkt in `config.yml`.
  * PlaceholderAPI moet beschikbaar zijn op de server.

----

===== 🧪 Troubleshooting =====

==== Placeholder geeft niets terug ====

Controleer of de speler online is en of PlaceholderAPI correct op de server is geïnstalleerd.

==== WorldGuard-regio wordt niet weergegeven ====

Controleer de region-ID en controleer of WorldGuard actief is.

<code bash>
/rg info <region>
</code>

Controleer daarnaast of de regio niet `__global__` is.

==== GriefPrevention-claim wordt niet herkend ====

Controleer of GriefPrevention actief is en of de speler zich daadwerkelijk binnen een claim bevindt.

==== Configuratie gewijzigd maar oude waarde wordt weergegeven ====

Laad de configuratie opnieuw:

<code bash>
/tcregion reload
</code>

Controleer vervolgens opnieuw de placeholder.

----

===== 📝 Onderhoud =====

**Laatste wijziging:** {{DATUM}}

**Wijziging:** Documentatie aangemaakt / bijgewerkt voor versie 1.0.2.

**Status:** ✅ Actief

----

===== 🔗 Externe links =====

  * [[https://github.com/TulpenCraft/TulpenCraftRegion|GitHub repository]]
  * [[https://github.com/TulpenCraft/TulpenCraftRegion#tulpencraftregion|README / documentatie]]