Dit is een oude revisie van het document!
TulpenCraftRegion
๐ 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 SimpleScore.
๐ฆ Installatie
Jar-bestand:
TulpenCraftRegion-1.0.2.jar
Locatie:
/srv/minecraft/survival/plugins/TulpenCraftRegion-1.0.2.jar
โ๏ธ Configuratie
Configuratiebestand:
/srv/minecraft/survival/plugins/TulpenCraftRegion/config.yml
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
regions: spawn: "Spawn" markt: "Markt" default: name: "Wildernis" description: "Wildernis"
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 |
|---|---|---|
/tcregion reload | 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
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.
/rg info <region>
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:
/tcregion reload
Controleer vervolgens opnieuw de placeholder.
๐ Onderhoud
Laatste wijziging: datum
Wijziging: Documentatie aangemaakt / bijgewerkt voor versie 1.0.2.
Status: โ Actief