Экономика и Банк SL

Банковская система SL объединяет: - личные карты игроков (баланс в АР), - государственную казну (Treasury), - судебные штрафы (Fine) и их оплату через банк.

Управление картами и переводами доступно в личном кабинете банка на сайте.

Роли и доступ

Игрок

• Имеет до 4 карт одновременно.
• Делает переводы между своими картами и чужими картами через сайт.
• Может оплачивать штрафы через сайт.
• Может менять цвет своей карты в кабинете.

Банкир

Банкир — это роль Discord (название содержит банкир ) или админ.

Права банкира: - Выполнять банковские команды через Minecraft/веб-консоль (см. ниже).

Судья / Детектив

Судья/детектив — роль Discord (название содержит судья/judge или детектив/detective).

Права: - Выписывать штрафы.

Карты: правила выпуска и лимиты

Общие лимиты

• Максимум карт на игрока: 4
• Максимум новых карт в сутки: 3

Стоимость выпуска

• Первая карта игрока — бесплатно.
• Каждая следующая — 5 АР комиссии в казну.

[!IMPORTANT] Комиссия за выпуск списывается с первой доступной карты игрока (если не указана конкретная карта для оплаты через сайт).

Закрытие карты

При закрытии карты остаток средств: - переносится на другую активную карту владельца, или - если других карт нет — уходит в казну.

Казна (Treasury)

Казна — это специальная карта.

[!NOTE] Часть операций банкира всегда так или иначе упирается в казну: комиссии, “mint”, выплаты из казны.

Команды (Minecraft / API консоль)

Ниже — точный синтаксис команд, которые реально понимает обработчик команд.

[!IMPORTANT] В командах “игрок_или_карта” можно указывать: - номер карты XXXX XXXX - номер карты без пробела XXXXXXXX - ник игрока (будет взята его первая по времени карта)

Команды банкира

1) /deposit — зачисление игроку (Minecraft Sync)

Зачисляет АР на карту игрока и берет комиссию 1% в казну (округление комиссии вверх отдельно по каждому типу руды).

/deposit <игрок_или_карта> <сумма> [комментарий]

Параметры - игрок_или_карта — получатель - сумма — целое число АР (> 0) - комментарий — опционально (до 255 символов). Если не указан: Синхронизация из Minecraft.

Особенность (руда) Команда поддерживает раздельный ввод источника суммы: - stone_count — обычная руда - deepslate_count — глубинная руда

Если эти значения не переданы, считается что вся сумма — обычная руда.

Комиссия - 1% в казну

Итог к зачислению = сумма - комиссия

[!IMPORTANT] По логике системы /deposit — это “внести в банк добытую руду”: игрок получает сумму за вычетом 1%, а комиссия улетает в казну.

2) /withdraw — снятие с карты (выдача “наличкой”)

Списывает сумму с карты игрока и возвращает “что выдать” в виде количества обычной/глубинной руды (пропорционально балансу карты).

/withdraw <игрок_или_карта> <сумма> [комментарий]

Параметры - игрок_или_карта — с кого списываем - сумма — целое число АР (> 0) - комментарий — опционально (до 255). Если не указан: Снятие наличных.

Что реально происходит - Баланс уменьшается на сумма - Внутри баланса есть разбиение на: - stone_balance - deepslate_balance - Система пытается подобрать целые числа блоков к выдаче пропорционально текущей структуре баланса, с небольшими допусками по округлению.

[!NOTE] Это сделано, чтобы “снятие” соответствовало тому, из какой руды исторически сформирован баланс карты.

Команды судьи / детектива

3) /fine — выписать штраф

Создает штраф со сроком оплаты. Штраф привязывается к карте нарушителя (по нику или номеру карты) и к карте получателя.

/fine <нарушитель> <получатель> <сумма> <кол_во_дней> <причина>

Параметры - нарушитель — ник или карта - получатель — ник или карта (обязателен в этой команде) - сумма — целое число АР (> 0) - кол_во_дней — целое число (> 0) - причина — обязательна, до 255 символов

Правила - нарушитель и получатель не могут совпадать - штраф создается со статусом unpaid - дата оплаты = “сейчас + N дней”

[!IMPORTANT] Если вам нужен штраф “в казну”, это делается через интерфейс сайта (там получатель может быть пустым). В командном обработчике /fine получатель обязателен.