Economias

Exemplo completo de configuração

Aqui está um exemplo de como configurar uma economia no plugin. Cada economia é um arquivo .yml separado dentro da pasta economies/:

# Identificação necessária para a API de Economias do yPlugins
# Identificação necessária para a API de Tops do yTops
# Identificação necessária para a API do PAPI
# Identificação necessária para a API de Chat
yplugins-id: 'yeconomias-token'
top-user: 'none'
# yPlugins -> puxar a formatação do yPlugins
# LETTER -> formatar em letras: 1K, 1M...
# NUMBER -> formatar em números decimais: 1.000, 10.000.000...
format: 'yPlugins'

# Ativar o sistema de receber a mensagem de pagamento na proxy (Velocity e BungeeCord)
proxy-chat: true

command:
  command: 'token'
  aliases: ['tokens']

sub-command:
  add: [ 'add', 'adicionar', 'somar', 'sum', 'depositar', 'deposit' ]
  remove: [ 'remove', 'remover', 'subtrair', 'subtract', 'withdraw', 'sacar', 'retirar' ]
  set: [ 'set', 'setar', 'define', 'definir' ]
  pay: [ 'pay', 'pagar', 'enviar', 'send' ]
  top: [ 'top' ]
  help: [ 'help', 'ajuda' ]
  force-update: [ 'forceupdate' ]
  check: [ 'check', 'cheque' ]
  give-media: [ 'givemedia', 'darmedia' ]

usage:
  add: '&cUse: /{command} {arg} <player> <quantia>'
  remove: '&cUse: /{command} {arg} <player> <quantia>'
  set: '&cUse: /{command} {arg} <player> <quantia>'
  pay: '&cUse: /{command} {arg} <player> <quantia>'
  check: '&cUse: /{command} {arg} <player> <porcentagem> <multiplier>'
  give-media: '&cUse: /{command} {arg} <player> <porcentagem> <multiplier>'

permission:
  main: 'yeconomias.token.use'
  look: 'yeconomias.token.look'
  add: 'yeconomias.token.add'
  remove: 'yeconomias.token.remove'
  set: 'yeconomias.token.set'
  pay: 'yeconomias.token.pay'
  top: 'yeconomias.token.top'
  help: 'yeconomias.token.help'
  force-update: 'yeconomias.token.forceupdate'
  admin: 'yeconomias.token.admin'
  check: 'yeconomias.token.check'
  give-media: 'yeconomias.token.givemedia'

general:
  # Quantia que recebe ao registrar
  default: 0
  # Delay em segundos entre usos dos comandos desta economia (0 = desativado)
  command-delay: 0
  # Abrir menu ao digitar /token
  main-menu: true
  # Abrir menu ao digitar /token top
  top-menu: true
  # Proibir o "pay/enviar" caso o jogador esteja offline
  block-offline-pay: false
  # Formato da economia na quantia singular
  singular: 'token'
  # Formato da economia no plural
  plural: 'tokens'
  # Tag do mais rico na economia
  tag: '&5[$]'

# Configuração do money top em chat
top-chat:
  # O plugin irá reconhecer quando isto for apenas espaços e vai removê-los.
  rich-format: '{currency} '
  # O plugin irá reconhecer quando isto for apenas espaços e vai removê-los.
  prefix-format: '%luckperms_prefix% '
  tags: '{rich}{prefix}'
  format: '  &f{pos}º {tags}&7{player}&6: &7(c {currency})'
  message:
    - '&5Top 10 Mais Ricos &7(Atualizado de 10 em 10 minutos)'
    - ''
    - '{format}'
    - ''

# Mensagens gerais do plugin
messages:
  permission: '&cVocê não possui permissão para isto.'
  target: '&cEste jogador não foi encontrado.'
  number: '&cO argumento não é um número.'
  has: '&cVocê não possui esta quantia de tokens.'
  yourself: '&cVocê não pode pagar à si mesmo.'
  delay: '&cAguarde {time}s para usar este comando novamente.'
  force-update: '&aVocê forçou a atualização do TOP.'
  balance: |
    &aVocê possui: &f{currency}&a {unit}.
  balance-target: |
    &aO jogador &7{player}&a possui: &f{currency}&a {unit}.
  set: |
    &aVocê setou os tokens do jogador &7{player} &apara: &f{currency}&a {unit}.
  remove: |
    &aVocê removeu &f{currency}&a {unit} do jogador &7{player}&a.
  add: |
    &aVocê adicionou &f{currency}&a {unit} para o jogador &7{player}&a.
  send: |
    &aVocê enviou &f{currency}&a {unit} para o jogador &7{player}&a.
  received: |
    &aVocê recebeu &f{currency}&a {unit} do jogador &7{player}&a.
  help: |
    &a<--> Comandos de tokens <-->
    <nl>
    - '&f > &a/tokens &8- &7Ver suas informações.
    - '&f > &a/tokens &f<jogador> &8- &7Ver as informações de outro jogador.
    - '&f > &a/tokens enviar &f<jogador> <quantia> &8- &7Enviar tokens para um jogador.
    - '&f > &a/tokens top &8- &7Ver o TOP mais ricos em tokens.
    <nl>
  help-admin: |
    &a<--> Comandos de tokens &7(STAFF)&a <-->
    <nl>
    &f > &a/tokens &8- &7Ver suas informações.
    &f > &a/tokens &f<jogador> &8- &7Ver as informações de outro jogador.
    &f > &a/tokens enviar &f<jogador> <quantia> &8- &7Enviar tokens para um jogador.
    &f > &a/tokens adicionar &f<jogador> <quantia> &8- &7Adicionar tokens para um jogador.
    &f > &a/tokens remover &f<jogador> <quantia> &8- &7Remover tokens de um jogador.
    &f > &a/tokens setar &f<jogador> <quantia> &8- &7Setar tokens para um jogador.
    &f > &a/tokens top &8- &7Ver o TOP mais ricos em tokens.
    &f > &a/tokens forceupdate &8- &7Forçar a atualização do TOP.
    <nl>
  rich: |
    <nl>
    &5&l[c]&d O jogador &f{player} &dé o novo &d&nRICO&d do servidor.
    &7O novo rico possui &f{currency} &7{unit}.
    <nl>
  check-give: |
    &aVocê enviou &f{currency}&a {unit} para o jogador &7{player}&a em forma de cheque.
  check-converted: |
    &aVocê juntou seus cheques com sucesso.
  check-activated: |
    &aVocê ativou um cheque de &e{amount}&a {unit}.
  give-media: |
    &aVocê enviou &f{currency}&a {unit} para o jogador &7{player}&a.
  received-media: |
    &aVocê recebeu &f{currency}&a {unit}&a.

# Item do cheque da média
check:
  material: 'INK_SACK:14'
  name: '&aCheque de Tokens'
  lore:
    - ''
    - ' &a&l| &fValor: &a{amount}'
    - ''

menu:
  top:
    name: '&8TOP Ricos'
    size: 36
    slots: [ 10, 11, 12, 13, 14, 15, 16 ]
    back-slot: 31
    previous-slot: 9
    next-slot: 17
    # Item do top
    item:
      material: '{player}'
      name: '&f#{pos} &7> &a{player}'
      lore: [ '', '&fTokens: &a{currency}&f.', '' ]
    # Seta de voltar
    back-item:
      material: 'ARROW'
      name: '&cVoltar'
      lore: [ '&7Clique para voltar ao menu anterior.' ]
    previous-item:
      material: 'ARROW'
      name: '&cAnterior'
      lore: [ '&7Clique para ir à página anterior.' ]
    next-item:
      material: 'ARROW'
      name: '&aPróximo'
      lore: [ '&7Clique para ir à próxima página.' ]
  main:
    name: '&8Tokens'
    size: 27
    # Item de informações
    item:
      slot: 11
      material: '{player}'
      name: '&aSuas informações'
      lore:
        - '&7Veja suas informações'
        - '&7referente ao token.'
        - ''
        - ' &fSaldo atual: &a{currency}&f.'
        - ''
    # Item do top
    top:
      slot: 15
      material: '351137e11443a8fbb05fcd3ccc1af9bd2303918f35448185e3ed96ef184da'
      name: '&aTop jogadores'
      lore:
        - '&7Veja os jogadores que'
        - '&7se destacam sendo os'
        - '&7mais ricos do servidor.'
        - ''
        - '&aClique para visualizar.'

Opções disponíveis na configuração

yplugins-id

Identificador único da economia usado para integração com outros plugins da yStore, PlaceholderAPI e sistema de chat.

Exemplo:

yplugins-id: 'yeconomias-token'

top-user

Define o usuário do sistema de tops. Use 'none' para desabilitar.

Exemplo:

top-user: 'none'

format

Define o formato de exibição dos valores da economia.

Valores válidos:

yPlugins - Usa a formatação do yPlugins
LETTER - Formata em letras (1K, 1M, 1B)
NUMBER - Formata em números decimais (1.000, 10.000.000)

Exemplo:

format: 'yPlugins'

proxy-chat

Ativa o sistema de receber a mensagem de pagamento na proxy (Velocity e BungeeCord).

Exemplo:

proxy-chat: true

command

Define o comando principal da economia e suas aliases.

Exemplo:

command:
  command: 'token'
  aliases: ['tokens']

sub-command

Lista de subcomandos e suas variações aceitas.

Exemplo:

sub-command:
  add: [ 'add', 'adicionar', 'somar', 'sum', 'depositar', 'deposit' ]
  remove: [ 'remove', 'remover', 'subtrair', 'subtract', 'withdraw', 'sacar', 'retirar' ]
  set: [ 'set', 'setar', 'define', 'definir' ]
  pay: [ 'pay', 'pagar', 'enviar', 'send' ]
  top: [ 'top' ]
  help: [ 'help', 'ajuda' ]
  force-update: [ 'forceupdate' ]
  check: [ 'check', 'cheque' ]
  give-media: [ 'givemedia', 'darmedia' ]

usage

Mensagens de uso incorreto para cada subcomando.

Placeholders disponíveis: {command}, {arg}

Exemplo:

usage:
  add: '&cUse: /{command} {arg} <player> <quantia>'
  remove: '&cUse: /{command} {arg} <player> <quantia>'
  set: '&cUse: /{command} {arg} <player> <quantia>'
  pay: '&cUse: /{command} {arg} <player> <quantia>'
  check: '&cUse: /{command} {arg} <player> <porcentagem> <multiplier>'
  give-media: '&cUse: /{command} {arg} <player> <porcentagem> <multiplier>'

permission

Permissões necessárias para executar cada comando e subcomando.

Exemplo:

permission:
  main: 'yeconomias.token.use'
  look: 'yeconomias.token.look'
  add: 'yeconomias.token.add'
  remove: 'yeconomias.token.remove'
  set: 'yeconomias.token.set'
  pay: 'yeconomias.token.pay'
  top: 'yeconomias.token.top'
  help: 'yeconomias.token.help'
  force-update: 'yeconomias.token.forceupdate'
  admin: 'yeconomias.token.admin'
  check: 'yeconomias.token.check'
  give-media: 'yeconomias.token.givemedia'

general

Configurações gerais da economia.

Exemplo:

general:
  # Quantia que recebe ao registrar
  default: 0
  # Abrir menu ao digitar o comando principal
  main-menu: true
  # Abrir menu ao digitar o comando de top
  top-menu: true
  # Proibir o "pay/enviar" caso o jogador esteja offline
  block-offline-pay: false
  # Formato da economia na quantia singular
  singular: 'token'
  # Formato da economia no plural
  plural: 'tokens'
  # Tag do mais rico na economia
  tag: '&5[$]'

top-chat

Configuração do sistema de top em chat.

Placeholders disponíveis: {currency}, {prefix}, {rich}, {player}, {pos}

Exemplo:

top-chat:
  # O plugin irá reconhecer quando isto for apenas espaços e vai removê-los.
  rich-format: '{currency} '
  # O plugin irá reconhecer quando isto for apenas espaços e vai removê-los.
  prefix-format: '%luckperms_prefix% '
  tags: '{rich}{prefix}'
  format: '  &f{pos}º {tags}&7{player}&6: &7(c {currency})'
  message:
    - '&5Top 10 Mais Ricos &7(Atualizado de 10 em 10 minutos)'
    - ''
    - '{format}'
    - ''

messages

Mensagens exibidas aos jogadores. Use | para criar mensagens em múltiplas linhas.

Placeholders disponíveis: {player}, {currency}, {unit}, {command}, {arg}, {amount}

Exemplo:

messages:
  permission: '&cVocê não possui permissão para isto.'
  target: '&cEste jogador não foi encontrado.'
  number: '&cO argumento não é um número.'
  has: '&cVocê não possui esta quantia de tokens.'
  yourself: '&cVocê não pode pagar à si mesmo.'
  force-update: '&aVocê forçou a atualização do TOP.'
  balance: |
    &aVocê possui: &f{currency}&a {unit}.
  balance-target: |
    &aO jogador &7{player}&a possui: &f{currency}&a {unit}.

check

Configuração do item de cheque da economia.

Exemplo:

check:
  material: 'INK_SACK:14'
  name: '&aCheque de Tokens'
  lore:
    - ''
    - ' &a&l| &fValor: &a{amount}'
    - ''

Configuração dos menus da economia (top e principal).

Exemplo:

menu:
  top:
    name: '&8TOP Ricos'
    size: 36
    slots: [ 10, 11, 12, 13, 14, 15, 16 ]
    back-slot: 31
    previous-slot: 9
    next-slot: 17
    item:
      material: '{player}'
      name: '&f#{pos} &7> &a{player}'
      lore: [ '', '&fTokens: &a{currency}&f.', '' ]
  main:
    name: '&8Tokens'
    size: 27
    item:
      slot: 11
      material: '{player}'
      name: '&aSuas informações'
      lore:
        - '&7Veja suas informações'
        - ''
        - ' &fSaldo atual: &a{currency}&f.'

Criando uma nova economia

Crie um novo arquivo

Dentro da pasta plugins/yEconomias/economies/, crie um novo arquivo .yml com o nome da sua economia (ex: cash.yml).

Copie a configuração de exemplo

Copie a configuração completa mostrada acima e cole no novo arquivo.

Personalize os valores

Altere os valores conforme necessário:

yplugins-id: Identificador único (ex: yeconomias-cash)
command: Comando principal (ex: cash)
permission: Altere todas as permissões para usar o novo identificador
general: Ajuste os valores padrão, nomes singular/plural e tag
messages: Personalize as mensagens para a nova economia
menu: Ajuste os menus conforme necessário

Reinicie o servidor

Reinicie o servidor para carregar a nova economia.

Você pode criar quantas economias quiser! Cada economia é completamente independente e possui seus próprios comandos, permissões e configurações.

Certifique-se de que cada economia possui um yplugins-id único para evitar conflitos com placeholders e integrações.

Nesta página