Emote v2.1.0 Update

Emote Management

Minecraft Account-Based Skin Generation

• Added support for generating player skin textures using Minecraft accounts.
• Microsoft accounts can be linked with /emote account login. Use the login link and one-time code shown in chat; the code can be clicked to copy it.
• /emote account now shows the current skin provider, registered accounts, and whether an account needs to be reauthenticated.
• Registered accounts can be removed with /emote account remove <name or UUID>.
• When multiple accounts are registered, upload jobs are distributed across them. Each account processes one job at a time, while different accounts can process jobs in parallel.
• When authentication expires, the mod attempts to refresh the token. Rate limits and server errors are retried a limited number of times.
• If at least one account is registered, the account-based provider is used. Otherwise, MineSkin is used. If a registered account encounters an authentication problem, it is marked as requiring reauthentication.
• Account credentials are stored encrypted. On Windows, DPAPI is used by default. If EMOTE_ACCOUNT_KEY is set, AES-256-GCM is used instead. EMOTE_ACCOUNT_KEY must contain a Base64-encoded 32-byte key.

Because the skin generation process changes the registered account's actual Minecraft skin, using a dedicated account instead of your main gameplay account is recommended.

Player Skin Preparation and Caching

• Skin regions used by emotes are now prepared in advance when a player joins.
• Required regions shared by multiple emotes are combined and deduplicated to reduce redundant requests.
• MineSkin and the account-based provider now share the same texture cache.
• Cache access is synchronized to better handle multiple skin generation jobs running at the same time.

Admin Commands and Reloading

• Added /emote info. It displays active sessions and participants, display usage and limits, the skin provider, processing/queued/retry job status, and the number of loaded emotes.
• Display limit usage is color-coded based on current utilization.
• /emote stop can now accept multiple players at once, and /emote stop-all has been removed.
• Improved autocomplete for /emote play.
• Improved the execution order of /emote reload. If resource pack preparation or emote directory loading fails, the existing catalog and resource pack are no longer replaced.

Stress Testing and Processing Cost

• Stress test load can now be specified by either instance count or display count. Unit suffixes such as 100i and 1000d are supported.
• Cleaned up reporting for timing and packet load in stress test results.
• Local transformation matrices for static nodes without transform tracks are now reused.
• Permission rules are precomputed per emote, reducing the cost of checking them on every playback request.

Permissions and Automatic Idle Emotes

• The emotes and idle.emote fields in permission groups now support regular expressions. This allows emotes sharing a common prefix or naming pattern to be matched with a single rule.
• Strings in a valid Minecraft Identifier format are matched literally. Other strings are treated as Java regular expressions.
• In the emotes field of a permission group, * can be used to allow all emotes.
• Regex-based idle selection uses equal probability and cannot be combined with explicit weights.
• If no emote currently matches a regex, selection is deferred and checked again later.

Cooldowns and Playback State

• Cooldowns now begin when playback ends rather than when playback starts.
• Added per-permission-group cooldown modifiers. Time values such as 5s are subtracted from the base cooldown, while values such as x0.5 and x2 apply multipliers.
• When multiple permission groups apply, entries are checked from top to bottom. The first entry that matches both the player and emote and defines cooldown is used.

---

Emote Playback and Expression

Movement and Looping

• When movement_distance, the movement cancellation threshold, is set to 0, the animation scene now follows the player's current position.
• When rotation_deadzone is 0, display position and rotation use 1-tick interpolation.
• Added loop_start for specifying where repeated playback should restart.
• The first playback begins at 0t, while subsequent loops begin from the configured loop_start. This makes it possible to play an intro animation once and repeat only the main section afterward.
• loop_start can only be non-zero in loop mode and must be before the end of the timeline.

Expanded Molang Expressions

• Expanded the Molang runtime to support query functions with arguments and string results.
• Conditional expressions now evaluate only the selected branch, and brace-delimited execution blocks are supported.
• Added support for loop, break, and continue, with a maximum of 1,024 iterations per loop.
• Expanded math function support, including angle calculations, interpolation, random and dice functions, and various easing functions.
• Added q.any, q.all, q.approx_eq, and q.in_range.
• Added q.position, q.position_delta, and q.movement_direction for querying position and movement information.
• Added slot-aware support for q.is_item_equipped, q.item_is_charged, and q.is_item_name_any.
• Added q.scoreboard for reading player scoreboard values.
• Added queries for states such as blocking, eating, jump input, crawling, invisibility, levitation, yaw rotation speed, and remaining fire time.
• Expression structure is now analyzed to detect unsupported queries and invalid assignments. Assignments to persistent variables inside tracks are also validated this way.
• Dynamic NBT values can now be defined using Molang.

Web Converter

• Multiple animation files can now be selected and imported at once.
• Added a Loop start field for editing the loop restart position.
• Existing loop_start values in Emote JSON files can now be imported and exported.
• Reduced duplicate compilation of the same animation when checking animation and resource requirements.

Conversion Accuracy and Output Data

• Continuous rotation conversion now chooses angles that continue naturally from the previous frame. This improves rotations exceeding 360 degrees and reverse rotations that could previously switch to an unintended angle mid-animation.
• Reduced sudden angle changes when crossing rotation-axis boundaries.
• Transform recovery now preserves the remaining axes' scale and rotation even when one scale axis is zero.
• Fixed incorrect rotation of Animated Java displays.
• Fixed per-axis signs and parent-node application order in Animated Java Molang rotation output.
• Emotecraft conversion now uses sampling that accounts for keyframe timing and step transitions.
• Export now removes unnecessary keyframes, near-zero values, and static nodes where possible, significantly reducing output file size.

Emotecraft Support

• Added an Emotecraft converter.
• Emotecraft's loop_from_tick loop start position is preserved.
• NBS music embedded in Emotecraft files can be converted into Minecraft note block sound events.
• Music tempo, pitch, layer volume, note velocity, and fine pitch are taken into account during conversion.
• Solo layer settings are respected, and notes occurring on the same tick are grouped into a single event.
• Unsupported features that cannot be converted directly, such as custom instruments, notes outside the animation duration, stereo panning, and independent music looping, are reported as warnings.
• If embedded music cannot be read, the animation can still be converted without the music.

Example Emotes

• Added backflip, cheering, laughing, and goat horn examples.
• Added a handstand sequence. The failure animation has a 75% chance of being selected, while the success animation has a 25% chance.
• Added a piano sequence. The normal performance has a 95% chance of being selected, while the "Ode to Joy" performance has a 5% chance.
• Added seasonal Christmas and Halloween examples: playing "Jingle Bells" with handbells and transforming into a flying bat.
• Standardized emote name and description formatting, and changed the IDs of sit, handstand, and piano to use the idle. prefix.
• Improved several existing emotes.

---

Upgrade Notes

• The emotes.json schema version has been updated to 3. Existing version 2 configurations are migrated automatically.
• If an existing configuration references emote:sit, it must be changed to the new example ID, emote:idle.sit.
• The select and options format in NBT tracks must be replaced with molang expressions.
• item_source, which referenced the item held by a player, has been removed. Item displays must now specify the item to render using item_stack_snbt.
• A loop start tick has been added to the Java API's PlaybackSettings, and the types used for item nodes and dynamic NBT values have also changed. Integrations that construct these types directly will need to be updated.