yChequesMediaAddon

Integração para criação de cheques baseados na média econômica dos jogadores.

Visão geral

O yChequesMediaAddon habilita a criação de cheques baseados na média econômica dos jogadores no servidor.

No yCheques, o addon é tratado como uma dependência opcional. A disponibilidade dele é verificada internamente pelo nome:

yChequesMediaAddon

Quando o addon não está ativo, o comando de cheque por média não executa e envia a mensagem configurada em Mensagens.Media addon indisponivel.

Comando

/cheque chequemedia <player> <economia> <porcentagem>

Cria um cheque para o jogador informado usando uma porcentagem da média da economia escolhida.

Argumentos

Argumento	Descrição
`<player>`	Jogador online que receberá o cheque.
`<economia>`	Tipo de economia usada para calcular a média.
`<porcentagem>`	Porcentagem da média que será convertida em valor do cheque.

Exemplo

/cheque chequemedia Steve money 10

Neste exemplo, o jogador Steve recebe um cheque com 10% da média calculada da economia money.

Permissão

ycheques.admin

Necessária para usar o subcomando chequemedia.

Economias aceitas

As economias aceitas pelo comando são:

Tipo	Origem dos dados
`money`	Economia principal via Vault ou plugins de economia suportados.
`yplantacoes`	Top de moedas do yPlantacoes.
`yminas`	Top de blocos do yMinas.
`yalmas`	Top de almas do yAlmas.
`ykillsystem`	Top de XP do yKillSystem.
`yrankup`	Top de fragmentos do yRankup.
`yspawnersshop`	Top de limite do ySpawnersShop.
`ypoints`	Top de pontos do yPoints.
`ypesca`	Top de coins do yPesca.
`yvips`	Top de créditos do yVips.
`ycampo`	Top de coins do yCampo.
`yminaspackets`	Top de blocos do yMinasPackets.
`ybanco`	Top de ricos do yBanco.
`yfloresta`	Top de coins do yFloresta.

Cálculo do cheque

O valor do cheque é calculado assim:

valor = porcentagem * media / 100

Depois do cálculo, o valor é arredondado sem casas decimais. Se o resultado for menor ou igual a 1, ou se o valor calculado for inválido, o cheque é criado com valor mínimo 1.

Exemplo:

media = 1.000.000
porcentagem = 10
valor do cheque = 100.000

Atualização da média

A coleta dos dados de TOP é executada periodicamente pelo TopManager.

Config em config.yml:

TopEconomia:
  Atualizar em segundos: 120

Este valor define o intervalo de atualização das médias econômicas. O valor mínimo efetivo é de 20 ticks.

Configuração de mensagens

As mensagens relacionadas ao addon ficam em config.yml:

Mensagens:
  Criou media: '&aVocê criou um cheque de &7{quantia}&a usando &7{porcentagem}%&a da média de &7{media}&a.'
  Media addon indisponivel: '&cO addon de média não está disponível no momento.'
  Media sem dados: '&cNão foi possível calcular a média econômica dos TOPs.'

Placeholders

Placeholder	Descrição
`{quantia}`	Valor final do cheque criado.
`{porcentagem}`	Porcentagem informada no comando.
`{media}`	Média calculada da economia escolhida.

Requisitos para criar cheque por média

Para o comando funcionar corretamente:

O addon yChequesMediaAddon deve estar ativo.
O jogador alvo deve estar online.
O jogador alvo deve ter espaço livre no inventário.
A porcentagem deve ser um número maior que 0.
A economia informada deve estar na lista de tipos aceitos.
A economia também precisa ter um cheque configurado em cheques.yml com o mesmo Tipo.

Configuração em cheques.yml

O tipo usado no comando deve existir em cheques.yml.

Exemplo para money:

Cheques:
  Cheque1:
    Tipo: 'Money'
    Display: 'Coins'
    material: 'PAPER'
    name: '&aCheque de Money'
    lore:
      - '&7Criado por: &a{player}&7.'
      - '&7Criado em: &f{data} &8- &f{hora}&7.'
      - '&bValor do cheque: &a{quantia}&b.'
    Mensagem:
      Title: '&a{quantia} coins<nl>&erecebidos!'
      Actionbar: '&aVocê ativou um cheque de &e{quantia}&a coins.'
      Chat: |
        &aVocê ativou um cheque de &e{quantia}&a coins.
      Chat-criou: |
        &aVocê criou um cheque de &e{quantia} coins&a com sucesso.

Fluxo interno

O comando verifica se yChequesMediaAddon está ativo.
O sistema valida permissão, argumentos, jogador online e inventário.
O tipo de economia é validado contra a lista de economias aceitas.
O sistema verifica se existe cheque configurado em cheques.yml para a economia.
A média é obtida pelo TopManager.getMedia(economia).
O valor final é calculado com base na porcentagem informada.
O item do cheque é entregue ao jogador.
O webhook de criação é enviado, se estiver configurado.

Problemas comuns

Problema	Causa provável	Solução
Mensagem de addon indisponível	`yChequesMediaAddon` não está ativo ou não foi detectado.	Verifique se o addon está instalado, carregado e registrado com o nome correto.
Economia não configurada	Não existe cheque em `cheques.yml` com o tipo informado.	Adicione um cheque com `Tipo` correspondente à economia usada no comando.
Jogador não encontrado	O alvo informado não está online.	Use o nome exato de um jogador online.
Inventário cheio	O alvo não possui slot livre.	Libere espaço no inventário antes de executar o comando.
Valor muito baixo	A média calculada está vazia, zerada ou a porcentagem é baixa.	Aguarde a atualização do TOP e confira se o plugin da economia está gerando dados.

Observações

O comando não cria múltiplos cheques de uma vez; ele entrega um item por execução.
O valor gerado depende dos dados coletados dos TOPs das economias.
Para money, o sistema tenta usar a economia principal via Vault e também reconhece alguns plugins de economia suportados pelo código.
Não há placeholders PAPI nativos do yChequesMediaAddon registrados neste projeto.

Nesta página