Starter Guide

Starter Guide: Creating Models

Creating custom models for AdvancedModels is straightforward. This guide will help you design and implement your own models from scratch using Blockbench and model.yml configuration.

1. Designing Your Model

The first step in creating a model is designing it. We recommend using Blockbench, a 3D model editor tailored for Minecraft. Follow these steps:

1. Open Blockbench and create a new model.

2. Design your model using various tools provided by Blockbench.

3. When you're satisfied, export the model as a .bbmodel file.

Make sure you save it with a clear name, as this will be used later in your plugin's configuration.

2. Setting Up the Model Folder

Next, you need to add the model to your server. Each model must have its own folder under plugins/AdvancedModels/models/. Follow this structure:

plugins 
    └── AdvancedModels
         └── models
              └── [model_name]
                   ├── [model_name].bbmodel
                   └── model.yml

For example, if you're creating a chair model, your folder structure would look like this:

plugins 
    └── AdvancedModels
         └── models 
              └── chair 
                   ├── chair.bbmodel 
                   └── model.yml

3. Configuring model.yml

Every model needs a model.yml file to function correctly. This file defines the model’s properties, parameters, and behavior. Here's a basic model.yml template:

name: "Chair"
description: "A simple wooden chair"
properties:
  item:
    type: OAK_LOG 
  entity-collision-threshold: 0.5
  block-collision-threshold: 0.3 
parameters:
  wood:
    default: "OAK"
    values: "OAK, BIRCH, SPRUCE"
    description: "Type of wood used for the chair"
  collision: true
parts:
  chair: 
    material: <wood>_LOG
  sitPart:
    material: <wood>_LOG
    interaction: SIT

4. Testing Your Model

Once your model is set up in the folder and the model.yml is configured, restart your server or run the /am reload command to load the new model.

You can now spawn the model in-game using:

/am spawn [model_name]

Example:

/am spawn chair

Congratulations, you're now ready to create and customize your own models with AdvancedModels!