Mastering Server Onboarding with the TutorialSpawn Plugin
Running a Minecraft server is a rewarding experience, but every admin knows the challenge of introducing new players to your unique world. You want to showcase your custom rules, quests, and hidden mechanics without overwhelming your seasoned veterans who just want to jump straight into the action. That is where TutorialSpawn comes in — a clever plugin that creates a dedicated tutorial area, ensuring every new player gets a guided introduction before stepping into your main spawn.
What Exactly Does TutorialSpawn Do?
At its core, TutorialSpawn allows server owners to set up a separate location that players are forced to visit upon joining. Instead of cluttering your primary spawn with rule boards, mini-games, and introductory NPCs, you can design an isolated tutorial zone. Every time a player logs in, they are teleported to that tutorial area until they enter a correct passphrase. Once they type the secret phrase, they are transported to the exit point and never see the tutorial again — unless you configure the plugin to require the phrase each session. This keeps your main spawn clean and efficient for regular players while still delivering essential information to newcomers.
Core Mechanics and Commands
TutorialSpawn operates on a simple but powerful principle: a location-based gate controlled by a passphrase. The plugin tracks each player’s progress and can limit the number of times they are forced into the tutorial using a maximum join events counter. By default, this counter is set to -1 (infinite), but you can tweak it to allow, say, five forced visits before the player is left alone. The passphrase itself is fully customizable, both in-game and via the configuration file.
The command set is intuitive and covers everything an admin needs. Here are the key commands:
- /tsphrase [passphrase] – Confirm the phrase and leave the tutorial.
- /tssetphrase [passphrase] – Set a new passphrase for your server.
- /tsgetphrase – Retrieve the current passphrase (useful for admins).
- /tsspawn – Teleport yourself to the tutorial spawn location.
- /tssetspawn – Mark your current position as the tutorial spawn.
- /tsexit – Teleport to the tutorial exit point.
- /tssetexit – Set the location players are sent to after entering the correct phrase.
- /tssetmje [integer] – Define the maximum join events before a player is no longer forced into the tutorial.
- /tsgetmje – Check the current max join events value.
- /tssetrp [true/false] – Toggle whether players must re-enter the phrase each login.
- /tsgetrp – See the reuse passphrase setting.
- /tssettd [double] – Set a teleport delay in seconds (e.g., 0.5 for half a second).
- /tsgettd – View the current teleport delay.
Setting up your tutorial area is straightforward: stand where you want the tutorial spawn, run /tssetspawn, then go to the exit point and use /tssetexit. Players will automatically be pulled into the tutorial until they type the passphrase or reach the join event limit.
Permissions and Player Roles
TutorialSpawn uses a permission system that separates regular players from admins. By default, all players have the tutorialspawn.phrase permission, which is exactly what they need to escape the tutorial. All other permissions are set to false for normal users, keeping control firmly in the hands of server operators. Admins can grant themselves access to set phrases, spawn points, and advanced settings using wildcard permissions like tutorialspawn.phrase.* to cover all related nodes. Here is the full permission breakdown:
- tutorialspawn.phrase – Allows using /tsphrase (default: true for everyone).
- tutorialspawn.phrase.get – View the passphrase (default: false).
- tutorialspawn.phrase.set – Change the passphrase (default: false).
- tutorialspawn.spawn – Teleport to tutorial spawn (default: false).
- tutorialspawn.spawn.set – Set the tutorial spawn point (default: false).
- tutorialspawn.exit – Teleport to tutorial exit (default: false).
- tutorialspawn.exit.set – Set the exit point (default: false).
- tutorialspawn.mje.get – Check max join events (default: false).
- tutorialspawn.mje.set – Set max join events (default: false).
- tutorialspawn.rp.get – Check reuse passphrase setting (default: false).
- tutorialspawn.rp.set – Toggle reuse passphrase (default: false).
- tutorialspawn.td.get – Check teleport delay (default: false).
- tutorialspawn.td.set – Set teleport delay (default: false).
This granular control means you can delegate specific tasks to moderators without giving full OP. For instance, a helper could be allowed to view the passphrase but not change it, simply by granting tutorialspawn.phrase.get.
Configuration and Flexibility
The plugin stores its settings in a clean config.yml file, so you can tweak the default passphrase, maximum join events, and teleport delay without ever touching an in-game command. The default passphrase is “putwhateverphraseyoulike”, which you should absolutely change to something unique for your server. The reuse passphrase setting is particularly handy for roleplay servers where players might need to revisit the tutorial area periodically. With /tssetrp true, they will be forced back into the tutorial every login until they say the magic words again.
Managing plugins like TutorialSpawn becomes even smoother when you use a modern launcher that simplifies mod and plugin installation. For example, the foxygame.net launcher lets you browse and download server-enhancing tools directly from its menu, making it a convenient and flexible way to keep your server up to date without manual file juggling. Once you have the plugin loaded, a quick restart and a few commands are all it takes to transform your player onboarding experience.
Why Every Server Needs a Tutorial Zone
First impressions matter. A well-crafted tutorial area reduces the flood of basic questions in chat, lowers the barrier for new players, and lets you showcase custom features like unique crafting recipes, economy systems, or modded mechanics. Instead of a wall of signs at spawn that veterans ignore, you can build an immersive tutorial with redstone-powered doors, NPCs from other plugins, and a satisfying “aha!” moment when they finally type the passphrase. TutorialSpawn gives you the framework to make that happen without interfering with your core spawn design.
Additionally, the plugin is lightweight and focuses on doing one job exceptionally well. It does not add bloated features or unnecessary GUI elements. The command-based interface is familiar to anyone who has managed a Bukkit or Spigot server, and the permission nodes integrate seamlessly with any existing permission plugin like LuckPerms.
Final Thoughts
TutorialSpawn solves a persistent problem for server admins: how to educate new players without annoying your regulars. By separating the tutorial experience from the main spawn and locking it behind a passphrase, you create a clean, efficient onboarding flow. The extensive command list, granular permissions, and configurable join event limits give you full control over how aggressive the tutorial enforcement should be. Whether you run a small survival community or a large minigame network, this plugin deserves a spot in your server’s toolkit. Set up your tutorial area, pick a creative passphrase, and watch your player retention improve as newcomers quickly learn the ropes and dive into your world with confidence.