AI Build Generator + 3D Model Importer

This mod lets you import 3D models into Minecraft, as well as use AI to generate your own.

Version: Forge 1.21.1

Key Features:

• Generate builds from text prompts using the power of AI.
• Seamlessly import 3D models into your Minecraft world.
• Scale, rotate, and move models in-game.
• Manipulate models using the Model Hammer item, or using commands.
• Built-in undo button.

Limitations:

Only supports .obj and .stl model files.

Generating models using AI requires a personal API key from meshy.ai

Only works on singleplayer.



Loading a Model:

1. Upon starting the game, a "models" folder will be created within your Minecraft directory. Place models and textures you want to use within this folder.
2. Once you load up your world, run the command "/model load <filename>" to load a model. The command will automatically list valid filenames within your folder.

Generating a Model:

1. To generate models using AI, an API key from Meshy is required. This involves creating an account on their website, and purchasing a subscription to get access to their API. This can be done here: Meshy API Page
2. After acquiring an API key, go into the config folder of your Minecraft directory, and open "ai_builder-common.toml". Paste your API key here.
3. Once you load up your world, run the command "model generate <prompt> to generate a model.

Manipulating Model using Model Hammer:

Models can be manipulated using the keyboard and mouse while holding the Model Hammer.

To set the initial position of the model, right click on where you want the model to be placed.

To scale, rotate, or move the model, switch between the three transformation modes by pressing their corresponding keys. By default, these are S for scale, R for rotate, and M for move. Then, simply scroll the wheel up or down to manipulate the model.

To select which access to apply the transformations to, press their corresponding keys. By default, these are X, Y, and Z.

To place and unplace the model, press P or U.

These keys can all be changed in settings.



Manipulating Model using Commands:

This mod adds the /model command, which has 7 subcommands.



/model load <filename>

Loads the file in your model folder. Only accepts .stl and .obj files.



/model generate ...

• ... <prompt> [<model_name>] Generates a 3D model from the given text prompt. If a model name is specified, will save the 3D model and textures to files using that name.
• ... cancel Cancels the current model generation if it exists. Useful for if generation is taking a long time or not responding.

/model place

Places the loaded model.



/model undo

Undoes the last placement of the model.



/model scale ...

• ... <scale> Scales the model in all dimensions by the given number.
• ... <x-scale> <y-scale> <z-scale> Scales the model in each dimension by the corresponding numbers given.
• ... <axis> <scale> Scales the model in the specified axis by the specified amount. <axis> can be "x", "y", or "z".

/model rotate ...

• ... <x-angle> <y-angle> <z-angle> Rotates the model around each axis by the corresponding angles given.
• ... <axis> <angle> Rotates the model around the specified axis by the given angle.

/model move <distance> [<direction>]

Moves the model by the specified distance.

If the direction is unspecified, will move the model in the direction the player is looking.

Direction can be "up", "down", "north", "east", "south", or "west".



Changing Model Appearance

There are three possible rendering previews that can be switched between by pressing "V".

• Bounding Box (Default) [​Low Performance Impact]
• Mesh/Wireframe [​Medium Performance Impact]
• Blocks Preview [​High Performance Impact]