Client New Emotion System and UI Handler 1.0.0

The plugin adds full support for the new emotion system introduced in RO clients from ~2023-08-02 onward.

It handles emotion playback packets, supports in-game emotion pack purchasing, and reads a configurable emotion pack database.

Compatible with the latest version of Hercules
Successfully built on Windows (MSVC) and Debian 12 (GCC)
Thoroughly tested with client version: 2025-03-05

The plugin provides the following features
1. Handling of new emotion playback packets
2. Management and parsing of the emotion pack database
3. Functions for purchasing emotion packs in-game

Setup

1. Set PACKETVER >= 20230802 in /src/common/mmo.h (make sure your client version supports the new emotion system)

2. Place emotion_pack_db.conf in your /db/ folder

Optional

Modify UI_CURRENCY_ID in the plugin.

To change UI_CURRENCY_ID client-side, apply the HEX patch.

Included in this post

ns_client_emote_ui_handler.c — server plugin (HPM)

emotion_pack_db.conf — emotion pack definitions

Client-side files (LUB/UI/HEX patch)

Client UI files, hex patch, and additional resources are available in the public repository:
🔗 https://github.com/AcidMarco/ro-releases