Current configurations.

plugins/ServerTutorialPlus/config.yml

@@ -0,0 +1,27 @@
+no permission command: '&cYou do not have permission to execute this command.'
+no permission tutorial: '&cYou do not have enough permissions to play this tutorial.'
+enable first join tutorial: true
+first join tutorial id: intro
+language: English
+npc:
+  # Whether the NPC should be removed if it is not found when starting the plugin.
+  # Best to disable this when using Citizens plugin.
+  remove-invalid: true
+  # The time between the first attempt to scan for NPCs and the second time. (seconds)
+  retry-time: 5
+command-whitelist:
+- w
+- msg
+- help
+- list
+- me
+- kittycannon
+datasource:
+  mysql:
+    # Should we use MySql to store data?
+    # If not: FlatFile option enabled.
+    enabled: false
+    username: root
+    password: root
+    host: localhost
+    database: minecraft

plugins/ServerTutorialPlus/language/English.yml

@@ -0,0 +1,151 @@
+invalid-args: '&cInvalid args! Use /st help for help.'
+no-permissions: '&cYou don''t have permission for that!'
+player-only-command: '&cThis is player only command!'
+'yes': '&a&lYES'
+'no': '&c&lNO'
+add: '&a&lAdd'
+clear: clear
+completed: completed
+uncompleted: uncompleted
+times-played: Times played
+amount-of-points: Amount of points
+permission: Permission
+id: ID
+invisible: Invisible
+time: Time
+seconds: seconds(s)
+chat-messages: Chat messages
+reward-commands: Reward Commands
+npc-type: NPC type
+servertutorial-id: Server tutorial ID
+blocks-commands: Blocks commands
+white-listed-commands: Whitelisted commands
+chat-blocked: Chat Blocked
+none: None
+action-cancelled: '&eAction has been cancelled'
+nothhing-to-cancel: '&cThere is nothing to cancel!'
+player-lookup: '&a&lPlayer Lookup'
+lookup-set-unfinished: '&c[Set unfinished]'
+lookup-set-finished: '&e[Set finished]'
+lookup-set-unfinished-message: '&cClick to set the tutorial to &cunfinished'
+lookup-set-finished-message: '&cClick to set the tutorial to &afinished'
+tutorial-created: '&aSuccessfully created the server tutorial with ID:&e %id%'
+tutorial-removed: '&aSuccessfully removed the server tutorial with ID:&e %id%'
+tutorial-id-not-found: '&cCould not find an server tutorial with that ID.'
+command-apddpoint-commandhint: '&7[&eNotice&7] The user needs to execute the command
+  &e/st next &7to proceed this point.'
+command-hastobe-number: '&cThe index has to be an number'
+command-invalid-index: '&cThat''s not a valid index.'
+command-succesfully-left: '&aSuccessfully left the tutorial.'
+command-quit-notin: '&4You are not in a tutorial.'
+command-setblock-fail: '&cFailed to create the block. Don''t stand too far away from
+  the block you want to set!'
+command-setblock-succes: '&aSuccessfully created a new tutorial block. Block Type:
+  &e%type%&a Server tutorial: &e%id%'
+command-setting-set: '&aSuccessfully set the setting &e%setting%&a for tutorial:&e
+  %id%'
+command-setting-rewards-clear: '&aSuccessfully cleared all reward commands.'
+command-setting-rewards-added: '&aSuccessfully added the command.'
+command-setting-rewards-removed: '&aSuccessfully removed the reward command.'
+command-setting-commands-clear: '&aSuccessfully cleared all whitelisted commands.'
+command-setting-commands-added: '&aSuccessfully added the command to the whitelist.'
+command-setting-commands-removed: '&aSuccessfully removed the whitelisted command.'
+command-switch-successful: Successfully switched the points %1% and %2%
+command-move-successful: Successfully moved the point %1% in front off %2%
+command-argument-available: '&aAvailable arguments: &7%args%'
+command-editall-canbe: '&eArguments that can be mass edited: &7%args%'
+command-editall-succes: '&aSuccessfully edited all points'
+command-lookup-define-player: '&ePlease define a player to check. &7/st player <name>'
+command-lookup-uuid-error: '&cUnable to get the UUID of the targed player. Are you
+  sure he/she has played on this server before?'
+command-lookup-never-played: '&cThat player has never joined the server.'
+command-lookup-set: '&aSuccessfully set the tutorial to completed.'
+command-lookup-unset: '&cSuccessfully set the tutorial to incompleted.'
+command-lookup-set-error: '&cPlayer has already completed this tutorial.'
+command-lookup-unset-error: '&cPlayer has not yet completed this tutorial.'
+event-block-remove: '&cYou do not have permission to remove this tutorial block.'
+event-block-removed: '&aSuccessfully removed the tutorial block!'
+reload-stoptutorial: '&cYour tutorial has been cancelled because the plugin has been
+  reloaded.'
+reload-succes: '&aSuccessfully reloaded the plugin.'
+potion-effect-time: '&ePotion time: &7%ticks%&e ticks - &7%seconds%&e seconds (20
+  ticks = 1 second)'
+potion-effect-notime: '&eNo time was giving. Using the point time instead.'
+potion-effect-amplifier: 'Potion amplifier: %amp%'
+potion-effect-wrong-usage-1: '&cWrong usage. Hold a potion in your hand and use this
+  command: &7/st edit <id> <point> add potion <time> <level>'
+potion-effect-wrong-usage-2: '&cOr use this command: &7/st edit <id> <point> add potion
+  <potioneffect> <time (s)> <level>'
+firework-remove-info: '&eThis commands removes the nearest firework. No need for more
+  arguments.'
+firework-remove-failed: '&cCould not find a firework in a range of 1000 blocks.'
+firework-add-wrongusage: '&cWrong usage. Hold a firework in your hand.'
+current-time: 'Current time: %time%'
+title-notitle-set: '&cThis point does not have a title yet. Please set one before
+  setting timings.'
+title-current: '&eThe current &a%type%&e time is: &a%ticks%&e ticks.'
+setting-edited: '&aSuccessfully edited the setting: &e%setting%'
+save-succes: '&aSuccessfully saved all the tutorials and blocks.'
+point-removed: '&aSuccessfully removed the point&e %id%'
+point-invalid-type: '&cInvalid point type!'
+point-example-command-click: '&eClick to show the &a%type%&e point command'
+point-example-message: '&eClick one of the following options to show the correct command: '
+point-added: '&aSuccessfully added the new point.'
+info-none-existing: '&eThere do not exist any server tutorials at the moment.'
+info-more-info: '&7&iUse /st info <id> to get more info.'
+npc-id-exists: '&cThere already exists an NPC with that ID!'
+npc-tested-mobs: '&eTested mobs: &7'
+npc-wrong-type: '&cInvalid entity type. ''&e%type%&c'' (Does not exist)'
+npc-living-type: '&cEntity has to be a living type!'
+npc-creation-success: 'Successfully created a NPC with NPC ID: &e%id%&a that plays
+  server tutorial: &e%tutorial%'
+npc-selection-cancelled: '&cSelecting an NPC has been cancelled.'
+npc-selection-message: '&eRight click an NPC to select it. &7(or use the command again
+  to exit selection mode'
+npc-id-not-existing: '&cThere does not exist a NPC with ID: &e%id%'
+npc-removed-succes: '&aSuccessfully removed the NCP!'
+npc-text-change: '&aSuccessfully changed the text!'
+npc-height-change: '&aSuccessfully changed the height!'
+npc-player-selected: '&cTo prevent errors, you cannot select a player as NPC!'
+npc-invalid-entity: '&cThe entity you tried to bind is not supported.'
+npc-info-none: '&eNo NPCs have been made yet!'
+npc-info-more-info: '&7&iUse /st npc info <id> to get more info.'
+help-help: Shows this helpful help.
+help-create: Create a new server tutorial.
+help-remove: Remove a server tutorial.
+help-addpoint: Add a point to a server tutorial.
+help-removepoint: Remove a point from a server tutorial
+help-edit: Edit settings of a servertutorial.
+help-editpoint: Edit a servertutorial point.
+help-editall: Edit all servertutorial point of a tutorial.
+help-info: Show info about a server tutorial.
+help-player: Shows info about the player
+help-gui: Opens a helpful GUI.
+help-play: Play a server tutorial.
+help-quit: Quit a server tutorial.
+help-playpoint: Play only 1 point of a server tutorial.
+help-setblock: Set a block that can be right clicked to start.
+help-npc: Spawn an NPC that can be right clicked to start.
+help-reload: Save current data to the configs.
+error-wait-to-end: '&cPlease wait for the current point to end!'
+error-player-offline: '&cThat player is currently not online!'
+error-person-in-tutorial: '&cThat person is already in a tutorial!'
+error-wait-to-end-tutorial: '&cPlease wait for the current tutorial to end before
+  starting a new one.'
+error-atleast-one-word: '&cYou need to enter a minimal of one word to add.'
+error-no-index: '&cPlease define a valid index.'
+error-notexisting-index: '&cThat index does not exist.'
+error-invalid-point: '&cPlease define a valid tutorial point.'
+error-editall: '&cFailed to set setting. Stopped editing the points.'
+error-invalid-number: '&cInvalid number.'
+error-failed-finding-tutorial: Failed to find server tutorial...
+error-failed-finding-tutorial-admin: '&cCould not find a server tutorial with the
+  id &e%id%&c. Please contact the server administrator.'
+error-invalid-effect: '&cInvalid potion effect.'
+error-invalid-time: '&cThat is not a valid time. (Time is in seconds)'
+error-invalid-amplifier: That is not a valid amplifier.
+error-command-blocked: '&cThat command has been blocked during the tutorial.'
+tip-editpoint: '&7[&aTIP&7] If you want to edit an point, use /st editpoint'
+wrong-command-format: '&cWrong arguments, please use the command like this: &7'
+unkown-argument: '&cUnknown arg. Possible args: &7'
+player-not-found: '&cUnable to find that player on this server.'

plugins/ServerTutorialPlus/tutorialsaves.yml

@@ -0,0 +1,115 @@
+tutorials:
+  intro:
+    stats:
+      plays: 24
+    invisible: false
+    permission: false
+    block-chat: false
+    blocks-commands: false
+    rewards: []
+    command-whitelist: []
+    points:
+      '0':
+        type: CHECKPOINT
+        location: world -71.46958093753142 173.0 -249.54917965215213 0.40734863 -1.3500156
+        time: 2.0
+        locplayer: false
+        locview: false
+        messages:
+        - This server has a few "&6lifestyle improvement&f" changes.
+        - Namely, &6graves, protection stones, tree felling and rare hostiles&f have
+          been added.
+        - Some of these changes introduce &6new crafting recipes&f!
+        - Go ahead and &awalk downstairs to the blue circle&f to collect some useful
+          resources and learn more.
+        commands:
+        - rg removemember -w "world" spawngatea {player_name}
+        - rg removemember -w "world" spawngateb {player_name}
+        title:
+          title: '&bWelcome {player_name}!'
+          subtitle: to Reslate Entertainment Minecraft Server!
+          fade-in: 20
+          stay: 40
+          fade-out: 20
+        animation: CIRCLE
+        colour: 244 153 0
+        distance: 1.0
+        repeatActionbar: true
+        drawguide: false
+        guidecolour: 244 244 244
+      '1':
+        type: CLICK_BLOCK
+        location: world -66.02339295638282 173.0 -251.12955773506133 -98.74217 5.700019
+        time: 2.0
+        locplayer: false
+        locview: false
+        messages:
+        - You'll want to &6grab a completed recipe book from the bookshelf&f.
+        actionbar: '&aright click&f on the &6highlighted bookshelf&f!'
+        commands: []
+        blocklocation: world -63.0 174.0 -252.0 0.0 0.0
+        particles: true
+        colour: 125 255 0
+        teleport: false
+      '2':
+        type: CLICK_BLOCK
+        location: world -67.02593065614552 173.0 -253.36556869704876 91.00787 9.600019
+        time: 2.0
+        locplayer: false
+        locview: false
+        messages:
+        - And like that, you've got &6all the recipes unlocked&f!
+        - Remember to &ause a crafting table&f to see all the larger recipes!
+        - Now, go open the &6highlighted chest&f!
+        actionbar: '&aright click&f on the &6highlighted chest&f!'
+        commands:
+        - recipe give {player_name} *
+        blocklocation: world -72.0 173.0 -254.0 0.0 0.0
+        particles: true
+        colour: 125 255 0
+        teleport: false
+      '3':
+        type: CHECKPOINT
+        location: world -66.53817412071187 173.0 -251.47260306607436 -179.88847 4.500104
+        time: 2.0
+        locplayer: false
+        locview: false
+        messages:
+        - '&6Emeralds&f are the designated &6currency&f. You now have &61&f of them!
+          You can always check your balance via &a/money&f. Also, &6create vaults&f
+          by &aplacing a sign with &9[vault]&a on containers&f!'
+        - Previously, I mentioned &6protection stones&f. You can use &a/ps&f to check
+          out the commands for these.
+        - Graves only work if you have a &6grave token&f. Feel free to look up the
+          recipe in your (now complete) recipe book.
+        - Trees can be felled by sneaking and &ausing any axe&f. Checkout &a/sm&f
+          for commands.
+        - Lastly, you may come across &6infernal hostiles&f. These hostiles are much
+          stronger, but also drop much better items.
+        commands:
+        - give {player_name} minecraft:emerald 1
+        animation: CIRCLE
+        colour: 244 153 0
+        distance: 1.5
+        repeatActionbar: true
+        drawguide: false
+        guidecolour: 244 244 244
+      '4':
+        type: CHECKPOINT
+        location: world -66.99725178455203 173.0 -254.3114881993384 -179.88847 4.500104
+        time: 2.0
+        locplayer: false
+        locview: false
+        messages:
+        - You are ready to start you're adventure!
+        - Remember to checkout &amc.ent.reslate.xyz&f in a browser!
+        - '&aJump down&f into the &6water&f whenever you''re ready.'
+        commands:
+        - rg addmember -w "world" spawngatea {player_name}
+        - rg addmember -w "world" spawngateb {player_name}
+        animation: CIRCLE
+        colour: 244 153 0
+        distance: 1.5
+        repeatActionbar: true
+        drawguide: false
+        guidecolour: 244 244 244