RS-Loot

Sistema de saque avançado para RedM com cooldown global por local e sistema de traduções robusto.

🎯 Características

• Cooldown Global por Local: Quando um jogador saqueia um local, todos os outros jogadores também ficam com cooldown nesse local
• Sistema de Traduções: Suporte completo ao português com fallback hardcoded
• Múltiplas Categorias: Comercial, residencial, militar, médico, raro, industrial, culinário e ervas
• Efeitos Visuais: Partículas e animações imersivas
• Sistema de Notificações: Compatível com rnotify e ox_lib
• Comandos Admin: Gerenciamento completo de cooldowns

🚀 Instalação

1. Coloque a pasta rs-loot em resources/[rick-sanchez]/
2. Adicione ensure rs-loot ao seu server.cfg
3. Reinicie o servidor

⚙️ Configuração

Dependências

• ox_lib - Para progress bars e notificações
• rsg-core - Framework principal

Configurações Principais

-- shared/config.lua
Config.Locale = 'pt-pt'  -- Idioma (pt-pt ou en)
Config.Notify = 'ox_lib' -- Sistema de notificações
Config.Settings.debug = false -- Debug mode

Idiomas Suportados

• Português (pt-pt): Idioma padrão
• Inglês (en): Suporte completo
• Fallback: Traduções hardcoded em português se arquivo não carregar

Cooldowns

Config.Cooldowns = {
    IndividualCooldowns = {
        ['valentine_general_store'] = 1800000, -- 30 minutos
        ['strawberry_house_1'] = 2700000,     -- 45 minutos
        ['fort_wallace_armory'] = 5400000,    -- 1.5 horas
    },
    GlobalCooldown = 30000, -- 30 segundos entre qualquer loot
}

🎮 Como Usar

Para Jogadores

1. Encontrar Locais: Use o mapa para encontrar pontos de saque (blips coloridos)
2. Saque: Aproxime-se do local e pressione E para saquear
3. Verificar Status: Use /checkcooldown para ver locais disponíveis
4. Monitor: Use /togglecooldowndisplay para ativar monitor automático

Para Administradores

• /lootreset - Resetar todos os cooldowns
• /lootcooldowns - Verificar cooldowns ativos
• /checkcooldown - Verificar status dos locais

🗺️ Sistema de Cooldown Global

Como Funciona

1. Jogador A saqueia o "Armazém de Valentine"
2. Local fica bloqueado para todos os jogadores por 30 minutos
3. Jogador B tenta saquear o mesmo local → Bloqueado
4. Jogador C tenta saquear outro local → Permitido (se não estiver em cooldown)

Exemplo Prático

14:00 - Jogador A saqueia "Armazém de Valentine"
14:00 - Local bloqueado até 14:30 para TODOS os jogadores
14:15 - Jogador B tenta saquear → "Local indisponível, aguarde 15m"
14:30 - Local liberado para todos os jogadores

🎨 Categorias de Loot

Categoria	Descrição	Exemplos
Comercial	Lojas e mercados	Dinheiro, joias, ferramentas
Residencial	Casas e apartamentos	Comida, roupas, objetos pessoais
Militar	Bases e fortalezas	Armas, munição, equipamentos
Médico	Hospitais e clínicas	Medicamentos, equipamentos médicos
Raro	Locais especiais	Ouro, prata, itens únicos
Industrial	Fábricas e minas	Materiais, ferramentas pesadas
Culinário	Restaurantes e cozinhas	Comida, temperos, utensílios
Ervas	Campos e jardins	Plantas medicinais, sementes

🔧 Comandos

Jogadores

• /checkcooldown - Verificar status dos locais
• /togglecooldowndisplay - Ativar/desativar monitor automático

Administradores

• /lootreset - Resetar todos os cooldowns
• /lootcooldowns - Verificar cooldowns ativos

🎯 Balanceamento

Cooldowns por Local

• Locais Comerciais: 30 minutos
• Locais Residenciais: 45 minutos
• Locais Militares: 1.5 horas
• Locais Raros: 2 horas

Cooldown Global

• 30 segundos entre qualquer ação de saque (evita spam)

🛠️ Desenvolvimento

Estrutura de Arquivos

rs-loot/
├── client/
│   └── main.lua          # Lógica do cliente
├── server/
│   └── main.lua          # Lógica do servidor
├── shared/
│   └── config.lua        # Configurações
├── locales/
│   └── pt-pt.json        # Traduções
├── fxmanifest.lua        # Manifesto
└── README.md             # Documentação

Adicionar Novos Locais

1. Editar shared/config.lua:

Config.LootPoints['novo_local'] = {
    id = 'novo_local',
    name = 'Novo Local',
    coords = vector3(x, y, z),
    lootType = 'commercial',
    showblip = true
}

2. Adicionar Cooldown:

Config.Cooldowns.IndividualCooldowns['novo_local'] = 1800000 -- 30 minutos

3. Reiniciar o recurso: restart rs-loot

🐛 Solução de Problemas

Traduções Não Aparecem

• O sistema usa fallback hardcoded se o arquivo JSON não carregar
• Verifique se Config.Locale = 'pt-pt' ou Config.Locale = 'en' está correto
• Reinicie o recurso: restart rs-loot

Alterar Idioma

Para usar inglês, altere no arquivo shared/config.lua:

Config.Locale = 'en'  -- Para inglês
Config.Locale = 'pt-pt'  -- Para português (padrão)

Cooldowns Não Funcionam

• Verifique se Config.Cooldowns está configurado corretamente
• Use /lootcooldowns para verificar status
• Use /lootreset para resetar se necessário

Blips Não Aparecem

• Verifique se showblip = true nos pontos de loot
• Confirme se as coordenadas estão corretas
• Reinicie o recurso

📝 Changelog

v2.0.0

• ✅ Sistema de cooldown global por local implementado
• ✅ Sistema de traduções com fallback hardcoded
• ✅ Código limpo e organizado
• ✅ Documentação atualizada
• ✅ Arquivos desnecessários removidos

v1.0.0

• ✅ Sistema básico de loot implementado
• ✅ Múltiplas categorias de loot
• ✅ Efeitos visuais e animações
• ✅ Sistema de notificações

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE.md para mais detalhes.

👨‍💻 Autor

Rick Sanchez - Desenvolvimento e manutenção

---

Nota: Este script foi desenvolvido especificamente para o framework RSG-Core e RedM. Certifique-se de que todas as dependências estão instaladas e configuradas corretamente.