hp_max

число видно другим игрокам со своим кодом
Максимальное количество очков здоровья сущности, игрока в том числе.
Стартовое значение
5
Кому выдаётся
bot enemy animal player
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

Записано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.

Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.

<?php
# Потолок запаса здоровья ниже единицы делает существо нечинимым: восстановление поднимает запас только ниже потолка,
# а порог бегства считается долей от потолка и вырождается в ноль. Значение задаётся контентом (префаб
# либо переопределение записи сущности), потому отбиваем его здесь, а не у каждого потребителя.
if(!is_numeric($value) || $value <= 0)
	throw new Error('Потолок запаса здоровья должен быть больше нуля, получено '.var_export($value, true));

# Запас выше потолка не приводится к норме ничем: восстановление ограничено потолком и такой запас не трогает,
# а порог бегства меряет запас долей потолка — существо не побежит и при смертельном уроне. Запас читается
# отсюда и при рождении существа: значения всех компонентов проставлены до вызова триггеров. Опустить потолок
# ниже текущего запаса контент не может — сперва опускается запас.
if($object->components->exists('hp') && $object->components->get('hp') > $value)
	throw new Error('Запас здоровья '.var_export($object->components->get('hp'), true).' выше потолка '.var_export($value, true));
К игре