Installation

Install Bestium

To install Bestium on your PaperMC server:

1. Download the latest plugin JAR from GitHub.
2. Make sure your server version matches the one listed in the release title.
   (A release titled Bestium 3.2.0 for Paper 1.21.10 will only work on PaperMC 1.21.10.)
3. Drop the downloaded JAR into your server’s plugins/ folder.
4. Modify your server start command to include -javaagent:plugins/Bestium-3.2.0.jar.
   For example:

   Paper start command

   java -javaagent:plugins/Bestium-3.2.0.jar -jar paper-1.21.10.jar nogui

5. Restart your server.

Done!

Using Bestium with Nova

When using Bestium together with the Nova plugin >= v0.21.0-alpha.1, make sure your server start command includes only one -javaagent argument.

It doesn’t matter whether you specify the Bestium or Nova JAR as the agent source.

Install BetterModel

BetterModel is a Bedrock model engine that lets Bestium display models without the need for mods. While it is optional to install BetterModel, you will need it if you want mobs with custom apppearance on your server.

To install BetterModel:

1. Download the plugin JAR from Modrinth
2. Drop the downloaded JAR into your server’s plugins/ folder, next to the Bestium JAR.
3. Restart your server.

BetterModel works by generating a custom resource pack in plugins/BetterModel/build.zip. To display the models to clients, you must set this resource pack as your server resource pack and send it to clients (see Minecraft Wiki - Preloaded resource packs).

Install Bestium Example

Bestium is a library plugin, which means it doesn’t add anything to the game by itself. It provides tools that other plugins can use to register and spawn custom entities.

If you don’t have a plugin using Bestium yet, you can try the Bestium Example plugin that adds a simple capybara entity:

1. Download the latest BestiumExample JAR from GitHub.
2. Drop the downloaded JAR into your server’s plugins/ folder, next to the Bestium JAR.
3. Restart your server again.