SG-Economy API

SG-Economy API — это современный инструмент для создания гибких экономических систем в Minecraft. Мод работает как API, предоставляя разработчикам и администраторам способы управления балансами через унифицированный интерфейс.

SG-Economy API добавляет в игру масштабируемую экономическую систему, которая позволяет игрокам, создателям сборок, разработчикам и администраторам серверов создавать собственные экономики простым и последовательным способом.

Основу системы составляет постоянный числовой баланс, напрямую связанный с данными игрока. Важно понимать, что этот баланс не представлен игровыми предметами — он работает как «виртуальный кошелек», название, значение и способы использования которого могут меняться в зависимости от конкретной реализации или интеграции с другими модами.

Система поддерживает использование как целых (integer), так и десятичных (decimal) значений. Это позволяет адаптировать экономику под разные задачи: от простых валют до сложных систем с копейками или центами. Настройка формата хранимого баланса осуществляется через конфигурационный файл.

Проект предоставляет полноценный набор инструментов для глубокой интеграции:

• Документированные классы и методы для запроса и изменения балансов игроков.
• Возможности нативной интеграции с другими модами.
• Инструменты для создания полностью кастомных экономических систем.
• Практические примеры и руководства по реализации в официальном репозитории GitHub.

Для управления экономикой в игре предусмотрены команды, позволяющие проверять баланс, добавлять, устанавливать или удалять значения, а также переводить средства между игроками (опционально). Все команды можно включать или отключать в зависимости от потребностей сервера.

Мод обеспечивает визуальное отображение экономического баланса игрока в интерфейсе инвентаря или на экране. Отображаемое значение соответствует только данным в профиле игрока и не имеет никакой связи с физическими предметами в инвентаре.

Поведение экономической системы можно детально настроить через конфигурационные файлы. Доступны параметры изменения формата валюты, правил сохранения баланса, списка доступных команд и вариантов отображения интерфейса.