---


====== TulpenCraftRules ======

~~NOTOC~~

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

^ Eigenschap ^ Waarde ^
| **Plugin** | TulpenCraftRules |
| **Status** | 🟢 Actief |
| **Versie** | 1.0.0 |
| **Platform** | Paper |
| **Server(s)** | Netwerk |
| **Onderdeel van netwerk** | Ja |
| **Buildsysteem** | Gradle |
| **Laatste controle** | 10 september 2026 |

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

----

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

TulpenCraftRules verzorgt de **regelacceptatie en onboarding van nieuwe spelers** binnen TulpenCraft.

Nieuwe spelers krijgen bij het aangewezen triggerpunt de serverregels aangeboden. Wanneer zij het triggerpunt verlaten, verschijnt een GUI waarin zij kunnen aangeven of zij de regels accepteren.

Na acceptatie kunnen configureerbare onboardingcommands worden uitgevoerd, bijvoorbeeld het toekennen van de spelersrank, claimblokken, starterkit en startkapitaal.

De plugin beheert uitsluitend de regelacceptatie en onboarding. De daadwerkelijke regelafbeelding in de wereld wordt door een afzonderlijk systeem, zoals Yamipa, verzorgd.

----

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

**Buildsysteem:**

<code bash>
./gradlew clean build
</code>

**Jar-bestand:**

<code>
TulpenCraftRules-1.0.0.jar
</code>

**Build-output:**

<code>
build/libs/TulpenCraftRules-1.0.0.jar
</code>

**Serverlocatie:**

<code>
/srv/minecraft/{{SERVER}}/plugins/TulpenCraftRules-1.0.0.jar
</code>

----

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

**Configuratiebestand:**

<code>
/srv/minecraft/{{SERVER}}/plugins/TulpenCraftRules/config.yml
</code>

==== Belangrijke instellingen ====

^ Instelling ^ Waarde ^ Betekenis ^
| `trigger.world` | `world` | Wereld waarin het triggerpunt zich bevindt |
| `trigger.x` | `390.0` | X-coördinaat van het triggerpunt |
| `trigger.y` | `64.0` | Y-coördinaat van het triggerpunt |
| `trigger.z` | `-474.0` | Z-coördinaat van het triggerpunt |
| `trigger.distance` | `1.5` | Afstand rond het triggerpunt |
| `settings.one-time` | `true` | Voorkomt dat onboarding opnieuw wordt geclaimd |

==== TulpenCraft-configuratie ====

<code yaml>
trigger:
  world: world
  x: 390.0
  y: 64.0
  z: -474.0
  distance: 1.5

settings:
  one-time: true
</code>

==== Acceptatiecommands ====

Bij acceptatie worden de onderstaande commands als console uitgevoerd:

<code yaml>
accept:
  commands:
    - 'lp user {player} parent set speler'
    - 'adjustbonusclaimblocks {player} 1000'
    - 'kit starter {player}'
    - 'eco give {player} 50'
    - 'say 🌷 Welkom {player} bij Tulpencraft! Veel plezier!'
</code>

Deze commands kunnen naar behoefte worden aangepast.

==== Opslag ====

De acceptatiestatus wordt opgeslagen in:

<code>
/srv/minecraft/{{SERVER}}/plugins/TulpenCraftRules/players.yml
</code>

De status wordt gekoppeld aan de UUID van de speler.

----

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

^ Permission ^ Rank ^ Beschrijving ^
| `tulpenrules.admin` | Admin / OP | Beheer van TulpenCraftRules |

==== Rankverdeling ====

^ Rank ^ Rechten ^
| **Speler** | Geen beheersrechten |
| **VIP** | Geen beheersrechten |
| **VIP+** | Geen beheersrechten |
| **Helper** | Geen beheersrechten |
| **Bouwer** | Geen beheersrechten |
| **Moderator** | Geen beheersrechten |
| **Developer** | Indien toegewezen |
| **Admin** | `tulpenrules.admin` |
| **Owner** | `tulpenrules.admin` |

----

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

^ Commando ^ Permission ^ Beschrijving ^
| <code>/tulpenrules reload</code> | `tulpenrules.admin` | Herlaadt de configuratie |
| <code>/tulpenrules reset &lt;speler&gt;</code> | `tulpenrules.admin` | Reset de regelacceptatie van een online speler |
| <code>/tulpenrules status &lt;speler&gt;</code> | `tulpenrules.admin` | Toont de acceptatiestatus van een online speler |
| <code>/rules</code> | `tulpenrules.admin` | Alias voor `/tulpenrules` |

----

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

  * Geen harde runtime dependencies
  * LuckPerms kan via de configuratie worden gebruikt
  * PlaceholderAPI is compile-time beschikbaar, maar geen harde dependency
  * Yamipa kan worden gebruikt voor de regelafbeelding in de wereld

----

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

**Proxy-plugin:** Nee

^ Onderdeel ^ Waarde ^
| Proxy | Velocity |
| Backend | Netwerk / onboarding |

TulpenCraftRules is geen Velocity-plugin. De plugin draait op een Paper-server en verzorgt daar de regelacceptatie.

----

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

TulpenCraftRules vormt onderdeel van de onboarding van nieuwe spelers.

De plugin:

  * slaat de acceptatiestatus op basis van UUID op;
  * kan onboardingcommands uitsluitend als serverconsole uitvoeren;
  * voorkomt standaard dubbele claim van onboarding wanneer `one-time: true` actief is;
  * biedt beheercommando's uitsluitend aan gebruikers met `tulpenrules.admin`;
  * gebruikt geen externe database;
  * maakt geen externe netwerkverbindingen voor de werking van de plugin.

Let op: de daadwerkelijke commands onder `accept.commands` worden door de beheerder bepaald. Deze configuratie moet daarom alleen door vertrouwde beheerders kunnen worden aangepast.

----

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

  * Controleer het triggerpunt na het verplaatsen van de spawn.
  * Pas `trigger.world` en de coördinaten aan wanneer de onboardinglocatie verandert.
  * Controleer de commands onder `accept.commands` voordat de plugin in productie wordt gebruikt.
  * `reset` werkt op online spelers.
  * Bij `settings.one-time: true` kunnen onboardingbeloningen niet opnieuw worden geclaimd.
  * De regelafbeelding zelf wordt niet door TulpenCraftRules beheerd.

----

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

==== Probleem ====

De regelacceptatie verschijnt niet.

==== Controle ====

<code bash>
/tulpenrules status <speler>
</code>

Controleer daarnaast `config.yml`:

<code yaml>
trigger:
  world: world
  x: 390.0
  y: 64.0
  z: -474.0
  distance: 1.5
</code>

==== Oplossing ====

Controleer of:

  * de wereldnaam correct is;
  * de coördinaten overeenkomen met het daadwerkelijke triggerpunt;
  * de speler de regels nog niet heeft geaccepteerd;
  * de plugin correct is geladen.

Herlaad daarna eventueel de plugin:

<code>
/tulpenrules reload
</code>

----

==== Probleem ====

Een speler moet de onboarding opnieuw kunnen doorlopen.

==== Controle ====

<code>
/tulpenrules status <speler>
</code>

==== Oplossing ====

Reset de acceptatiestatus:

<code>
/tulpenrules reset <speler>
</code>

----

==== Probleem ====

De onboardingbeloningen worden niet uitgevoerd.

==== Controle ====

Controleer `accept.commands` in:

<code>
plugins/TulpenCraftRules/config.yml
</code>

==== Oplossing ====

Controleer of de gebruikte commands op de server bestaan en of de betreffende plugins, zoals LuckPerms, Economy of het claim-systeem, correct beschikbaar zijn.

----

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

**Laatste wijziging:** 10 september 2026

**Wijziging:** Documentatie gecontroleerd op basis van TulpenCraftRules versie 1.0.0.

**Status:** 🟢 Actief

----

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

  * [[https://github.com/TulpenCraft/TulpenCraftRules|Projectpagina]]