mirror of
https://github.com/Xtao-Labs/GCAuth-OAuth.git
synced 2024-11-22 15:36:59 +00:00
70 lines
2.4 KiB
Markdown
70 lines
2.4 KiB
Markdown
# GCAuth OAuth
|
|
|
|
The in-game login system for [Grasscutter](https://github.com/Grasscutters/Grasscutter) is based on oauth and [GCAuth](https://github.com/exzork/GCAuth).
|
|
|
|
## Current Features:
|
|
|
|
- [x] Use Twitter oauth to login
|
|
- [x] Custom pages
|
|
|
|
## Important Notes:
|
|
|
|
This plugin is made to run on the current [Development](https://github.com/Grasscutters/Grasscutter/tree/development) branch of Grasscutter. \
|
|
|
|
This plugin is in very early development and only have the backend now. Frontend is extermely hardcore.
|
|
|
|
## Setup
|
|
|
|
### Download Plugin Jar
|
|
|
|
See releases.
|
|
|
|
### Compile yourself
|
|
|
|
1. Pull the latest code from github using ``git clone https://github.com/Xtao-Team/GCAuth-OAuth`` in your terminal of choice.
|
|
2. Locate your grasscutter server and copy the ``grasscutter`` server jar into the newly created ``GCAuth-OAuth/lib`` folder
|
|
3. Navigate back into the project root folder called ``GCAuth-OAuth`` folder and run ``gradlew build`` (cmd) **or** ``./gradlew build`` (Powershell, Linux & Mac).
|
|
4. Assuming the build succeeded, in your file explorer navigate to the ``GCAuth-OAuth`` folder, you should have a ``gcauth_oauth.jar`` file, copy it.
|
|
5. Navigate to your ``Grasscutter`` server, find the ``plugins`` folder and paste the ``gcauth_oauth.jar`` into it.
|
|
6. Start your server.
|
|
|
|
...Jump to next section...
|
|
|
|
### Usage
|
|
|
|
7. Put the all the [frontend](#Frontend) files into the folder `GRASSCUTTER_RESOURCE/plugins/GCAuth/OAuth`. Note that your must have `login.html` for now. You are free to put any other dynamiclly loaded file(e.g. `.js`, `.css`) in that folder. Check the last section for current available frontend.
|
|
|
|
8. Put the ``gcauth.jar`` file into the ``plugins`` folder of your grasscutter server. [GCAuth](https://github.com/exzork/GCAuth)
|
|
|
|
9. Log in to your server and you should be able to log in with Twitter account. (make sure `webapi-os.account.hoyoverse.com` is in your proxy list)
|
|
|
|
Your final plugins' folder's directory structure should look similar to this
|
|
```
|
|
plugins
|
|
│ gcauth.jar
|
|
│ gcauth_oauth.jar
|
|
│ ...
|
|
└───GCAuth
|
|
│ config.json
|
|
└───OAuth
|
|
│ login.html
|
|
│ ...
|
|
```
|
|
|
|
### Frontend
|
|
|
|
#### Recommend
|
|
|
|
[TwitterTheme](https://github.com/SwetyCore/GCAuth-OAuth-TwitterTheme)
|
|
|
|
- [x] Login page
|
|
- [x] Register page
|
|
- [x] Change password page
|
|
- [x] Error notice
|
|
|
|
#### Default
|
|
|
|
[en](https://github.com/Xtao-Team/GCAuth-OAuth/tree/en) [zh](https://github.com/Xtao-Team/GCAuth-OAuth/tree/zh)
|
|
|
|
- [x] Login page
|