mirror of
https://github.com/He4eT/elseifplayer.git
synced 2026-05-05 01:17:22 +00:00
57 lines
2.9 KiB
Markdown
57 lines
2.9 KiB
Markdown
# [ElseIFPlayer](https://he4et.github.io/elseifplayer/)
|
|
|
|
ElseIFPlayer is an interactive fiction player for the web.
|
|
It's powered by [cheap-glkote](https://github.com/He4eT/cheap-glkote) and [Emglken](https://github.com/curiousdannii/emglken).
|
|
|
|
To see a live demo, visit [https://he4et.github.io/elseifplayer/](https://he4et.github.io/elseifplayer/).
|
|
|
|
## Getting Started
|
|
|
|
- Ensure that you have Node.js and NPM installed on your system.
|
|
- Install the required packages by running the command `npm install` in your project directory.
|
|
- Launch the local development server using `npm run dev`.
|
|
|
|
## Build
|
|
|
|
To create a production build, use the following command:
|
|
```
|
|
npm run build <public-url>
|
|
```
|
|
|
|
- If you intend to host the player on `https://your.domain/`, use `npm run build /`.
|
|
- For hosting it in a specific directory like `https://your.domain/some-directory/`, use `npm run build /some-directory`.
|
|
|
|
## Direct links
|
|
|
|
You can provide direct links to your games using the following URL format:
|
|
```
|
|
/#/<mode>/<encodedURL>/[theme]/
|
|
```
|
|
|
|
- The `mode` parameter specifies the player interface mode:
|
|
- `play`: the default multi-window mode
|
|
- `focus`: the single-window mode without additional windows, such as the status bar
|
|
- The `encodedURL` parameter represents the location of the storyfile encoded with `encodeURIComponent`.
|
|
- The `theme` parameter is optional and allows you to choose a specific UI theme.
|
|
|
|
### CORS
|
|
|
|
If the player and your storyfile are located on different domains,
|
|
you need to use appropriate [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings.
|
|
|
|
If you cannot modify the server settings, you can use the [Parchment Proxy](https://iplayif.com/proxy/) as an alternative.
|
|
|
|
### Direct Link Examples
|
|
|
|
- [Play "Lost Pig" with default or last used theme](https://he4et.github.io/elseifplayer/#/play/https%3A%2F%2Fmirror.ifarchive.org%2Fif-archive%2Fgames%2Fzcode%2FLostPig.z8/)
|
|
- [Play "Lost Pig" without statusbar with default or last used theme](https://he4et.github.io/elseifplayer/#/focus/https%3A%2F%2Fmirror.ifarchive.org%2Fif-archive%2Fgames%2Fzcode%2FLostPig.z8/)
|
|
- [Play "Lost Pig" with Nord theme](https://he4et.github.io/elseifplayer/#/play/https%3A%2F%2Fmirror.ifarchive.org%2Fif-archive%2Fgames%2Fzcode%2FLostPig.z8/nord/)
|
|
- [Play "Lost Pig" without statusbar with Dim theme](https://he4et.github.io/elseifplayer/#/focus/https%3A%2F%2Fmirror.ifarchive.org%2Fif-archive%2Fgames%2Fzcode%2FLostPig.z8/dim/)
|
|
- [Play "Lost Pig" loaded with Parchment Proxy](https://he4et.github.io/elseifplayer/#/play/https%3A%2F%2Fiplayif.com%2Fproxy%2F%3Furl%3Dhttps%3A%2F%2Fifarchive.org%2Fif-archive%2Fgames%2Fzcode%2FLostPig.z8)
|
|
|
|
## License
|
|
|
|
ElseIFPlayer is released under the MIT License.
|
|
However, it is important to note that while using ElseIFPlayer,
|
|
you must also adhere to the licenses of the interpreters listed on the
|
|
[Emglken page](https://github.com/curiousdannii/emglken#included-projects).
|