Client/README.md

53 lines
2.1 KiB
Markdown
Raw Normal View History

2020-12-16 19:11:06 +00:00
# OpenFusionClient
[![Current Release](https://img.shields.io/github/v/release/OpenFusionProject/OpenFusionClient?include_prereleases)](https://github.com/OpenFusionProject/OpenFusionClient/releases/latest) [![Discord](https://img.shields.io/badge/chat-on%20discord-7289da.svg?logo=discord)](https://discord.gg/DYavckB)[![License](https://img.shields.io/github/license/OpenFusionProject/OpenFusionClient)](https://github.com/OpenFusionProject/OpenFusionClient/blob/master/LICENSE.md)
An Electron app that allows you to easily join FusionFall servers.
2023-07-12 00:17:16 +00:00
It automatically installs FF's custom build of Unity Web Player, manages text files such as `assetInfo.php`/`loginInfo.php`, and embeds the game, all in a few clicks!
2023-07-12 00:17:16 +00:00
For an overview of how the game client worked originally, please see [this section in the OpenFusion README](https://github.com/OpenFusionProject/OpenFusion#architecture).
2023-07-12 00:17:16 +00:00
## Disclaimer
This repository does not contain any code from the actual FusionFall game client. **Think of it more as a launcher:** it abstracts away having to use a NPAPI plugin capable web browser, along with having to host a HTTP server for it to connect to.
2023-07-12 00:17:16 +00:00
In addition, if you are interested in contributing: do note that **this project likely cannot utilize more modern Javascript techniques**. In order to use NPAPI plugins, a very old version of Electron was needed (0.31.0). This limits the project to only a portion of ES5 in non-strict mode, and a reduced subset of Node/Electron APIs.
2023-07-12 00:17:16 +00:00
## Usage
Provided that you have npm installed, clone the repository, then run install like so:
2023-07-12 00:17:16 +00:00
```
git clone https://github.com/OpenFusionProject/OpenFusionClient.git
npm install
```
After that has completed you can then test OpenFusionClient:
2023-07-12 00:17:16 +00:00
```
npm run start
```
If you would like to package it as a standalone win32 application:
2023-07-12 00:17:16 +00:00
```
npm run pack
```
You can then compress the application directory into a zip file and installer for distribution:
2023-07-12 00:17:16 +00:00
```
npm run dist
```
Before opening a PR or running pack/dist, please do a code formatting pass:
2023-07-12 00:17:16 +00:00
```
npm run prettier
```
## License
2023-07-12 00:17:16 +00:00
MIT unless specified otherwise