https://github.com/mattjennings/vite-plugin-excalibur-hmr
Basic scene hot module reloading for excalibur.js
https://github.com/mattjennings/vite-plugin-excalibur-hmr
Last synced: about 1 month ago
JSON representation
Basic scene hot module reloading for excalibur.js
- Host: GitHub
- URL: https://github.com/mattjennings/vite-plugin-excalibur-hmr
- Owner: mattjennings
- Created: 2023-12-18T00:12:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-19T22:14:44.000Z (about 1 year ago)
- Last Synced: 2025-04-08T19:31:49.791Z (2 months ago)
- Language: TypeScript
- Size: 36.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# vite-plugin-excalibur-hmr
Adds scene hot reloading to [Excalibur.js](https://excaliburjs.com/) games.
This does not support hot reloading of actors, only scenes. When you make a change that affects a scene it will reload it without restarting the game.
It's mainly a proof-of-concept so there's probably issues, but it should work well enough for most cases.
## Installation
```bash
npm install -d vite-plugin-excalibur-hmr
```
## Usage
1. Add the plugin to your vite config:
```ts
import { defineConfig } from "vite"
import hmr from "vite-plugin-excalibur-hmr"
export default defineConfig({
plugins: [hmr()],
})
```
2. Mark your engine as hot reloadable:
```ts
import hot from "vite-plugin-excalibur-hmr/hot"
const engine = new ex.Engine({
// ...
})
if (import.meta.env.DEV) {
hot(engine)
}
```
## Making Scenes Hot Reloadable
In order for Scenes to be hot-reloadable, they must a default export in a file that is either under a `scenes` directory or ends with a `.scene.ts` or `.scene.js` extension.
Example:
```ts
// src/scenes/level1.ts or src/level1.scene.ts
import { Scene } from "excalibur"
export default class Level1 extends Scene {
// ...
}
```
Whenever changes are made to the scene or any of its imported modules the scene will be hot reloaded in the engine. If that scene is currently active then it will restart.