Minescript HUD Addon

Minescript HUD Addon

Этот мод добавляет возможность рисовать собственные элементы HUD в Minescript.

Для отрисовки объектов в мире я сделаю отдельный мод.

Документацию можно найти в вики.

Баги/Фичи

Если у вас есть предложения или вы нашли баги, пожалуйста, заполните эту гугл-форму.

сейчас работаю над добавлением отрисовки в мире.

## Возможности - Рисовать *текст* на HUD - Рисовать *прямоугольники* и градиентные прямоугольники - Отрисовывать *предметы* - Отрисовывать *текстуры* - Отрисовывать *собственные фигуры* - *Анимировать* все свойства элементов - *Определять* наведение и клики мыши - Управлять *длительностью отображения* и *слоями отрисовки*
## Установка 1. Установите Minescript. 2. Поместите этот аддон в папку mods. 3. Запустите игру.
## Пример ```python from hud_renderer import *

add_text("Hello World",x=10,y=10,color=argb(255,255,255,255),shadow=True,display_duration=5)

<br></br>
## Анимации
Все элементы HUD можно анимировать с помощью функций анимации.
```python
from hud_renderer import *

def move(text:TextObject):
    text.x+=1

_id=add_text("I can MOVE!",x=10,y=10,color=Colors.WHITE,shadow=True,display_duration=5)

animate_text(_id,move)

## События мыши Все объекты могут определять наведение и клики мыши. ```python from minescript import echo from hud_renderer import *

def hover(text:TextObject,mouse:MouseObject,exited:bool): if (exited): text.color=Colors.WHITE else: text.color=Colors.GREEN

def click(text:TextObject,mouse:MouseObject): echo("Clicked!")

_id=add_text("Click me!",x=10,y=10,color=Colors.WHITE,shadow=True,display_duration=10)

add_mouse_callbacks_and_wait(_id,on_hover=hover,on_click=click)

<br></br>
## Система слоёв
Элементы отрисовываются по слоям.
Элементы с большим значением слоя отрисовываются поверх элементов с меньшим.
<br></br>
## Обзор API
> Более подробное API можно найти в [вики](https://maksymiblue12.github.io/Minescript-Hud-Addon/).
### Текст
 - `add_text(...)`
 - `add_text_with_background(...)`
 - `add_advanced_text(...)`
 - `add_advanced_text_with_background(...)`
 - `animate_text(...)`
 - `animate_text_with_background(...)`

### Прямоугольники
 - `add_rectangle(...)`
 - `add_rectangle_from_corners(...)`
 - `add_gradient_rectangle(...)`
 - `add_stroked_rectangle(...)`
 - `animate_rectangle(...)`

### Предметы
 - `add_item(...)`
 - `add_advanced_item(...)`
 - `animate_item(...)`

### Текстуры
> **Примечание:** Собственные текстуры должны быть добавлены ресурспаком в папку `assets/minescripthud/textures/gui/sprites/`.
 - `add_texture(...)`
 - `add_advanced_texture(...)`
 - `animate_texture(...)`

### Фигуры
 - `add_shape(...)`
 - `add_advanced_shape(...)`
 - `animate_shape(...)`
 - `add_line(...)`
 - `add_multiline(...)`
 - `add_triangle(...)`
 - `add_quad(...)`
 - `add_circle(...)`
 - `add_ellipse(...)`

### Сглаженные фигуры (с плавными краями)
- `add_anti_aliased_shape(...)`
- `add_advanced_anti_aliased_shape(...)`
- `animate_anti_aliased_shape(...)`
- `add_line_with_thickness(...)`
- `add_anti_aliased_quad(...)`
- `add_anti_aliased_rectangle(...)`
- `add_anti_aliased_rectangle_with_round_corners(...)`
- `get_points_for_circle(...)`
- `add_anti_aliased_circle(...)`
- `get_points_for_ellipse(...)`
- `add_anti_aliased_ellipse(...)`

### Вспомогательные функции
 - `argb(...)`
 - `argb_to_int(...)`
 - `alpha_from_int(...)`
 - `add_async_mouse_callbacks(...)`
 - `add_mouse_callbacks_and_wait(...)`
 - `wait_until_removed(...)`
 - `remove_element(...)`
 - `clear()`
 - `suppress_done_message()`