BetterModel
Official compatibility
| Element | Reference |
|---|---|
TypeWriter | Required. Use the official TypeWriter release supported by the extension release. |
| Related extensions | Install the related extensions listed on this page before using entries that depend on them. |
- Voxel Store — Available on the BTC Studio Voxel store.
The BetterModel Extension provides deep integration for the BetterModel plugin, allowing you to use high-quality custom entity models within TypeWriter scripts and worlds.
Features
- Custom Entity Models — Spawn and control entities with complex BetterModel animations.
- Hitbox Interaction — Precise interaction detection on custom model regions.
- Animation Control — Trigger specific animations (idle, attack, walk) via actions.
- Tracker Integration — Effortless management of model visibility and tracking.
Entries
- Actions — Play Entity Animation: Trigger model animations. Play Player Animation: Trigger animations on players. Stop Animation: Halt current animations.
- Cinematics — Model Cinematic: Sync entity animations. Player Cinematic: Sync player animations. Bone Camera Cinematic: Attach the camera to an animated model bone.
- Activities — Navigation Activity: Smart GPS-based pathfinding.
- Entity Data — Bone Visibility: Show or hide bones from criteria. Bone Appearance: Per-bone glow, tint, glint and brightness. Hitbox: Custom interaction hitboxes. Attachment and Passenger: Swap a bone for one taken from another model.
User guide
- 1. Trigger Actions — Use action entries to interact with the extension: play_bettermodel_animation, play_player_animation, stop_bettermodel_animation. Trigger them from commands, NPCs, events, or other entries. → play_bettermodel_animation → play_player_animation
Activities
- Navigation Activity — An activity that makes an entity navigate to a target location using the GPS system.
Technical Details
This extension requires the BetterModel plugin. It acts as a wrapper that translates TypeWriter commands into BetterModel API calls.
Dependencies
| Extension | Required | Usage |
|---|---|---|
| Typewriter | Required | Includes the native quest engine. |
| BasicExtension | Required | Core extension utilities. |
| EntityExtension | Required | Entity management framework. |
| RoadNetworkExtension | Required | NPC pathfinding and road network. |
| PlaceholderAPI | Optional | For @Placeholder fields. |
Troubleshooting
The extension is not visible
Check that the installed release matches the supported TypeWriter release and that the related extensions listed in the compatibility section are present.
An entry is missing
In the Typewriter Web panel, use the Search bar or the + button to find or create the entry with its exact identifier. Entry IDs and field names are case-sensitive; do not translate them.
The entry saves but nothing happens
Check that the entry is connected to the trigger, command, objective, event, or menu interaction required by its type. Test with optional permissions and criteria removed, then add them back one at a time.
An integration does not work
Verify the dependency and version shown in the extension card, then check the server log for the first error. Do not replace a missing dependency with a similarly named plugin unless the extension source explicitly supports it.