mirror of
https://github.com/MihailRis/voxelcore.git
synced 2026-11-21 18:09:46 +00:00
Merge a98fcbfa6a into f0a407c20a
This commit is contained in:
commit
1ea95e0c24
2 changed files with 120 additions and 0 deletions
|
|
@ -35,9 +35,26 @@ entity:set_enabled(name: str, enable: bool)
|
|||
-- Возвращает id игрока, к которому привязана сущность, в ином же случае возвращает -1.
|
||||
-- Во время инициализации компонентов при спавне сущности также возвращает -1,
|
||||
-- так как привязка происходит после инициализации.
|
||||
-- Возвращает nil, если сущность не существует.
|
||||
entity:get_player() -> int или nil
|
||||
```
|
||||
|
||||
### Сущность игрока
|
||||
|
||||
Сущность, привязанная к игроку, служит его телом: позиция игрока берётся
|
||||
из её Transform, а хитбокс игрока - это её Rigidbody. Движок спавнит такую
|
||||
сущность автоматически по определению из параметра `player-entity` файла
|
||||
`config/defaults.toml` (в паке base - `base:player`) и привязывает её к игроку.
|
||||
ID сущности игрока возвращает `player.get_entity(playerid)`.
|
||||
|
||||
`entity:get_player()` позволяет отличить сущность игрока от прочих сущностей
|
||||
и узнать, какому игроку она принадлежит. Например, компонент выпавшего предмета
|
||||
`base:drop` при касании другой сущности проверяет `other:get_player()`:
|
||||
игрок подбирает предмет, а другой выпавший предмет объединяется с ним в стопку.
|
||||
|
||||
Чтобы выполнить код в момент привязки, используйте событие компонента
|
||||
[on_player_set](#события-компонента).
|
||||
|
||||
## Встроенные компоненты
|
||||
|
||||
### Transform
|
||||
|
|
@ -102,6 +119,7 @@ body:is_vdamping() -> bool
|
|||
-- Возвращает множитель вертикального затухания скорости
|
||||
body:get_vdamping() -> number
|
||||
-- Включает/выключает вертикальное затухание скорости / устанавливает значение множителя
|
||||
-- (true соответствует 1.0, false - 0.0)
|
||||
body:set_vdamping(enabled: bool | number)
|
||||
|
||||
-- Проверяет, находится ли сущность на земле (приземлена)
|
||||
|
|
@ -141,6 +159,48 @@ body:is_selectable() -> bool
|
|||
body:set_selectable(flag: bool)
|
||||
```
|
||||
|
||||
#### Затухание скорости
|
||||
|
||||
После расчёта движения скорость тела за каждый кадр меняется так
|
||||
(`delta` - длительность кадра в секундах):
|
||||
|
||||
```lua
|
||||
-- псевдокод
|
||||
local k = body:is_grounded() and 10.0 or body:get_linear_damping()
|
||||
local ground_vel = body:get_ground_vel()
|
||||
|
||||
vel.x = vel.x + (ground_vel.x - vel.x) * delta * k
|
||||
vel.z = vel.z + (ground_vel.z - vel.z) * delta * k
|
||||
if body:get_vdamping() > 0 then
|
||||
vel.y = vel.y / (1 + delta * k * body:get_vdamping())
|
||||
end
|
||||
```
|
||||
|
||||
**linear_damping** (по умолчанию 0.5) - скорость затухания горизонтальной
|
||||
скорости относительно поверхности, на которой находится тело. Значение не
|
||||
ограничено диапазоном 0..1:
|
||||
- 0 - затухания нет, тело в воздухе сохраняет горизонтальную скорость;
|
||||
- чем больше значение, тем быстрее затухание: горизонтальная скорость
|
||||
уменьшается примерно в e^(k*t) раз за t секунд. При 0.5 она падает вдвое
|
||||
примерно за 1.4 с, при 10 - примерно за 0.07 с;
|
||||
- при `delta * k = 1` (например, k = 60 при 60 FPS) скорость гасится
|
||||
за один кадр. Значения больше этого дают перескок через скорость
|
||||
поверхности, а при `delta * k > 2` скорость начинает расти.
|
||||
|
||||
Пока тело стоит на земле (`body:is_grounded()`), вместо установленного
|
||||
значения используется фиксированное значение 10 (трение о поверхность),
|
||||
поэтому `set_linear_damping` влияет только на движение в воздухе.
|
||||
|
||||
**vdamping** (по умолчанию 1.0) - множитель затухания вертикальной скорости
|
||||
относительно `k`. На горизонтальное затухание не влияет:
|
||||
- 0 (или `false`) - вертикальная скорость не затухает;
|
||||
- 1 (или `true`) - вертикальная скорость затухает так же быстро, как горизонтальная;
|
||||
- значения больше 1 усиливают вертикальное затухание, меньше 1 - ослабляют.
|
||||
|
||||
Вертикальное затухание ограничивает скорость падения: при постоянной
|
||||
гравитации она стремится примерно к `g * gravity_scale / (k * vdamping)`,
|
||||
где `g` - ускорение свободного падения в мире.
|
||||
|
||||
### Skeleton
|
||||
|
||||
Компонент отвечает за скелет сущности. См. [риггинг](../rigging.md).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue