Tags
Creators
Details
3.1.0+26.4-beta1
Compatibility
Required content
Changes
Emote 3.1.0
Emote 3.1.0 introduces a session-based Playback API, new animations and interactive performances, and improvements to the web converter.
This update also improves animation playback control, Molang evaluation, and skin handling.
Highlights
BETA Converter | Converter | Legacy Converter
- Playback API Overhaul: Introduced session-based playback control, precise timeline seeking, and actorless animation playback.
- Web Converter Redesign: Unified Animation and Sequence management within a single editing interface.
- New Samples: Added Knight Tribute and an interactive Christmas ensemble featuring multiple players.
- Animation Processing Improvements: Added shared Molang variables across Sequence animations and per-animation skin overrides.
Breaking Changes
API and Animation Format Changes
Schema v5 remains unchanged, but some JSON properties and public Java APIs have been updated.
- Renamed the attachment property
entity_nbttoentity_snbtin Animation JSON files. Existing files must be updated manually or re-exported through the web converter. - Replaced session UUID-based playback control methods with methods on the new
Playbackinterface. See Developer API Changes for details. - Removed the legacy Fabric Permissions API dependency and migrated to Fabric Permission API v1.
Mod Runtime
Animation Playback
- Improved seeking across Animations, transitions, delays, and Sequence steps.
- Fixed Animation clip offsets being lost during timeline seeking.
- Improved playback state management and resource cleanup.
Molang and Animation Processing
- Enabled Molang variables to be shared across Animations within the same Sequence.
- Added Molang expression support for Quaternion and Matrix transformation values.
- Improved Molang compilation and evaluation session management.
- Allowed Sequences to combine Animations with different skin bindings.
- Improved skin assignment isolation between player rigs.
Server Management
- Increased the default active display entity limit from 768 to 1024.
- Added permission identifier validation when loading access configurations.
- Improved node hierarchy validation during animation preparation.
- Improved playback interruption checks.
Other Changes and Sample Improvements
- Added Knight Tribute, a new sample animation.
- Added Christmas samples featuring four instruments. When all four are played nearby, a separate Chorus performance starts automatically.
- Renamed the IDs and names of the Juggling and Victory samples.
- Regenerated sample animation data using the latest web converter output.
- Redesigned the emote wheel and added animated slot selection.
Web Converter
Interface and Editing
- Unified Animation and Sequence editing into a single Edit interface.
- Reorganized the settings editor into Settings, Options, and Events sections.
- Improved frame-based event navigation and command execution source selection.
- Improved the presentation of conversion warnings and error messages.
- Improved multi-file importing and Sequence exporting.
Skin Overrides
- Added support for animation-specific
overrideandoverride_masktextures in Animated Java and GeckoLib projects. - Redesigned the skin upload interface with texture previews and removal controls.
- Improved skin part assignment handling across multiple imported Animations.
Conversion Compatibility
- Standardized item Display Context and SNBT property naming.
- Improved conversion handling for unsupported source features.
Developer API Changes
Session-Based Playback API
Introduced the Playback interface for inspecting and controlling individual playback sessions.
- Changed
EmoteApi.getPlayback(...)andPlayResult.Success.playback()to returnPlaybackinstead ofPlaybackInfo. - Moved session UUID-based playback control methods to the
Playbackinterface. - Added
Playback.snapshot()to retrieve the current playback state as aPlaybackInfo. - Added
isActive(),getStopReason(), andstop(reason). - Added
EmoteApi.play(world, emoteId, position, yaw)to support actorless animation playback.
Playback Time and Timeline Control
Clarified playback time semantics and standardized related method names.
getElapsedTicks()— Total elapsed ticks since the session started.getTimelineTick()— Current position in the complete playback timeline, including delays and transitions.getAnimationTick()— Current position within the active Animation, accounting for custom Molang clocks.getCursor()— Current segment, Sequence step, repetition index, and segment-local position.getTimeline()— Returns the resolved timeline segments for the current session.
Standardized playback seeking methods:
seekTimeline(tick)— Seeks to a position in the complete playback timeline.seekAnimation(tick)— Seeks within the active Animation.seekStep(stepIndex, repeatIndex, tick)— Seeks to a specific Sequence step and repetition.
Seeking preserves the existing session and elapsed playback time. Seeking is not supported in server_sync mode.
Lifecycle Callbacks and Listeners
- Updated
PlaybackContextto extend thePlaybackinterface. - Added
getScopeEmoteId()andgetScopeElapsedTicks()to retrieve callback-scoped Animation IDs and elapsed time. - Renamed the callback close reason accessor to
getCloseReason(). - Updated
EmotePlaybackListenerto receivePlaybackinstead ofPlaybackInfo. - Renamed
EmotePlayListener.beforePlay(...)toonStarting(...). - Renamed
PlaybackPositiontoPlaybackCursorandphaseTick()tosegmentTick().
Optional dependencies
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:qUF0jygw:xYPkvYPn"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:qUF0jygw:xYPkvYPn"
}
