Плагин для серверов Майнкрафт с виртуальной фондовой биржей и экономикой через Vault. Игроки покупают и продают акции через меню-сундук или команды, следят за портфелем, участвуют в рейтингах и соревнованиях; для котировок можно использовать реальные биржевые данные либо полностью локальный рынок.
Возможности
- Рынки акций Китая, Гонконга и США с преднастроенными тикерами; котировки получает Tencent Finance.
- Локальные рынки без внешнего API: цены меняются по настраиваемой случайной модели, с бычьими, медвежьими и нейтральными периодами. Это подходит для акций компаний и событий самого сервера.
- Торговое меню с постраничным списком акций, графиком изменения цены, быстрыми суммами покупки и продажи, подтверждением крупных сделок, избранным и портфелем.
- В портфеле отображаются количество акций, средняя цена покупки, текущая стоимость и нереализованная прибыль или убыток.
- Лимитные заявки, стоп-лосс и тейк-профит: сделка выполняется автоматически, когда цена достигает заданного значения.
- Короткие позиции: игрок занимает акции, продаёт их и выкупает позднее. Для них настраиваются залог, процент принудительного закрытия и процент за день.
- Рейтинги самых прибыльных и убыточных инвесторов, общий индекс рынка и текстовый отчёт по рынку.
- Соревнования с отдельными виртуальными портфелями и наградами через Vault: реальные акции участников при этом не затрагиваются.
- Администратор может проводить первичные размещения акций: игроки подают заявки, а при переподписке акции распределяются пропорционально, лишние деньги возвращаются.
- Акции из портфеля можно превратить в предмет-сертификат, передать другому игроку, продать в магазине или на аукционе. Нажмите сертификатом правой кнопкой по воздуху, чтобы вернуть акции в портфель.
- Цена выбранной акции выводится в BossBar; цвет полосы показывает направление движения цены.
- Защита от устаревших и аномально изменившихся котировок, автоматическая остановка торгов при резком скачке, лимиты частоты и размера сделок.
- Есть русский встроенный язык: в
config.ymlукажитеlanguage: ru_RU. - Поддерживаются плейсхолдеры PlaceholderAPI:
%superstocks_cash%,%superstocks_portfolio_value%,%superstocks_total_value%,%superstocks_profit%,%superstocks_profit_percent%,%superstocks_shares_<symbol>%.
Команды
Основное меню и информация:
/stocksили/stocks open— открыть биржевое меню./stocks quote <symbol>— узнать котировку./stocks buy <symbol> <shares>и/stocks sell <symbol> <shares>— купить или продать акции./stocks portfolio— открыть портфель в текстовом виде./stocks history <symbol>— показать историю цены./stocks stats— личная статистика инвестиций./stocks rank winnersи/stocks rank losers— рейтинги прибыли и убытков./stocks index— индексы рынков./stocks report— отчёт по рынку./stocks pin <symbol>и/stocks unpin— показать цену в BossBar или убрать её.
Избранное, уведомления и заявки:
/stocks watch add <symbol>,/stocks watch remove <symbol>,/stocks watch list— управлять избранными акциями./stocks alert <symbol> above <price>или/stocks alert <symbol> below <price>— создать уведомление о достижении цены./stocks order buy <symbol> <shares> <price> [seconds]— отложенная покупка./stocks order sell <symbol> <shares> <price> [seconds]— отложенная продажа./stocks order stop-loss <symbol> <shares> <price> [seconds]— стоп-лосс./stocks order take-profit <symbol> <shares> <price> [seconds]— тейк-профит./stocks order listи/stocks order cancel <id>— посмотреть или отменить заявки.
Дополнительные механики:
/stocks short <symbol> <shares>— открыть короткую позицию./stocks cover <id> [shares]— закрыть короткую позицию полностью или частично./stocks certificate issue <symbol> <shares>— создать предмет-сертификат из акций./stocks certificate list— список своих сертификатов./stocks competition list,/stocks competition join <id>— посмотреть соревнования и присоединиться./stocks competition buy <id> <symbol> <shares>и/stocks competition sell <id> <symbol> <shares>— торговать в соревновании./stocks ipo listи/stocks ipo subscribe <id> <shares>— посмотреть размещения и подать заявку.
Команды администратора: /stocks sync, /stocks status, /stocks pause, /stocks resume, /stocks admin panel, /stocks admin audit [player] [action], /stocks admin portfolio <player>, /stocks admin give <player> <symbol> <shares>, /stocks admin remove <player> <symbol> <shares>, /stocks admin clear <player>, /stocks competition create <name> <days> <capital>, /stocks competition end <id>, /stocks ipo create <symbol> <name> <market> <price> <total> <max>, /stocks ipo cancel <id>, /stocks reload.
Права
superstocks.use— меню и команды игрока.superstocks.admin— управление рынком, синхронизация, панель администратора и перезагрузка настроек.superstocks.penalty.exempt— иммунитет к штрафам за убытки.
Настройка
Главный файл находится по пути plugins/SuperStocks/config.yml, языковые файлы — в plugins/SuperStocks/Language/, а локальные рынки — в plugins/SuperStocks/CustomMarkets/. Изменения настроек, языков, списков рынков и локальных рынков применяются командой /stocks reload.
В блоке markets задаются группы акций и их коды. Для Tencent Finance используются форматы sh<code> для Шанхая, sz<code> для Шэньчжэня, hk<code> для Гонконга и us<ticker> для США.
Локальный рынок создаётся отдельным файлом .yml в plugins/SuperStocks/CustomMarkets/. Для каждой акции задаются symbol, name, initial-price, min-price, max-price, drift-percent-per-tick и volatility-percent. Параметры min-price и max-price ограничивают цену, а volatility-percent определяет силу случайных колебаний.
Раздел gameplay-volatility позволяет умножать реальные цены через price-multiplier и добавлять случайное отклонение через random-adjustment. Так цену можно подогнать под масштаб серверной валюты. Границы safety.min-price и safety.max-price защищают от некорректных значений.
В orders задаётся число открытых заявок на игрока, а automation.check-seconds — частота их проверки. Средства для заявки на покупку резервируются заранее и возвращаются при отмене или окончании срока действия.
Настройки quote-safety и trading отвечают за защиту экономики: максимальный возраст котировки, допустимое изменение цены за синхронизацию, автоматическую заморозку торгов, задержку между сделками и лимиты позиции. В market-hours можно ограничить торговлю часами рынка, выбрав DENY либо SELL_ONLY.
Через economy настраиваются комиссия сделок и дополнительный сбор за быструю продажу. Блок dividends начисляет владельцам акций выплату от рыночной стоимости. loss-penalty включает штрафы за убытки портфеля: списание денег Vault или выполнение серверных команд с переменными {player}, {loss}, {loss_percent}, {portfolio_value} и другими.
Требования
Плагин работает на серверах Paper и Purpur с Java 21. Обязательны Vault и совместимый с ним плагин экономики; поддерживается EssentialsX Economy. Для реальных котировок серверу нужен доступ к Tencent Finance, а локальные рынки работают без сети. PlaceholderAPI подключается по желанию для вывода данных в табло, чат и меню.
Данные акций, сделок, заявок и журнала действий хранятся в SQLite-файле plugins/SuperStocks/stocks.db. Не редактируйте его при работающем сервере; перенос пути к базе требует полной перезагрузки сервера.
