**Download Link**: [monogatari-v2.8.1.zip](https://storage.monogatari.io/releases/monogatari-v2.8.1.zip)

`v2.8.1` is a small patch release with two fixes: the [`@monogatari/core`](https://www.npmjs.com/package/@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](https://github.com/sponsors/Hyuchia)
- 🧡 [Patreon](https://www.patreon.com/Hyuchia)
- ☕ [Ko-fi](https://ko-fi.com/hyuchia)

### 📰 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`, and `exports` point 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/core` and `@monogatari/core/browser` are 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 `exports` map added in `2.8.0` was blocking it; it's now available as `@monogatari/core/monogatari.css`, and the old `@monogatari/core/dist/engine/core/monogatari.css` path works too.
- Installing no longer fails on npm 12, which refuses git dependencies by default. Monogatari's fork of [`random-js`](https://github.com/Monogatari/random-js) is now included in the engine's source instead of being installed from GitHub.

```javascript
import Monogatari from '@monogatari/core';
import '@monogatari/core/monogatari.css';
```

Thanks to [UCSB PLSE](https://ucsbplse.github.io/) 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:

```javascript
'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:

```javascript
'show character y happy at center with move transition 3s',
```

…or change the default for your whole game with the new CSS variables:

```css
:root {
    --character-move-speed: 0.5s;
    --character-move-easing: ease-in-out;
}
```

More details in the [Characters documentation](https://monogatari.io/v2/script-actions/characters).

#### 📦 Misc

- `@types/luxon` is now a regular dependency, since the engine's types expose the `Luxon` namespace. Strict TypeScript projects no longer error on it.
- The development toolchain has been updated to Bun 1.4.4.
- The [npm package](https://www.npmjs.com/package/@monogatari/core) 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 `engine` directory with the new ones from the download.
- **Using npm:** run `npm install @monogatari/core@2.8.1`. 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](https://monogatari.io/v2/upgrading-from-v1-4-1) first — the jump to v2 is a big one.
