@boruto_vk7/gerador-sensi

Gerador Inteligente de Sensibilidade para Free Fire — Calcula automaticamente a melhor configuração de sensibilidade baseado no desempenho real do seu dispositivo (AnTuTu), estilo de jogo e preferências pessoais.

🎯 Características

• 🔍 Integração com AnTuTu: Busca dados reais de performance do seu dispositivo
• 🎮 3 Estilos de Jogo: Agressivo, Equilibrado e Sniper
• 📊 Cálculo Inteligente: Algoritmo baseado em AnTuTu score, não em categorias genéricas
• ⚡ Cache Automático: Reduz requisições ao AnTuTu com cache de 1 hora
• 🔎 Busca Avançada: Procure por marca, faixa de AnTuTu ou veja o ranking top
• 📱 Suporte Universal: Funciona com qualquer dispositivo Android/iOS
• 🚀 TypeScript: Tipos completos e IntelliSense
• 📦 Zero Dependências Externas: Apenas axios e cheerio

📦 Instalação

npm install @boruto_vk7/gerador-sensi

Ou com yarn:

yarn add @boruto_vk7/gerador-sensi

🚀 Uso Rápido

Gerar Sensibilidade para um Dispositivo

import SensitivityGenerator from '@boruto_vk7/gerador-sensi';

// Gerar sensibilidade equilibrada para Samsung A15
const result = await SensitivityGenerator.generate('Samsung A15', 'balanced');

console.log(result);
// {
//   device: 'Samsung Galaxy A15',
//   antutu: 350000,
//   category: 'intermediate',
//   dpi: 650,
//   general: 160,
//   redDot: 170,
//   scope2x: 160,
//   scope4x: 170,
//   awm: 120,
//   freeCamera: 140,
//   style: 'balanced',
//   timestamp: '2026-06-05T...'
// }

Gerar Múltiplas Variações

// Gerar os 3 estilos (agressivo, equilibrado, sniper)
const variations = await SensitivityGenerator.generateVariations('iPhone 13');

variations.forEach((v) => {
  console.log(`${v.style}: Geral=${v.general}, Câmera=${v.freeCamera}`);
});
// aggressive: Geral=185, Câmera=160
// balanced: Geral=175, Câmera=140
// sniper: Geral=160, Câmera=130

Buscar Informações do Dispositivo

// Obter informações completas do dispositivo
const device = await SensitivityGenerator.getDeviceInfo('Samsung A15');

console.log(device);
// {
//   rank: 45,
//   name: 'Samsung Galaxy A15',
//   soc: 'Exynos 1280',
//   cpu: 285000,
//   gpu: 95000,
//   mem: 45000,
//   ux: 65000,
//   totalScore: 490000
// }

Ver Melhores Dispositivos

// Top 10 dispositivos
const topDevices = await SensitivityGenerator.getBestDevices(10);

topDevices.forEach((device, i) => {
  console.log(`${i + 1}. ${device.name} - AnTuTu: ${device.totalScore}`);
});
// 1. Red Magic 11 Pro - AnTuTu: 3964036
// 2. OPPO Find X9 Ultra - AnTuTu: 3876104
// 3. HONOR WIN - AnTuTu: 3764432
// ...

Buscar por Marca

// Todos os Samsung no ranking
const samsungs = await SensitivityGenerator.getDevicesByBrand('Samsung', 20);

samsungs.forEach((device) => {
  console.log(`${device.name}: ${device.totalScore}`);
});

Buscar por Faixa de AnTuTu

// Dispositivos intermediários (200k - 400k)
const intermediate = await SensitivityGenerator.getDevicesByScoreRange(200000, 400000);

console.log(`Encontrados ${intermediate.length} dispositivos intermediários`);

Gerar com AnTuTu Manual

// Se você já sabe o AnTuTu do seu celular
const result = SensitivityGenerator.generateManual(350000, 'balanced');

console.log(result);
// {
//   device: 'Manual',
//   antutu: 350000,
//   category: 'intermediate',
//   dpi: 650,
//   general: 160,
//   ...
// }

📚 API Completa

generate(deviceName, style?)

Gera sensibilidade para um dispositivo específico.

Parâmetros:

• deviceName (string): Nome do dispositivo (ex: "Samsung A15", "iPhone 13")
• style (string, opcional): "aggressive" | "balanced" | "sniper" (padrão: "balanced")

Retorna: Promise<SensitivityResult | null>

generateVariations(deviceName)

Gera as 3 variações de estilo para um dispositivo.

Parâmetros:

• deviceName (string): Nome do dispositivo

Retorna: Promise<SensitivityResult[] | null>

generateManual(antutu, style?)

Gera sensibilidade com AnTuTu manual (sem buscar no site).

Parâmetros:

• antutu (number): Score do AnTuTu
• style (string, opcional): "aggressive" | "balanced" | "sniper" (padrão: "balanced")

Retorna: SensitivityResult

getDeviceInfo(deviceName)

Busca informações completas de um dispositivo.

Parâmetros:

• deviceName (string): Nome do dispositivo

Retorna: Promise<DeviceInfo | null>

getTopDevices(limit?)

Obtém os melhores dispositivos do ranking do AnTuTu.

Parâmetros:

• limit (number, opcional): Quantidade de dispositivos (padrão: 50)

Retorna: Promise<DeviceInfo[] | null>

getBestDevices(limit?)

Alias para getTopDevices().

Parâmetros:

• limit (number, opcional): Quantidade de dispositivos (padrão: 10)

Retorna: Promise<DeviceInfo[] | null>

getDevicesByBrand(brand, limit?)

Busca dispositivos de uma marca específica.

Parâmetros:

• brand (string): Nome da marca (ex: "Samsung", "iPhone", "Redmi")
• limit (number, opcional): Quantidade de dispositivos (padrão: 20)

Retorna: Promise<DeviceInfo[]>

getDevicesByScoreRange(minScore, maxScore)

Busca dispositivos em uma faixa de AnTuTu.

Parâmetros:

• minScore (number): Score mínimo
• maxScore (number): Score máximo

Retorna: Promise<DeviceInfo[]>

📊 Tipos TypeScript

SensitivityResult

interface SensitivityResult {
  device: string;
  antutu: number;
  category: 'basic' | 'intermediate' | 'good' | 'top' | 'ultra';
  dpi: number;
  general: number;
  redDot: number;
  scope2x: number;
  scope4x: number;
  awm: number;
  freeCamera: number;
  style: 'aggressive' | 'balanced' | 'sniper';
  timestamp: string;
}

DeviceInfo

interface DeviceInfo {
  rank: number;
  name: string;
  soc: string;
  cpu: number;
  gpu: number;
  mem: number;
  ux: number;
  totalScore: number;
}

🎮 Entendendo os Estilos

Agressivo

• Ideal para: Jogadores que gostam de rotação rápida e movimento constante
• Características: Geral e Câmera Livre aumentados
• Quando usar: Modo Squad, combates próximos

Equilibrado

• Ideal para: Maioria dos jogadores
• Características: Balanço entre precisão e velocidade
• Quando usar: Todos os modos

Sniper

• Ideal para: Jogadores que focam em precisão
• Características: Miras curtas reduzidas, 4x e AWM aumentados
• Quando usar: Modo Sniper, combates à distância

🔧 Categorias de Dispositivos

| Categoria | AnTuTu | Exemplo | |-----------|--------|---------| | Basic | < 200k | Moto E6, Samsung A02 | | Intermediate | 200k - 400k | Samsung A15, Redmi 9 | | Good | 400k - 600k | Samsung A52, iPhone 11 | | Top | 600k - 800k | Samsung S22, iPhone 13 | | Ultra | > 800k | Red Magic 11, iPhone 15 Pro |

💡 Exemplos Práticos

Exemplo 1: Encontrar Melhor Dispositivo

const topDevices = await SensitivityGenerator.getBestDevices(5);
const best = topDevices[0];

const sensi = await SensitivityGenerator.generate(best.name, 'aggressive');
console.log(`Melhor dispositivo: ${best.name}`);
console.log(`Sensibilidade recomendada: ${sensi.general}`);

Exemplo 2: Comparar Estilos

const variations = await SensitivityGenerator.generateVariations('iPhone 13');

console.log('Comparação de Estilos:');
variations.forEach((v) => {
  console.log(`
${v.style.toUpperCase()}:
  Geral: ${v.general}
  Ponto: ${v.redDot}
  2x: ${v.scope2x}
  4x: ${v.scope4x}
  AWM: ${v.awm}
  Câmera: ${v.freeCamera}
  `);
});

Exemplo 3: Buscar Dispositivos em Faixa

// Encontrar dispositivos intermediários
const devices = await SensitivityGenerator.getDevicesByScoreRange(200000, 400000);

console.log(`Dispositivos intermediários encontrados: ${devices.length}`);

// Gerar sensi para cada um
for (const device of devices.slice(0, 5)) {
  const sensi = await SensitivityGenerator.generate(device.name);
  console.log(`${device.name}: Geral=${sensi.general}`);
}

⚙️ Configuração Avançada

Cache

O módulo usa cache automático de 1 hora para reduzir requisições ao AnTuTu.

// Limpar cache (se necessário)
// Nota: Não há método público, mas o cache expira automaticamente

Timeout

As requisições têm timeout de 10 segundos.

🐛 Troubleshooting

"Dispositivo não encontrado"

• Verifique o nome exato do dispositivo (ex: "Samsung Galaxy A15" em vez de "Samsung A15")
• Tente buscar por marca com getDevicesByBrand()
• Use getBestDevices() para ver dispositivos disponíveis

"Erro ao buscar AnTuTu"

• Verifique sua conexão com a internet
• O site do AnTuTu pode estar indisponível temporariamente
• Tente novamente em alguns minutos

Resultados inconsistentes

• O cache expira a cada 1 hora
• Os dados do AnTuTu são atualizados mensalmente
• Resultados podem variar com base na versão do AnTuTu

📈 Performance

• Primeira requisição: ~2-3 segundos (busca no AnTuTu)
• Requisições em cache: ~10ms (cache local)
• Cache TTL: 1 hora

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Fork o repositório
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📝 Licença

Este projeto está licenciado sob a Licença MIT — veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

• AnTuTu pelos dados de performance
• Mobileverso pela inspiração
• Comunidade Free Fire por feedback e testes

📞 Suporte

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues
• 💬 Discussões: GitHub Discussions

🔗 Links Úteis

• Documentação do AnTuTu
• Guia de Sensibilidade Free Fire
• Comunidade Free Fire

Desenvolvido com ❤️ para a comunidade Free Fire

v1.0.0 • MIT License • 2026