[block entities] implement basic rendering API

Author: SpaceWalkerRS

libraries/blockentities-rendering/README.md

@@ -0,0 +1,26 @@
+# Block Entities Rendering API
+
+The Block Entities Rendering API provides events and utilities for registering and working with block entity renderers.
+
+## Registering Custom Block Entity Renderers
+
+Block entity renderer registration should be done in a listener to the `REGISTER_BLOCK_ENTITY_RENDERERS` event.
+
+An example is shown below.
+
+```java
+package com.example;
+
+import net.ornithemc.osl.blockentities.api.client.BlockEntityRenderingEvents;
+import net.ornithemc.osl.entrypoints.api.client.ClientModInitializer;
+
+public class ExampleInitializer implements ClientModInitializer {
+
+	@Override
+	public void initClient() {
+		BlockEntityRenderingEvents.REGISTER_BLOCK_ENTITY_RENDERERS.register(registry -> {
+			registry.register(CookieBlockEntity.class, CookieBlockRenderer::new);
+		});
+	}
+}
+```

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/build.gradle

@@ -0,0 +1 @@
+setUpModule(project)

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/gradle.properties

@@ -0,0 +1,8 @@
+environment = client
+min_mc_version = a1.0.1_01
+max_mc_version = 1.14.4
+
+minecraft_version = 1.7.2
+raven_build = 1
+sparrow_build = 1
+nests_build = 3

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/src/main/java/net/ornithemc/osl/blockentities/api/client/BlockEntityRendererRegistry.java

@@ -0,0 +1,46 @@
+package net.ornithemc.osl.blockentities.api.client;
+
+import java.util.function.Supplier;
+
+import net.minecraft.block.entity.BlockEntity;
+import net.minecraft.client.render.block.entity.BlockEntityRenderDispatcher;
+import net.minecraft.client.render.block.entity.BlockEntityRenderer;
+
+/**
+ * A wrapper around the {@linkplain BlockEntityRenderDispatcher} renderers map.
+ */
+@FunctionalInterface
+public interface BlockEntityRendererRegistry {
+
+	/**
+	 * Registers the given block entity renderer for the given block entity type.
+	 * 
+	 * @param <T>     the block entity type for which to register the renderer.
+	 * @param type    the block entity type class.
+	 * @param factory the factory for the block entity renderer to register.
+	 */
+	<T extends BlockEntity> void register(Class<T> type, Supplier<BlockEntityRenderer<? super T>> factory);
+
+	/**
+	 * Registers the given block entity renderer for the given block entity type.
+	 * <p>
+	 * NOTE: this method only exists because generic type signatures are stripped
+	 * from all Minecraft jars from 1.8.2-pre4 and below, which makes using
+	 * {@linkplain #register(Class, Supplier)} impossible without special patches to
+	 * bring these generic type signatures back. Progress on this work is being
+	 * made, but has not yet been completed. In the meantime, this method exists to
+	 * allow block entity renderers to be registered without compile time type
+	 * safety checks.
+	 * 
+	 * @param <T>     the block entity type for which to register the renderer.
+	 * @param type    the block entity type class.
+	 * @param factory the factory for the block entity renderer to register.
+	 * 
+	 * @deprecated use {@linkplain #register(Class, Supplier)} if possible
+	 */
+	@SuppressWarnings({ "unchecked", "rawtypes" })
+	@Deprecated
+	default <T extends BlockEntity> void registerUnsafe(Class<T> type, Supplier<BlockEntityRenderer> factory) {
+		this.register(type, (Supplier) factory);
+	}
+}

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/src/main/java/net/ornithemc/osl/blockentities/api/client/BlockEntityRenderingEvents.java

@@ -0,0 +1,34 @@
+package net.ornithemc.osl.blockentities.api.client;
+
+import java.util.function.Consumer;
+
+import net.ornithemc.osl.core.api.events.Event;
+
+/**
+ * Events related to the block entities rendering lifecycle.
+ */
+public final class BlockEntityRenderingEvents {
+
+	/**
+	 * This event is invoked upon client start-up, after Vanilla block entity renderer registration is finished.
+	 * 
+	 * <p>
+	 * Custom block entity renderer registration should be done in a listener of this event.
+	 * 
+	 * <p>
+	 * Listeners to this event should be registered in your mod's entrypoint,
+	 * and can be done as follows:
+	 * 
+	 * <pre>
+	 * {@code
+	 * BlockEntityRenderingEvents.REGISTER_BLOCK_ENTITY_RENDERERS.register(registry -> {
+	 * 	registry.register(CookieBlockEntity.class, CookieBlockRenderer::new);
+	 * });
+	 * }
+	 * </pre>
+	 * 
+	 * @see BlockEntityRendererRegistry
+	 */
+	public static final Event<Consumer<BlockEntityRendererRegistry>> REGISTER_BLOCK_ENTITY_RENDERERS = Event.consumer();
+
+}

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/src/main/java/net/ornithemc/osl/blockentities/impl/mixin/client/BlockEntityRenderDispatcherMixin.java

@@ -0,0 +1,41 @@
+package net.ornithemc.osl.blockentities.impl.mixin.client;
+
+import java.util.Map;
+import java.util.function.Supplier;
+
+import org.spongepowered.asm.mixin.Final;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.Shadow;
+import org.spongepowered.asm.mixin.Unique;
+import org.spongepowered.asm.mixin.injection.At;
+import org.spongepowered.asm.mixin.injection.Inject;
+import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
+
+import net.minecraft.block.entity.BlockEntity;
+import net.minecraft.client.render.block.entity.BlockEntityRenderDispatcher;
+import net.minecraft.client.render.block.entity.BlockEntityRenderer;
+
+import net.ornithemc.osl.blockentities.api.client.BlockEntityRenderingEvents;
+
+@Mixin(BlockEntityRenderDispatcher.class)
+public class BlockEntityRenderDispatcherMixin {
+
+	@Shadow @Final
+	private Map<Class<? extends BlockEntity>, BlockEntityRenderer<? extends BlockEntity>> renderers;
+
+	@Inject(
+		method = "<init>",
+		at = @At(
+			value = "INVOKE",
+			target = "Ljava/util/Map;values()Ljava/util/Collection;"
+		)
+	)
+	private void osl$blockentities$registerBlockEntityRenderers(CallbackInfo ci) {
+		BlockEntityRenderingEvents.REGISTER_BLOCK_ENTITY_RENDERERS.invoker().accept(this::register);
+	}
+
+	@Unique
+	private <T extends BlockEntity> void register(Class<T> type, Supplier<BlockEntityRenderer<? super T>> factory) {
+		this.renderers.put(type, factory.get());
+	}
+}

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/src/main/resources/fabric.mod.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "id": "osl-blockentities-rendering",
+  "version": "0.1.0+mca1.0.1_01-mc1.14.4",
+  "environment": "client",
+  "mixins": [
+    "osl.blockentities-rendering.mixins.json"
+  ],
+  "depends": {
+    "fabricloader": "\u003e\u003d0.18.0",
+    "minecraft": "\u003e\u003d1.0.0-alpha.0.1.1 \u003c\u003d1.14.4",
+    "osl-core": "\u003e\u003d0.9.0",
+    "osl-entrypoints": "\u003e\u003d0.5.0"
+  },
+  "name": "OSL Block Entities Rendering",
+  "description": "Block Entities Rendering API and events.",
+  "authors": [
+    "OrnitheMC"
+  ],
+  "contact": {
+    "homepage": "https://ornithemc.net/",
+    "issues": "https://github.com/OrnitheMC/ornithe-standard-libraries/issues",
+    "sources": "https://github.com/OrnitheMC/ornithe-standard-libraries"
+  },
+  "license": "Apache-2.0"
+}

libraries/blockentities-rendering/blockentities-rendering-mca1.0.1_01-mc1.14.4/src/main/resources/osl.blockentities-rendering.mixins.json

@@ -0,0 +1,16 @@
+{
+	"required": true,
+	"minVersion": "0.8",
+	"package": "net.ornithemc.osl.blockentities.impl.mixin",
+	"compatibilityLevel": "JAVA_8",
+	"mixins": [
+	],
+	"client": [
+		"client.BlockEntityRenderDispatcherMixin"
+	],
+	"server": [
+	],
+	"injectors": {
+		"defaultRequire": 1
+	}
+}

libraries/blockentities-rendering/build.gradle

@@ -0,0 +1 @@
+setUpLibrary(project)

libraries/blockentities-rendering/gradle.properties

@@ -0,0 +1,6 @@
+library_id = blockentities-rendering
+library_name = Block Entities Rendering
+library_description = Block Entities Rendering API and events.
+library_version = 0.1.0
+
+osl_dependencies = core:0.9.0,entrypoints:0.5.0