Skip to main content
The Companion Extension allows players to have persistent companions that follow them around the world, supporting both NPCs and ModelEngine entities.

Source Code

View source on GitHub.

Download Releases

Get the latest JARs.

Features

Summoning

Spawn NPC or ModelEngine entities.

Follow/Wait

Toggle following behavior.

Teleportation

Companions follow between worlds.

Animations

Walk/Idle animations support.

Entries

Entities

Invocation: Spawn companion.

Actions

Follow Mode: Toggle state.
Interact: Click handler.

Facts

Is Active: Check status.

Quick Start

1. Trigger Actions

Use action entries to interact with the extension: companion_follow_mode, companion_interact. Trigger them from commands, NPCs, events, or other entries.→ companion_follow_mode → companion_interact

Configuration

FieldTypeDefaultDescription
definitionRefRequiredEntity definition.
minDistanceDouble2.0Stop distance.
maxDistanceDouble4.0Start following.