JumpAndRun 1.18.X [ENG/GER]

First of all: Sorry if there are any spelling mistakes. I am from Germany and my English is not perfect. Please write me a message for any mistakes you find. Thank you!

If you don't want to read all this, just download the plugin and use it. It's self explanatory. But here you can find more information about the plugin, it's features and how to setup it correctly. Have fun! :)

Tutorial Video:
coming soon... (please write me, if you want to make a review/tutorial of this plugin (in English). Than I will insert your video here)

Features:

language changeable with just one command (/jnr language <english/germand>)

create as many maps as you want

unlimited checkpoints

customizable ingame Items (back to last checkpoint, hide/show players, quit)

timer (displayed in ActionBar, at every checkpoint)

stats (global record time for every map, personal record time, etc.)
Join-Signs to join a JumpAndRun

Join-Sign 's to join a JumpAndRun

inventory saving system (so the player will not lose his items, if he left the server while ingame)

all messages are editable

ActionBar live timer

Admin-Commands (Permission: jnr.admin):

/jnr - shows all (Admin-)commands
/jnr create <Name> - Creates a new JumpAndRun
/jnr setspawn <Name> - Sets the spawn-point for a JumpAndRun
/jnr setblock <Checkpoint/Win> - Sets the Win/Checkpoint-Block
/jnr setcp <Name> <Checkpoint> - Sets a checkpoint for a JumpAndRun

The next Admin-Commands are optional:

/jnr setleave <Name> - Sets the leave-point for a JumpAndRun
/jnr allcpstowin <true/false> - Determines if you need all checkpoints to complete a JumpAndRun or not
/jnr item <checkpoint/hide/unhide/quit> - Sets the JumpAndRun-Items (Back to last checkpoint, Hide players, Show players, Quit)
/jnr language <english/german> - Sets the language to english/german (if you execute this command, all players will be kicked out of the JumpAndRun)
/jnr reload - Reloads the configs of the plugin
/jnr resetall <Player> - Resets all stats of a player
/jnr reset <Player> <Map> - Resets the map-stats of a player

Player-Commands (no permission needed):

/jnr stats <Map> - Shows your stats
/jnr stats <Player> <Map> - Shows the stats of a player
/jnr join <Map> - Join a JumpAndRun

Join-Signs:
Optional to the "/jnr join"-Command, you can place Join-Signs.
How to create a Join-Sign:

1. Line: [jnr]
2. Line: Name of the map
The 3. and 4. line will not change, so you can write what you want in this lines or you can leave it blank

Editable messages:
Since version 3.0 all messages are editable. You can edit all messages in the "messages.yml" file.

Explanation of the placeholders:

& x - Formatting code (e.g. textcolor), valid codes are: a-f, 0-9, k, l, m, n, o, r. Example: "&a" for a green text. Here you can find a detailed description of all Minecraft formatting oncodes: https://minecraft.gamepedia.com/Formatting_codes
%map% - Name of the JumpAndRun map, the player is playing
%time% - The current time of the JumpAndRun timer
%checkpoint% - current checkpoint
%player% - player name (displayname)

Important! You can't use every placeholder at every message. In the default "messages.yml" you can find all valid placeholde at every message, which you can use for this message.
If that was to complicated, just test what you want and if it won't work delete the "messages.yml" and reload the server and there will be a new "messages.yml" which works.

Preview of the messages.yml:

# Write an 'x' instead of an message to disable the message.
# If you want to disable a Title message, just leave the fields ('1' and '2') blank, so the title will not be displayed to the player anymore.
# At 'Messages.Win.Stats' you can write as many messages as you want (you must only keep the format, so for every message you need a new line which starts with '-').
Prefix: '&7[&6JumpAndRun&7] '
Item:
  BackToLastCheckpoint:
    Name: '&cBack to last checkpoint'
  HidePlayers:
    Name: '&cHide players'
  ShowPlayers:
    Name: '&aShow players'
  Quit:
    Name: '&cQuit'
Messages:
  JoinSign:
    '1': '&0- &6JumpAndRun &0-'
  JoinTitle:
    '1': '%map%'
    '2': ''
  AlreadyInAJumpAndRun: '&cYou are already in a JumpAndRun! (%map%)'
  JoinCooldown: '&cPlease wait before you can play the next JumpAndRun.'
  ActionBar: '&a%map%: ยง6%time% &r&7| &aFails: &c&l%fails%'
  NoCommandsWhileInGame: '&cYou can not execute commands during JumpAndRun.'
  NoRealoadsWhileGameRunning: '&cPlease do not reload while players are in a JumpAndRun!'
  ItemCooldown: '&cPlease wait before you can use that item again.'
  CheckpointReached:
    Time: '&7Your time: &6&l%time%'
    Title:
      '1': ''
      '2': '&aCheckpoint #%checkpoint% reached!'
  NotAllCheckpoints: '&cYou need all checkpoint to finish this JumpAndRun! Go back
    to the last checkpoint.'
  Win:
    Title:
      '1': '&aCongratulations!'
      '2': '&6%map% completed.'
    Stats:
    - '&8==============='
    - ''
    - '&aMap&7: &6%map%'
    - '&aTime&7: %time%'
    - '&aFails&7: &6%fails%'
    - ''
    - '&8==============='
  NewPersonalRecord:
    Title:
      '1': '&a&lNew personal record!'
      '2': 'Map: %map%'
  NewGlobalRecord:
    Title:
      '1': '&a&lNew global record!'
      '2': 'Map: %map%'
    Broadcast: '&a%player% &6sets a new record &7(&a%time%&7) &6on the map &a%map%&6!'
  Command:
    Stats:
      Player:
      - '&8======&6JumpAndRun&8======'
      - ''
      - '&7JumpAndRun: &6%map%'
      - '&7Started JumpAndRuns: &6%playedTimes%'
      - '&7Completed JumpAndRuns: &6%finishedTimes%'
      - '&7Fails: &6%fails%'
      - '&7Record time: &6%recordTime%'
      - '&7Global record time: &6%globalRecordTime%'
      - ''
      - '&8=====&9Stats of &c%player%&8====='
      NoRecord: '&6You have no record on this map yet.'
      NoGlobalRecord: '&6There is no record for this map.'

The config:
There are a few things in the "config.yml" file, which you can edit/change.

Here is a short explanation of the editable things:

Language - Sets the language (english/german) - Default: english
EnableReloadWhilePlayerInGame - Enables the "/reload"-command while players are in a JumpAndRun ( not recommended). - Default: 'false'
EnableCommandsWhileInGame - Allows players to use commands while ingame. Notice that they could teleport theirself, with a "/warp"- or "/spawn"-command (if available), out of the JumpAndRun without leaving the JumpAndRun. - Default: 'false'
EnableJoinCommand - De-/Activates the "/jnr join <Map>"-command. If you change this to 'false', players can only join JumpAndRuns through JoinSigns. - Default: 'true'
EnableFallDamage - If 'true', falldamage is enabled - Default: 'false'
NeedAllCheckpointsToWin - (look at the "/jnr allcpstowin <true/false>"-command) - Default: 'true'

You can only use "true" to activate the feature or "false" to deactivate the feature (except of "Language"). Otherwise there will be an error and the plugin won't work.

# Attention! If you set 'EnableReloadWhilePlayerInGame' to 'true' (NOT recommended!) and you use the reload-command while players are in a JumpAndRun,
# the players can no longer use the JumpAndRun-Items and must rejoin to get their old inventory contents back.
#
# Notice that if you set 'EnableCommandsWhileInGame' to 'true',
# the players can teleport theirself, with a warp- or spawn-command (if available), out of the JumpAndRun although they are still in the JumpAndRun-Mode with the JumpAndRun-Items.
Language: english
EnableReloadWhilePlayerInGame: false
EnableCommandsWhileInGame: false
EnableFallDamage: false
EnableJoinCommand: true
NeedAllCheckpointsToWin: true