Tutorials

Tutorials

The beginner tutorial guides new players through a basic Build The Earth workflow before (optionally) allowing plot claims.

Config

tutorials:
  tutorial-enable: true
  beginner-tutorial:
    required: true
    start-on-first-join: false
  tutorial-npc-name: 'Bob'
  tutorial-npc-texture: '<base64>'
  tutorial-npc-signature: '<base64>'
  tutorial-chat-prefix: '<dark_gray>[<gold>Tutorial</gold>] » </dark_gray>'

Key	Effect
tutorial-enable	Master switch for the tutorial system
beginner-tutorial.required	If true, players must finish the beginner tutorial before using the Plot System normally
beginner-tutorial.start-on-first-join	Only when required: auto-start on first join (false by default since v5.2.0)

NPC texture/signature and chat prefix customise the tutorial NPC and messages.

Players can open the tutorial with /tutorial (plotsystem.tutorial) or the companion tutorial button.

Schematics & config files

Custom tutorial schematics live in:

plugins/Plot-System/tutorial/schematics/

Use .schem.gz format. On upgrade from v4, move files from the old /schematics/tutorials path and update tutorial_beginner.yml (height stages accept units like 8m).

Chat input stages need messages to reach the Paper server — see Message Input on Installation (FreedomChat, enforce-secure-profile=false).