Skip to content

dudujarra/olefut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

736 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚽ OléFUT

O clássico Elifoot e a alma dos arcades dos anos 90, fundidos com a profundidade do RPG moderno e a grife de um design Retro-Chique espetacular.

O OléFUT é o simulador de gestão de futebol definitivo rodando 100% offline direto no seu navegador. Composto por uma Engine Headless robusta e um Gabinete Virtual CRT Widescreen programado em React e CSS de alta definição, o jogo é o herdeiro espiritual perfeito da era de ouro do futebol tático com a identidade marcante da várzea brasileira.


OléFUT Gameplay Widescreen CRT Cabinet Dashboard


🎮 Jogue Agora: https://dudujarra.github.io/olefut/

CI Tests Specs SDD License


🥋 Diretrizes de Governança: Antes de tocar em qualquer linha de código, leia a nossa constituição em CLAUDE.md e os mandamentos do AKITA_RULES.md.


🎯 O Conceito: "Arcade de Grife"

OléFUT é construído sob o conceito de Arcade de Grife: uma fusão equilibrada entre o minimalismo contemporâneo limpo e a nostalgia dos painéis e gabinetes CRT dos anos 90. Nada de layouts genéricos ou emulações baratas de tela de console: o jogo se apresenta como um monitor analógico de alta resolução centrado em uma paisagem crepuscular em pixel art de uma comunidade brasileira.

🏛️ A Trindade Visual do Jogo:

  • Google Stitch: Governança estrita de layout, bento-grids assimétricos de alta legibilidade, espaçamentos calibrados contra a fadiga visual e botões reunidos em um grid de comando 6×3 com a ação principal destacada.
  • Figma & Canva Pro+: Cores de monitor CRT sutilmente ajustadas, escudos reais com dithering 16-bit, chanfros dourados metálicos e sombras projetadas limpas.
  • Canvas HTML5 & Pixel-Art Hardening: Algoritmo de Flood Fill BFS nas bordas para recorte dinâmico de fundos e renderização de contornos com nearest-neighbor estrito no navegador (zero borrões na imagem).

🎮 Gameplay & Sistemas

O jogo possui dois modos principais de jogo totalmente integrados, suportados por mais de 41 subsistemas lógicos rodando em tempo real na engine:

👔 1. Modo Treinador (Manager)

  • Gestão Total de Clubes: Gerencie um dos 268 clubes reais (divididos em 10 países: Brasil Séries A/B/C/D + potências da Europa e América do Sul).
  • Mesa de Táticas Dinâmica: Escolha entre 8 formações clássicas × 6 táticas (um sistema complexo de neutralização mútua) e escale seus titulares com auxílio do conselho tático da IA.
  • Vestiário Atômico: Lide com a química do elenco. A contratação de um Refugo MCO pode corromper o moral, enquanto a escolha de um Capitão Líder Nato estabiliza a equipe.
  • Mercado de Transferências & Finanças: Negocie contratos, faça ofertas em leilões de estrelas e monitore o fluxo de caixa para evitar a falência ou o tribunal de Justiça do Trabalho.
  • Categoria de Base & Staff: Melhore as instalações da sua Youth Academy de 5 níveis para revelar jovens regens promissores e contrate olheiros e fisioterapeutas no Staff.

🏃 2. Modo Jogador (Player RPG)

  • Carreira Individual: Crie e controle a trajetória de um único atleta, brigando por minutos no banco de reservas até se tornar a estrela do time.
  • Stress & Energia: Recursos limitados que exigem microgerenciamento. Excesso de treino ou baladas na semana drenam sua energia e disparam o estresse, levando a quebras mentais e lesões graves.
  • Linha de Vida & Relações: Administre a reputação com a torcida, a diretoria, seus companheiros e com os patrocinadores (sponsors) para selar novos acordos e transferências gigantescas.
  • Metaprogresso & Hall de Lendas: Compre itens cosméticos na loja e eternize seu nome na galeria histórica do clube.

🇧🇷 3. O Legítimo Sabor Brasileiro

  • Atmosfera Regional: logs de partida ricos em dialetos e narrativas do terrão, influenciados pelo clima de sol, chuva e calor tropical.
  • Vozes de Clubes Reais: Textos e reações personalizadas de 20 grandes clubes nacionais (a diretoria do Vasco é intolerante a derrotas em derbies; o Sport Recife se inflama em casa).
  • Eventos Sazonais: Triggers de calendário reais, incluindo feriados como Carnaval (que afeta o estresse e a energia dos jogadores) e janelas de transferências caóticas.
  • Linhagem e Filhos Regens: Aposente seus atletas de grife e veja seus filhos regens nascerem deterministicamente herdando características visuais e traços de personalidade (como Showman ou Rebelde).

🏗️ A Pilha Tecnológica (Tech Stack)

Camada Tecnologia Descrição
Core Engine JavaScript ES2022 Headless OOP pura, sem dependências de tela ou de DOM. Totalmente determinístico.
Interface (UI) React 19 + Vite 8 Widescreen Shell responsivo reproduzindo o monitor CRT e scanlines acelerados por hardware.
Áudio Tone.js Sintetizador interativo executando trilhas em tempo real baseadas em subgêneros de Tech-House de 16-bit.
Telemetria de IA WebLLM Geração de crônicas e análises pós-jogo locais via LLM no navegador com degradação segura sintética.
Suíte de Testes Vitest 4 Cobertura maciça com mais de 1814 testes integrados no CI.

🚀 Como Executar Localmente

Pré-requisitos

Certifique-se de ter o Node.js instalado na versão 18 ou superior.

Passo a Passo

  1. Clone o repositório oficial:

    git clone https://github.com/dudujarra/olefut.git
    cd olefut
  2. Instale as dependências de desenvolvimento:

    npm install
  3. Execute a suíte de testes globais para atestar a estabilidade:

    npm test
  4. Suba o servidor de desenvolvimento em tempo real (Vite):

    npm run dev

    Acesse a URL gerada no terminal (normalmente http://localhost:5173) para ver o jogo brilhando na sua tela!

  5. Compile o bundle otimizado de produção:

    npm run build

🧪 Governança & Disciplina (Protocolo AKITA)

O OléFUT é desenvolvido sob o Protocolo AKITA, um framework rigoroso de desenvolvimento de software que aniquila o vibe coding em favor da previsibilidade e robustez absoluta:

  1. SDD Obrigatório: Nenhuma linha de código de produção é escrita sem que a especificação (SPEC-XXX.md) correspondente tenha sido previamente debatida e aprovada na pasta /specs.
  2. Regra 0 (Sem Spec, Sem Harness): Cada PR deve conter simultaneamente a especificação e o teste/harness correspondente. Código sem teste dedicado é rejeitado automaticamente no CI.
  3. Bug Workflow de 3 Artefatos: Cada bug relatado gera um ticket detalhado no BUGS.md, um teste de regressão focado na anomalia e, somente então, o fix cirúrgico correspondente.

🤝 Créditos & Licença

Este projeto é desenvolvido e mantido por @dudujarra e publicado sob a Licença MIT — sinta-se livre para clonar, customizar e colocar no ar o seu próprio gerenciador de futebol de várzea!

Produzido sob a chancela da RIPA NA XULIPA STUDIOS.

Inspirado nos eternos clássicos:

  • Elifoot 98 (Miguel Vasconcelos) — O pai espiritual de uma geração de técnicos brasileiros.
  • Football Manager (Sports Interactive)
  • Hattrick (O clássico absoluto de navegadores)

Jogue grátis, sem anúncios, sem rastreadores e sem taxas. Apenas futebol, tática e resenha! 🎮👑

About

⚽ Football manager RPG retro 8-bit. 30 specs SDD + 597 tests + 20 bugs fixed Akita protocol. Theme toggle Modern/8-bit. Built with Claude Code + Stitch (Gemini 3 Pro) + Google Flow.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors