python aternos

[Sin demora] Python Aternos

Una API de Atern no oficial escrita en Python.
Utiliza la API privada de Atern y el análisis HTML.

Advertencia

Esta biblioteca ya no se mantiene, porque:

1. Aternos comenzó a detectar todas las solicitudes automatizadas (y, por lo tanto, las violaciones de TOS) a través del código JS en AJAX_TOKEN que se ejecuta incorrectamente en JS2PY y requiere una biblioteca NodeJS DOM (al menos) o un motor de navegador. Para más detalles, ver #85.
2. Aternos Frontend está protegido con CloudFlare, por lo que esta biblioteca no analiza las páginas en caso de, por ejemplo, una dirección IP bloqueada o sospechosa (por ejemplo, alojamiento web). CF muestra la página IUAM, a menudo con Captcha. Necesitamos un motor de navegador como el cromo sin detectado y una IA o un hombre que resuelve captchas.
3. La última actualización de la API de ATERNOS rompió casi todo.
4. No tengo más motivación y no tengo suficiente tiempo para trabajar en esto, ni necesito en el uso de Aternos.

Lo siento mucho. Si desea continuar el desarrollo de Python-Agarnos, contácteme, pero creo que es mejor escribir desde cero.

Python Aterns soporta:

• Iniciar sesión para tener en cuenta con contraseña (simple o hash) o valor de cookie ATERNOS_SESSION
• Guardar sesión en el archivo y restaurar
• Cambiar el nombre de usuario, el correo electrónico y la contraseña
• Analización de los servidores de Minecraft
• Analizar la información del servidor por su ID
• Iniciar/detener el servidor, reiniciar, confirmar/cancelar el lanzamiento
• Actualización de información del servidor en tiempo real (consulte la API de WebSocket)
• Cambiar el subdominio del servidor y MOTD (mensaje del día)
• Administración de archivos, configuraciones, jugadores (lista blanca, operadores, etc.)

Instalar

Común

$ pip install python-aternos

Nota para los usuarios de Windows

Instale el paquete lxml desde aquí si tiene problemas con él y luego ejecuta:
pip install --no-deps python-aternos

Desarrollo

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

Uso

Para usar la API de Aterns en su script de Python, importe e inicie sesión con su nombre de usuario y contraseña o su hash MD5.

Luego solicite la lista de servidores usando list_servers() .
Puede iniciar/detener su servidor Aternos, llamar start() o stop() .

Aquí hay un ejemplo de cómo usar la API:

 # 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 ()

Más ejemplos

Documentación

Guía de cómo hacer

Colegio de cambios

Versión	Descripción
V0.3	API de archivos implementado, tipización agregada.
V0.4	API de configuración implementada, algunas correcciones de errores.
V0.5	La API se actualizó correspondiente a los nuevos métodos de seguridad de Aternos. Muchas gracias a LUSM554.
V0.6/v1.0.0	Refactorización de código, API de WebSockets y ahorro de sesión para evitar la detección de acceso de automatización.
v1.0.x	Muchas correcciones de errores, versiones cambiadas (SEMVER).
v1.1.x	Documentación, pruebas unitarias, pylint, correcciones de errores, cambios en ATWSS.
v1.1.2/v2.0.0	Solución para #25 (omisión de CloudFlare), correcciones de errores en JS Parser.
v2.0.x	Documentación, Sesión de guardar/restaurar automáticamente, mejoras en la API de archivos.
v2.1.x	Corrección en la API de WebSockets, Atconnect (incluida la solución refrescante de cookies). Soporte para los servicios de resolución de Captcha (Ver #52).
v2.2.x	Soporte de intérprete Node.js.
v3.0.0	Actualizaciones de API parcialmente reescritas.
v3.0.5	Sin mantenimiento.
v3.1.x	TODO: Implementación completa de la API de configuración.
v3.2.x	TODO: API de acceso compartido y tal vez las copias de seguridad de Google Drive.

Especificación de API invertida

Las solicitudes privadas de la API de Atern se capturaron en este archivo HAR y se importaron a un espacio de trabajo de Postman.
Puede usar ambos recursos para explorar la API.
Cualquier ayuda para mejorar esta biblioteca es bienvenido.

Licencia

Aviso de la licencia:

 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.