Python Aternos

An unofficial Aternos API written in Python. It uses [aternos](https://aternos.org/)' private API and html parsing. Python Aternos supports: - Logging in to account with password (plain or hashed) or `ATERNOS_SESSION` cookie value. - Saving session to the file and restoring. - Changing username, email and password. - Parsing Minecraft servers list. - Parsing server info by its ID. - Starting/stoping server, restarting, confirming/cancelling launch. - Updating server info in real-time (view WebSocket API). - Changing server subdomain and MOTD (message-of-the-day). - Managing files, settings, players (whitelist, operators, etc.) > **Warning** > > According to the Aternos' [Terms of Service §5.2e](https://aternos.gmbh/en/aternos/terms#:~:text=Automatically%20accessing%20our%20website%20or%20automating%20actions%20on%20our%20website.), > you must not use any software or APIs for automated access, > beacuse they don't receive money from advertisting in this case. > > I always try to hide automated python-aternos requests > using browser-specific headers/cookies, > but you should make backups to restore your world > if Aternos detects violation of ToS and bans your account > (view issues [#16](https://github.com/DarkCat09/python-aternos/issues/16) > and [#46](https://github.com/DarkCat09/python-aternos/issues/46)). ## Install ### Common ```bash $ pip install python-aternos ``` > **Note** for Windows users > > Install `lxml` package from [here](https://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml) > if you have problems with it, and then execute: > `pip install --no-deps python-aternos` ### Development ```bash $ git clone https://github.com/DarkCat09/python-aternos.git $ cd python-aternos $ pip install -e . ``` ## Usage To use Aternos API in your Python script, import it and login with your username and password or MD5. Then request the servers list using `list_servers()`. You can start/stop your Aternos server, calling `start()` or `stop()`. Here is an example how to use the API: ```python # Import from python_aternos import Client # Log in aternos = Client.from_credentials('example', 'test123') # ----OR---- aternos = Client.from_hashed('example', 'cc03e747a6afbbcbf8be7668acfebee5') # ----OR---- aternos = Client.from_session('ATERNOS_SESSION cookie') # Returns AternosServer list servs = aternos.list_servers() # Get the first server by the 0 index myserv = servs[0] # Start myserv.start() # Stop myserv.stop() # You can also find server by IP testserv = None for serv in servs: if serv.address == 'test.aternos.org': testserv = serv if testserv is not None: # Prints the server software and its version # (for example, "Vanilla 1.12.2") print(testserv.software, testserv.version) # Starts server testserv.start() ``` ## [More examples](https://github.com/DarkCat09/python-aternos/tree/main/examples) ## [Documentation](https://python-aternos.codeberg.page/) ## [How-To Guide](https://python-aternos.codeberg.page/howto/auth) ## Changelog |Version|Description | |:-----:|:-----------| |v0.1|The first release.| |v0.2|Fixed import problem.| |v0.3|Implemented files API, added typization.| |v0.4|Implemented configuration API, some bugfixes.| |v0.5|The API was updated corresponding to new Aternos security methods. Huge thanks to [lusm554](https://github.com/lusm554).| |**v0.6/v1.0.0**|Code refactoring, websockets API and session saving to prevent detecting automation access.| |v1.0.x|Lots of bugfixes, changed versioning (SemVer).| |v1.1.x|Documentation, unit tests, pylint, bugfixes, changes in atwss.| |**v1.1.2/v2.0.0**|Solution for [#25](https://github.com/DarkCat09/python-aternos/issues/25) (Cloudflare bypassing), bugfixes in JS parser.| |v2.0.x|Documentation, automatically saving/restoring session, improvements in Files API.| |v2.1.x|Fixes in websockets API, atconnect. Supported captcha solving services (view [#52](https://github.com/DarkCat09/python-aternos/issues/52)).| |**v2.2.x**|Using Node.js as a JS interpreter if it's installed, fixed cookie refreshing.| |v3.0.x|Full implementation of config and software API.| |v3.1.x|Shared access API and Google Drive backups.| ## License [License Notice:](https://github.com/DarkCat09/python-aternos/blob/main/NOTICE) ``` Copyright 2021-2022 All contributors Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ```