python aternos

[Uncainted] Python aternos

Неофициальный API aternos, написанный на Python.
Он использует частный анализ API и HTML ATERNOS.

Предупреждение

Эта библиотека больше не поддерживается, потому что:

1. Aternos начал обнаруживать все автоматизированные запросы (и, следовательно, нарушения TOS) через код JS в AJAX_TOKEN , который неверно выполняется в JS2PY и требует библиотеки NodeJS DOM (по крайней мере) или двигателя браузера. Подробнее см. #85.
2. Frontend Anternos защищен CloudFlare, поэтому эта библиотека не может анализировать страницы в случае, например, заблокированного или подозрительного IP -адреса (например, веб -хостинг). CF показывает IUAM Page, часто с Captcha. Нам нужен двигатель браузера, такой как незамеченная-хромедривер, и ИИ или человек, решающий каптхи.
3. Последнее обновление API API разбило почти все.
4. У меня больше нет мотивации, и я не имею достаточно времени, чтобы поработать над этим, и не нуждается в использовании aternos.

Мне очень жаль. Если вы хотите продолжить развитие Python-Asternos, свяжитесь со мной, но я думаю, что лучше написать с нуля.

Python aternos поддерживает:

• Вход в систему для учетной записи с паролем (простой или хэшированным) или значением cookie ATERNOS_SESSION
• Сохранение сеанса в файл и восстановление
• Изменение имени пользователя, электронной почты и пароля
• Список серверов Minecraft Minecraft
• Информация о сервере диапазона по идентификатору
• Сервер запуска/остановки, перезапуск, подтверждение/отмену запуска
• Обновление информации о сервере в режиме реального времени (см. WebSocket API)
• Изменение субдомена сервера и MOTD (сообщение дня)
• Управление файлами, настройками, игроками (белый список, операторы и т. Д.)

Установить

Общий

$ pip install python-aternos

Примечание для пользователей Windows

Установите пакет lxml отсюда, если у вас есть проблемы с ним, а затем выполните:
pip install --no-deps python-aternos

Разработка

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

Использование

Чтобы использовать API API ATERNOS в своем сценарии Python, импортируйте его и войдите с вашим именем пользователя и паролем или его хэшем MD5.

Затем запросите список серверов, используя list_servers() .
Вы можете запустить/остановить свой сервер Aternos, вызовать start() или stop() .

Вот пример, как использовать 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 ()

Больше примеров

Документация

Как рекомендовать

Изменение

Версия	Описание
v0.3	Реализовано API файлов, добавлена ​​типизация.
v0.4	Реализованный API конфигурации, некоторые ошибки.
v0.5	API был обновлен, соответствующий новым методам безопасности Aternos. Огромное спасибо LUSM554.
v0.6/v1.0.0	Рефакторинг кода, WebSockets API и сбережения сеансов для предотвращения доступа к автоматизации.
v1.0.x	Множество ошибок, измененные версии (SEMVER).
v1.1.x	Документация, модульные тесты, пилинты, ошибки, изменения в ATWSS.
v1.1.2/v2.0.0	Решение для #25 (CloudFlare обходит), ошибки в JS -анализаторе.
v2.0.x	Документация, автоматическое сохранение/восстановление сеанса, улучшения в API файлов.
v2.1.x	Исправлено в API WebSockets, AtConnect (включая освежающее исправление cookie). Поддержка услуг по решению CAPTCHA (View #52).
v2.2.x	Node.js Поддержка интерпретатора.
v3.0.0	Частично переписано, обновления API.
v3.0.5	Невозможно.
v3.1.x	TODO: Полная реализация конфигурации API.
v3.2.x	TODO: Shared Access API и, возможно, Google Drive Резервные копии.

Обратный спецификация API

Частные запросы API API API были захвачены в этот файл HAR и были импортированы в рабочее пространство почтальона.
Вы можете использовать оба ресурса для изучения API.
Любая помощь в улучшении этой библиотеки приветствуется.

Лицензия

Уведомление о лицензии:

 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.