BAMO - Block And Move On

BAMO is a Blockbench plugin/Minecraft mod combo that allows any user to turn their BB models into fully working Minecraft blocks without requiring them to write a single line of code.

Currently only supports Forge 1.16.5 and Fabric 1.20.1/1.18.2

BAMO can help you create:

• Custom 1x1 blocks with matching stairs, slabs, and walls
• Blocks and props using custom models of any size, with working hitboxes
• Blocks who's facing changes depending on which direction you place it
• Flowers

BAMO cannot create (yet):

• Custom entities
• "Functional" blocks such as doors, buttons, furnaces, and crafting tables
• Blocks with custom behavior
• Blocks that use less than a 1x1x1 cube (although the model/hitbox can be smaller)
• Variant blocks

How to Install

Minecraft Mod

1.  Install Forge/Fabric
2.  Install Kotlin for Forge/Fabric Language Kotlin
3.  Install BAMO by placing the relevant BAMO .jar file in your Minecraft mods directory
4.  Either run Minecraft once or create a folder named "bamopacks" in your Minecraft directory
5.  Place any existing BAMO model packs you have in the bamopacks folder
6.  Run Minecraft

Blockbench Plugin

1.  Download the BAMO.js file from the latest release of BAMO (currently waiting on acceptance into blockbench plugin store)
2.  Install the plugin in BB by navigating to File -> Plugins and clicking Load Plugin From File at the top of the Plugins window. Then select the BAMO.js file you downloaded
3.  Navigate to your Minecraft folder (the one that contains your mods/resourcepacks/bamopacks folders) and copy the folder path from the navigation window
4.  Navigate to File -> Preferences -> Settings, click the "Export" tab, scroll to the bottom, and paste your Minecraft folder location into the provided textbox
5. ENSURE YOU CREATE A BAMO BLOCK PROJECT OR THE BAMO PROPERTIES WILL NOT BE SAVED
6.  Export your model by clicking Tools -> BAMO Exporter

How to Use

Minecraft Mod

• Exported models will automatically be placed in a .zip file inside the bamopacks folder. Simply restart Minecraft to load any new blocks.
• Changes to models/textures can be seen ingame by exporting the model and reloading Minecraft's resource packs (F3+T). This allows for changes to the model/texture to be quickly prototyped. Changes to any other settings in the exporter will only apply after restarting Minecraft

Blockbench Plugin

• Settings are preserved in the exporter until Blockbench is closed. Please ensure that you have the correct settings chosen before exporting a model
• The exporter uses the display name to generate the new model's .zip file. Any existing model with the same name will be overwritten
• "Export" can be clicked on any export tab, with all properties defaulting to the values for a dirt block

Known Issues

• Hitboxes for models with rotated cubes do not match the cube positions. This is due to hitboxes being axis aligned and there's no easy way to resolve this

Changelog

0.5.0

• Updated to work with 1.20.1
• Added toggle for game version to BAMO exporter
• Added initial toggle for animated textures

0.4.3

• Added wizard menus for particles and simplified hitbox
• Fixed issue with exporter not loading CSS
• Added BAMO Crate, a block that can be converted to BAMO blocks using the stonecutter
• Added the option to create a BAMO Crate recipe to wizard

0.3.4

• Added option to create plants
• Added texture selection option for standard blocks
• Added support for minecraft default textures
• Added support for using textures from other mods
• Fixed slabs/walls not auto-loading first texture
• Fixed issue with stairs/slabs/walls being created if you dont unselect before swapping to custom block
• Added Auto-cleaning all non-alphanumeric chars from texture/file names
• Changed cleaning code to replace spaces in the model name with underscores, rather than just removing them (e.g. "Test Block" used to be cleaned to "testblock", now "test_block")

0.3.3

• Fixed issue with block collision not working from some directions
• Added temporary fix for plane collisions
• Fixed block variant names not showing
• Added initial step for plant blocks

0.3.2

• Fixed issues with walls and slabs not generating
• Set plugin to export .zip files

0.3.1

• Fixed issue with block rotation
• Split plugin file into multiple smaller files

0.3.0

• Added collision support
• Added rotateable blocks (currently y-axis only)
• Fixed block names by overriding function that returns it (vs using a lang file)

0.2.0

• Continued developing plugin UI
• Revamped mod to use custom block classes
• Added support for rapid single-texture block export
• Added variant options for stairs, walls, and slabs
• Reworked resourcepack system to instead load data from either folder or .zip file in bamopacks folder

0.1.3

• Revamped blockbench plugin UI
• Created placeholder settings for future export options

0.1.2

• Fixed issue with advanced mode on blockbench plugin not showing correctly
• Added transparency option

0.1.1

• Fixed bug causing files to fail to load when BAMO was installed
• Started conversion of BAMO to a wizard based interface
• Added Instant Export function

0.1.0

• Launched initial version of both Minecraft mod and Blockbench plugin with support for Block objects