python aternos

[Unerbittlich] Python Aternos

Eine inoffizielle Aternos -API, die in Python geschrieben wurde.
Es verwendet Aternos 'private API und HTML -Parsen.

Warnung

Diese Bibliothek wird nicht mehr aufrechterhalten, weil:

1. Aternos begann mit der Erkennung aller automatisierten Anforderungen (und damit TOS -Verstöße) über JS -Code in AJAX_TOKEN , das in JS2PY falsch ausgeführt wird und eine NodeJS -DOM -Bibliothek (zumindest) oder eine Browser -Engine benötigt. Weitere Informationen finden Sie unter #85.
2. Aternos Frontend ist mit CloudFlare geschützt, sodass diese Bibliothek beispielsweise beispielsweise die blockierte oder verdächtige IP -Adresse (z. B. Webhosting) von Seiten analysiert wird. CF zeigt IUAM -Seite, oft mit Captcha. Wir brauchen einen Browsermotor wie unentdeckter Chromedriver und eine KI oder einen Mann, der Captchas löst.
3. Das letzte Aternos -API -Update brach fast alles.
4. Ich habe weder Motivation und nicht genug Zeit, um daran zu arbeiten, noch brauche ich Aternos.

Es tut mir so leid. Wenn Sie die Entwicklung von Python-Marernos fortsetzen möchten, kontaktieren Sie mich, aber ich denke, es ist besser, von Grund auf neu zu schreiben.

Python Aternos unterstützt:

• Anmelden mit Passwort (einfach oder gehasht) oder ATERNOS_SESSION Cookie -Wert
• Speichern der Sitzung in der Datei und Wiederherstellung
• Ändern des Benutzernamens, E -Mail und Passwort
• Minecraft -Serverliste analysieren
• Serverinformationen nach seiner ID analysieren
• Starten/Stopp -Server, Neustart, Bestätigung/Stornierung des Starts
• Aktualisieren von Serverinformationen in Echtzeit (siehe WebSocket-API)
• Ändern des Server-Subdomains und der MOTD (Meldung des Tages)
• Verwalten von Dateien, Einstellungen, Spielern (Whitelist, Operatoren usw.)

Installieren

Gemeinsam

$ pip install python-aternos

Hinweis für Windows -Benutzer

Installieren Sie lxml -Paket von hier, wenn Sie Probleme damit haben, und führen Sie dann aus:
pip install --no-deps python-aternos

Entwicklung

$ git clone https://github.com/DarkCat09/python-aternos.git
$ cd python-aternos
$ pip install -e .[dev]

Verwendung

Um Aternos API in Ihrem Python -Skript zu verwenden, importieren Sie es und melden Sie sich mit Ihrem Benutzernamen und Passwort oder seinem MD5 -Hash an.

Fordern Sie dann die Serverliste mit list_servers() an.
Sie können Ihren Aternos -Server starten/stoppen, start() oder stop() aufrufen.

Hier ist ein Beispiel, wie man die API verwendet:

 # Import
from python_aternos import Client

# Create object
atclient = Client ()

# Log in
# with username and password
atclient . login ( 'example' , 'test123' )
# ----OR----
# with username and MD5 hashed password
atclient . login_hashed ( 'example' , 'cc03e747a6afbbcbf8be7668acfebee5' )
# ----OR----
# with session cookie
atclient . login_with_session ( 'ATERNOS_SESSION cookie value' )

# Get AternosAccount object
aternos = atclient . account

# Get servers list
servs = aternos . list_servers ()

# Get the first server
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 ()

Weitere Beispiele

Dokumentation

Anleitungen

Changelog

Version	Beschreibung
v0.3	Implementierte Dateien -API, hinzugefügte Typisierung.
v0.4	Implementierte Konfigurations -API, einige Fehler.
v0.5	Die API wurde aktualisiert, was den neuen Aternos -Sicherheitsmethoden entspricht. Vielen Dank an LUSM554.
v0.6/v1.0.0	Code Refactoring, WebSockets -API und Sitzungsspeicher, um die Erkennung des Automatisierungszugriffs zu verhindern.
v1.0.x	Viele Bugfixes, veränderte Versioning (SEMVER).
v1.1.x	Dokumentation, Unit -Tests, Pylint, Bugfixes, Änderungen in ATWSS.
v1.1.2/v2.0.0	Lösung für #25 (Cloudflare Bypassing), Fehler in JS Parser.
v2.0.x	Dokumentation, automatisch Speichern/Wiederherstellung der Sitzung, Verbesserungen in der Dateien -API.
v2.1.x	Korrekturen in der Websockets -API, ATCONNECT (einschließlich Cookie -Aktualisierungsfix). Unterstützung für Captcha -Lösungsdienste (Ansicht Nr. 52).
v2.2.x	Node.js Interpreter Support.
v3.0.0	Teilweise umgeschrieben, API -Updates.
v3.0.5	Ungehelegt.
v3.1.x	TODO: Vollständige Implementierung der Konfigurations -API.
v3.2.x	TODO: Shared Access API und möglicherweise Google Drive Backups.

Umgekehrte API -Spezifikation

Private Aternos -API -Anfragen wurden in diese HAR -Datei aufgenommen und in einen Postman -Arbeitsbereich importiert.
Sie können beide Ressourcen verwenden, um die API zu untersuchen.
Jede Hilfe bei der Verbesserung dieser Bibliothek ist willkommen.

Lizenz

Lizenz Mitteilung:

 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.