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

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.

/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