twin/paper-mc
1
0
Fork 0
mirror of https://github.com/PaperMC/Paper.git synced 2025-08-07 07:32:03 -07:00
Code Issues Packages Projects Releases Wiki Activity

Expand Explosions API

Browse Source 
Add Entity as a Source capability, and add more API choices, and on Location.

Co-authored-by: Esoteric Enderman <90862990+EsotericEnderman@users.noreply.github.com>
Co-authored-by: Bjarne Koll <git@lynxplay.dev>
This commit is contained in:
Aikar
2017-12-19 16:24:42 -05:00
parent e95376162f
commit 9624ed131b
2 changed files with 182 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

84
paper-api/src/main/java/org/bukkit/Location.java
View File

@@ -7,6 +7,7 @@ import java.util.HashMap;
import java.util.Map;
import org.bukkit.block.Block;
import org.bukkit.configuration.serialization.ConfigurationSerializable;
import org.bukkit.entity.Entity; // Paper
import org.bukkit.util.NumberConversions;
import org.bukkit.util.Vector;
import org.jetbrains.annotations.NotNull;
@@ -569,6 +570,89 @@ public class Location implements Cloneable, ConfigurationSerializable, io.paperm
}
// Paper end - expand Location API
// Paper start - Expand Explosions API
/**
* Creates explosion at this location with given power
* <p>
* Will break blocks and ignite blocks on fire.
*
* @param power The power of explosion, where 4F is TNT
* @return false if explosion was canceled, otherwise true
*/
public boolean createExplosion(float power) {
return this.getWorld().createExplosion(this, power);
}
/**
* Creates explosion at this location with given power and optionally
* setting blocks on fire.
* <p>
* Will break blocks.
*
* @param power The power of explosion, where 4F is TNT
* @param setFire Whether to set blocks on fire
* @return false if explosion was canceled, otherwise true
*/
public boolean createExplosion(float power, boolean setFire) {
return this.getWorld().createExplosion(this, power, setFire);
}
/**
* Creates explosion at this location with given power and optionally
* setting blocks on fire.
*
* @param power The power of explosion, where 4F is TNT
* @param setFire Whether to set blocks on fire
* @param breakBlocks Whether to have blocks be destroyed
* @return false if explosion was canceled, otherwise true
*/
public boolean createExplosion(float power, boolean setFire, boolean breakBlocks) {
return this.getWorld().createExplosion(this, power, setFire, breakBlocks);
}
/**
* Creates explosion at this location with given power, with the specified entity as the source.
* <p>
* Will break blocks and ignite blocks on fire.
*
* @param source The source entity of the explosion
* @param power The power of explosion, where 4F is TNT
* @return false if explosion was canceled, otherwise true
*/
public boolean createExplosion(@Nullable Entity source, float power) {
return this.getWorld().createExplosion(source, this, power, true, true);
}
/**
* Creates explosion at this location with given power and optionally
* setting blocks on fire, with the specified entity as the source.
* <p>
* Will break blocks.
*
* @param source The source entity of the explosion
* @param power The power of explosion, where 4F is TNT
* @param setFire Whether to set blocks on fire
* @return false if explosion was canceled, otherwise true
*/
public boolean createExplosion(@Nullable Entity source, float power, boolean setFire) {
return this.getWorld().createExplosion(source, this, power, setFire, true);
}
/**
* Creates explosion at this location with given power and optionally
* setting blocks on fire, with the specified entity as the source.
*
* @param source The source entity of the explosion
* @param power The power of explosion, where 4F is TNT
* @param setFire Whether to set blocks on fire
* @param breakBlocks Whether to have blocks be destroyed
* @return false if explosion was canceled, otherwise true
*/
public boolean createExplosion(@Nullable Entity source, float power, boolean setFire, boolean breakBlocks) {
return this.getWorld().createExplosion(source, this, power, setFire, breakBlocks);
}
// Paper end - Expand Explosions API
// Paper start - additional getNearbyEntities API
/**
* Returns a list of entities within a bounding box centered around a Location.