Monogatari v2.8.1
November 15, 2026
Hyuchia
Download Link: monogatari-v2.8.1.zip
v2.8.1 is a small patch release with two fixes: the @monogatari/core npm package can be installed and imported again, and characters slide between positions with move instead of jumping.
π Support Monogatari#
Monogatari is free, open source, and built in the open β releases like this one are powered by the people who chip in to keep it going. If the engine helps you bring your stories to life, please consider sponsoring its development:
- β€οΈ GitHub Sponsors
- π§‘ Patreon
- β Ko-fi
π° Release Change Log#
π Bug Fixes#
π¦ The npm package works again
2.8.0 was published to npm in a broken state. Its entry points pointed at files that weren’t in the package, and its TypeScript type definitions were never generated, so import Monogatari from '@monogatari/core' failed with ERR_MODULE_NOT_FOUND and TypeScript couldn’t find any types for it. In 2.8.1:
- The package’s
main,module, andexportspoint at the ES module build (lib/monogatari.module.js), and that build is now actually included in the package. - The type definitions are generated and shipped, so both
@monogatari/coreand@monogatari/core/browserare fully typed. The build now fails if the types aren’t generated, so this can’t slip through silently again. - The engine stylesheet can be imported from a bundler again. The
exportsmap added in2.8.0was blocking it; it’s now available as@monogatari/core/monogatari.css, and the old@monogatari/core/dist/engine/core/monogatari.csspath works too. - Installing no longer fails on npm 12, which refuses git dependencies by default. Monogatari’s fork of
random-jsis now included in the engine’s source instead of being installed from GitHub.
import Monogatari from '@monogatari/core';
import '@monogatari/core/monogatari.css';Thanks to UCSB PLSE for the detailed, reproducible report.
πΆ Characters move between positions again
Showing a character who’s already on screen at a new position with move now slides the sprite over to its new spot, instead of making it jump there:
'show character y happy at left',
'y Over here...',
'show character y happy at right with move',
'y ...and now over here!',The slide takes 0.2s by default. Use the transition property to change it for a single statement:
'show character y happy at center with move transition 3s',β¦or change the default for your whole game with the new CSS variables:
:root {
--character-move-speed: 0.5s;
--character-move-easing: ease-in-out;
}More details in the Characters documentation.
π¦ Misc#
@types/luxonis now a regular dependency, since the engine’s types expose theLuxonnamespace. Strict TypeScript projects no longer error on it.- The development toolchain has been updated to Bun 1.4.4.
- The npm package has been updated to
2.8.1.
How To Upgrade#
If you’re on a v2.x.x version#
- Using the game template: replace the files in your
enginedirectory with the new ones from the download. - Using npm: run
npm install @monogatari/[email protected]. If you were importing the stylesheet by its full path, you can switch to@monogatari/core/monogatari.css.
If you’re on v1.4.1 (stable) or below#
If you’re upgrading from a game built on v1.4.1, we recommend reading the Upgrade Guide first β the jump to v2 is a big one.