Changes

• Improved skin part inference in the BD Engine datapack converter.

  • Rotated arm/leg parts are now judged using the torso-based axis, allowing markers to be placed more reliably.

• Added converter execution options.

  • --defaults: Uses default values for metadata input.
  • --swap-left-right: Swaps arm/leg markers when left and right are reversed due to BD Engine coordinate differences.

• Regenerated skin markers for the default example emote datapacks.

  • Corrected left/right arm and leg markers in the cry, hello, no, and yes example packs.

v0.3.0 Update

This v0.3.0 update focuses on adding MineSkin support, expanding pack.json options, enabling loop playback, and improving skin processing stability.

---

New Features & Improvements

MineSkin Support Added

• Integration with the MineSkin API has been added.
• Feature: Player skins can be uploaded via MineSkin and reused from saved results.

pack.json Options Field Added

• An options field has been added to pack.json.
• Feature: Configure pack-level options using space-separated strings.
• Example: loop, sync loop

Loop Animation Support Added

• Datapacks containing play_anim_loop.mcfunction can now use loop animations.
• Feature: Adding loop to options generates additional playback entries such as default_loop.
• Enables smoother continuous emote playback.

---

Skin & Playback Changes

• Reworked handling for classic/slim and 64x32 / 64x64 skins. → Reduced issues where baked skins had incorrect orientation or referenced wrong parts.

• Fixed slim arm baking flow. → Corrected an issue where the wrong arm region was being read.

• Loop playback no longer stops automatically. → Loop animations continue until manually stopped.

• Removed emote playback success message. → /emote play ... no longer sends a success message in chat.

Emote Update

This update focuses on the new emote pack registration system, pack.json-based loading and permission handling, improved reload behavior, and overall server management cleanup.

---

New Features & Improvements

Added pack.json-Based Emote Pack Registration

• Added a new pack.json configuration file.
• Emote packs are now registered using the values defined in pack.json, including datapack_identifier, name, command_name, description, and default_animation_name.
• This makes pack metadata easier to manage in one place.

Datapack Loading Now Uses Registered Packs Only

• Datapacks are no longer loaded automatically just because they exist in the datapack folder.
• Only namespaces registered in pack.json are treated as valid and loadable emote packs.

Improved Permission Mapping

• Permission mapping has been updated.
• Namespace-based permissions are now built from the permissions section in pack.json.
• Pack registration and permission settings are now managed in a more consistent structure.

---

Admin & Server Management Changes

Expanded /emote reload Behavior

• /emote reload now reloads both config.json and pack.json.
• It also reapplies datapacks and refreshes skin server settings.
• The result message now includes cfg=..., identifier=..., and emotes=..., with (resource reload) shown when applicable.

Removed Automatic Cleanup of Legacy Shortcut Datapacks

• The old automatic cleanup logic for legacy emote-dialog-shortcut datapacks has been removed.
• If those files or folders still exist, they must now be removed manually.

---

Internal Changes

Reorganized Server Initialization Structure

• Server initialization has been restructured.
• Command registration, network setup, lifecycle handling, and skin sync logic are now separated more clearly for easier maintenance.

Reworked Skin Synchronization Flow

• Emote skin synchronization has been restructured.
• Skin and playback state are now managed through separate services and a new network/listener flow.

Emote for Fabric

Emote is a Minecraft Fabric emote player compatible with BD Engine humanoid exports. It supports server-side emote playback from datapacks, and if the client also has the mod installed, the emote model can use the player's current skin so it looks more like the player.

---

Key Features

• Server-side emote playback from datapacks
• Automatic datapack discovery and reload support
• /emote command with menu, list, play, stop, and reload actions
• Optional live player skin rendering on modded clients
• Support for BD Engine humanoid exports that use emote:* skin markers

---

Install

Server

1. Put the mod jar into the server mods folder.
2. Put the emote datapack zip or folder into the world datapacks folder.
3. Start the server or run /emote reload.
4. Use /emote or /emote play <emote>.

Client

Client installation is optional.

• With the client mod installed, the emote model can use the player's current skin.
• Without the client mod, the skin defined in the datapack is used instead.
• The example datapack includes the developer skin, so unusual skin visuals are expected there.

---

Commands

• /emote
  Opens the emote menu for the current player.
• /emote menu [page]
  Opens a specific menu page.
• /emote list
  Shows loaded emotes and their basic metadata.
• /emote play <emote> [animation]
  Plays the selected emote.
• /emote stop
  Stops the active emote for the player.
• /emote reload
  Reloads config and emote datapacks.

---

Datapacks

Emotes are loaded from datapacks.

Datapacks are usually prepared directly from a BD Engine export zip with prepare_emote_datapack.py. The tool generates the required metadata, adds the emote:* markers needed for player skin support, and writes the result as a .emote.zip file that can be placed in the datapacks folder.

Usage:

python docs\prepare_emote_datapack.py path\to\project.zip

---

Config

The main config file is stored at config/emote/config.json.

• menu_page_size sets how many emotes are shown per menu page.
• player_skin_port sets the port used for the built-in skin texture endpoint. Use 0 for automatic selection.
• emote_permission sets the default permission required to use emotes.
• emote_permissions allows per-emote permission overrides.

The mod also writes an example datapack metadata file to config/emote/datapack/emote-datapack.example.json.

---

License

This project is licensed under the Apache License 2.0.