AllayaStockMarket

Autor: Allaya Studios | Versão: 1.4

Informações Técnicas

API Target: Minecraft 1.21 Dependência obrigatória: PlaceholderAPI Compatibilidade adicional: Load antes de AllayaLojas Recomendado para: servidores com sistemas econômicos e RankUp

---

Descrição

O AllayaStockMarket é um plugin de simulação de bolsa de valores para servidores Minecraft (Paper 1.21), modelando variações de mercado, crises econômicas, recuperações, eventos aleatórios e integração com PlaceholderAPI.

Dependências

• Obrigatória: PlaceholderAPI

Comandos

Comando	Descrição	Permissão Necessária
/bolsa	Abre o menu da bolsa de valores	Não requer permissão
/stockmarket [reload]	Recarrega as configurações do plugin	allaya.stock.admin
/evento [forcar ]	Força a ativação de um evento específico	stockmarket.admin
/stockdebug	Exibe dados internos da bolsa para debug	stockmarket.admin
/eventosortear	Força o sorteio de um evento aleatório	stockmarket.admin

Permissões

Permissão	Função
allaya.stock.admin	Permissão administrativa geral
stockmarket.admin	Permissão para gerenciar eventos e debugar

Placeholders

Placeholder	Função	Sugestão de Uso
%allayastock_variacao_atual%	Mostra a última variação de valor	Placares, menus de economia
%allayastock_valor_bolsa%	Valor acumulado da bolsa (formatado)	GUI de mercado, placares
%allayastock_valor_bolsa_bruto%	Valor acumulado bruto (sem formatação)	Sistemas de script
%allayastock_direcao%	Direção da última variação (Alta ou Baixa)	Indicação visual
%allayastock_tendencia%	Tendência atual (Alta, Baixa, Estável, Crise, Recuperação)	Informativos em menus

Explicação dos Arquivos .yml

config.yml

Configuração principal do comportamento do mercado:

update-interval-minutes: 10
trend-duration-cycles: 6
intelligent-variation: true
target-positive-limit: 200.0
crisis-duration-cycles: 10
recovery-value: -65.0
recovery-end-value: 25.0
limit-top-value: 140
limit-top-bonus-chance: 60
sounds:
  positive: "UI_TOAST_CHALLENGE_COMPLETE"
  negative: "ENTITY_WITHER_SPAWN"
min-variation: 25
max-variation: 25

• Define intervalos, limites de mercado, modos de crise e recuperação, sons e variações.

data.yml

Arquivo de dados de runtime do mercado:

variacao: 0.0
acumulado: 0.0
historico:
  - 0.0

• Armazena informações como valor atual, variação e histórico recente.

events.yml

Definição de eventos econômicos configuráveis:

enabled: true
chance-percent: 10
rare-chance-percent: 5

events:
  - id: "lucro_agricola"
    name: "Lucro Agrícola"
    effect: 15.0
    message: "&aSafra recorde impulsiona a economia!"

  - id: "crise_bancaria"
    name: "Crise Bancária"
    effect: -20.0
    message: "&cBancos falham e abalam a bolsa!"

  # Outros eventos também configurados aqui...

• Controla ativação, chances de eventos e efeitos econômicos.

messages.yml

Mensagens exibidas aos jogadores e placeholders de texto:

prefix: "&6[Bolsa]&r "
only-players: "&cApenas jogadores podem usar este comando."
reload-start: "&eRecarregando configurações..."
reload-success: "&aConfigurações recarregadas com sucesso."

menu-title: "&6&lBolsa de Valores"
menu-title-crisis: "&4&lBolsa de Valores - CRISE"
menu-title-recovery: "&6&lBolsa de Valores - RECUPERAÇÃO"

# E diversas outras mensagens usadas nas GUIs e eventos.

• Gerencia todos os textos do plugin, permitindo customização sem precisar alterar código.