Tiny Multiblock Lib

A Tiny Lib for simple creation of Multiblocks

Meant as blocks that that contain multiple blocks of itself, but still act like 1 block (for example a bed, door etc...) not to be confused with multiblock structures!!

(Since it's a lib, there's no point to download it by itself)

Features

Super simple

creating a multiblock of any size can be done just by overriding a single method and adding a block entity. All breaking and placing logic is done for you.

Jar-in-Jar -able

Because I hate dowloading thousands of dependencies for each mod, the whole lib is intended as a jar-in-jar, meaning it gets included in your mod jar and players won't have to download any extra dependencies

Multiblock Previews

Allows devs to enable placement previews for specific multiblocks. When a player holds that multiblock in hand, it renders a transparent client-side preview of the multiblock (see the picture in gallery). This can be disabled with client config on forge and neoforge

Shared Blockstates

Allows registering blockstates that automatically sync across the whole multiblock when updated, great for mod compatibility

Support

If you're a developer and have some issues / suggestions, just dm me on discord (nikdo53) or github and I pinky promise to get back to you as soon as I can (unless you live in the USA and it's like 3AM for me😬)

Installation instructions

First, get the modrinth maven repository url and put into your build.gradle repository block.

repositories {
    //some other repositories you might have
    
    exclusiveContent {
        forRepository {
            maven {
                name = "Modrinth"
                url = "https://api.modrinth.com/maven"
            }
        }
       // forRepositories(fg.repository) // Only add this if you're using ForgeGradle, otherwise remove this line
        filter {
            includeGroup "maven.modrinth"
        }
    }
}

Then add the following to your gradle.properties:

# this example is for neoforge 1.21.1
# replace with the newest version for your mc version and loader!
tiny_multiblock_lib_version=neo-1.21.1-3.0

Lastly, add the dependecy to your build.gradle based on your loader / gradle plugin

Neoforge MDG or NG

jarJar(implementation("maven.modrinth:tiny-multiblock-lib:${tiny_multiblock_lib_version}"))

Forge FG

1. enable jarjar by adding jarJar.enable() anywhere before your minecraft block
2. add this line into dependencies:

implementation(fg.deobf(jarJar("maven.modrinth:tiny-multiblock-lib:${tiny_multiblock_lib_version}")))

Forge MDGL

jarJar(modImplementation("maven.modrinth:tiny-multiblock-lib:${tiny_multiblock_lib_version}"))

Fabric

modImplementation(include("maven.modrinth:tiny-multiblock-lib:${tiny_multiblock_lib_version}"))

Multiloader

The whole lib is coded in multiloader and anything you'd want to reference is common, meaning you can just add any version as a common dependency, then add the jar in jar into each loader separately