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)
|
|
|
|
- Register: `/grasscutter/register` (POST) <br>payload : `{"username":"username","password":"password","password_confirmation":"password_confirmation"}`
|
|
|
|
- Login: `/grasscutter/login` (POST) <br>payload : `{"username":"username","password":"password"}`
|
|
|
|
- Change password: `/grasscutter/change_password` (POST) <br>payload : `{"username":"username","new_password":"new_password","new_password_confirmation":"new_password_confirmation","old_password":"old_password"}`
|
|
|
|
- Response is `JSON` with following keys:
|
|
|
|
- `status` : `success` or `error`
|
|
|
|
- `message` : `success` or `error` message :
|
|
|
|
- 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.
|