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

SPIGOT-4193: API for selecting entities by strings

Browse Source 
By: md_5 <git@md-5.net>
This commit is contained in:
Bukkit/Spigot 2019-01-31 15:08:12 +11:00
parent ae3cc2807b
commit 33fd2ea254
2 changed files with 50 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1384,6 +1384,32 @@ public final class Bukkit {
return server.getLootTable(key);
}
/**
* Selects entities using the given Vanilla selector.
* <br>
* No guarantees are made about the selector format, other than they match
* the Vanilla format for the active Minecraft version.
* <br>
* Usually a selector will start with '@', unless selecting a Player in
* which case it may simply be the Player's name or UUID.
* <br>
* Note that in Vanilla, elevated permissions are usually required to use
* '@' selectors, but this method should not check such permissions from the
* sender.
*
* @param sender the sender to execute as, must be provided
* @param selector the selection string
* @return a list of the selected entities. The list will not be null, but
* no further guarantees are made.
* @throws IllegalArgumentException if the selector is malformed in any way
* or a parameter is null
* @deprecated draft API
*/
@Deprecated
public static List<Entity> selectEntities(CommandSender sender, String selector) throws IllegalArgumentException {
return server.selectEntities(sender, selector);
}
/**
* @see UnsafeValues
* @return the unsafe values instance

24
paper-api/src/main/java/org/bukkit/Server.java
View File

@ -1153,6 +1153,30 @@ public interface Server extends PluginMessageRecipient {
*/
LootTable getLootTable(NamespacedKey key);
/**
* Selects entities using the given Vanilla selector.
* <br>
* No guarantees are made about the selector format, other than they match
* the Vanilla format for the active Minecraft version.
* <br>
* Usually a selector will start with '@', unless selecting a Player in
* which case it may simply be the Player's name or UUID.
* <br>
* Note that in Vanilla, elevated permissions are usually required to use
* '@' selectors, but this method should not check such permissions from the
* sender.
*
* @param sender the sender to execute as, must be provided
* @param selector the selection string
* @return a list of the selected entities. The list will not be null, but
* no further guarantees are made.
* @throws IllegalArgumentException if the selector is malformed in any way
* or a parameter is null
* @deprecated draft API
*/
@Deprecated
List<Entity> selectEntities(CommandSender sender, String selector) throws IllegalArgumentException;
/**
* @see UnsafeValues
* @return the unsafe values instance