Merge branch 'main' into main

This commit is contained in:
Astazium 2026-10-15 16:19:06 +03:00 • committed by GitHub
commit bf59e520a7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
109 changed files with 1908 additions and 474 deletions

View file

@ -1,8 +1,5 @@
# Документация
> [!WARNING]
> Версия находится в разработке. Перейдите к [документации для 0.31.](https://github.com/MihailRis/voxelcore/blob/release-0.31/doc/ru/main-page.md)
## Разделы
- [XML разметка интерфейса](xml-ui-layouts.md)

View file

@ -78,6 +78,9 @@ file.stem(путь: string) -> string
-- Извлекает расширение из пути. Пример: `world:data/base/config.toml` -> `toml`.
file.ext(путь: string) -> string
-- Возвращает путь без расширения. Пример: `world:data/base/config.toml` -> `world:data/base/config`.
file.remove_ext(путь: string) -> string
```
## Директории
@ -145,4 +148,4 @@ file.open(путь: string, режим: string) -> io_stream
-- * `/tmp/` или `\\\\.\\pipe\\` добавлять не нужно - движок делает это автоматически.
-- * Недоступен режим с `+`
file.open_named_pipe(имя: string, режим: string) -> io_stream
```
```

View file

@ -42,8 +42,14 @@ skeleton:is_visible([опционально] index: int) -> boolean
skeleton:set_visible([опционально] index: int, status: boolean)
-- Возвращает цвет сущности
skeleton:get_color() -> vec3
skeleton:get_color() -> vec4
-- Возвращает цвет кости
skeleton:get_color(index: int) -> vec4
-- Устанавливает цвет сущности
skeleton:set_color(color: vec3)
```
skeleton:set_color(color: vec4)
-- Устанавливает цвет кости
skeleton:set_color(color: vec4, index: int)
```

View file

@ -50,7 +50,7 @@ network.get(
)
-- Пример:
network.get("https://api.github.com/repos/MihailRis/VoxelEngine-Cpp/releases/latest", function (s)
network.get("https://api.github.com/repos/MihailRis/voxelcore/releases/latest", function (s)
print(json.parse(s).name) -- выведет имя последнего релиза движка
end)

View file

@ -174,9 +174,11 @@ rig:index(name: str) -> int
-- или всего скелета, если индекс не указан
rig:is_visible([optional] index: int) -> bool
-- Устанавливает статус видимости всего скелета
rig:set_visible(status: bool)
-- Устанавливает статус видимости кости по индексу
-- или всего скелета, если индекс не указан
rig:set_visible([optional] index: int, status: bool)
rig:set_visible(index: int, status: bool)
-- Возвращает цвет сущности
rig:get_color() -> vec4

View file

@ -20,6 +20,8 @@ packid.binding.name="inputtype:codename"
- a..z
- 0..9
- f1..f25
- grave-accent, minus, equal, left-bracket, right-bracket, backslash
- semicolon, apostrophe, comma, period, slash
## Библиотека input

View file

@ -27,6 +27,7 @@ VCA файл состоит из набора директив, порядок
- `@rotate` - поворот объекта/кости
- `@scale` - масштабирование объекта/кости (множитель)
- `@zoom` - масштаб камеры (множитель)
- `@texture` - смена динамически-назначаемой текстуры (см. [skeleton:set_texture](scripting/ecs.md#skeleton))
## Мета-информация
@ -73,6 +74,28 @@ VCA файл состоит из набора директив, порядок
@key frame 138 value 53.00411 lx 127.067 ly 53.00411 rx 138.001 ry 53.00411
```
Для директивы texture всё проще. Пример:
```vcd
@texture name $0 {
@key frame 0 value entities/tireman:face_0
@key frame 24 value entities/tireman:face_1
}
```
> entities/tireman здесь - имя текстурного атласа, в котором находятся face_\* текстуры.
> Текстура не обязательно должна находиться в атласе.
Если вы не хотите ограничивать длительность анимации через `configure`, но хотите зациклить анимацию по ключевым кадрам для конкретной линии, то можно использовать параметр `period` для указания периода повторения анимации в кадрах. Пример:
```vcd
@move by y curve linear period 24 {
@key frame 0 value 0
@key frame 12 value 1
@key frame 24 value 0
}
```
## Кривые через выражения
Через атрибут описывается функция `f(t) = x` где t - время в секундах.

View file

@ -42,6 +42,7 @@
- `region-scale` вектор-множитель для UV региона. Пример: `region-scale (0.5,1)`
- `shading` определяет возможность затенения на примитиве. Пример: `shading off`
- `normal` переопределяет вектор нормали. Пример: `normal (0,1,0)`
- `cull-face` - определяет, какая сторона будет отсечена. Пример: `cull-face front` или `cull-face off` (отлючает отсечение сторон)
Текстурные координаты по-умолчанию не зависят от формы из размера, в отличие от других примитивов.
@ -58,6 +59,7 @@
- `shading` - определяет возможность затенения на примитиве. Пример: `shading off`
- `flip` - отражает UV регион по горизонтали или вертикали. Пример: `flip v`
- `normal` - переопределяет вектор нормали. Пример: `normal (0,1,0)`
- `cull-face` - определяет, какая сторона будет отсечена. Пример: `cull-face front` или `cull-face off` (отлючает отсечение сторон)
### Свойства `box`

View file

@ -216,6 +216,9 @@
> [!WARNING]
> Расположение инвентарей управляется движком и не может быть изменено свойствами pos, margin и т.д.
> [!WARNING]
> Слоты без привязки к инвентарю не будут отображаться. Под приязкой к инвентарю понимается связь UI элемента inventory с инвентарём по id. Которая может быть явно создана через `inventory_ui.inventory = inventory_id`. [(см ui.md)](scripting/ui.md#инвентарь-inventory)
## Одиночный слот - *slot*
Элемент должен находиться внутри `inventory` элемента, без посредников.