Библиотеки

Фильтр
Сбросить

Библиотеки — готовый код для механик игры: поиск пути, реестр методов и т.п.

Библиотеку ставят в свою игру — в том числе взятую со страницы Игры — и пользуются кодом библиотеки в своих механиках. Работает библиотека поверх фреймворка игры — общего кода, на котором стоят все механики игры.

Инвентарь и торговля
Держит правила хранилищ вещей и торговли: куда ложится вещь в инвентаре существа и в добыче — тела, сундука либо лавки торговца, — кому достаётся добыча, по какой цене торговец продаёт и покупает. Устройство Правила: из чего состоит запись вещи: префаб, количество и свои значения компонентов; в какой слот инвентаря ложится вещь; как вещь ложится в добычу: у одной вещи одна запись, разных вещей не больше предела — столько, сколько слотов в значении «По умолчанию» компонента inventory; розыгрыш таблицы добычи; кому доступна добыча и в каком порядке к ней допускают игроков (по вкладу урона, отсчёт status/lootfree); цены торговца и расчёт монет. Правила общие для инвентаря существа, добычи тела либо сундука и лавки — потому лежат одним носителем, а не в триггере компонента-владельца формата: триггер срабатывает лишь на существе с таким компонентом, и на карте без таких существ добыча звала бы несуществующую функцию. Методы статические и зовутся напрямую (Inventory::findSlot, Trade::price) — без реестра замыканий: тот идёт через магию PHP и стоит около 0.2 мкс на вызов сверх прямого. Что нужно игре Пока описанием — объявления зависимостей у библиотек ещё нет: фреймворк rpg2d (php): классы World, ComponentCollection, EntityAbstract, Player; компоненты inventory (словарь слотов; его значение «По умолчанию» задаёт ёмкость инвентаря и предел разных вещей в добыче), loot, price, trade, hp; группа команд status/lootfree — ею закрепляется добыча за игроками; префаб валюты с идентификатором coin — им идёт расчёт в торговле.
Поиск пути A*
Ищет путь по карте алгоритмом A*: учитывает проходимость клеток и их «цену» — по дороге существо идёт охотнее, через болото неохотнее. Цену клетки задают в редакторе карт Tiled. Пример использования — механика движения к цели в игре The Mana World: events/move/walk/to.php. Устройство Поиск пути A* с binary heap: Open list использует BinaryHeap (extractBest O(log n)) вместо линейного поиска. Closed list — NodeHashTable (O(1) lookup по id). DomainLogic адаптирует A* к карте Map2D: getAdjacentNodes — соседи из графа Map2D (8 направлений, tunneling prevention); calculateRealCost — вес ребра из графа (1.0 ортогональ, 1.41 диагональ, умножается на cost тайла); calculateEstimatedCost — Euclidean distance. Веса местности (cost) Дизайнер ставит property cost на SizeTile в Tiled (float, множитель, по умолчанию 1.0). Примеры: дорога cost=0.5 (быстрее), болото cost=3.0 (медленнее), лава cost=999 (почти непроходима). Cost попадает через мету набора графики → sandbox terrain → граф Map2D → DomainLogic::calculateRealCost(). Формула: realCost = baseCost (1.0 или 1.41) * targetTile.cost. Что нужно игре Пока описанием — объявления зависимостей у библиотек ещё нет: фреймворк с Map2D (матрица проходимости целиком — terrain, проверка общей связной области sameArea), Position (разделитель координат), PHP (журнал), Perfomance (замер). Связь односторонняя: при первом поиске библиотека берёт у фреймворка матрицу проходимости (Map2D::terrain) и сама зовёт DomainLogic::init. Фреймворк о библиотеке не знает: без неё карта поднимается, недоступным остаётся только движение к цели.
Реестр методов
Реестр разделяемых функций песочницы: имя → замыкание, положенное на лету кодом механик. Общий код нескольких механик (триггер компонента и команды, которые с ним работают) живёт у своего владельца — в коде компонента, — а реестр даёт остальным дотянуться до него по имени, без отдельной библиотеки под каждую механику. Владелец имени один: он кладёт замыкание (addMethod), остальные проверяют наличие (hasMethod) и вызывают как обычный статический метод. Повторная регистрация имени запрещена — два разных тела под одним именем разъезжаются молча. Вызов идёт через магию PHP и потому дороже прямого статического: для механик, работающих по команде игрока, разницы нет, на кадровый путь (тик, движение, столкновения) реестр не тащить.
Сущности
библиотека показывает как можно переопределить классы сущностей. Для того что бы это работало в коде IN необходиом делать return этих новых обектов