Getting Started

Installation

To install Expressive, simply download the latest version from Modrinth and place the JAR file in your server’s plugins directory.

Dependencies

Simply install the latest versions of PineLib and version 2.2.0 of BetterModel (Other versions may not be compatible) to ensure Expressive works correctly.

Usage

After installing Expressive and its dependencies, start your server to allow the plugin to generate the necessary files and resource pack. Once the server is running, you can access the Quick Actions menu by pressing the hotkey (default is G) and you should see the Expressive emote menu (or a button to open it if you have other plugins/datapacks that use the Quick Actions menu). From there, you can play the included emotes or any custom emotes you have created!

What could go wrong? / Troubleshooting

If you have installed Expressive and it is not working correctly, here are some common issues and their solutions:

Issue: The plugin is not loading or is throwing errors in the console.
- Solution: Make sure you have installed the required dependencies (PineLib and BetterModel) and that they are the correct versions. Also, check for any error messages in the console that may indicate what the issue is.
- BetterModel: Expressive is built on BetterModel v2.2.0, newer versions appear to have breaking changes that cause Expressive to not work correctly. If you are using a newer version of BetterModel, try downgrading to v2.2.0 to see if that resolves the issue.
Issue: Resource pack isn’t being served to players / I only see missing models when using Expressive.
- Solution #1: You may have to force players to accept server resource packs. This can be done by setting force-resource-pack to true in your server’s server.properties file.
- Solution #2: The resource pack server may not have started correctly, try restarting your server and checking the console for any errors related to the resource pack server. If all else fails, manually make players apply plugins/BetterModel/build.zip