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.
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: falseMantenha 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: 2020 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
- 86400Destaques 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:
200ticks = 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:
| Segundos | Prazo |
|---|---|
3600 | 1h |
7200 | 2h |
21600 | 6h |
86400 | 1 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
- 86400server
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| Tipo | default | types |
|---|---|---|
item | 5000.0 | — |
maquina | 25000.0 | key da máquina no yMaquinas |
terreno | 80000.0 | — |
plot | 60000.0 | — |
spawner | 20000.0 | key do spawner no ySpawners |
mina | 70000.0 | key da estrutura no yMinasPv |
enabled: false— o botão de empréstimo do servidor fica bloqueadomax-amount: 0— sem teto extra além da tabela de preçostypes— sobrescreve odefaultquando 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.0credit
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| Faixa | Score mínimo | Valor (amount-multiplier) | Juros (interest-multiplier) |
|---|---|---|---|
excelente | 80 | 1.5 | 0.7 |
bom | 60 | 1.25 | 0.85 |
regular | 40 | 1.0 | 1.0 |
ruim | 0 | 0.6 | 1.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| Tipo | Plugin | Enquanto em garantia |
|---|---|---|
item | — | Fica retido no plugin até quitar ou calote |
maquina | yMaquinas | Não pode quebrar/remover |
terreno | yTerrenos | Não pode deletar/vender |
plot | yPlots | Não pode transferir/deletar |
spawner | ySpawners | Não pode quebrar/remover |
mina | yMinasPv | Não pode remover |
Exemplo de uso:
collateral:
item: true
maquina: true
terreno: false
plot: false
spawner: true
mina: falsestatus
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'| Status | Descrição |
|---|---|
request | Pedido P2P aguardando um agiota aceitar |
active | Contrato ativo |
paid | Empréstimo quitado |
defaulted | Calote, com transferência da garantia |
cancelled | Pedido cancelado |
expired | Pedido ou empréstimo expirado no prazo |