-
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit bcd99de
Showing
91 changed files
with
19,655 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
dist |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
{ | ||
"env": { | ||
"es2022": true, | ||
"node": true | ||
}, | ||
"extends": "eslint:recommended", | ||
"parserOptions": { | ||
"ecmaVersion": 2022, | ||
"sourceType": "module" | ||
}, | ||
"rules": { | ||
"indent": [ | ||
"error", | ||
4, | ||
{ | ||
"SwitchCase": 1 | ||
} | ||
], | ||
"linebreak-style": [ | ||
"error", | ||
"windows" | ||
], | ||
"quotes": [ | ||
"error", | ||
"single" | ||
], | ||
"semi": [ | ||
"error", | ||
"never" | ||
], | ||
"no-var": [ | ||
"error" | ||
], | ||
"no-console": [ | ||
0 | ||
], | ||
"no-control-regex": [ | ||
0 | ||
], | ||
"no-unused-vars": [ | ||
"error", | ||
{ | ||
"vars": "all", | ||
"args": "none", | ||
"ignoreRestSiblings": false, | ||
"argsIgnorePattern": "reject" | ||
} | ||
], | ||
"no-async-promise-executor": [ | ||
0 | ||
] | ||
}, | ||
"overrides": [ | ||
{ | ||
"files": [ "app/assets/js/scripts/*.js" ], | ||
"rules": { | ||
"no-unused-vars": [ | ||
0 | ||
], | ||
"no-undef": [ | ||
0 | ||
] | ||
} | ||
} | ||
] | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
github: LaeDev |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,38 @@ | ||
name: Build | ||
|
||
on: push | ||
|
||
jobs: | ||
release: | ||
runs-on: ${{ matrix.os }} | ||
|
||
permissions: | ||
contents: write | ||
|
||
strategy: | ||
matrix: | ||
os: [macos-latest, ubuntu-latest, windows-latest] | ||
|
||
steps: | ||
- name: Check out Git repository | ||
uses: actions/checkout@v3 | ||
|
||
- name: Set up Node | ||
uses: actions/setup-node@v3 | ||
with: | ||
node-version: 20 | ||
|
||
- name: Set up Python | ||
uses: actions/setup-python@v4 | ||
with: | ||
python-version: 3.x | ||
|
||
- name: Install Dependencies | ||
run: npm ci | ||
shell: bash | ||
|
||
- name: Build | ||
env: | ||
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} | ||
run: npm run dist | ||
shell: bash |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
/node_modules/ | ||
/.vs/ | ||
/.vscode/ | ||
/target/ | ||
/logs/ | ||
/dist/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
20 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
MIT License | ||
|
||
Copyright (c) 2017-2024 Daniel D. Scalzi | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy | ||
of this software and associated documentation files (the "Software"), to deal | ||
in the Software without restriction, including without limitation the rights | ||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
copies of the Software, and to permit persons to whom the Software is | ||
furnished to do so, subject to the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be included in all | ||
copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,211 @@ | ||
<p align="center"><img src="./app/assets/images/SealCircle.png" width="150px" height="150px" alt="aventium softworks"></p> | ||
|
||
<h1 align="center">Helios Launcher</h1> | ||
|
||
<em><h5 align="center">(formerly Electron Launcher)</h5></em> | ||
|
||
[<p align="center"><img src="https://img.shields.io/github/actions/workflow/status/dscalzi/HeliosLauncher/build.yml?branch=master&style=for-the-badge" alt="gh actions">](https://github.com/dscalzi/HeliosLauncher/actions) [<img src="https://img.shields.io/github/downloads/dscalzi/HeliosLauncher/total.svg?style=for-the-badge" alt="downloads">](https://github.com/dscalzi/HeliosLauncher/releases) <img src="https://forthebadge.com/images/badges/winter-is-coming.svg" height="28px" alt="winter-is-coming"></p> | ||
|
||
<p align="center">Join modded servers without worrying about installing Java, Forge, or other mods. We'll handle that for you.</p> | ||
|
||
![Screenshot 1](https://i.imgur.com/6o7SmH6.png) | ||
![Screenshot 2](https://i.imgur.com/x3B34n1.png) | ||
|
||
## Features | ||
|
||
* 🔒 Full account management. | ||
* Add multiple accounts and easily switch between them. | ||
* Microsoft (OAuth 2.0) + Mojang (Yggdrasil) authentication fully supported. | ||
* Credentials are never stored and transmitted directly to Mojang. | ||
* 📂 Efficient asset management. | ||
* Receive client updates as soon as we release them. | ||
* Files are validated before launch. Corrupt or incorrect files will be redownloaded. | ||
* ☕ **Automatic Java validation.** | ||
* If you have an incompatible version of Java installed, we'll install the right one *for you*. | ||
* You do not need to have Java installed to run the launcher. | ||
* 📰 News feed natively built into the launcher. | ||
* ⚙️ Intuitive settings management, including a Java control panel. | ||
* Supports all of our servers. | ||
* Switch between server configurations with ease. | ||
* View the player count of the selected server. | ||
* Automatic updates. That's right, the launcher updates itself. | ||
* View the status of Mojang's services. | ||
|
||
This is not an exhaustive list. Download and install the launcher to gauge all it can do! | ||
|
||
#### Need Help? [Check the wiki.][wiki] | ||
|
||
#### Like the project? Leave a ⭐ star on the repository! | ||
|
||
## Downloads | ||
|
||
You can download from [GitHub Releases](https://github.com/dscalzi/HeliosLauncher/releases) | ||
|
||
#### Latest Release | ||
|
||
[![](https://img.shields.io/github/release/dscalzi/HeliosLauncher.svg?style=flat-square)](https://github.com/dscalzi/HeliosLauncher/releases/latest) | ||
|
||
#### Latest Pre-Release | ||
[![](https://img.shields.io/github/release/dscalzi/HeliosLauncher/all.svg?style=flat-square)](https://github.com/dscalzi/HeliosLauncher/releases) | ||
|
||
**Supported Platforms** | ||
|
||
If you download from the [Releases](https://github.com/dscalzi/HeliosLauncher/releases) tab, select the installer for your system. | ||
|
||
| Platform | File | | ||
| -------- | ---- | | ||
| Windows x64 | `Helios-Launcher-setup-VERSION.exe` | | ||
| macOS x64 | `Helios-Launcher-setup-VERSION-x64.dmg` | | ||
| macOS arm64 | `Helios-Launcher-setup-VERSION-arm64.dmg` | | ||
| Linux x64 | `Helios-Launcher-setup-VERSION.AppImage` | | ||
|
||
## Console | ||
|
||
To open the console, use the following keybind. | ||
|
||
```console | ||
ctrl + shift + i | ||
``` | ||
|
||
Ensure that you have the console tab selected. Do not paste anything into the console unless you are 100% sure of what it will do. Pasting the wrong thing can expose sensitive information. | ||
|
||
#### Export Output to a File | ||
|
||
If you want to export the console output, simply right click anywhere on the console and click **Save as..** | ||
|
||
![console example](https://i.imgur.com/T5e73jP.png) | ||
|
||
|
||
## Development | ||
|
||
This section details the setup of a basic developmentment environment. | ||
|
||
### Getting Started | ||
|
||
**System Requirements** | ||
|
||
* [Node.js][nodejs] v20 | ||
|
||
--- | ||
|
||
**Clone and Install Dependencies** | ||
|
||
```console | ||
> git clone https://github.com/dscalzi/HeliosLauncher.git | ||
> cd HeliosLauncher | ||
> npm install | ||
``` | ||
|
||
--- | ||
|
||
**Launch Application** | ||
|
||
```console | ||
> npm start | ||
``` | ||
|
||
--- | ||
|
||
**Build Installers** | ||
|
||
To build for your current platform. | ||
|
||
```console | ||
> npm run dist | ||
``` | ||
|
||
Build for a specific platform. | ||
|
||
| Platform | Command | | ||
| ----------- | -------------------- | | ||
| Windows x64 | `npm run dist:win` | | ||
| macOS | `npm run dist:mac` | | ||
| Linux x64 | `npm run dist:linux` | | ||
|
||
Builds for macOS may not work on Windows/Linux and vice-versa. | ||
|
||
--- | ||
|
||
### Visual Studio Code | ||
|
||
All development of the launcher should be done using [Visual Studio Code][vscode]. | ||
|
||
Paste the following into `.vscode/launch.json` | ||
|
||
```JSON | ||
{ | ||
"version": "0.2.0", | ||
"configurations": [ | ||
{ | ||
"name": "Debug Main Process", | ||
"type": "node", | ||
"request": "launch", | ||
"cwd": "${workspaceFolder}", | ||
"program": "${workspaceFolder}/node_modules/electron/cli.js", | ||
"args" : ["."], | ||
"outputCapture": "std" | ||
}, | ||
{ | ||
"name": "Debug Renderer Process", | ||
"type": "chrome", | ||
"request": "launch", | ||
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron", | ||
"windows": { | ||
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron.cmd" | ||
}, | ||
"runtimeArgs": [ | ||
"${workspaceFolder}/.", | ||
"--remote-debugging-port=9222" | ||
], | ||
"webRoot": "${workspaceFolder}" | ||
} | ||
] | ||
} | ||
``` | ||
|
||
This adds two debug configurations. | ||
|
||
#### Debug Main Process | ||
|
||
This allows you to debug Electron's [main process][mainprocess]. You can debug scripts in the [renderer process][rendererprocess] by opening the DevTools Window. | ||
|
||
#### Debug Renderer Process | ||
|
||
This allows you to debug Electron's [renderer process][rendererprocess]. This requires you to install the [Debugger for Chrome][chromedebugger] extension. | ||
|
||
Note that you **cannot** open the DevTools window while using this debug configuration. Chromium only allows one debugger, opening another will crash the program. | ||
|
||
--- | ||
|
||
### Note on Third-Party Usage | ||
|
||
Please give credit to the original author and provide a link to the original source. This is free software, please do at least this much. | ||
|
||
For instructions on setting up Microsoft Authentication, see https://github.com/dscalzi/HeliosLauncher/blob/master/docs/MicrosoftAuth.md. | ||
|
||
--- | ||
|
||
## Resources | ||
|
||
* [Wiki][wiki] | ||
* [Nebula (Create Distribution.json)][nebula] | ||
* [v2 Rewrite Branch (Inactive)][v2branch] | ||
|
||
The best way to contact the developers is on Discord. | ||
|
||
[![discord](https://discordapp.com/api/guilds/211524927831015424/embed.png?style=banner3)][discord] | ||
|
||
--- | ||
|
||
### See you ingame. | ||
|
||
|
||
[nodejs]: https://nodejs.org/en/ 'Node.js' | ||
[vscode]: https://code.visualstudio.com/ 'Visual Studio Code' | ||
[mainprocess]: https://electronjs.org/docs/tutorial/application-architecture#main-and-renderer-processes 'Main Process' | ||
[rendererprocess]: https://electronjs.org/docs/tutorial/application-architecture#main-and-renderer-processes 'Renderer Process' | ||
[chromedebugger]: https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome 'Debugger for Chrome' | ||
[discord]: https://discord.gg/zNWUXdt 'Discord' | ||
[wiki]: https://github.com/dscalzi/HeliosLauncher/wiki 'wiki' | ||
[nebula]: https://github.com/dscalzi/Nebula 'dscalzi/Nebula' | ||
[v2branch]: https://github.com/dscalzi/HeliosLauncher/tree/ts-refactor 'v2 branch' |
Oops, something went wrong.