807 lines
28 KiB
Java
807 lines
28 KiB
Java
/*
|
|
* WorldEdit, a Minecraft world manipulation toolkit
|
|
* Copyright (C) sk89q <http://www.sk89q.com>
|
|
* Copyright (C) WorldEdit team and contributors
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
package com.sk89q.worldedit;
|
|
|
|
import com.fastasyncworldedit.core.configuration.Caption;
|
|
import com.fastasyncworldedit.core.extension.factory.TransformFactory;
|
|
import com.fastasyncworldedit.core.extent.ResettableExtent;
|
|
import com.google.common.base.Throwables;
|
|
import com.google.common.collect.HashMultimap;
|
|
import com.google.common.collect.ImmutableList;
|
|
import com.google.common.collect.ImmutableMap;
|
|
import com.google.common.collect.Lists;
|
|
import com.google.common.collect.SetMultimap;
|
|
import com.google.common.util.concurrent.ListeningExecutorService;
|
|
import com.google.common.util.concurrent.MoreExecutors;
|
|
import com.sk89q.worldedit.blocks.BaseItem;
|
|
import com.sk89q.worldedit.entity.Player;
|
|
import com.sk89q.worldedit.event.platform.BlockInteractEvent;
|
|
import com.sk89q.worldedit.event.platform.InputType;
|
|
import com.sk89q.worldedit.event.platform.PlayerInputEvent;
|
|
import com.sk89q.worldedit.extension.factory.BlockFactory;
|
|
import com.sk89q.worldedit.extension.factory.ItemFactory;
|
|
import com.sk89q.worldedit.extension.factory.MaskFactory;
|
|
import com.sk89q.worldedit.extension.factory.PatternFactory;
|
|
import com.sk89q.worldedit.extension.platform.Actor;
|
|
import com.sk89q.worldedit.extension.platform.Capability;
|
|
import com.sk89q.worldedit.extension.platform.Locatable;
|
|
import com.sk89q.worldedit.extension.platform.Platform;
|
|
import com.sk89q.worldedit.extension.platform.PlatformManager;
|
|
import com.sk89q.worldedit.extent.inventory.BlockBag;
|
|
import com.sk89q.worldedit.function.mask.Mask;
|
|
import com.sk89q.worldedit.function.pattern.Pattern;
|
|
import com.sk89q.worldedit.internal.SchematicsEventListener;
|
|
import com.sk89q.worldedit.internal.expression.Expression;
|
|
import com.sk89q.worldedit.internal.expression.invoke.ReturnException;
|
|
import com.sk89q.worldedit.internal.util.LogManagerCompat;
|
|
import com.sk89q.worldedit.math.BlockVector3;
|
|
import com.sk89q.worldedit.session.SessionManager;
|
|
import com.sk89q.worldedit.util.Direction;
|
|
import com.sk89q.worldedit.util.Location;
|
|
import com.sk89q.worldedit.util.concurrency.EvenMoreExecutors;
|
|
import com.sk89q.worldedit.util.concurrency.LazyReference;
|
|
import com.sk89q.worldedit.util.eventbus.EventBus;
|
|
import com.sk89q.worldedit.util.formatting.text.TextComponent;
|
|
import com.sk89q.worldedit.util.io.file.FileSelectionAbortedException;
|
|
import com.sk89q.worldedit.util.io.file.FilenameException;
|
|
import com.sk89q.worldedit.util.io.file.FilenameResolutionException;
|
|
import com.sk89q.worldedit.util.io.file.InvalidFilenameException;
|
|
import com.sk89q.worldedit.util.task.SimpleSupervisor;
|
|
import com.sk89q.worldedit.util.task.Supervisor;
|
|
import com.sk89q.worldedit.util.translation.TranslationManager;
|
|
import com.sk89q.worldedit.world.World;
|
|
import com.sk89q.worldedit.world.block.BlockStateHolder;
|
|
import com.sk89q.worldedit.world.block.BlockType;
|
|
import com.sk89q.worldedit.world.registry.BundledBlockData;
|
|
import com.sk89q.worldedit.world.registry.BundledItemData;
|
|
import com.sk89q.worldedit.world.registry.LegacyMapper;
|
|
import org.apache.logging.log4j.Logger;
|
|
|
|
import javax.annotation.Nullable;
|
|
import javax.script.ScriptException;
|
|
import java.io.DataInputStream;
|
|
import java.io.File;
|
|
import java.io.FileInputStream;
|
|
import java.io.IOException;
|
|
import java.io.InputStream;
|
|
import java.nio.charset.StandardCharsets;
|
|
import java.nio.file.InvalidPathException;
|
|
import java.nio.file.Path;
|
|
import java.nio.file.Paths;
|
|
import java.util.HashMap;
|
|
import java.util.Iterator;
|
|
import java.util.List;
|
|
import java.util.Locale;
|
|
import java.util.Map;
|
|
|
|
import static com.google.common.base.Preconditions.checkArgument;
|
|
import static com.sk89q.worldedit.event.platform.Interaction.HIT;
|
|
import static com.sk89q.worldedit.event.platform.Interaction.OPEN;
|
|
|
|
/**
|
|
* The entry point and container for a working implementation of WorldEdit.
|
|
*
|
|
* <p>An instance handles event handling; block, mask, pattern, etc. registration;
|
|
* the management of sessions; the creation of {@link EditSession}s; and more.
|
|
* In order to use WorldEdit, at least one {@link Platform} must be registered
|
|
* with WorldEdit using {@link PlatformManager#register(Platform)} on the
|
|
* manager retrieved using {@link WorldEdit#getPlatformManager()}.</p>
|
|
*
|
|
* <p>An instance of WorldEdit can be retrieved using the static
|
|
* method {@link WorldEdit#getInstance()}, which is shared among all
|
|
* platforms within the same classloader hierarchy.</p>
|
|
*/
|
|
public final class WorldEdit {
|
|
|
|
/**
|
|
* This is for internal use only.
|
|
*/
|
|
public static final Logger logger = LogManagerCompat.getLogger();
|
|
|
|
private static final WorldEdit instance = new WorldEdit();
|
|
private static String version;
|
|
|
|
private final EventBus eventBus = new EventBus();
|
|
private final PlatformManager platformManager = new PlatformManager(this);
|
|
@Deprecated
|
|
private final EditSessionFactory editSessionFactory = new EditSessionFactory.EditSessionFactoryImpl();
|
|
private final SessionManager sessions = new SessionManager(this);
|
|
private final ListeningExecutorService executorService = MoreExecutors.listeningDecorator(EvenMoreExecutors.newBoundedCachedThreadPool(
|
|
0,
|
|
1,
|
|
20,
|
|
"WorldEdit Task Executor - %s"
|
|
));
|
|
private final Supervisor supervisor = new SimpleSupervisor();
|
|
//FAWE start
|
|
private final LazyReference<TranslationManager> translationManager =
|
|
LazyReference.from(() -> new TranslationManager(
|
|
WorldEdit.getInstance().getPlatformManager().queryCapability(Capability.CONFIGURATION).getResourceLoader()
|
|
));
|
|
//FAWE end
|
|
|
|
private final BlockFactory blockFactory = new BlockFactory(this);
|
|
private final ItemFactory itemFactory = new ItemFactory(this);
|
|
private final MaskFactory maskFactory = new MaskFactory(this);
|
|
private final PatternFactory patternFactory = new PatternFactory(this);
|
|
private final TransformFactory transformFactory = new TransformFactory(this);
|
|
|
|
static {
|
|
getVersion();
|
|
}
|
|
|
|
private WorldEdit() {
|
|
eventBus.register(new SchematicsEventListener());
|
|
}
|
|
|
|
/**
|
|
* Gets the current instance of this class.
|
|
*
|
|
* <p>An instance will always be available, but no platform may yet be
|
|
* registered with WorldEdit, meaning that a number of operations
|
|
* may fail. However, event handlers can be registered.</p>
|
|
*
|
|
* @return an instance of WorldEdit.
|
|
*/
|
|
public static WorldEdit getInstance() {
|
|
return instance;
|
|
}
|
|
|
|
/**
|
|
* Get the platform manager, where platforms (that implement WorldEdit)
|
|
* can be registered and information about registered platforms can
|
|
* be queried.
|
|
*
|
|
* @return the platform manager
|
|
*/
|
|
public PlatformManager getPlatformManager() {
|
|
return platformManager;
|
|
}
|
|
|
|
/**
|
|
* Get the event bus for WorldEdit.
|
|
*
|
|
* <p>Event handlers can be registered on the event bus.</p>
|
|
*
|
|
* @return the event bus
|
|
*/
|
|
public EventBus getEventBus() {
|
|
return eventBus;
|
|
}
|
|
|
|
/**
|
|
* Get the supervisor. Internal, not for API use.
|
|
*
|
|
* @return the supervisor
|
|
*/
|
|
public Supervisor getSupervisor() {
|
|
return supervisor;
|
|
}
|
|
|
|
/**
|
|
* Get the executor service. Internal, not for API use.
|
|
*
|
|
* @return the executor service
|
|
*/
|
|
public ListeningExecutorService getExecutorService() {
|
|
return executorService;
|
|
}
|
|
|
|
/**
|
|
* Get the block factory from which new {@link BlockStateHolder}s can be
|
|
* constructed.
|
|
*
|
|
* @return the block factory
|
|
*/
|
|
public BlockFactory getBlockFactory() {
|
|
return blockFactory;
|
|
}
|
|
|
|
/**
|
|
* Get the item factory from which new {@link BaseItem}s can be
|
|
* constructed.
|
|
*
|
|
* @return the item factory
|
|
*/
|
|
public ItemFactory getItemFactory() {
|
|
return itemFactory;
|
|
}
|
|
|
|
/**
|
|
* Get the mask factory from which new {@link Mask}s
|
|
* can be constructed.
|
|
*
|
|
* @return the mask factory
|
|
*/
|
|
public MaskFactory getMaskFactory() {
|
|
return maskFactory;
|
|
}
|
|
|
|
/**
|
|
* Get the pattern factory from which new {@link Pattern}s
|
|
* can be constructed.
|
|
*
|
|
* @return the pattern factory
|
|
*/
|
|
public PatternFactory getPatternFactory() {
|
|
return patternFactory;
|
|
}
|
|
|
|
/**
|
|
* Get the transform factory from which new {@link ResettableExtent}s
|
|
* can be constructed.
|
|
*
|
|
* @return the transform factory
|
|
*/
|
|
public TransformFactory getTransformFactory() {
|
|
return transformFactory;
|
|
}
|
|
|
|
/**
|
|
* Return the session manager.
|
|
*
|
|
* @return the session manager
|
|
*/
|
|
public SessionManager getSessionManager() {
|
|
return sessions;
|
|
}
|
|
|
|
/**
|
|
* Return the translation manager.
|
|
*
|
|
* @return the translation manager
|
|
*/
|
|
public TranslationManager getTranslationManager() {
|
|
return translationManager.getValue();
|
|
}
|
|
|
|
/**
|
|
* Gets the path to a file. This method will check to see if the filename
|
|
* has valid characters and has an extension. It also prevents directory
|
|
* traversal exploits by checking the root directory and the file directory.
|
|
* On success, a {@code java.io.File} object will be returned.
|
|
*
|
|
* @param actor the actor
|
|
* @param dir sub-directory to look in
|
|
* @param filename filename (user-submitted)
|
|
* @param defaultExt append an extension if missing one, null to not use
|
|
* @param extensions list of extensions, null for any
|
|
* @return a file
|
|
* @throws FilenameException thrown if the filename is invalid
|
|
*/
|
|
public File getSafeSaveFile(Actor actor, File dir, String filename, String defaultExt, String... extensions) throws
|
|
FilenameException {
|
|
return getSafeFile(actor, dir, filename, defaultExt, extensions, true);
|
|
}
|
|
|
|
/**
|
|
* Gets the path to a file. This method will check to see if the filename
|
|
* has valid characters and has an extension. It also prevents directory
|
|
* traversal exploits by checking the root directory and the file directory.
|
|
* On success, a {@code java.io.File} object will be returned.
|
|
*
|
|
* @param actor the actor
|
|
* @param dir sub-directory to look in
|
|
* @param filename filename (user-submitted)
|
|
* @param defaultExt append an extension if missing one, null to not use
|
|
* @param extensions list of extensions, null for any
|
|
* @return a file
|
|
* @throws FilenameException thrown if the filename is invalid
|
|
*/
|
|
public File getSafeOpenFile(Actor actor, File dir, String filename, String defaultExt, String... extensions) throws
|
|
FilenameException {
|
|
return getSafeFile(actor, dir, filename, defaultExt, extensions, false);
|
|
}
|
|
|
|
/**
|
|
* Get a safe path to a file.
|
|
*
|
|
* @param actor the actor
|
|
* @param dir sub-directory to look in
|
|
* @param filename filename (user-submitted)
|
|
* @param defaultExt append an extension if missing one, null to not use
|
|
* @param extensions list of extensions, null for any
|
|
* @param isSave true if the purpose is for saving
|
|
* @return a file
|
|
* @throws FilenameException thrown if the filename is invalid
|
|
*/
|
|
private File getSafeFile(
|
|
@Nullable Actor actor,
|
|
File dir,
|
|
String filename,
|
|
String defaultExt,
|
|
String[] extensions,
|
|
boolean isSave
|
|
) throws FilenameException {
|
|
if (extensions != null && (extensions.length == 1 && extensions[0] == null)) {
|
|
extensions = null;
|
|
}
|
|
|
|
File f;
|
|
|
|
if (filename.equals("#") && actor != null) {
|
|
if (isSave) {
|
|
f = actor.openFileSaveDialog(extensions);
|
|
} else {
|
|
f = actor.openFileOpenDialog(extensions);
|
|
}
|
|
|
|
if (f == null) {
|
|
throw new FileSelectionAbortedException(Caption.of("worldedit.error.no-file-selected"));
|
|
}
|
|
} else {
|
|
List<String> exts = extensions == null ? ImmutableList.of(defaultExt) : Lists.asList(defaultExt, extensions);
|
|
f = getSafeFileWithExtensions(dir, filename, exts, isSave);
|
|
}
|
|
|
|
try {
|
|
Path filePath = Paths.get(f.toURI()).normalize();
|
|
Path dirPath = Paths.get(dir.toURI()).normalize();
|
|
|
|
boolean inDir = filePath.startsWith(dirPath);
|
|
Path existingParent = filePath;
|
|
do {
|
|
existingParent = existingParent.getParent();
|
|
} while (existingParent != null && !existingParent.toFile().exists());
|
|
|
|
boolean isSym = existingParent != null && !existingParent.toRealPath().equals(existingParent);
|
|
if (!inDir || (!getConfiguration().allowSymlinks && isSym)) {
|
|
throw new FilenameResolutionException(filename, Caption.of("worldedit.error.file-resolution.outside-root"));
|
|
}
|
|
|
|
return filePath.toFile();
|
|
} catch (IOException | InvalidPathException e) {
|
|
throw new FilenameResolutionException(filename, Caption.of("worldedit.error.file-resolution.resolve-failed"));
|
|
}
|
|
}
|
|
|
|
private File getSafeFileWithExtensions(File dir, String filename, List<String> exts, boolean isSave) throws
|
|
InvalidFilenameException {
|
|
if (isSave) {
|
|
// First is default, only use that.
|
|
if (exts.size() != 1) {
|
|
exts = exts.subList(0, 1);
|
|
}
|
|
} else {
|
|
int dot = filename.lastIndexOf('.');
|
|
if (dot < 0 || dot == filename.length() - 1) {
|
|
String currentExt = filename.substring(dot + 1);
|
|
if (exts.contains(currentExt) && checkFilename(filename)) {
|
|
File f = new File(dir, filename);
|
|
if (f.exists()) {
|
|
return f;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
File result = null;
|
|
for (Iterator<String> iter = exts.iterator(); iter.hasNext() && (result == null || (!isSave && !result.exists())); ) {
|
|
result = getSafeFileWithExtension(dir, filename, iter.next());
|
|
}
|
|
if (result == null) {
|
|
throw new InvalidFilenameException(filename, Caption.of("worldedit.error.invalid-filename.invalid-characters"));
|
|
}
|
|
return result;
|
|
}
|
|
|
|
private File getSafeFileWithExtension(File dir, String filename, String extension) {
|
|
if (extension != null) {
|
|
int dot = filename.lastIndexOf('.');
|
|
if (dot < 0 || dot == filename.length() - 1 || !filename.substring(dot + 1).equalsIgnoreCase(extension)) {
|
|
filename += "." + extension;
|
|
}
|
|
}
|
|
|
|
if (!checkFilename(filename)) {
|
|
return null;
|
|
}
|
|
|
|
return new File(dir, filename);
|
|
}
|
|
|
|
private boolean checkFilename(String filename) {
|
|
return filename.matches("^[A-Za-z0-9_\\-./'$@~!%()\\[\\]+{},]+\\.[A-Za-z0-9]+$");
|
|
}
|
|
|
|
/**
|
|
* Load the bundled mappings.
|
|
*/
|
|
public void loadMappings() {
|
|
BundledBlockData.getInstance(); // Load block registry
|
|
BundledItemData.getInstance(); // Load item registry
|
|
LegacyMapper.getInstance(); // Load item registry
|
|
}
|
|
|
|
/**
|
|
* Checks to see if the specified radius is within bounds.
|
|
*
|
|
* @param radius the radius
|
|
* @throws MaxRadiusException if the radius is bigger than the configured radius
|
|
*/
|
|
public void checkMaxRadius(double radius) throws MaxRadiusException {
|
|
if (getConfiguration().maxRadius > 0 && radius > getConfiguration().maxRadius) {
|
|
throw new MaxRadiusException();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks to see if the specified brush radius is within bounds.
|
|
*
|
|
* @param radius the radius
|
|
* @throws MaxBrushRadiusException if the radius is bigger than the configured radius
|
|
*/
|
|
public void checkMaxBrushRadius(double radius) throws MaxBrushRadiusException {
|
|
if (getConfiguration().maxBrushRadius > 0 && radius > getConfiguration().maxBrushRadius) {
|
|
throw new MaxBrushRadiusException();
|
|
}
|
|
}
|
|
|
|
//FAWE start
|
|
public void checkMaxBrushRadius(Expression radius) throws MaxBrushRadiusException {
|
|
double val = radius.evaluate();
|
|
checkArgument(val >= 0, "Radius must be a positive number.");
|
|
if (getConfiguration().maxBrushRadius > 0) {
|
|
if (val > getConfiguration().maxBrushRadius) {
|
|
throw new MaxBrushRadiusException();
|
|
}
|
|
}
|
|
}
|
|
//FAWE end
|
|
|
|
/**
|
|
* Get a file relative to the defined working directory. If the specified
|
|
* path is absolute, then the working directory is not used.
|
|
*
|
|
* @param path the subpath under the working directory
|
|
* @return a working directory
|
|
* @deprecated Use {@link WorldEdit#getWorkingDirectoryPath(String)} instead
|
|
*/
|
|
@Deprecated
|
|
public File getWorkingDirectoryFile(String path) {
|
|
return getWorkingDirectoryPath(path).toFile();
|
|
}
|
|
|
|
/**
|
|
* Get a file relative to the defined working directory. If the specified
|
|
* path is absolute, then the working directory is not used.
|
|
*
|
|
* @param path the subpath under the working directory
|
|
* @return a working directory
|
|
*/
|
|
public Path getWorkingDirectoryPath(String path) {
|
|
Path p = Paths.get(path);
|
|
if (p.isAbsolute()) {
|
|
return p;
|
|
}
|
|
|
|
return getConfiguration().getWorkingDirectoryPath().resolve(path);
|
|
}
|
|
|
|
//FAWE start
|
|
|
|
/**
|
|
* Gets the path to the folder in which schematics are saved by default
|
|
*
|
|
* @return Path to the schematic folder
|
|
*/
|
|
public Path getSchematicsFolderPath() {
|
|
return getWorkingDirectoryPath(getConfiguration().saveDir);
|
|
}
|
|
//FAWE end
|
|
|
|
/**
|
|
* Get the direction vector for a player's direction.
|
|
*
|
|
* @param player the player
|
|
* @param dirStr the direction string
|
|
* @return a direction vector
|
|
* @throws UnknownDirectionException thrown if the direction is not known, or a relative direction is used with null player
|
|
*/
|
|
public BlockVector3 getDirection(@Nullable Player player, String dirStr) throws UnknownDirectionException {
|
|
dirStr = dirStr.toLowerCase(Locale.ROOT);
|
|
|
|
final Direction dir = getPlayerDirection(player, dirStr);
|
|
|
|
if (dir.isUpright() || dir.isCardinal()) {
|
|
return dir.toBlockVector();
|
|
} else {
|
|
throw new UnknownDirectionException(dir.name());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the direction vector for a player's direction.
|
|
*
|
|
* @param player the player
|
|
* @param dirStr the direction string
|
|
* @return a direction vector
|
|
* @throws UnknownDirectionException thrown if the direction is not known, or a relative direction is used with null player
|
|
*/
|
|
public BlockVector3 getDiagonalDirection(@Nullable Player player, String dirStr) throws UnknownDirectionException {
|
|
dirStr = dirStr.toLowerCase(Locale.ROOT);
|
|
|
|
final Direction dir = getPlayerDirection(player, dirStr);
|
|
|
|
if (dir.isCardinal() || dir.isOrdinal() || dir.isUpright()) {
|
|
return dir.toBlockVector();
|
|
}
|
|
|
|
throw new UnknownDirectionException(dir.name());
|
|
}
|
|
|
|
private static final Map<String, Direction> NAME_TO_DIRECTION_MAP;
|
|
|
|
static {
|
|
SetMultimap<Direction, String> directionNames = HashMultimap.create();
|
|
for (Direction direction : Direction.valuesOf(
|
|
Direction.Flag.CARDINAL | Direction.Flag.UPRIGHT
|
|
)) {
|
|
String name = direction.name().toLowerCase(Locale.ROOT);
|
|
for (int i = 1; i <= name.length(); i++) {
|
|
directionNames.put(direction, name.substring(0, i));
|
|
}
|
|
}
|
|
ImmutableMap.Builder<String, Direction> nameToDirectionMap = ImmutableMap.builder();
|
|
for (Direction direction : directionNames.keySet()) {
|
|
directionNames.get(direction).forEach(name ->
|
|
nameToDirectionMap.put(name, direction)
|
|
);
|
|
}
|
|
for (Direction direction : ImmutableList.of(Direction.NORTH, Direction.SOUTH)) {
|
|
for (Direction diagonal : ImmutableList.of(Direction.WEST, Direction.EAST)) {
|
|
for (String dirName : directionNames.get(direction)) {
|
|
for (String diagName : directionNames.get(diagonal)) {
|
|
nameToDirectionMap.put(dirName + diagName, Direction.valueOf(
|
|
direction.name() + diagonal.name()
|
|
));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
NAME_TO_DIRECTION_MAP = nameToDirectionMap.build();
|
|
}
|
|
|
|
/**
|
|
* Get the direction vector for a player's direction.
|
|
*
|
|
* @param player the player
|
|
* @param dirStr the direction string
|
|
* @return a direction enum value
|
|
* @throws UnknownDirectionException thrown if the direction is not known, or a relative direction is used with null player
|
|
*/
|
|
private Direction getPlayerDirection(@Nullable Player player, String dirStr) throws UnknownDirectionException {
|
|
Direction byName = NAME_TO_DIRECTION_MAP.get(dirStr);
|
|
if (byName != null) {
|
|
return byName;
|
|
}
|
|
switch (dirStr) {
|
|
case "m":
|
|
case "me":
|
|
case "f":
|
|
case "forward":
|
|
return getDirectionRelative(player, 0);
|
|
|
|
case "b":
|
|
case "back":
|
|
Direction dir = getDirectionRelative(player, 180);
|
|
if (dir.isUpright()) {
|
|
// If this is an upright direction, flip it.
|
|
dir = dir == Direction.UP ? Direction.DOWN : Direction.UP;
|
|
}
|
|
return dir;
|
|
|
|
case "l":
|
|
case "left":
|
|
return getDirectionRelative(player, -90);
|
|
|
|
case "r":
|
|
case "right":
|
|
return getDirectionRelative(player, 90);
|
|
|
|
default:
|
|
throw new UnknownDirectionException(dirStr);
|
|
}
|
|
}
|
|
|
|
private Direction getDirectionRelative(Player player, int yawOffset) throws UnknownDirectionException {
|
|
if (player != null) {
|
|
return player.getCardinalDirection(yawOffset);
|
|
}
|
|
throw new UnknownDirectionException("Only a player can use relative directions");
|
|
}
|
|
|
|
/**
|
|
* Flush a block bag's changes to a player.
|
|
*
|
|
* @param actor the actor
|
|
* @param editSession the edit session
|
|
*/
|
|
public void flushBlockBag(Actor actor, EditSession editSession) {
|
|
BlockBag blockBag = editSession.getBlockBag();
|
|
|
|
if (blockBag != null) {
|
|
blockBag.flushChanges();
|
|
}
|
|
|
|
Map<BlockType, Integer> missingBlocks = editSession.popMissingBlocks();
|
|
|
|
if (!missingBlocks.isEmpty()) {
|
|
TextComponent.Builder str = TextComponent.builder();
|
|
str.append("Missing these blocks: ");
|
|
int size = missingBlocks.size();
|
|
int i = 0;
|
|
|
|
for (Map.Entry<BlockType, Integer> blockTypeIntegerEntry : missingBlocks.entrySet()) {
|
|
str.append((blockTypeIntegerEntry.getKey()).getRichName());
|
|
|
|
str.append(" [Amt: ")
|
|
.append(String.valueOf(blockTypeIntegerEntry.getValue()))
|
|
.append("]");
|
|
|
|
++i;
|
|
|
|
if (i != size) {
|
|
str.append(", ");
|
|
}
|
|
}
|
|
|
|
actor.printError(str.build());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Called on arm swing.
|
|
*
|
|
* @param player the player
|
|
* @return true if the swing was handled
|
|
*/
|
|
public boolean handleArmSwing(Player player) {
|
|
PlayerInputEvent event = new PlayerInputEvent(player, InputType.PRIMARY);
|
|
getEventBus().post(event);
|
|
return event.isCancelled();
|
|
}
|
|
|
|
/**
|
|
* Called on right click (not on a block).
|
|
*
|
|
* @param player the player
|
|
* @return true if the right click was handled
|
|
*/
|
|
public boolean handleRightClick(Player player) {
|
|
PlayerInputEvent event = new PlayerInputEvent(player, InputType.SECONDARY);
|
|
getEventBus().post(event);
|
|
return event.isCancelled();
|
|
}
|
|
|
|
/**
|
|
* Called on right click.
|
|
*
|
|
* @param player the player
|
|
* @param clicked the clicked block
|
|
* @return false if you want the action to go through
|
|
*/
|
|
@Deprecated
|
|
public boolean handleBlockRightClick(Player player, Location clicked) {
|
|
return handleBlockRightClick(player, clicked, null);
|
|
}
|
|
|
|
/**
|
|
* Called on right click.
|
|
*
|
|
* @param player the player
|
|
* @param clicked the clicked block
|
|
* @param face The clicked face
|
|
* @return false if you want the action to go through
|
|
*/
|
|
public boolean handleBlockRightClick(Player player, Location clicked, @Nullable Direction face) {
|
|
BlockInteractEvent event = new BlockInteractEvent(player, clicked, face, OPEN);
|
|
getEventBus().post(event);
|
|
return event.isCancelled();
|
|
}
|
|
|
|
/**
|
|
* Called on left click.
|
|
*
|
|
* @param player the player
|
|
* @param clicked the clicked block
|
|
* @return false if you want the action to go through
|
|
*/
|
|
@Deprecated
|
|
public boolean handleBlockLeftClick(Player player, Location clicked) {
|
|
return handleBlockLeftClick(player, clicked, null);
|
|
}
|
|
|
|
/**
|
|
* Called on left click.
|
|
*
|
|
* @param player the player
|
|
* @param clicked the clicked block
|
|
* @param face The clicked face
|
|
* @return false if you want the action to go through
|
|
*/
|
|
public boolean handleBlockLeftClick(Player player, Location clicked, @Nullable Direction face) {
|
|
BlockInteractEvent event = new BlockInteractEvent(player, clicked, face, HIT);
|
|
getEventBus().post(event);
|
|
return event.isCancelled();
|
|
}
|
|
|
|
/**
|
|
* Get Worldedit's configuration.
|
|
*
|
|
* @return a configuration
|
|
*/
|
|
public LocalConfiguration getConfiguration() {
|
|
return getPlatformManager().getConfiguration();
|
|
}
|
|
|
|
/**
|
|
* Get a factory for {@link EditSession}s.
|
|
*
|
|
* @deprecated Use {@link #newEditSessionBuilder()} instead. See {@link EditSessionFactory} for details.
|
|
*/
|
|
@Deprecated
|
|
public EditSessionFactory getEditSessionFactory() {
|
|
return editSessionFactory;
|
|
}
|
|
|
|
/**
|
|
* Create a builder for {@link EditSession}s.
|
|
*/
|
|
public EditSessionBuilder newEditSessionBuilder() {
|
|
return new EditSessionBuilder(eventBus);
|
|
}
|
|
|
|
/**
|
|
* Shorthand for {@code newEditSessionBuilder().world(world).build()}.
|
|
*
|
|
* @param world the world
|
|
* @return the new {@link EditSession}
|
|
*/
|
|
public EditSession newEditSession(@Nullable World world) {
|
|
return newEditSessionBuilder().world(world).build();
|
|
}
|
|
|
|
/**
|
|
* Shorthand for {@code newEditSessionBuilder().locatableActor(locatableActor).build()}.
|
|
*
|
|
* @param locatableActor the actor
|
|
* @return the new {@link EditSession}
|
|
*/
|
|
public <A extends Actor & Locatable> EditSession newEditSession(A locatableActor) {
|
|
return newEditSessionBuilder().locatableActor(locatableActor).build();
|
|
}
|
|
|
|
/**
|
|
* Get the version.
|
|
*
|
|
* @return the version of WorldEdit
|
|
*/
|
|
public static String getVersion() {
|
|
if (version != null) {
|
|
return version;
|
|
}
|
|
|
|
WorldEditManifest manifest = WorldEditManifest.load();
|
|
|
|
return version = manifest.getWorldEditVersion();
|
|
}
|
|
|
|
}
|