/**
* Detecting factory, based on the position of the sign. The base must be one or two blocks above
* and the rails an additional block above the base. Signs are guaranteed to be signs and rails
* are guaranteed to be rails.
*
* @param sign the block containing the sign that gives additional configuration to the mechanism.
*/
public static CartMechanismBlocks findBySign(Block sign) throws InvalidMechanismException {
if (!SignUtil.isSign(sign))
throw new InvalidMechanismException("sign argument must be a sign!");
if (BlockType.isRailBlock(sign.getFace(BlockFace.UP, 2).getTypeId())) {
return new CartMechanismBlocks(
sign.getFace(BlockFace.UP, 2), sign.getFace(BlockFace.UP, 1), sign);
} else if (BlockType.isRailBlock(sign.getFace(BlockFace.UP, 3).getTypeId())) {
return new CartMechanismBlocks(
sign.getFace(BlockFace.UP, 3), sign.getFace(BlockFace.UP, 2), sign);
}
throw new InvalidMechanismException("could not find rails.");
}
/**
* Detecting factory, based on the position of the base. The rails must be one block above and the
* sign if it exists must be one or two blocks below. Signs are guaranteed to be signs (unless
* they're null) and rails are guaranteed to be rails.
*
* @param base the block on which the rails sit; the type of this block is what determines the
* mechanism type.
*/
public static CartMechanismBlocks findByBase(Block base) throws InvalidMechanismException {
if (!BlockType.isRailBlock(base.getFace(BlockFace.UP, 1).getTypeId()))
throw new InvalidMechanismException("could not find rails.");
if (SignUtil.isSign(base.getFace(BlockFace.DOWN, 1).getTypeId())) {
return new CartMechanismBlocks(
base.getFace(BlockFace.UP, 1), base, base.getFace(BlockFace.DOWN, 1));
} else if (SignUtil.isSign(base.getFace(BlockFace.DOWN, 2).getTypeId())) {
return new CartMechanismBlocks(
base.getFace(BlockFace.UP, 1), base, base.getFace(BlockFace.DOWN, 2));
}
return new CartMechanismBlocks(base.getFace(BlockFace.UP, 1), base, null);
}
/**
* Detecting factory, based on the position of the rails. The base must be one block below and the
* sign if it exists must be two or three blocks below. Signs are guaranteed to be signs (unless
* they're null) and rails are guaranteed to be rails.
*
* <p>This is the most important constructor, since it is the one invoked when processing cart
* move events.
*
* @param rail the block containing the rails.
*/
public static CartMechanismBlocks findByRail(Block rail) throws InvalidMechanismException {
if (!BlockType.isRailBlock(rail.getTypeId()))
throw new InvalidMechanismException("rail argument must be a rail!");
if (SignUtil.isSign(rail.getFace(BlockFace.DOWN, 2).getTypeId())) {
return new CartMechanismBlocks(
rail, rail.getFace(BlockFace.DOWN, 1), rail.getFace(BlockFace.DOWN, 2));
} else if (SignUtil.isSign(rail.getFace(BlockFace.DOWN, 3).getTypeId())) {
return new CartMechanismBlocks(
rail, rail.getFace(BlockFace.DOWN, 1), rail.getFace(BlockFace.DOWN, 3));
}
return new CartMechanismBlocks(rail, rail.getFace(BlockFace.DOWN, 1), null);
}
/**
* Detecting factory; defers to one of the other three specific detecting factories based on
* whether the given unknown block appears to be a sign, rail, or base.
*
* @param unknown the block to examine.
*/
public static CartMechanismBlocks find(Block unknown) throws InvalidMechanismException {
final int ti = unknown.getTypeId();
if (SignUtil.isSign(ti)) return findBySign(unknown);
else if (BlockType.isRailBlock(ti)) return findByRail(unknown);
else return findByBase(unknown);
}