Model Editor: A Comprehensive Guide
Introduction
The Model Editor in CrashPanel is a versatile tool for creating and animating custom models in your Minecraft server.
Getting Started
Access the Model Editor:
- Navigate to the 'Custom Models' section within the CrashPanel of your server.
- Create a new Custom Model to open the editor.
- Change the name by clicking the EDIT button.
Model Structure and Elements
- Outline: This displays a hierarchical list of all elements within your model.
- Adding Elements:
- ITEM/BLOCK: Incorporates Minecraft blocks or items.
- INTERACTION: Creates interactive elements with customizable behavior using the Script Editor. Here is how to configure it.
- TEXT: Adds floating text.
- CUSTOM MODEL: Embeds custom JSON models. Here is how to configure it.
Editing Elements
- Selection: Click on an element in the outline to select it.
- Properties: The selected element's properties are displayed on the right.
- Transformation: Use the following shortcuts to manipulate the element:
- r: Rotate
- s: Scale
- o: Translate
- Shift: Precise editing
- Escape: Cancel the current action
Custom Models
You can configure the Custom Model in 2 ways:
- Create: Click 'NEW MODEL' and upload your JSON files.
- Reuse: Enter in the 'MODEL ID' property the ID of the custom block/item you want to add. Convenient to avoid duplicates.
Ensure you delete unused models to prevent clutter.
Poses and Animation
- Creating Poses:
- Click the '+' button near 'POSES' to create a new pose.
- Modify elements within a pose to create different states or animations.
- Switching Poses: Click on a pose to make it active.
- Animation Duration: Set the 'DURATION' property of elements to control how quickly they transition between poses. (value is in ticks, 20 ticks = 1 second)
Scripting
- Script Editor: Access the Script Editor for an INTERACTION element to define its behavior.
- Nodes: Use nodes like 'Left Click' or/and 'Right Click' as listeners, and 'Custom Model' nodes to trigger actions.
- Examples:
- Remove a custom model on left-click.
- Cycle through multiple poses on right-click.
Saving and Using Custom Models
- Saving: Click 'SAVE' to save your custom model.
- Placement:
- Use scripts or the /custommodel command to place custom models.
- Ensure you have a mechanism to remove them, such as clicking an INTERACTION element.