Version 1.3.0

.github/.gitignore

@@ -0,0 +1 @@
+/.DS_Store

README.md

@@ -19,11 +19,10 @@ The Parkour addon is a BentoBox addon for Minecraft that allows players to creat
 To get started, use the `/pk` or `/parkour` command to access the parkour plugin. This will teleport players to an example parkour course and get them started. Admins can use blueprints to change the default course example or make additional ones.
 
 ### Course Creation
-1. Enter creative mode. Players will need permission to do this.
-2. Use creative mode tools to design your parkour course.
-3. Place gold pressure plates at the start and end points of the course.
-4. Optionally, add checkpoints throughout the course using blackstone pressure plates.
-5. Test your course to ensure it is playable and challenging.
+1. Use creative mode tools to design your parkour course.
+2. Place gold pressure plates at the start and end points of the course.
+3. Optionally, add checkpoints throughout the course using blackstone pressure plates.
+4. Test your course to ensure it is playable and challenging.
 
 ### Course Gameplay
 1. Locate the course you want to play using the `/pk courses` command, or play your own.
@@ -35,16 +34,16 @@ To get started, use the `/pk` or `/parkour` command to access the parkour plugin
 ### Team Collaboration
 1. Form a team with other players using the team creation commands `pk team invite <player name>`.
 2. Collaborate with your team members to design and build parkour courses.
-3. When you want to make your course available go to the starting area and set a warp point for visitors using `/pk setwarp`
+3. When you want to make your course available go to the starting area and set a warp point for visitors using `/pk setwarp` or place a **warped pressure plate** where you want visitors to arrive
 4. Use the `/pk courses` command to view and play each other's courses.
 5. Compete within the team to achieve the best times on the courses.
 
 ## Commands
 - `/pk`: Main command to start a parkour course and teleport to the parkour world.
 - `/pk courses`: List all the tracks or courses available and teleport to them.
 - `/pk top`: Show the Top Ten.
-- `/pk setwarp`: Places the course in the courses menu and sets the warp position visitors will arrive at
-- `/pk removewarp`: Makes the course private and removes the visitor's warp
+- `/pk setwarp`: Places the course in the courses menu and sets the warp position visitors will arrive at. This can also be done by placing a **warped pressure plate**
+- `/pk removewarp`: Makes the course private and removes the visitor's warp. Or break the **warped pressure plate** if there is one.
 
 ## Permissions
 

pom.xml

@@ -68,7 +68,7 @@
         <!-- Do not change unless you want different name for local builds. -->
         <build.number>-LOCAL</build.number>
         <!-- This allows to change between versions. -->
-        <build.version>1.2.0</build.version>
+        <build.version>1.3.0</build.version>
         <sonar.organization>bentobox-world</sonar.organization>
         <sonar.host.url>https://sonarcloud.io</sonar.host.url>
     </properties>

src/main/java/world/bentobox/parkour/Parkour.java

@@ -1,5 +1,8 @@
 package world.bentobox.parkour;
 
+import java.util.HashMap;
+
+import org.bukkit.Material;
 import org.bukkit.World;
 import org.bukkit.World.Environment;
 import org.bukkit.WorldCreator;
@@ -14,18 +17,24 @@
 import world.bentobox.bentobox.api.commands.island.DefaultPlayerCommand;
 import world.bentobox.bentobox.api.configuration.Config;
 import world.bentobox.bentobox.api.configuration.WorldSettings;
+import world.bentobox.bentobox.api.flags.Flag;
+import world.bentobox.bentobox.api.flags.clicklisteners.CycleClick;
+import world.bentobox.bentobox.managers.RanksManager;
 import world.bentobox.parkour.commands.ClearTopCommand;
 import world.bentobox.parkour.commands.CoursesCommand;
+import world.bentobox.parkour.commands.QuitCommand;
 import world.bentobox.parkour.commands.RemoveWarpCommand;
 import world.bentobox.parkour.commands.SetWarpCommand;
 import world.bentobox.parkour.commands.TopCommand;
+import world.bentobox.parkour.commands.WarpCommand;
 import world.bentobox.parkour.generators.ChunkGeneratorWorld;
 import world.bentobox.parkour.gui.RankingsUI;
 import world.bentobox.parkour.listeners.CourseRunnerListener;
 import world.bentobox.parkour.listeners.MakeCourseListener;
 
 /**
  * Main Parkour class
+ *
  * @author tastybento
  */
 public class Parkour extends GameModeAddon implements Listener {
@@ -42,6 +51,20 @@ public class Parkour extends GameModeAddon implements Listener {
     private ParkourManager pm;
     private RankingsUI rankings;
 
+    /**
+     * Parkour flag that sets which ranks should enter creative mode at the end of the course and
+     * when entering the island. Visitors never have creative enabled.
+     */
+    public final Flag CREATIVE_FLAG = new Flag.Builder("PARKOUR_CREATIVE", Material.LIGHT)
+            .addon(this)
+            .type(Flag.Type.PROTECTION)
+            .defaultRank(RanksManager.MEMBER_RANK)
+            .setGameMode(this)
+            .clickHandler(new CycleClick("PARKOUR_CREATIVE", RanksManager.COOP_RANK, RanksManager.OWNER_RANK)) // exclude visitor
+            .build();
+
+    private ParkourRunRecord parkourRunManager;
+
     @Override
     public void onLoad() {
         // Save the default config from config.yml
@@ -51,26 +74,31 @@ public void onLoad() {
         // Chunk generator
         chunkGenerator = settings.isUseOwnGenerator() ? null : new ChunkGeneratorWorld(this);
         // Register commands
-        playerCommand = new DefaultPlayerCommand(this)
-
-        {
+        playerCommand = new DefaultPlayerCommand(this) {
             @Override
-            public void setup()
-            {
+            public void setup() {
                 super.setup();
                 new TopCommand(this);
                 new CoursesCommand(this);
                 new SetWarpCommand(this);
+                new WarpCommand(this);
                 new RemoveWarpCommand(this);
                 new ClearTopCommand(this);
+                new QuitCommand(this);
             }
         };
 
-        adminCommand = new DefaultAdminCommand(this) {};
+        adminCommand = new DefaultAdminCommand(this) {
+        };
+
+        parkourRunManager = new ParkourRunRecord(new HashMap<>(), new HashMap<>());
+
+        registerFlag(CREATIVE_FLAG);
 
         // Register listeners
         this.registerListener(new MakeCourseListener(this));
         this.registerListener(new CourseRunnerListener(this));
+
     }
 
     private boolean loadSettings() {
@@ -141,8 +169,9 @@ public void createWorlds() {
 
     /**
      * Gets a world or generates a new world if it does not exist
-     * @param worldName2 - the overworld name
-     * @param env - the environment
+     *
+     * @param worldName2      - the overworld name
+     * @param env             - the environment
      * @param chunkGenerator2 - the chunk generator. If <tt>null</tt> then the generator will not be specified
      * @return world loaded or generated
      */
@@ -212,7 +241,7 @@ public void allLoaded() {
     /**
      * @return the pm
      */
-    public ParkourManager getPm() {
+    public ParkourManager getParkourManager() {
         return pm;
     }
 
@@ -223,4 +252,9 @@ public RankingsUI getRankings() {
         return rankings;
     }
 
+    public ParkourRunRecord getParkourRunManager() {
+        return parkourRunManager;
+    }
+
+
 }

src/main/java/world/bentobox/parkour/ParkourManager.java

@@ -2,6 +2,7 @@
 
 import java.util.Collection;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.Map;
 import java.util.Map.Entry;
@@ -26,12 +27,14 @@ public class ParkourManager {
      * A cache of high scores. Key is island UUID
      */
     private final Map<String, ParkourData> cache;
+    private Parkour addon;
 
     /**
      * Handles storing a retrieval of score data for islands
      * @param addon Parkour addon
      */
     public ParkourManager(Parkour addon) {
+        this.addon = addon;
         // Get the BentoBox database
         // Set up the database handler to store and retrieve data
         // Note that these are saved by the BentoBox database
@@ -43,6 +46,9 @@ public ParkourManager(Parkour addon) {
     }
 
     private ParkourData getIsland(Island island) {
+        if (!addon.inWorld(island.getWorld())) {
+            throw new IllegalArgumentException("Island is not in Parkour world: " + island.getWorld());
+        }
         return cache.computeIfAbsent(island.getUniqueId(), k -> getFromDb(island));
     }
 
@@ -168,4 +174,21 @@ public void setWarpSpot(Island island, Location location) {
         // Save every time right now
         saveIsland(island);
     }
+
+    /**
+     * Get a map of warps to courses
+     * @return map with the key being the name of the island owner and value being the warp location
+     */
+    public Map<String, Location> getWarps() {
+        Map<String, Location> map = new HashMap<>();
+        for (ParkourData pd : getParkourData()) {
+            if (pd.getWarpSpot() == null) continue;
+            UUID owner = addon.getIslands().getIslandById(pd.getUniqueId()).map(Island::getOwner).orElse(null);
+            if (owner != null) {
+                String name = addon.getPlayers().getName(owner);
+                map.put(name, pd.getWarpSpot());
+            }
+        }
+        return map;
+    }
 }

src/main/java/world/bentobox/parkour/ParkourRunRecord.java

@@ -0,0 +1,18 @@
+package world.bentobox.parkour;
+
+import java.util.Map;
+import java.util.UUID;
+
+import org.bukkit.Location;
+
+public record ParkourRunRecord(Map<UUID, Location> checkpoints, Map<UUID, Long> timers) {
+    /**
+     * Clears any current times or checkpoints
+     * @param uuid UUID of runner
+     */
+    public void clear(UUID uuid) {
+        checkpoints.remove(uuid);
+        timers.remove(uuid);
+    }
+
+}

src/main/java/world/bentobox/parkour/Settings.java

@@ -229,6 +229,12 @@ public class Settings implements WorldSettings {
     @ConfigEntry(path = "world.hidden-flags")
     private List<String> hiddenFlags = new ArrayList<>();
 
+    @ConfigComment("Allowed commands when running a parkour course - all others are banned")
+    @ConfigComment("Matched by prefix of command, including '/' - if config is '/parkour home',")
+    @ConfigComment("'/parkour home abc' is allowed, while '/parkour sethome' is not")
+    @ConfigEntry(path = "world.parkour-allowed-commands")
+    private List<String> parkourAllowedCommands = new ArrayList<>();
+
     @ConfigComment("Visitor banned commands - Visitors to areas cannot use these commands in this world")
     @ConfigEntry(path = "world.visitor-banned-commands")
     private List<String> visitorBannedCommands = new ArrayList<>();
@@ -683,6 +689,15 @@ public List<String> getHiddenFlags() {
         return hiddenFlags;
     }
 
+    /**
+     * @return the parkourAllowedCommands
+     */
+    public List<String> getParkourAllowedCommands() {
+        return parkourAllowedCommands;
+    }
+
+
+
     /**
      * @return the visitorBannedCommands
      */
@@ -1087,6 +1102,15 @@ public void setHiddenFlags(List<String> hiddenFlags) {
         this.hiddenFlags = hiddenFlags;
     }
 
+    /**
+     * @param parkourAllowedCommands the parkourAllowedCommands to set
+     */
+    public void setParkourAllowedCommands(List<String> parkourAllowedCommands) {
+        this.parkourAllowedCommands = parkourAllowedCommands;
+    }
+
+
+
     /**
      * @param visitorBannedCommands the visitorBannedCommands to set
      */

src/main/java/world/bentobox/parkour/commands/ClearTopCommand.java

@@ -38,10 +38,10 @@ public ClearTopCommand(CompositeCommand parent) {
 
     @Override
     public void setup() {
-        this.setPermission("parkour.cleartop");
+        this.setPermission("cleartop");
         setOnlyPlayer(true);
         setDescription("parkour.commands.parkour.cleartop.description");
-        this.setParametersHelp(".commands.parkour.cleartop.parameters");
+        this.setParametersHelp("parkour.commands.parkour.cleartop.parameters");
         setConfigurableRankCommand();
         this.setDefaultCommandRank(RanksManager.OWNER_RANK);
         addon = getAddon();
@@ -78,16 +78,16 @@ public boolean canExecute(User user, String label, List<String> args) {
 
     @Override
     public boolean execute(User user, String label, List<String> args) {
-        this.askConfirmation(user, () -> confirmed(user, label, args));
+        this.askConfirmation(user, () -> confirmed(user));
         return true;
     }
 
-    void confirmed(User user, String label, List<String> args) {
+    void confirmed(User user) {
         Island island = getIslands().getIsland(getWorld(), user);
         if (island != null && targetUUID == null) {
-            addon.getPm().clearScores(island);
+            addon.getParkourManager().clearScores(island);
         } else if (island != null && targetUUID != null) {
-            addon.getPm().removeScore(island, User.getInstance(targetUUID));
+            addon.getParkourManager().removeScore(island, User.getInstance(targetUUID));
         } else {
             user.sendMessage("general.errors.no-island");
             return;
@@ -98,7 +98,8 @@ void confirmed(User user, String label, List<String> args) {
     @Override
     public Optional<List<String>> tabComplete(User user, String label, List<String> args) {
         Island island = getIslands().getIsland(getWorld(), user);
-        return Optional.of(addon.getPm().getRankings(island, 10).keySet().stream().map(getAddon().getPlayers()::getName)
+        if (island == null) return Optional.empty();
+        return Optional.of(addon.getParkourManager().getRankings(island, 10).keySet().stream().map(getAddon().getPlayers()::getName)
                 .filter(name -> !name.isBlank()).toList());
     }
 

src/main/java/world/bentobox/parkour/commands/CoursesCommand.java

@@ -7,6 +7,11 @@
 import world.bentobox.bentobox.api.user.User;
 import world.bentobox.parkour.gui.CoursesTab;
 
+/**
+ * Shows what courses are available
+ * @author tastybento
+ *
+ */
 public class CoursesCommand extends CompositeCommand {
 
     public CoursesCommand(CompositeCommand parent) {
@@ -15,7 +20,7 @@ public CoursesCommand(CompositeCommand parent) {
 
     @Override
     public void setup() {
-        this.setPermission("parkour.courses");
+        this.setPermission("courses");
         setOnlyPlayer(true);
         setDescription("parkour.commands.parkour.courses.description");
     }