GCAuth/README.md

36 lines
1.6 KiB
Markdown
Raw Normal View History

2022-04-29 00:20:13 +00:00
# GCAuth
2022-04-29 00:19:26 +00:00
Grasscutter Authentication System
2022-04-29 00:20:13 +00:00
### Usage :
2022-04-29 00:19:26 +00:00
- Place jar inside plugins folder of Grasscutter.
- To change hash algorithm change `Hash` in config.json inside plugins/GCAuth (Only Bcrypt and Scrypt is supported)
- To enable/disable plugin change `Enable` config.json inside plugins/GCAuth (enabled by default)
2022-04-29 00:38:54 +00:00
- All payload must be send with `application/json` and Compact JSON format ( without unnecessary spaces )
- Auth endpoint is:
- Check auth status : `/grasscutter/auth_status` (GET)
2022-04-29 00:50:15 +00:00
- Register: `/grasscutter/register` (POST)
```
{"username":"username","password":"password","password_confirmation":"password_confirmation"}
```
- Login: `/grasscutter/login` (POST)
```
{"username":"username","password":"password"}
```
- Change password: `/grasscutter/change_password` (POST)
```
{"username":"username","new_password":"new_password","new_password_confirmation":"new_password_confirmation","old_password":"old_password"}
```
2022-04-29 00:38:54 +00:00
- Response is `JSON` with following keys:
- `status` : `success` or `error`
2022-04-29 00:51:26 +00:00
- `message` :
2022-04-29 00:38:54 +00:00
- AUTH_ENABLED : Plugin is enabled
- AUTH_DISABLED : Plugin is disabled
- EMPTY_BODY : No data was sent with the request
- USERNAME_TAKEN : Username is already taken
- PASSWORD_MISMATCH : Password does not match
- UNKNOWN : Unknown error
- INVALID_ACCOUNT : Username or password is invalid
- NO_PASSWORD : Password is not set, please set password first by resetting it (change password)
- `jwt` : JWT token if success with body :
- `token` : Token used for authentication, paste it in username field of client.
- `username` : Username of the user.
- `uid` : UID of the user.