he4et/elseifplayer
1
0
Fork 0
mirror of https://github.com/He4eT/elseifplayer.git synced 2026-05-05 01:17:22 +00:00
Code Issues Projects Releases Packages Wiki Activity

Update README.md

Browse source
This commit is contained in:
He4eT 2023-06-29 19:39:52 +03:00
commit 686e4ced29
1 changed files with 31 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

52
README.md
View file

@ -1,42 +1,45 @@
# [ElseIFPlayer](https://he4et.github.io/elseifplayer/) # [ElseIFPlayer](https://he4et.github.io/elseifplayer/)
Interactive Fiction player for the web. ElseIFPlayer is an interactive fiction player for the web.
Powered by [cheap-glkote](https://github.com/He4eT/cheap-glkote) and [Emglken](https://github.com/curiousdannii/emglken). It's powered by [cheap-glkote](https://github.com/He4eT/cheap-glkote) and [Emglken](https://github.com/curiousdannii/emglken).
To see a live demo, check out [https://he4et.github.io/elseifplayer/](https://he4et.github.io/elseifplayer/). To see a live demo, visit [https://he4et.github.io/elseifplayer/](https://he4et.github.io/elseifplayer/).
## Getting Started ## Getting Started
- Make shure that you have NodeJS and NPM installed - Ensure that you have Node.js and NPM installed on your system.
- Install required packages with `npm install` - Install the required packages by running the command `npm install` in your project directory.
- Run local development server with `npm run dev` - Launch the local development server using `npm run dev`.
## Build ## Build
For making a production build use To create a production build, use the following command:
`npm run build <public-url>` ```
npm run build <public-url>
```
- If you want to host player on `https://your.domain/` use `npm run build /` - If you intend to host the player on `https://your.domain/`, use `npm run build /`.
- For `https://your.domain/some-directory/` use `npm run build /some-derectory` - For hosting it in a specific directory like `https://your.domain/some-directory/`, use `npm run build /some-directory`.
## Direct links ## Direct links
You can provide the direct link to your game: You can provide direct links to your games using the following URL format:
```
/#/<mode>/<encodedURL>/[theme]/
```
`/#/mode/encodedURL/[theme]/` - The `mode` parameter specifies the player interface mode:
- `play`: the default multi-window mode
- `mode` — player interface mode: - `focus`: the single-window mode without additional windows, such as the status bar
- `play` — default multi-window mode - The `encodedURL` parameter represents the location of the storyfile encoded with `encodeURIComponent`.
- `focus` — single window mode without additional windows, such as the status bar - The `theme` parameter is optional and allows you to choose a specific UI theme.
- `encodedURL` — storyfile location encoded with `encodeURIComponent`
- `theme` — [UI theme](https://github.com/He4eT/elseifplayer/blob/master/src/themes/themes.js), optional
### CORS ### CORS
If the player and your storyfile located on different domains If the player and your storyfile are located on different domains,
you shoud set appropriate [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings. you need to use appropriate [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) settings.
In case you cannot change the server settings [Parchment Proxy](https://iplayif.com/proxy/) can be used. If you cannot modify the server settings, you can use the [Parchment Proxy](https://iplayif.com/proxy/) as an alternative.
### Direct Link Examples ### Direct Link Examples
@ -45,3 +48,10 @@ In case you cannot change the server settings [Parchment Proxy](https://iplayif.
- [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" 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" 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) - [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).