Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/Titlehhhh-patch-1' into release/…
Browse files Browse the repository at this point in the history
…2.0.0-preview.2
  • Loading branch information
TitleHHHH authored and TitleHHHH committed Jan 6, 2024
2 parents 4e6aefa + 8bf237a commit 719608f
Show file tree
Hide file tree
Showing 7 changed files with 137 additions and 35 deletions.
118 changes: 92 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,108 @@
[![Discord Banner](https://img.shields.io/badge/discord-join%20chat-46BC99)](https://discord.gg/HVDzx4rCgg)
<h1 align="center">
<img src="https://raw.githubusercontent.com/Titlehhhh/Minecraft-Holy-Client/master/mhc.svg" alt="Minecraft Holy Client">
</h1>

*На данный момент программа находится в предварительной версии, поэтому некоторые функции нестабильны. Подробнее можно узнать [здесь](preview.md).*

# Minecraft Holy Client
<h4 align="center">A high-performance platform for running stress-testing minecraft bots.</h4>

Высокопроизводительная платформа для запуска стресс-тест ботов Minecraft, написанная на C#.
<p align="center">
<a href="https://github.com/Titlehhhh/Minecraft-Holy-Client/commits/master">
<img src="https://img.shields.io/github/last-commit/Titlehhhh/Minecraft-Holy-Client.svg?style=flat-square&logo=github&logoColor=white"
alt="GitHub last commit">
<a href="https://github.com/Titlehhhh/Minecraft-Holy-Client/issues">
<img src="https://img.shields.io/github/issues-raw/Titlehhhh/Minecraft-Holy-Client.svg?style=flat-square&logo=github&logoColor=white"
alt="GitHub issues">
<a href="https://github.com/Titlehhhh/Minecraft-Holy-Client/pulls">
<img src="https://img.shields.io/github/issues-pr-raw/Titlehhhh/Minecraft-Holy-Client.svg?style=flat-square&logo=github&logoColor=white"
alt="GitHub pull requests">
<a href="https://discord.gg/HVDzx4rCgg">
<img src="https://img.shields.io/badge/discord-join%20chat-46BC99"
alt="Discord">
<a href="https://github.com/Titlehhhh/Minecraft-Holy-Client/releases">
<img src="https://img.shields.io/github/downloads/Titlehhhh/Minecraft-Holy-Client/total.svg"
alt="Download">

## Get Started
</p>

[Скачайте в релизах](https://github.com/Titlehhhh/Minecraft-Holy-Client/releases) последнюю версию Minecraft Holy Client и запустите её.

После запуска приложения Вас встретит окно с главной страницей.
![image](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/4d582c49-13bd-44c7-81b4-f6ebd5b924cd)
<p align="center">
<a href="#installation">Installation</a> •
<a href="#launch">Launch</a> •
<a href="#features">Features</a> •
<a href="#contributing">Contributing</a> •
<a href="#support">Custom plugin</a> •
<a href="#license">License</a>
</p>

После открытия навигационного меню Вы увидите несколько пунктов:
- Главная. Страница где есть основная информация о приложении: GitHub, Наш Discord сервер, а также документация(в разрботке).
- Бот менеджер. Эта экспериментальная функция. Планируется в программу добавить простых ботов, таких как, боты афк-рыбалки или подобные.
- Настройки. Вы можете настроить язык. Пока можно настроить только это.
- Стресс-тест. Основная возможность приложения. Здесь Вы можете протестировать Ваш сервер под высокой нагрузкой.
- Управление расширениями. Здесь Вы можете добавить свои плагины в программу.
![image](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/3a156e06-bd3c-4882-9c5c-ce123c14b9c2)
---

### Запуск стресс-теста

1) Перейдем на страницу Стресс-тест и введем Ip адрес сервера, который мы хотим нагрузить.
2) Далее поставить префикс ника для ботов. Пусть будет "Title_"
3) Затем укажем количество ботов. Это количество, которое система будет стремиться запустить. Например 1000.
4) Укажем, что нужно в тестировании использовать прокси сервера, а также укажем версию 1.16.5.
5) В настройках поведения укажем, чтобы боты спамили "Hello from Minecraft Holy Client".
![image](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/fdbab77e-0eed-44ed-bbe3-30e6d100802b)
<table>
<tr>
<td>

Нажимаем на зеленую кнопку видим, что боты зашли на сервер и спамят "Hello from Minecraft Holy Client"
![image](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/51c89585-1fd5-4351-9677-a59322ececd7)
**Minecraft Holy Client** is a handy, **high-performance**, easily extensible **open-source** application designed to run load and stress-test **Minecraft** bots, written in C#.

All components of the application have been designed to **maximize performance**, so it works stably on **weak devices**.

## Roadmap

![image](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/cee54a39-b6e5-4e10-b329-ec0230eb43b4)
![Minecraft Holy Client Bots](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/75c9f0a3-8ae2-4b7c-8ad5-e8b5fa120165)
<p align="right">
<sub>(Preview 300~ bots)</sub>
</p>

</td>
</tr>
</table>

## Installation

Minecraft Holy Client is available for **Windows**, **Linux** and **MacOs**. In addition, it is **portable** and is not installed on the system, so it can be easily uninstalled.

[Download](https://github.com/Titlehhhh/Minecraft-Holy-Client/releases) the latest version of HolyClient.Desktop and follow these instructions depending on your platform.

### Windows

1) Open and _extract_ the archive with the program.
2) Run **HolyClient.Desktop.exe**

### Linux

_Using Ubuntu as an example_

1) Open and _extract_ the archive with the program.
2) Open a terminal where the HolyClient.Desktop file is located and execute `./HolyClient.Desktop` in the console

### Mac Os

1) Open and _extract_ the archive with the program.
2) Open a terminal where the HolyClient.Desktop file is located and execute `./HolyClient.Desktop` in the console


## Launch

When we have launched the app, then we can safely go to the "Stress Test" tab and we can launch bots.



![image](https://github.com/Titlehhhh/Minecraft-Holy-Client/assets/93156853/55769ef1-f81d-477d-9027-02dfa0339f80)


## Features

- **Custom proxies**. It is possible to load custom proxies from a link and a file.
- **Multiverse in bots**. Bots can enter servers from 1.12.2 to 1.19.3. Temporarily not all packets are supported, this is being actively worked on.
- **Using user behavior for stress testing**.

## Contributing

Contributions are always welcome!

## Custom plugin

The default plugin has few features. It just sends `/register <pass> <pass>` first and starts spamming immediately.
Minecraft servers are a large number, with different anti-bot systems and if you want to test your server for bot attacks, it makes sense to write a custom plugin that would bypass it. How to write custom plugins is written here.



Expand Down
2 changes: 1 addition & 1 deletion ReleaseNotes/2.0.0-preview.1/En.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
> [!WARNING]
> Disclaimer: This translation was generated using AI.
# What's New in Minecraft Holy Client *2.0.0-preview.1*?
# What's New in Minecraft Holy Client **2.0.0-preview.1.1**?

## Major Fixes

Expand Down
2 changes: 1 addition & 1 deletion ReleaseNotes/2.0.0-preview.1/Ru.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Что изменилось в Minecraft Holy Client *2.0.0-preview.1*?
# Что изменилось в Minecraft Holy Client **2.0.0-preview.1.1**?

## Основные исправления

Expand Down
2 changes: 2 additions & 0 deletions changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
- memory performance
- default plugin /reg to /regoster
10 changes: 3 additions & 7 deletions preview.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,22 +2,18 @@

Этот раздел может меняться в течение разработки. Все изменения будут написаны в заметках о выпуске предварительной версии.

# Функции, которые нужно добавить

## Плагины
- Плагин, который будет установлен в программу по умолчанию. Это упростит использование программой простым пользователям.
# Плагины
- Возможность перезагружать плагины из менеджера расширений, а также из вкладки "Поведения".
- Возможность загружать плагины из NuGet.
- Отображение ошибки, если плагин не найден.
- Отображение ошибки, если поведение не найдено.

## Прокси
- Прокси по умолчанию.
- Возможность загружать прокси из URL источников, например, из открытых репозиториех GitHub с бесплатными списками прокси.
# Прокси
- Возможность загружать прокси с логином и паролем.
- Отображение количества загруженных прокси в окне с запуском стресс теста.
- Возможность загружать разные типы прокси(HTTP(S), Socks(4/5)) из одного источника.

## Прочее
# Прочее
- Система профилей в стресс тесте.

Binary file added roadmap.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 38 additions & 0 deletions tasks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
- Вырезать бот менеджер
- на главную страницу добавить ссылку на Release Notes


# General

- Сделать систему профилей
- Number of bots переименовать во что то связанное с паралелностью
- Сделать возможность загрузки прокси с логином и паролем
- сделать возможность загрузки разных прокси из одного источника
- Добавить флажок "Загрузка офлайн" у файла и ссылки
- добавить больше настроек в поведение
- В процессе добавить две вкладки:
- Графики с метриками
- Популярные исключения

- Генерация отчетов на основе стресс-теста
- Разделение чекинга прокси и стресс-теста
- Добавить вкладку с атакой разными методами
- Динамическая перезагрузка плагинов
- Загрузка плагинов из NuGet
- В настройках сделать красиво
- Добавить автообновление программы
- В процессе кнопку отмены вынести отдельно и красиво и перекрасить в красный

# Documentation

Сделать документацию по созданию плагинов

# Future

Сделать генерацию пакетов с помощью codegen


# Readme

- добавить RoadMap
- Добавить release notes

0 comments on commit 719608f

Please sign in to comment.