LogoyStore

Configuração

Conheça as várias opções de configuração.

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

commands.yml
config.yml
economies.yml
menus.yml
messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla limites de empréstimo, juros, prazos, ofertas do servidor, crédito e tipos de garantia. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Modo de depuração para correção de problemas no plugin.
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados dos empréstimos serão armazenados. O plugin suporta três tipos de armazenamento:

  • SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
  • MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
  • HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.
database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yAgiota/data.db.

redis

Configurações do servidor Redis. Deixe enabled: false se não for usar.

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 3306]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

login-delay

Delay em ticks para carregar os dados do jogador após o login. Necessário para usar em servidor de mina separado.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

20 ticks equivale a 1 segundo. Aumente este valor se os jogadores entrarem no servidor sem ver seus dados carregados corretamente.

general

Configurações gerais do sistema de empréstimos. Este bloco controla limite de contratos, juros mínimos do P2P, expiração, valores e prazos.

general:
  # Máximo de empréstimos simultâneos (REQUEST + ACTIVE) por jogador sem permissão yagiota.slots.N
  max-loans-default: 3
  # Juros mínimos (%) que o jogador deve oferecer no pedido P2P
  # O pedinte pode oferecer uma taxa maior para atrair agiotas
  player-interest-percent: 15.0
  # Tempo (em segundos) para um pedido P2P expirar sem ninguém aceitar
  request-expire-seconds: 3600
  # Intervalo (em ticks) para verificar pedidos/empréstimos expirados (200 ticks = 10 segundos)
  expiry-check-interval-ticks: 200
  # Se true, permite pagamento parcial (atualmente o menu quita o restante de uma vez)
  allow-partial-pay: true
  # Valor mínimo que o jogador pode pedir em empréstimo P2P
  min-amount: 1.0
  # Valor máximo que o jogador pode pedir em empréstimo P2P
  max-amount: 10000000.0
  # Prazos pré-definidos em segundos que o jogador pode selecionar
  # 3600=1h, 7200=2h, 21600=6h, 86400=1dia
  duration-presets-seconds:
    - 3600
    - 7200
    - 21600
    - 86400

Destaques importantes:

  • max-loans-default: Limite de empréstimos simultâneos (REQUEST + ACTIVE) sem a permissão yagiota.slots.N
  • player-interest-percent: Juros mínimos do pedido P2P. O pedinte pode oferecer uma taxa maior
  • request-expire-seconds: 3600 = 1 hora sem aceite
  • expiry-check-interval-ticks: 200 ticks = 10 segundos
  • allow-partial-pay: Se true, permite pagamento parcial. O menu quita o restante de uma vez
  • min-amount / max-amount: Faixa de valor do pedido P2P

Prazos pré-definidos:

SegundosPrazo
36001h
72002h
216006h
864001 dia

Exemplo de uso:

general:
  max-loans-default: 5
  player-interest-percent: 10.0
  request-expire-seconds: 1800
  min-amount: 100.0
  max-amount: 500000.0
  duration-presets-seconds:
    - 3600
    - 21600
    - 86400

server

Empréstimo direto com o servidor. Não usa outro jogador como agiota. O valor não é escolhido pelo jogador — ele vem da tabela de preços da garantia.

  server:
    # Se false, o botão de empréstimo do servidor fica bloqueado
    enabled: true
    # Juros (%) cobrados pelo servidor
    interest-percent: 20.0
    # Teto absoluto do valor emprestado pelo servidor (0 = sem teto extra além da tabela)
    max-amount: 500000.0
    # Tabela de preços: valor que o servidor empresta conforme a garantia.
    # O jogador NÃO escolhe o valor — ele é definido por esta tabela.
    # Use 'default' para o valor padrão do tipo.
    # Use 'types' para valores específicos (key da máquina/spawner/estrutura da mina).
    prices:
      item:
        # Valor emprestado ao deixar um item como garantia
        default: 5000.0
      maquina:
        # Valor padrão para qualquer máquina yMaquinas
        default: 25000.0
        # Valores por tipo da máquina (a key usada no yMaquinas)
        types:
          exemplo: 50000.0
      terreno:
        # Valor emprestado ao deixar um terreno yTerrenos como garantia
        default: 80000.0
      plot:
        # Valor emprestado ao deixar um plot yPlots como garantia
        default: 60000.0
      spawner:
        # Valor padrão para qualquer spawner ySpawners
        default: 20000.0
        # Valores por tipo do spawner (a key usada no ySpawners)
        types:
          exemplo: 35000.0
      mina:
        # Valor padrão para qualquer mina yMinasPv
        default: 70000.0
        # Valores por estrutura da mina (a key usada no yMinasPv)
        types:
          exemplo: 120000.0
Tipodefaulttypes
item5000.0—
maquina25000.0key da máquina no yMaquinas
terreno80000.0—
plot60000.0—
spawner20000.0key do spawner no ySpawners
mina70000.0key da estrutura no yMinasPv
  • enabled: false — o botão de empréstimo do servidor fica bloqueado
  • max-amount: 0 — sem teto extra além da tabela de preços
  • types — sobrescreve o default quando a key da máquina, spawner ou mina coincidir

Exemplo de uso:

    prices:
      maquina:
        default: 25000.0
        types:
          exemplo: 50000.0
      spawner:
        default: 20000.0
        types:
          exemplo: 35000.0
      mina:
        default: 70000.0
        types:
          exemplo: 120000.0

credit

Histórico de crédito. Melhora ou piora as ofertas do servidor. A faixa usada é a maior que o score alcançar.

  credit:
    enabled: true
    # Score inicial de quem nunca pegou empréstimo
    starting-score: 50
    # Pontos ganhos ao quitar um empréstimo
    paid-bonus: 8
    # Pontos extras se quitar antes do prazo
    on-time-bonus: 4
    # Pontos perdidos ao dar calote
    default-penalty: 25
    min-score: 0
    max-score: 100
    # Score mínimo para pegar empréstimo do servidor (0 = sem bloqueio)
    server-min-score: 0
    # Faixas usadas no empréstimo do servidor (a maior faixa que o score alcançar)
    # amount-multiplier: multiplica o valor da tabela de preços
    # interest-multiplier: multiplica os juros do servidor
    tiers:
      excelente:
        min-score: 80
        display: '&2Excelente'
        amount-multiplier: 1.5
        interest-multiplier: 0.7
      bom:
        min-score: 60
        display: '&aBom'
        amount-multiplier: 1.25
        interest-multiplier: 0.85
      regular:
        min-score: 40
        display: '&eRegular'
        amount-multiplier: 1.0
        interest-multiplier: 1.0
      ruim:
        min-score: 0
        display: '&cRuim'
        amount-multiplier: 0.6
        interest-multiplier: 1.4
FaixaScore mínimoValor (amount-multiplier)Juros (interest-multiplier)
excelente801.50.7
bom601.250.85
regular401.01.0
ruim00.61.4
  • paid-bonus: pontos ganhos ao quitar
  • on-time-bonus: pontos extras se quitar antes do prazo
  • default-penalty: pontos perdidos ao dar calote
  • server-min-score: 0 = sem bloqueio para empréstimo do servidor

Exemplo: score 80, garantia item (default: 5000.0) e juros do servidor 20.0:

  • Valor emprestado: 5000.0 * 1.5 = 7500.0
  • Juros cobrados: 20.0 * 0.7 = 14.0%

collateral

Quais tipos de garantia estão habilitados neste servidor. Desative o que não for usar.

  collateral:
    # Item do inventário (fica retido no plugin até quitar ou dar calote)
    item: true
    # Máquina do yMaquinas (não pode quebrar/remover enquanto em garantia)
    maquina: true
    # Terreno do yTerrenos (não pode deletar/vender enquanto em garantia)
    terreno: true
    # Plot do yPlots (não pode transferir/deletar enquanto em garantia)
    plot: true
    # Spawner do ySpawners (não pode quebrar/remover enquanto em garantia)
    spawner: true
    # Mina do yMinasPv (não pode remover enquanto em garantia)
    mina: true
TipoPluginEnquanto em garantia
item—Fica retido no plugin até quitar ou calote
maquinayMaquinasNão pode quebrar/remover
terrenoyTerrenosNão pode deletar/vender
plotyPlotsNão pode transferir/deletar
spawnerySpawnersNão pode quebrar/remover
minayMinasPvNão pode remover

Exemplo de uso:

  collateral:
    item: true
    maquina: true
    terreno: false
    plot: false
    spawner: true
    mina: false

status

Formatação dos textos de status exibidos nos menus. Personalize as cores e os rótulos de cada estado.

status:
  request: '&eAguardando'
  active: '&aAtivo'
  paid: '&2Quitado'
  defaulted: '&cCalote'
  cancelled: '&7Cancelado'
  expired: '&8Expirado'
StatusDescrição
requestPedido P2P aguardando um agiota aceitar
activeContrato ativo
paidEmpréstimo quitado
defaultedCalote, com transferência da garantia
cancelledPedido cancelado
expiredPedido ou empréstimo expirado no prazo

Nesta página