StockMarket wAPI (Стокмаркет вэпи)

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

Возможности

• Валюта KABU не требует сторонних экономических модов. В неё и обратно можно обменивать любые зарегистрированные предметы, включая предметы из других модов.
• У каждой акции есть минимальная и максимальная цена, а величина одного изменения ограничивается настройкой. Механизм отскока не даёт цене приблизиться к нулю.
• Спрос и предложение учитываются при очередном обновлении рынка, а не сразу после сделки. Масштаб их влияния автоматически подстраивается под объём торговли сервера.
• ИИ создаёт новости рынка и описания компаний. Если запрос к ИИ не удался, рынок продолжает работать без его влияния.
• Новости публикуются в чате, а история последних 30 записей доступна игрокам.
• Администратор может назначать комиссии на покупку и продажу, добавлять акции и курсы обмена предметов.
• Функции можно привязать к табличкам: просмотр цены и списка акций, покупка, продажа, обмен предметов, покупка предметов за KABU и чтение новостей. Игрок использует табличку правой кнопкой мыши.
• Во время обновления рынка торговля блокируется: сначала меняются цены и сохраняются новости, затем обновляются таблички и открывается торговля.

Как пользоваться

Сначала обменяйте предметы на KABU, затем изучите цены и купите нужные акции. Информацию о балансе, активах и прибыли показывает команда myinfo.

• /stockwapi list — список акций и цен.
• /stockwapi info <ticker> — сведения об акции и описание компании.
• /stockwapi news — последние новости рынка.
• /stockwapi buy <ticker> <quantity> и /stockwapi sell <ticker> <quantity> — покупка и продажа акций.
• /stockwapi exchange <item> <count> — обмен предметов на KABU.
• /stockwapi buyitem <item> <count> — покупка предметов за KABU.
• /stockwapi myinfo или /stockwapi portfolio — баланс, портфель и прибыль.

Настройки

Основные параметры находятся в config/stock_wapi-common.toml: частота обновлений updatesPerDay, предел изменения цены maxPriceChangePercent, блокировка торговли при обновлении tradingPausedOnUpdate, комиссии buyFeePercent и sellFeePercent, а также лимиты сделок и владения акциями.

Файл config/stock_wapi-stocks.json содержит акции и их параметры: стартовую цену, волатильность, тенденцию, границы цены, силу отскока и влияние сделок с ИИ. Курсы обмена предметов хранятся в config/stock_wapi-exchange.json.

Для настройки ИИ доступны newsLanguage — язык новостей — и worldSetting — описание мира, передаваемое ИИ.

Требования и совместимость

Требуется NeoForge, Java 21 и мод AI DataBase wAPI Core; оба мода нужны и серверу, и клиентам. В aidbwapi_core необходимо зарегистрировать провайдера ИИ и модель. Ключ API безопаснее задать напрямую в config/aidbwapi_core-keynames.json, поскольку ключ, введённый командой в чат, записывается в logs/latest.log.

Администратор настраивает биржу командами с уровнем OP, заданным в commandPermissionLevel:

• /stockwapi admin add <ticker> <name> <initialPrice> — добавить акцию.
• /stockwapi admin setrate <item> <kabuRate> — назначить курс предмета.
• /stockwapi admin sign <type> [<arg1>] [<arg2>] — привязать функцию к табличке, смотря на неё.
• /stockwapi admin unsign — отвязать табличку.
• /stockwapi admin pause и /stockwapi admin resume — остановить и запустить рынок.
• /dbwapi ai test — проверить связь с ИИ; /dbwapi ai errors — посмотреть ошибки.