💰 SFEconomy

Sistema de economia completo, rápido e 100% configurável para o seu servidor

Feito no Brasil por Serafim

Purpur Paper Spigot — Minecraft 1.21.11

✨ Sobre o plugin

O SFEconomy é um sistema de economia moderno para servidores de Minecraft. Ele cuida do saldo dos seus jogadores, permite transferências entre eles, ranking de mais ricos e ferramentas completas de administração — tudo isso sem travar o servidor e sem exigir conhecimento técnico para configurar.

Foi construído do zero pensando em performance, flexibilidade e facilidade de uso, tanto para quem administra o servidor quanto para quem só quer instalar e jogar.

🎯 Por que escolher o SFEconomy?

🕹️ Comandos

Comando principal totalmente renomeável — por padrão é /coins, mas pode virar /money, /economia, o que preferir, direto na configuração.

Cada um desses nomes (pay, top, give...) também pode ser trocado na configuração — se você preferir /coins enviar ao invés de /coins pay, é só editar um arquivo.

🔗 Funciona com os seus outros plugins

O SFEconomy conversa com qualquer plugin compatível com Vault — o padrão que praticamente todo plugin de loja, cassino, recompensa ou ranking do mercado já sabe usar. Instale os dois juntos e a integração acontece sozinha, sem configuração extra.

🧑‍💻 Você é desenvolvedor e quer que o seu plugin puxe o saldo dos jogadores do SFEconomy? Veja abaixo.

🧩 Como puxar a API do SFEconomy no seu plugin

O SFEconomy não tem uma API própria — ele usa a API do Vault, que é o padrão universal de economia no mundo Bukkit/Paper. Isso significa que, se o seu plugin já sabe usar Vault, ele já funciona com o SFEconomy automaticamente, sem nenhuma linha de código extra.

Passo 1 — Adicione o Vault como dependência

No build.gradle do seu plugin:

repositories {
    maven { url = 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.MilkBowl:VaultAPI:1.7'
}

E no plugin.yml:

depend: [Vault]

Passo 2 — Pegue a economia quando o plugin ligar

import net.milkbowl.vault.economy.Economy;
import org.bukkit.Bukkit;
import org.bukkit.plugin.RegisteredServiceProvider;

private Economy economia;

@Override
public void onEnable() {
    RegisteredServiceProvider<Economy> provedor =
            Bukkit.getServicesManager().getRegistration(Economy.class);

    if (provedor == null) {
        getLogger().severe("Nenhuma economia encontrada! Instale o SFEconomy + Vault.");
        return;
    }

    economia = provedor.getProvider();
}

Passo 3 — Use normalmente

// Ver o saldo de um jogador
double saldo = economia.getBalance(player);

// Cobrar do jogador (ex: comprar um item)
if (economia.has(player, 100.0)) {
    economia.withdrawPlayer(player, 100.0);
    // entregar o item aqui
}

// Dar dinheiro ao jogador (ex: recompensa de missão)
economia.depositPlayer(player, 50.0);

// Formatar um valor do jeito que o servidor configurou (ex: "R$ 1.234,50")
String textoFormatado = economia.format(1234.5);

Pronto — é só isso. O SFEconomy cuida de todo o resto (salvar no banco, aplicar as regras configuradas, etc.) por trás dos panos.

📖 Guia técnico completo, com todos os métodos disponíveis e detalhes de comportamento: veja API.md.

SFEconomy — desenvolvido por Serafim 🇧🇷