Profitable

О плагине

Profitable - это плагин экономики для Minecraft, который привносит в игру реальный спрос и предложение через систему биржевых ордеров. В отличие от обычных магазинов с фиксированными ценами или простым линейным изменением, здесь цены определяют сами игроки. Каждая покупка или продажа влияет на рынок, а стоимость активов меняется динамически, как на настоящей бирже.

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

Особенности плагина

Ключевые возможности

• Цены, устанавливаемые игроками - каждый может влиять на рынок через свои ордера.
• Мгновенные транзакции по лучшей цене - система автоматически подбирает подходящий ордер.
• Частичное исполнение - если ордер не полностью удовлетворяет запрос, сделка делится на части.
• Мультивалютные кошельки - поддержка разных активов на одном счёте.
• Офлайн-транзакции - ордера исполняются даже когда игрок не в сети.
• Торговля предметами, сущностями и валютами - покупай и продавай что угодно.
• Валютный обмен (Forex) - торговля одной валютой против другой.
• Продвинутая торговля - лимитные и стоп-лимитные ордера.
• Графики свечей - визуализация цен для анализа.
• Комиссии (налоги) - настраиваемые сборы за транзакции.
• Автоматическая миграция БД - не нужно беспокоиться о версиях.
• Поддержка MySQL - для крупных серверов.
• Полная поддержка Folia - работа на многопоточных серверах.

Интеграция

• Vault - работает со всем, что поддерживает Vault (например, EssentialsX, CMI).
• PlayerPoints - поддержка баллов игроков.

Файл конфигурации

# поддержка валюты Vault - её можно добавлять как актив, выводить и депонировать
vault-support: true

# поддержка PlayerPoints
player-points-support: true

colors: # настройка цветов для команд и графиков
  # цвет для роста цены (hex)
  bullish: "#8CD740"
  # цвет для падения цены (hex)
  bearish: "#FA413B"

database:
  # если true - ордера работают в пределах одного мира
  data-per-world: false
  # (0) SQLite, (1) MySQL
  database-type: 0
  mysql:
    host:
    port:
    database:
    username:
    password:
    options: "?useSSL=true&requireSSL=true&serverTimezone=UTC&allowPublicKeyRetrieval=true"

exchange:
  fees: # фиксированная или процентная комиссия
    withdrawal-fees: 0
    deposit-fees: 0

  commodities:
    fees:
      taker-fees: 0   # комиссия при мгновенной сделке
      maker-fees: 0   # комиссия при добавлении ордера в стакан
      entity-claiming-fees: 0  # комиссия при заявке на сущность (фиксированная)

    # при true товары появляются в точке доставки, иначе зачисляются в кошелёк
    physical-delivery: true
    # разрешить брать товары из кошелька
    take-wallet: true
    # разрешить брать предметы из инвентаря
    take-inventory: true
    # разрешить брать заявленных сущностей из мира
    take-world: true

    generation:
      # авто-генерация активов для товаров по белому/чёрному списку
      active: true
      # белый список предметов (активен когда true)
      item-whitelisting: true
      commodity-item-whitelist:
        - COAL
        - CHARCOAL
        - IRON_INGOT
        - COPPER_INGOT
        - GOLD_INGOT
        - NETHERITE_SCRAP
        - AMETHYST_SHARD
        - DIAMOND
        - NETHER_QUARTZ
        - EMERALD
        - LAPIS_LAZULI
        - GLOWSTONE_DUST
        - REDSTONE
        - WHEAT
        - EGG
        - APPLE
        - MELON_SLICE
        - PUMPKIN
        - SWEET_BERRIES
        - GLOW_BERRIES
        - CHORUS_FRUIT
        - CARROT
        - POTATO
        - POISONOUS_POTATO
        - BEETROOT
        - FISH
        - RAW_COD
        - RAW_SALMON
        - TROPICAL_FISH
        - PUFFERFISH
        - SUGARCANE
        - KELP
        - COCOA_BEANS
        - HONEY_BOTTLE
        - SPIDER_EYE
        - ROTTEN_FLESH
        - FLINT
        - BONE
        - STRING
        - FEATHER
        - LEATHER
        - HONEYCOMB
        - INK_SAC
        - GLOW_INK_SAC
        - TURTLE_SCUTE
        - ARMADILLO_SCUTE
        - SLIME_BALL
        - CLAY_BALL
        - PRISMARINE_SHARD
        - PRISMARINE_CRYSTALS
        - NAUTILUS_SHELL
        - HEART_OF_THE_SEA
        - BLAZE_ROD
        - BREEZE_ROD
        - HEAVY_CORE
        - NETHER_STAR
        - ENDER_PEARL
        - SHULKER_SHELL
        - ECHO_SHARD
        - NETHER_WART
        - GUNPOWDER
        - DRAGON_BREATH
        - GHAST_TEAR
        - PHANTOM_MEMBRANE
        - BAMBOO
        - CACTUS
        - POWDER_SNOW_BUCKET
        - INK_SAC
        - WATER_BUCKET
        - MILK_BUCKET
        - LAVA_BUCKET
        - OAK_LOG
        - SPRUCE_LOG
        - BIRCH_LOG
        - JUNGLE_LOG
        - ACACIA_LOG
        - DARK_OAK_LOG
        - MANGROVE_LOG
        - CHERRY_LOG
        - CRIMSON_STEM
        - WARPED_STEM
        - DIRT
        - GRAVEL
        - SAND
        - COBBLESTONE
        - GRANITE
        - DIORITE
        - ANDESITE
        - OBSIDIAN
        - NETHERRACK
        - SPONGE
        - SOUL_SAND
        - SOUL_SOIL
        - ICE
        - END_STONE
        - TOTEM_OF_UNDYING
        - BROWN_MUSHROOM
        - RED_MUSHROOM

  commodity-item-blacklist:
    - BARRIER
    - COMMAND_BLOCK
    - STRUCTURE_BLOCK
    - STRUCTURE_VOID

  entity-whitelisting: true
  commodity-entity-whitelist:
    - PIG
    - SHEEP
    - COW
    - CHICKEN
    - MOOSHROOM
    - VILLAGER

  commodity-entity-blacklist:
    - ENDER_DRAGON
    - WARDEN

forex: fees: taker-fees: 0 maker-fees: 0

main-currency:

настройка главной валюты, можно изменить в игре

currency: EMD_Villager Emerald_#00ff00 create-last-resort-only: true initial-balance: 0 vault-currency: VLT_Vault Currency_#ffbb15 playerpoints-currency: PTS_Player Points_#ff6d92

</details>

## Ордера

Система ордеров - сердце Profitable. Это инструкции на покупку или продажу актива по определённым условиям.

### Рыночный ордер (Market Order)

Исполняется мгновенно по лучшей цене в стакане ордеров. Самый быстрый способ купить или продать, но цена может отличаться от ожидаемой, если ликвидность низкая.

### Лимитный ордер (Limit Order)

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

### Стоп-лимитный ордер (Stop-Limit Order)

Становится лимитным ордером, когда рынок достигает указанной триггерной цены. Удобно, если вы ожидаете, что цена продолжит рост после пробоя определённого уровня.

## Рыночные данные и анализ

Profitable создан для реалистичной торговли, поэтому включает инструменты для отслеживания цен и объёмов. Игроки могут смотреть:
- текущие цены и динамику
- глубину рынка (ликвидность)
- свечные графики

Это позволяет предсказывать движение цен и зарабатывать на спекуляциях. Серверная экономика становится интересной и азартной.

## Пример: как это работает

Представьте: на сервере две враждующие группы. Они начинают массово скупать алмазы и незерит для крафта брони. Продавцы видят повышенный спрос и поднимают цены. Цена растёт. Наш знакомый Джонни замечает это и вкладывает все деньги в 100 алмазов, надеясь на дальнейший рост. Но на следующий день лидера одной из групп банит админ, конфликт прекращается. Теперь у всех много алмазов, но продать их по высокой цене некому. Продавцы вынуждены снижать цену, и рынок падает. Джонни остаётся с убытками. Но если бы цена продолжила расти, он бы разбогател.

Именно такие сценарии делает возможным Profitable. Это не просто магазин с линейными ценами - это полноценная экономика, где каждый игрок влияет на рынок. Фермы и рейды больше не ломают баланс, цены подстраиваются сами.

## Текущая версия

Плагин находится на ранней стадии разработки. В будущем появятся дополнительные функции и улучшения. Но уже сейчас Profitable предлагает одну из самых глубоких экономических систем для Minecraft.