2012-08-22 22:54:39 +00:00
|
|
|
/*
|
2014-04-04 22:03:18 +00:00
|
|
|
* WorldEdit, a Minecraft world manipulation toolkit
|
|
|
|
* Copyright (C) sk89q <http://www.sk89q.com>
|
|
|
|
* Copyright (C) WorldEdit team and contributors
|
2012-08-22 22:54:39 +00:00
|
|
|
*
|
2014-04-04 22:03:18 +00:00
|
|
|
* This program is free software: you can redistribute it and/or modify it
|
|
|
|
* under the terms of the GNU Lesser General Public License as published by the
|
|
|
|
* Free Software Foundation, either version 3 of the License, or
|
2012-08-22 22:54:39 +00:00
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
2014-04-04 22:03:18 +00:00
|
|
|
* 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 Lesser General Public License
|
|
|
|
* for more details.
|
2012-08-22 22:54:39 +00:00
|
|
|
*
|
2014-04-04 22:03:18 +00:00
|
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
2012-08-22 22:54:39 +00:00
|
|
|
|
2014-04-03 04:23:14 +00:00
|
|
|
package com.sk89q.worldedit.world;
|
2012-08-22 22:54:39 +00:00
|
|
|
|
2014-07-09 21:14:17 +00:00
|
|
|
import com.sk89q.worldedit.BlockVector2D;
|
|
|
|
import com.sk89q.worldedit.EditSession;
|
|
|
|
import com.sk89q.worldedit.MaxChangedBlocksException;
|
|
|
|
import com.sk89q.worldedit.Vector;
|
|
|
|
import com.sk89q.worldedit.WorldEditException;
|
2014-04-03 04:23:14 +00:00
|
|
|
import com.sk89q.worldedit.blocks.BaseBlock;
|
2014-04-05 05:40:29 +00:00
|
|
|
import com.sk89q.worldedit.blocks.BaseItemStack;
|
2014-06-28 02:55:38 +00:00
|
|
|
import com.sk89q.worldedit.extension.platform.Platform;
|
2014-04-05 05:40:29 +00:00
|
|
|
import com.sk89q.worldedit.extent.Extent;
|
|
|
|
import com.sk89q.worldedit.function.mask.Mask;
|
|
|
|
import com.sk89q.worldedit.regions.Region;
|
|
|
|
import com.sk89q.worldedit.util.TreeGenerator;
|
|
|
|
import com.sk89q.worldedit.util.TreeGenerator.TreeType;
|
2014-07-09 21:14:17 +00:00
|
|
|
import com.sk89q.worldedit.world.registry.WorldData;
|
2012-08-22 22:54:39 +00:00
|
|
|
|
|
|
|
/**
|
2014-04-05 05:40:29 +00:00
|
|
|
* Represents a world (dimension).
|
2012-08-22 22:54:39 +00:00
|
|
|
*/
|
2014-07-09 21:14:17 +00:00
|
|
|
public interface World extends Extent {
|
2012-08-22 22:54:39 +00:00
|
|
|
|
|
|
|
/**
|
2014-04-05 05:40:29 +00:00
|
|
|
* Get the name of the world.
|
|
|
|
*
|
|
|
|
* @return a name for the world
|
|
|
|
*/
|
|
|
|
String getName();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the maximum Y.
|
|
|
|
*
|
|
|
|
* @return the maximum Y
|
|
|
|
*/
|
|
|
|
int getMaxY();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Checks whether the given block ID is a valid block ID.
|
|
|
|
*
|
|
|
|
* @param id the block ID
|
|
|
|
* @return true if the block ID is a valid one
|
|
|
|
*/
|
|
|
|
boolean isValidBlockType(int id);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Checks whether the given block ID uses data values for differentiating
|
|
|
|
* types of blocks.
|
|
|
|
*
|
|
|
|
* @param id the block ID
|
|
|
|
* @return true if the block uses data values
|
|
|
|
*/
|
|
|
|
boolean usesBlockData(int id);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a mask that matches all liquids.
|
2014-07-29 18:04:04 +00:00
|
|
|
*
|
|
|
|
* <p>Implementations should override this so that custom liquids
|
|
|
|
* are supported.</p>
|
2014-04-05 05:40:29 +00:00
|
|
|
*
|
|
|
|
* @return a mask
|
|
|
|
*/
|
|
|
|
Mask createLiquidMask();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #getLazyBlock(Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
int getBlockType(Vector pt);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #getLazyBlock(Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
int getBlockData(Vector pt);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Similar to {@link Extent#setBlock(Vector, BaseBlock)} but a
|
|
|
|
* {@code notifyAndLight} parameter indicates whether adjacent blocks
|
|
|
|
* should be notified that changes have been made and lighting operations
|
|
|
|
* should be executed.
|
2014-07-29 18:04:04 +00:00
|
|
|
*
|
|
|
|
* <p>If it's not possible to skip lighting, or if it's not possible to
|
2014-04-05 05:40:29 +00:00
|
|
|
* avoid notifying adjacent blocks, then attempt to meet the
|
2014-07-29 18:04:04 +00:00
|
|
|
* specification as best as possible.</p>
|
|
|
|
*
|
|
|
|
* <p>On implementations where the world is not simulated, the
|
|
|
|
* {@code notifyAndLight} parameter has no effect either way.</p>
|
2014-04-05 05:40:29 +00:00
|
|
|
*
|
|
|
|
* @param position position of the block
|
2012-08-22 22:54:39 +00:00
|
|
|
* @param block block to set
|
2014-04-05 05:40:29 +00:00
|
|
|
* @param notifyAndLight true to to notify and light
|
2012-08-22 22:54:39 +00:00
|
|
|
* @return true if the block was successfully set (return value may not be accurate)
|
|
|
|
*/
|
2014-04-06 22:06:38 +00:00
|
|
|
boolean setBlock(Vector position, BaseBlock block, boolean notifyAndLight) throws WorldEditException;
|
2014-04-05 05:40:29 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #setBlock(Vector, BaseBlock)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean setBlockType(Vector position, int type);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #setBlock(Vector, BaseBlock)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
void setBlockData(Vector position, int data);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #setBlock(Vector, BaseBlock)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean setTypeIdAndData(Vector position, int type, int data);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the light level at the given block.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
* @return the light level (0-15)
|
|
|
|
*/
|
|
|
|
int getBlockLightLevel(Vector position);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Clear a chest's contents.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
* @return true if the container was cleared
|
|
|
|
*/
|
|
|
|
boolean clearContainerBlockContents(Vector position);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Drop an item at the given position.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
* @param item the item to drop
|
|
|
|
* @param count the number of individual stacks to drop (number of item entities)
|
|
|
|
*/
|
|
|
|
void dropItem(Vector position, BaseItemStack item, int count);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Drop one stack of the item at the given position.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
* @param item the item to drop
|
|
|
|
* @see #dropItem(Vector, BaseItemStack, int) shortcut method to specify the number of stacks
|
|
|
|
*/
|
|
|
|
void dropItem(Vector position, BaseItemStack item);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Simulate a block being mined at the given position.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
*/
|
|
|
|
void simulateBlockMine(Vector position);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Regenerate an area.
|
|
|
|
*
|
|
|
|
* @param region the region
|
|
|
|
* @param editSession the {@link EditSession}
|
|
|
|
* @return true if re-generation was successful
|
|
|
|
*/
|
|
|
|
boolean regenerate(Region region, EditSession editSession);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Generate a tree at the given position.
|
|
|
|
*
|
|
|
|
* @param type the tree type
|
|
|
|
* @param editSession the {@link EditSession}
|
|
|
|
* @param position the position
|
|
|
|
* @return true if generation was successful
|
|
|
|
* @throws MaxChangedBlocksException thrown if too many blocks were changed
|
|
|
|
*/
|
|
|
|
boolean generateTree(TreeGenerator.TreeType type, EditSession editSession, Vector position) throws MaxChangedBlocksException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #generateTree(TreeType, EditSession, Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean generateTree(EditSession editSession, Vector position) throws MaxChangedBlocksException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #generateTree(TreeType, EditSession, Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean generateBigTree(EditSession editSession, Vector position) throws MaxChangedBlocksException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #generateTree(TreeType, EditSession, Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean generateBirchTree(EditSession editSession, Vector position) throws MaxChangedBlocksException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #generateTree(TreeType, EditSession, Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean generateRedwoodTree(EditSession editSession, Vector position) throws MaxChangedBlocksException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @deprecated Use {@link #generateTree(TreeType, EditSession, Vector)}
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
boolean generateTallRedwoodTree(EditSession editSession, Vector position) throws MaxChangedBlocksException;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Load the chunk at the given position if it isn't loaded.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
*/
|
|
|
|
void checkLoadedChunk(Vector position);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Fix the given chunks after fast mode was used.
|
2014-07-29 18:04:04 +00:00
|
|
|
*
|
|
|
|
* <p>Fast mode makes calls to {@link #setBlock(Vector, BaseBlock, boolean)}
|
2014-04-05 05:40:29 +00:00
|
|
|
* with {@code false} for the {@code notifyAndLight} parameter, which
|
|
|
|
* may causes lighting errors to accumulate. Use of this method, if
|
|
|
|
* it is implemented by the underlying world, corrects those lighting
|
2014-07-29 18:04:04 +00:00
|
|
|
* errors and may trigger block change notifications.</p>
|
2014-04-05 05:40:29 +00:00
|
|
|
*
|
|
|
|
* @param chunks a list of chunk coordinates to fix
|
|
|
|
*/
|
|
|
|
void fixAfterFastMode(Iterable<BlockVector2D> chunks);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Relight the given chunks if possible.
|
|
|
|
*
|
|
|
|
* @param chunks a list of chunk coordinates to fix
|
|
|
|
*/
|
|
|
|
void fixLighting(Iterable<BlockVector2D> chunks);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Play the given effect.
|
|
|
|
*
|
|
|
|
* @param position the position
|
|
|
|
* @param type the effect type
|
|
|
|
* @param data the effect data
|
|
|
|
* @return true if the effect was played
|
|
|
|
*/
|
|
|
|
boolean playEffect(Vector position, int type, int data);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Queue a block break effect.
|
|
|
|
*
|
|
|
|
* @param server the server
|
|
|
|
* @param position the position
|
|
|
|
* @param blockId the block ID
|
|
|
|
* @param priority the priority
|
|
|
|
* @return true if the effect was played
|
|
|
|
*/
|
2014-06-28 02:55:38 +00:00
|
|
|
boolean queueBlockBreakEffect(Platform server, Vector position, int blockId, double priority);
|
2014-04-05 05:40:29 +00:00
|
|
|
|
2014-07-09 21:14:17 +00:00
|
|
|
/**
|
|
|
|
* Get the data for blocks and so on for this world.
|
|
|
|
*
|
|
|
|
* @return the world data
|
|
|
|
*/
|
|
|
|
WorldData getWorldData();
|
|
|
|
|
2014-04-05 05:40:29 +00:00
|
|
|
@Override
|
|
|
|
boolean equals(Object other);
|
|
|
|
|
|
|
|
@Override
|
|
|
|
int hashCode();
|
2012-08-22 22:54:39 +00:00
|
|
|
|
|
|
|
}
|