/**
* @param mechname
* @return true if the bracketed keyword on the sign matches the given mechname; false otherwise
* or if no sign.
* @throws ClassCastException if the declarative constructor was used in such a way that a
* non-sign block was specified for a sign.
*/
public boolean matches(String mechname) {
return (sign == null)
? false
: (((Sign) sign.getState()).getLine(1).equalsIgnoreCase("[" + mechname + "]"));
// the astute will notice there's a problem coming up here with the one dang thing that had to
// go and break the mold with second line definer.
}
/**
* 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, 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; 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);
}
/**
* @return a Sign BlockState, or null if there is no sign block.
* @throws ClassCastException if there a sign block is set, but it's not *actually* a sign block.
*/
public Sign getSign() {
return (sign == null) ? null : (Sign) sign.getState();
}
// this tends to be redundant if checked within a CartMechanism, since it's axiomatic that that
// CartMechanism by virtue of its configured base material.
public boolean matches(Material mat) {
return (base.getType() == mat);
}