Use argument object for survival autoplace

[Glease]

New Feature

• Method to start Survival Autoplace now wraps some of its arguments in ISurvivalBuildEnvironment, allowing the API to evolve without requiring client code migrations
• IStructureElement#survivalPlaceBlock now wraps some of its arguments in AutoPlaceEnvironment, allowing the API to evolve without requiring client code migrations.
• IStructureElement#survivalPlaceBlock can now inspect its surrounding structure in a limited way via AutoPlaceEnvironment#isContainedInPiece. This allow the structure element to determine if any coordinate is contained within structure. Currently, this means if given coordinate is not literal ' ' in addShape()
• Added a utility method to get world direction from relative direction.

Impact

• Necessary to solve GT hatch autoplace orientation issue
• Necessary for NEI addon to render structure on client side.

Migrations required for client code

IStructrueElement

Reusable IStructrueElement subclass should override the default shim code for survivalPlaceBlock's new overload while keeping the old overload functional.

Single purpose IStructrueElement subclass should override the default shim code for survivalPlaceBlock's new overload. The old overload can be removed or made to throw an AssertionError or UnsupportedOperationException.

Decorating IStructrueElement (e.g. ofChain) should override both survivalPlaceBlock, and call the backing IStructureElement's survivalPlaceBlock whichever overload it was called from.

IStructureDefinition

IStructureDefinition users are encouraged, but not required, to use the new survivalBuild api. The new overload allows passing in EntityPlayer instead of EntityPlayerMP to allow NEI

ISurvivalConstructable

ISurvivalConstructable Implementor should implement the new survivalConstruct to allow third party tools (e.g. NEI addon) to use this API on client side, without the presence of a server.

Mentions

@Quarri6343 This includes the necessary API change for accepting EntityPlayer to survivalPlaceBlock. I did some hack here to ensure the existing multis can use EntityPlayer without any code changes. Please check if this satisfy your needs in the NEI handler you are developing.

Reviews

I'm not asking for a review here, but I will happily accept it if you want to do so.

[github-actions]

Warning: 2 uncommitted changes
#14

[Quarri6343]

It still does not allow client EntityPlayer to SurvivalPlaceBlock

StructureLib/src/main/java/com/gtnewhorizon/structurelib/structure/IStructureElement.java

Lines 70 to 81 in 9700499

	default PlaceResult survivalPlaceBlock(
	T t, World world, int x, int y, int z, ItemStack trigger, AutoPlaceEnvironment env) {
	EntityPlayer actor = env.getActor();
	if (actor instanceof EntityPlayerMP)
	return survivalPlaceBlock(
	t, world, x, y, z, trigger, env.getSource(), (EntityPlayerMP) actor, env.getChatter());
	if (PANIC_MODE) throw new RuntimeException("Panic Tripwire hit");
	if (StructureLibAPI.isDebugEnabled())
	LOGGER.info(
	"Fallback shim code of survivalPlaceBlock hit! Things aren't going to work well! IStructureElement class: {}",
	getClass().getName());
	return PlaceResult.SKIP;

[github-actions]

Warning: 2 uncommitted changes
#15

[github-actions]

Warning: 2 uncommitted changes
#16

[Glease]

Seems good now.