docs: wording, consistency
This commit is contained in:
parent
eb723f76f5
commit
783a619bae
1 changed files with 19 additions and 18 deletions
37
README.md
37
README.md
|
@ -1,5 +1,5 @@
|
|||
# treepuncher
|
||||
An hackable headless Minecraft client, built with [aiocraft](https://git.alemi.dev/aiocraft/about)
|
||||
an hackable headless Minecraft client, built with [aiocraft](https://git.alemi.dev/aiocraft/about)
|
||||
|
||||
### Features
|
||||
* persistent storage
|
||||
|
@ -9,14 +9,14 @@ An hackable headless Minecraft client, built with [aiocraft](https://git.alemi.d
|
|||
* world processing
|
||||
|
||||
## Quick Start
|
||||
Treepuncher is still in development and thus not available yet on PyPI, to install it fetch directly from git:
|
||||
`treepuncher` is still in development and thus not available yet on PyPI, to install it fetch directly from git:
|
||||
* `pip install "git+https://git.alemi.dev/treepuncher@v0.3.0"`
|
||||
|
||||
Treepuncher can both be run as a pluggable CLI application or as a library, depending on how much you need to customize its behavior
|
||||
`treepuncher` can both be run as a pluggable CLI application or as a library, depending on how much you need to customize its behaviour
|
||||
|
||||
### as an application
|
||||
Treepuncher ships as a standalone CLI application which you can run with `python -m treepuncher`
|
||||
* create your first addon (a simple chat logger) inside `./addons/chat_logger.py`
|
||||
`treepuncher` ships as a standalone CLI application which you can run with `python -m treepuncher`
|
||||
* create your first addon (for example, a simple chat logger) inside `./addons/chat_logger.py`
|
||||
```py
|
||||
from dataclasses import dataclass
|
||||
from treepuncher import Addon, ConfigObject
|
||||
|
@ -33,7 +33,7 @@ class ChatLogger(Addon):
|
|||
async def print_chat(event: ChatEvent):
|
||||
print(f"{event.user} >> {event.text})
|
||||
```
|
||||
* create a config file: `my_bot.ini`
|
||||
* create a config file for your session (for example, `my_bot`): `my_bot.ini`
|
||||
```ini
|
||||
[Treepuncher]
|
||||
server = your.server.com
|
||||
|
@ -45,10 +45,11 @@ code = microsoft_auth_code
|
|||
[ChatLogger]
|
||||
prefix = CHAT |::
|
||||
```
|
||||
* run the treepuncher client : `python -m treepuncher my_bot`
|
||||
* run the treepuncher client : `python -m treepuncher my_bot` (note that session name must be same as config file, minus `.ini`)
|
||||
|
||||
### as a library
|
||||
* instantiate the Treepuncher object
|
||||
under the hood `treepuncher` is just a library and it's possible to invoke it programmatically
|
||||
* instantiate the `treepuncher` object
|
||||
```py
|
||||
from treepuncher import Treepuncher
|
||||
|
||||
|
@ -73,24 +74,24 @@ client.run()
|
|||
```
|
||||
|
||||
## Authentication
|
||||
Treepuncher supports both legacy Yggdrasil authentication (with options to override session and auth server) and modern Microsoft OAuth authentication. It will store the auth token inside a session file, to be able to restart without requiring credentials again.
|
||||
`treepuncher` supports both legacy Yggdrasil authentication (with options to override session and auth server) and modern Microsoft OAuth authentication. It will store the auth token inside a session file, to restart without requiring credentials again
|
||||
|
||||
To be able to use Microsoft authentication you will need to register an Azure application (see [community](https://wiki.vg/Microsoft_Authentication_Scheme) and [microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) docs on how to do that).
|
||||
to be able to use Microsoft authentication you will need to register an Azure application (see [community](https://wiki.vg/Microsoft_Authentication_Scheme) and [microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) docs on how to do that).
|
||||
|
||||
This is a tedious process but can be done just once for many accounts, sadly Microsoft decided that only kids play minecraft and we developers should just suffer...
|
||||
this is a tedious process but can be done just once for many accounts, sadly Microsoft decided that only kids play minecraft and we developers should just suffer...
|
||||
|
||||
**Be warned that Microsoft may limit your account if they find your activity suspicious**
|
||||
**be warned that Microsoft may limit your account if they find your activity suspicious**
|
||||
|
||||
Once you have your `client_id` and `client_secret` use [this page](https://fantabos.co/msauth) to generate a login code: put in your `client_id` and any state and press `auth`.
|
||||
You will be brought to Microsoft login page, input your credentials, authorize your application and you will be redirected back to the `msauth` page, but now there should be a code in the `auth code` field.
|
||||
once you have your `client_id` and `client_secret` use [this page](https://fantabos.co/msauth) to generate a login code: put in your `client_id` and any state and press `auth`.
|
||||
you will be brought to Microsoft login page, input your credentials, authorize your application and you will be redirected back to the `msauth` page, but now there should be a code in the `auth code` field
|
||||
|
||||
Put this code in your config and you're good to go!
|
||||
put this code in your config and you're good to go!
|
||||
|
||||
If you'd rather use classic Yggdrasil authentication, consider [ftbsc yggdrasil](https://yggdrasil.fantabos.co) ([src](https://git.fantabos.co/yggdrasil))
|
||||
if you'd rather use classic Yggdrasil authentication, consider [ftbsc yggdrasil](https://yggdrasil.fantabos.co) ([src](https://git.fantabos.co/yggdrasil))
|
||||
|
||||
Legacy Yggdrasil authentication supports both an hardcoded password or a pre-authorized access token
|
||||
legacy Yggdrasil authentication supports both an hardcoded password or a pre-authorized access token
|
||||
|
||||
|
||||
## Contributing
|
||||
Development is managed by [ftbsc](https://fantabos.co), mostly on [our git](https://git.fantabos.co). If you'd like to contribute, get in contact with any of us using any available form.
|
||||
development is managed by [ftbsc](https://fantabos.co), mostly on [our git](https://git.fantabos.co). If you'd like to contribute, get in contact with any of us using any available form
|
||||
|
||||
|
|
Loading…
Reference in a new issue