From NPC 1.1 to 2.0
Use2.0.0 for every selected NPC module. This release adds shared clip admission,
reservations and optional sound-duration metadata. The four-argument Java NpcClipSound
constructor remains available; Kotlin data-class copy signatures changed. Recompile consumers
rather than replacing a JAR beneath already compiled Kotlin code.
If you use Scene, select scene-npc-minestom:1.0.1. Ordinary hosts do not need to build Scene,
Lobby or Dialogue to use the standalone NPC library.
From NPC 0.2
NPC1.0.0 intentionally breaks source and JVM signatures from 0.2.0.
Schema-1 model JSON, resource IDs and authored units remain compatible. Recompile Java and Kotlin
consumers against one matching released dependency set.
Update packages and construction
Options are immutable construction results. Preparation rejections defensively copy a nonempty
diagnostic list and no longer expose data-class
copy or destructuring.
Update lifecycle and animation calls
Retain preparation tokens before asynchronous readiness, publish hidden handles explicitly and
await cancellation on every failed installation path.
closed() observes final cleanup without
closing. Custom or delegating NpcHandle implementations forward preparePresentation directly.
Keep numeric sampling in seconds, shared command time in milliseconds, and rotations in degrees.
Shared playback still needs a host clock; private playback uses the library’s monotonic clock.
Update an application
- Select released NPC
2.0.0modules in your build. - Update an optional Scene NPC adapter to
1.0.1and recompile the host. - Run your normal application tests, then check model appearance, animation, sound, reconnects and cleanup with the matching client pack.
0.5.0 is the older adapter for NPC 0.2.0; it cannot be mixed with the redesigned
NPC API. See installation for package access and
advanced workflows if you maintain the libraries themselves.