Unofficial Aternos API written in Python
This repository has been archived on 2024-07-30. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
2022-10-05 16:59:48 +04:00
docs Typo; easier QR code png saving 2022-09-29 19:17:38 +04:00
examples Fixed handlers overwriting (#55), improved WS API 2022-10-05 16:59:48 +04:00
logo PEP8, mkdocs, corrected logo 2022-06-23 15:13:56 +04:00
python_aternos Fixed handlers overwriting (#55), improved WS API 2022-10-05 16:59:48 +04:00
tests Removed sensitive data from logging; 1 more test 2022-09-30 14:55:24 +04:00
.gitignore MkDocs, Readme, Files API, Automated session saving, v2.0.1 2022-08-26 16:14:07 +04:00
aternos.txt Detailed description of API that is not integrated yet 2021-10-14 18:52:35 +04:00
aternos_ws.txt WebSocket API, token parser updates 2022-01-22 15:10:30 +04:00
cloudflare.html Bugfixes in Client, Cloudflare page example 2022-07-26 10:07:12 +04:00
LICENSE Initial commit 2021-09-17 09:21:17 +04:00
Makefile MkDocs, Readme, Files API, Automated session saving, v2.0.1 2022-08-26 16:14:07 +04:00
mkdocs.yml MkDocs, Readme, Files API, Automated session saving, v2.0.1 2022-08-26 16:14:07 +04:00
NOTICE MkDocs, Readme, Files API, Automated session saving, v2.0.1 2022-08-26 16:14:07 +04:00
pylintrc Removed sensitive data from logging; 1 more test 2022-09-30 14:55:24 +04:00
pyproject.toml Add files via upload 2021-10-08 19:35:20 +04:00
README.md Readme, bug in docs 2022-08-29 13:57:45 +04:00
requirements.txt Bugfixes: Cloudflare bypassing, JS parser; tests, pylint, makefile 2022-08-22 09:55:08 +04:00
setup.cfg Module docstrings, pylint, pep8 2022-07-01 14:28:39 +04:00
setup.py Changed links in setup.py 2022-10-05 14:36:16 +04:00
test.sh Bugfixes: Cloudflare bypassing, JS parser; tests, pylint, makefile 2022-08-22 09:55:08 +04:00

Python Aternos Logo

Python Aternos

An unofficial Aternos API written in Python.
It uses aternos' 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, 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 and #46).

Install

Common

$ pip install python-aternos

Note

for Windows users

Install lxml package from here if you have problems with it, and then execute:
pip install --no-deps python-aternos

Development

$ 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:

# Import
from python_aternos import Client

# Log in
aternos = Client.from_credentials('example', 'test123')
# ----OR----
aternos = Client.from_hashed('example', 'cc03e747a6afbbcbf8be7668acfebee5')
# ----OR----
aternos = Client.restore_session()

# 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 a server softaware and its version
    # (for example, "Vanilla 1.12.2")
    print(testserv.software, testserv.version)
    # Starts server
    testserv.start()

More examples

Documentation

How-To Guide

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.
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 (Cloudflare bypassing), bugfixes in JS parser.
v2.0.x Documentation, automatically saving/restoring session, improvements in Files API.
v2.1.x Fixes in the implementation of websockets API.
v2.2.x Using Node.js as a JS interpreter if it's installed.
v3.0.x Full implementation of config and software API.
v3.1.x Shared access API and Google Drive backups.

License

License 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.