TutorialCreator - Guide Your Players v. 1.32.1

Added compatibility for Minecraft 26.X

Please report any issues on Discord.
If you enjoy the update please consider leaving a positive review!

Additions

• New countdown shows remaining time while creating actions.
• Teleport-actions are now created by simply punching into the air. Specific coordinates can still be specified by editing the tutorials.yml file and then reloading.
• Re-done commands for more structured usage. Check the wiki for details. /tc <create | edit | reload>
• Hex color support: Use &#COLOR (Minecraft 1.16+).

Further improvements

• Added info about how to delete the tutorial villagers (when spawning or hitting them as admin).
• Damaging other players and item pickup are now blocked while in a tutorial.
• Reloading now happens through commands only, force-saving in the GUI of individual tutorials.
• Internal improvements for efficiency.
• Latest Minecraft 1.21.X is officially supported.

Additions to config.yml

Spoiler

Code:

messages:
  punchforlocationinput: 'Punch to use your current location as input.'
  villager-damage-info: '&cTutorial villagers cannot be damaged. Open the villager GUI using shift + right-click.'
  tutorial-already-exists: '&cTutorial &e%tutorial% &calready exists! Use &e/tc edit %tutorial% &cto edit it.'
  tutorial-not-found-create: '&cTutorial &e%tutorial% &cdoes not exist! Use &e/tc create %tutorial% &cto create it.'
  confirm-reload-command:
    - '&cWarning: Reloading tutorials may overwrite changes made since last server startup!'
    - '&7Use &e/tc reload tutorials confirm &7to proceed with the reload.'
  tutorial-syntax:
    - '&cInvalid Syntax'
    - '&e/tutorial <tutorial> [player] &7- Start a tutorial for you or another player.'
    - '&e/tutorials &7- View available tutorials.'
  tc-syntax:
  - '&6Command Syntax:'
  - '&e/tc create <tutorial> &7- Create a new tutorial'
  - '&e/tc edit [tutorial] &7- Edit a tutorial (or show overview)'
  - '&e/tc reload <config | tutorials> &7- Reload configuration or tutorials'
  tc-create-syntax:
  - '&6Create Command Syntax:'
  - '&e/tc create <tutorial> &7- Create a new tutorial with the specified name'
  tc-edit-syntax:
  - '&6Edit Command Syntax:'
  - '&e/tc edit <tutorial> &7- Edit the specified tutorial'
  tc-reload-syntax:
  - '&6Reload Command Syntax:'
  - '&e/tc reload config &7- Reload the configuration file'
  - '&e/tc reload tutorials &7- Reload all tutorials'

# OLD SECTION - CAN BE REMOVED
#wrong-syntax:
#- '&7[&6&lTutorial&r&7] &cWrong syntax!'
#- '&c» &7/tutorials &8| &7View all tutorials you can start'
#- '&c» &7/tutorial <tutorial> [player] &8| &7Start a tutorial for you or another player'
#- '&c» &7/tutedit <tutorial> &8| &7Create / Edit a tutorial'
#- '&c» &7/tutedit &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
#- '&c» &7/tutreload <config | tutorials> &8| &7Reload the plugin'
#- '&c» &7/abort &8| &7Exit the chat input'

Please report any issues on Discord.
If you enjoy the update please consider leaving a positive review!

This is one of the biggest updates since the plugin’s release in 2018. It brings a complete redesign of all major GUIs.

GUI Improvements

• Improved layout and descriptions of all GUI elements
• Consistent logic for going back and changing pages
• Redesigned Confirmation GUI for better readability and to minimize accidental confirmations
• Added confirmation prompt before force-saving a tutorial to disk
• Fixed a bug where the GUI didn’t update in certain situations

Other Changes

• Tutorials now display last edited on and last edited by
• The Tutorial List GUI (/tutedit) now sorts tutorials by most recent edit
• Added compatibility for Minecraft 1.21.8

A huge amount of work went into this release.
If you enjoy the plugin and its continuous development and haven’t left a review yet, I’d really appreciate it!
Thanks a lot!

Attention: If you modify the movement settings during a tutorial, please review the update notes carefully.

As part of usability enhancements, settings per tutorial have been introduced. This allows you to configure settings such as flying and player damage in a dedicated interface. This simplifies the management and separates settings from actions.

Conversion:

1. Upon starting the new plugin version for the first time, a backup of the old tutorials.yml will be saved.
2. Settings actions will no longer be accessible or executed.
3. Default values will be used instead: head movement enabled, player movement disabled, flying disabled, damage protection enabled.
4. A warning will be displayed in the console and to admins on the server.
5. Ensure that the settings are configured as required.
6. If you need different settings throughout the tutorial, consider dividing it into smaller, individual tutorials.

Feedback to the new system and suggestions are as always welcome. This update has required significant effort, positive reviews are greatly appreciated.

Update Information

• Version support for Minecraft 1.21.3 and minor GUI improvements.
• If you encounter any issues, please report them on Discord.

A positive plugin review is much appreciated.

Update Information

• Introducing the new main GUI! After studying user behavior and re-evaluating the most important functions, the icons, descriptions and layout of the main tutorial editing GUI have been revised. This allows a more intuitive and easier use.
• A new settings menu has been added to change tutorial settings in one place. In the future, movement settings won't be controlled by actions, but will be configured in this GUI.
• You can now also force the saving of individual tutorials.

Please report any problems on Discord.

Like the update?
A lot of effort went into this update. If you like it, a positive review is very much appreciated!

Join the Discord
Join the community Discord for news, feature votes and support!

Add this to your config.yml messages:
force-saved-tutorial: 'You force-saved the tutorial &e%tutorial%&7.'