Upstream/Paper
1
0
Fork 0
mirror of https://github.com/PaperMC/Paper.git synced 2025-01-01 05:47:45 +01:00
Code Issues Projects Releases Wiki Activity

SPIGOT-7063, #763: Add DragonBattle#initiateRespawn with custom EnderCrystals

Browse Source 
By: Doc <nachito94@msn.com>
This commit is contained in:
Bukkit/Spigot 2023-08-05 09:24:48 +10:00
parent cbeae89133
commit c84d5c6336
1 changed files with 20 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
paper-api/src/main/java/org/bukkit/boss/DragonBattle.java
View File

@ -1,6 +1,8 @@
package org.bukkit.boss; package org.bukkit.boss;
import java.util.Collection;
import org.bukkit.Location; import org.bukkit.Location;
import org.bukkit.entity.EnderCrystal;
import org.bukkit.entity.EnderDragon; import org.bukkit.entity.EnderDragon;
import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable; import org.jetbrains.annotations.Nullable;
@ -12,7 +14,7 @@ public interface DragonBattle {
/** /**
* Get the {@link EnderDragon} active in this battle. * Get the {@link EnderDragon} active in this battle.
* * <br>
* Will return null if the dragon has been slain. * Will return null if the dragon has been slain.
* *
* @return the ender dragon. null if dead * @return the ender dragon. null if dead
@ -30,7 +32,7 @@ public interface DragonBattle {
/** /**
* Get the location of the end portal. * Get the location of the end portal.
* * <br>
* This location will be at the center of the base (bottom) of the portal. * This location will be at the center of the base (bottom) of the portal.
* *
* @return the end portal location or null if not generated * @return the end portal location or null if not generated
@ -41,25 +43,37 @@ public interface DragonBattle {
/** /**
* Generate the end portal. * Generate the end portal.
* *
* @param withPortals whether or not end portal blocks should be generated * @param withPortals whether end portal blocks should be generated
* *
* @return true if generated, false if already present * @return true if generated, false if already present
*/ */
public boolean generateEndPortal(boolean withPortals); public boolean generateEndPortal(boolean withPortals);
/** /**
* Check whether or not the first dragon has been killed already. * Check whether the first dragon has been killed already.
* *
* @return true if killed before, false otherwise * @return true if killed before, false otherwise
*/ */
public boolean hasBeenPreviouslyKilled(); public boolean hasBeenPreviouslyKilled();
/** /**
* Initiate a respawn sequence to summon the dragon as though a player has * Try to initiate a respawn sequence to summon the dragon as though a player has
* placed 4 end crystals on the portal. * placed 4 end crystals on the portal.
*/ */
public void initiateRespawn(); public void initiateRespawn();
/**
* Try to initiate a respawn sequence to summon the dragon.
*
* @param enderCrystals the {@link EnderCrystal EnderCrystals} to use in the
* respawn, or a null or empty list to render the respawn sequence
* uncancellable. null entries or crystals that do not reside in the same
* world as this dragon battle will be ignored.
*
* @return true if the respawn was initiated, false otherwise.
*/
public boolean initiateRespawn(@Nullable Collection<EnderCrystal> enderCrystals);
/** /**
* Get this battle's current respawn phase. * Get this battle's current respawn phase.
* *
@ -70,7 +84,7 @@ public interface DragonBattle {
/** /**
* Set the dragon's respawn phase. * Set the dragon's respawn phase.
* * <br>
* This method will is unsuccessful if a dragon respawn is not in progress. * This method will is unsuccessful if a dragon respawn is not in progress.
* *
* @param phase the phase to set * @param phase the phase to set