Ice Boat Racing

# Finnick4's Ice Boat Racing This datapack enables server administrators to create an ice boat racing event for their SMP (or other server), allowing checkpoints, highscores, seasonal leaderboards and more! It must however be set up by someone with op. ## Features - Easily setup your track for this datapack - Unaffected vanilla gameplay - Ensure players follow the correct path on your track - Prevention of players leaving the boat - Use the built in timer with 2 decimal point accuracy automaticly - Keep track of everyones highscore - Prevent players getting stuck in water - View everyone's highscore in a panel - Lag efficient design - Seasonal leaderboard - Built in advancements (that don't affect vanilla behaviour) ## How to use the datapack First anyone with OP has to set this datapack up. See heading setup for this! ### Playing the race To start a race, head towards the start of the race, seat yourself in a boat and hit the text of the starting checkpoint. Row over the start line and the timer begins. Follow the track by getting checkpoints *(pro tip: the next checkpoint is highlighted with golden particles)*. Once you get a new checkpoint, you will be notified about your current time and the checkpoint is saved. If you finish the race (get the final checkpoint) your time is saved. If you achieved a new personal best, you will also be notified about that. The difference is directly calculated and told to you. ### Edgecases If you... - activate a checkpoint that you already have or isn't chronologically next, you will be returned to your last valid checkpoint. - get stuck in water you will get returned to your last checkpoint as well - leave the boat at any time for whatever reason, the race is canceled for you. You have to go back to the start and begin anew. <details> <summary>Player panel</summary> ### Player panel To interact with the datapack, every player has a panel under `/trigger iceboat`. Here they can... - **View** *(their)* **stats**: See how many races you have started, finished, what your personal all-time and seasonal record is and many more pieces of information in regards to their ice boating career. - **Show PBs**: See the personal bests of everyone online. The leaderboard only allows for 5 people to be mentioned. Maybe you want to know the time of someone specific that is online. - **Show leaderboard**: See the leaderboard. Get the top 5 all-time times with whoever got them. Each player can only have one entry and only the best time is displayed here! - **Show seasonal leaderboard**: A feature of this datapack are the possibility for seasons, in which you have a new leaderboard independent of the all-time leaderboard. You may have achieved a time of 45 seconds in season 1, making this your PB, however to have this time displayed on the seasonal leaderboard of season 2, you have to achieve it again. If you can only manage 50 seconds, this will be your seasonal time. - **Start race**: If you do not want to hit the start every time, you can use this option. If you only want to type in one command, use `/trigger iceboat set 105`! - **View credits**: Lets everyone view the credits and who made the datapack. Includes a link to the official (https://modrinth.com/datapack/f4boats) and (https://github.com/Finnick4/f4boats/) of this project! </details> <details> <summary>Admin panel</summary> ### Admin panel To ease with setting the datapack up and managing it, there exists an admin panel. To access it, type `/function finnick4:f4boats/admin-panel` Here are the uses for all options mentioned there: - **Initiate new season**: Immediately end the current season and start a new season. This means the seasonal record of everyone and the seasonal leaderboard is reset. Also applies to offline players. - **View global statistics**: View the global stats of the server. Adds everything except times from the player menu from each player. Also works when some people are offline. - **Set highscore**: If you need to overwrite a highscore, use the given command that is then given to you. Change the name of the player in `execute as PLAYERNAME` and set the duration of the new PB in `{d:NEWLENGTH}`. This length is in ticks. To convert seconds to ticks, multiply the number of seconds by 20. - **Create new checkpoint**: Used for the setup process of a track. View the section for setup for this. - **Find help**: When in need for help, use this command to get a link to the official (https://modrinth.com/datapack/f4boats), (https://github.com/Finnick4/f4boats/) and official Discord server to ask for help. - **Remove all checkpoints**: Using this kills every loaded checkpoint entity. To complete a clean uninstall, use this. See section uninstalling for more. Also useful for when you messed up whilest spawning checkpoints. You have to manually load every chunk that contains an checkpoint entity to remove them! - **Datapack Uninstall**: Removes ev