TulpenCraftRules

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.

Buildsysteem:

./gradlew clean build

Jar-bestand:

TulpenCraftRules-1.0.0.jar

Build-output:

build/libs/TulpenCraftRules-1.0.0.jar

Serverlocatie:

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

Configuratiebestand:

/srv/minecraft/{{SERVER}}/plugins/TulpenCraftRules/config.yml

trigger:
  world: world
  x: 390.0
  y: 64.0
  z: -474.0
  distance: 1.5

settings:
  one-time: true

Bij acceptatie worden de onderstaande commands als console uitgevoerd:

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!'

Deze commands kunnen naar behoefte worden aangepast.

De acceptatiestatus wordt opgeslagen in:

/srv/minecraft/{{SERVER}}/plugins/TulpenCraftRules/players.yml

De status wordt gekoppeld aan de UUID van de speler.

• 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

Proxy-plugin: Nee

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

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.

• 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.

De regelacceptatie verschijnt niet.

/tulpenrules status <speler>

Controleer daarnaast config.yml:

trigger:
  world: world
  x: 390.0
  y: 64.0
  z: -474.0
  distance: 1.5

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:

/tulpenrules reload

Een speler moet de onboarding opnieuw kunnen doorlopen.

/tulpenrules status <speler>

Reset de acceptatiestatus:

/tulpenrules reset <speler>

De onboardingbeloningen worden niet uitgevoerd.

Controleer accept.commands in:

plugins/TulpenCraftRules/config.yml

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

Laatste wijziging: 10 september 2026

Wijziging: Documentatie gecontroleerd op basis van TulpenCraftRules versie 1.0.0.

Status: 🟢 Actief

• Projectpagina