sevenx_engine 0.2.11

# 📦 Guia de Instalação - SevenX Engine


## 🎯 Escolha Sua Versão


### ✅ Versão Stable (Recomendado)


**Para**: Produção, projetos sérios, iniciantes

**Características**:
- ✅ Testada e estável
- ✅ Sem bugs críticos
- ✅ Documentação completa
- ✅ Suporte garantido

```toml
[dependencies]
sevenx_engine = "0.2.10"
```

### 🧪 Versão Beta (Experimental)


**Para**: Testes, early adopters, contribuidores

**Características**:
- 🆕 Novas features
- ⚠️ Pode ter bugs
- 📝 Documentação em progresso
- 🐛 Ajude reportando bugs

```toml
[dependencies]
sevenx_engine = "0.2.11-beta.1"
```

---

## 🚀 Instalação Rápida


### 1. Criar Projeto


```bash
cargo new meu_jogo
cd meu_jogo
```

### 2. Adicionar Dependência


**Stable**:
```bash
cargo add sevenx_engine@0.2.10
```

**Beta**:
```bash
cargo add sevenx_engine@0.2.11-beta.1
```

### 3. Código Básico


```rust
use sevenx_engine::*;

struct MeuJogo;

impl GameState for MeuJogo {
    fn new() -> Self { MeuJogo }
    
    fn update(&mut self, dt: f32, input: &input::InputHandler, _world: &mut world::World) {
        // Sua lógica aqui
    }
    
    fn draw(&mut self, _world: &world::World, pixels: &mut [u8]) {
        // Seu desenho aqui
    }
}

fn main() {
    Engine::new().run::<MeuJogo>();
}
```

### 4. Executar


```bash
cargo run
```

---

## 📋 Versões Disponíveis


### Stable (Produção)


| Versão | Data | Status | Notas |
|--------|------|--------|-------|
| 0.2.10 | 2025-01-10 | ✅ Atual | Bug fixes 3D |
| 0.2.9 | 2025-01-09 | ✅ Estável | Suporte Android |
| 0.2.8 | 2025-01-08 | ✅ Estável | 3D v0.1.1 |

### Beta (Testes)


| Versão | Data | Status | Notas |
|--------|------|--------|-------|
| 0.2.11-beta.1 | Em breve | 🧪 Beta | Deferred rendering |

---

## 🔄 Atualizar Versão


### Atualizar para Última Stable


```bash
cargo update sevenx_engine
```

### Mudar para Beta


```toml
[dependencies]
sevenx_engine = "0.2.11-beta.1"
```

```bash
cargo update
```

### Voltar para Stable


```toml
[dependencies]
sevenx_engine = "0.2.10"
```

```bash
cargo update
```

---

## 🎮 Features por Versão


### v0.2.10 (Stable Atual)


#### 2D

- ✅ Sprites e animação
- ✅ Física 2D
- ✅ Partículas 2D (8 presets)
- ✅ Shaders 2D (20+ tipos)
- ✅ Tilemap
- ✅ UI e texto
- ✅ Áudio
- ✅ Networking
- ✅ Gamepad

#### 3D

- ✅ 15+ primitivas 3D
- ✅ PBR materials
- ✅ Iluminação dinâmica
- ✅ Partículas 3D
- ✅ Model loader (OBJ)
- ✅ Frustum culling
- ✅ LOD system
- ✅ Skybox
- ✅ Terreno

#### Mobile

- ✅ Suporte Android completo
- ✅ Touch multi-touch
- ✅ Joystick virtual
- ✅ Sensores (acelerômetro/giroscópio)
- ✅ Vibração
- ✅ Gestos

### v0.2.11-beta.1 (Em Breve)


#### Novo

- 🆕 Deferred rendering
- 🆕 Cascaded shadow maps
- 🆕 Screen space reflections
- 🆕 Temporal anti-aliasing
- 🆕 Async texture loading
- 🆕 GPU acceleration (wgpu)

---

## ⚠️ Problemas Conhecidos


### v0.2.10


#### AdvancedRenderer3D

- ⚠️ Pode ter overflow em resoluções muito altas (>4K)
- **Solução**: Use Renderer3D básico ou aguarde v0.2.11

#### Android

- ⚠️ Alguns dispositivos antigos podem ter problemas com sensores
- **Solução**: Desabilite sensores se necessário

### v0.2.11-beta.1


- 🧪 Em desenvolvimento
- 🐛 Bugs esperados
- 📝 Documentação incompleta

---

## 🆘 Suporte


### Versão Stable


✅ **Suporte completo**
- GitHub Issues
- Discussions
- Documentação completa
- Exemplos testados

### Versão Beta


⚠️ **Suporte limitado**
- GitHub Issues (bugs)
- Discussions (dúvidas)
- Documentação em progresso
- Exemplos podem não funcionar

---

## 📚 Recursos


### Documentação


**Stable**:
- [API 2D Completa](API_2D_COMPLETE.md)
- [API 3D Completa](API_3D_COMPLETE.md)
- [Quick Start 3D](QUICK_START_3D.md)
- [FAQ](FAQ.md)

**Beta**:
- [Roadmap v0.2.11](ROADMAP_v0.2.11.md)
- [Changelog Beta](CHANGELOG_BETA.md)

### Exemplos


**Stable**:
```bash
cargo run --example simple_3d_working
cargo run --example pbr_demo
cargo run --example android_complete
```

**Beta**:
```bash
cargo run --example deferred_rendering_demo
cargo run --example csm_demo
```

---

## 🐛 Reportar Bugs


### Versão Stable


1. Verifique se já foi reportado
2. Crie issue com template
3. Inclua versão exata
4. Código mínimo para reproduzir

### Versão Beta


1. Verifique se é bug conhecido
2. Crie issue marcada como `beta`
3. Inclua versão beta exata
4. Descreva comportamento esperado

---

## 🎯 Recomendações


### Use Stable Se:

- ✅ Está fazendo um jogo sério
- ✅ Precisa de estabilidade
- ✅ É iniciante
- ✅ Vai publicar o jogo

### Use Beta Se:

- 🧪 Quer testar novas features
- 🧪 Pode lidar com bugs
- 🧪 Quer contribuir
- 🧪 Está experimentando

---

## 📊 Comparação


| Aspecto | Stable | Beta |
|---------|--------|------|
| Estabilidade | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| Features | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Documentação | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| Suporte | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| Performance | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Bugs | ⭐⭐⭐⭐⭐ | ⭐⭐ |

---

## 🔗 Links


- **Crates.io**: https://crates.io/crates/sevenx_engine
- **GitHub**: https://github.com/sevenx777-dev/SevenX-Engine
- **Docs**: https://github.com/sevenx777-dev/SevenX-Engine/tree/main
- **Issues**: https://github.com/sevenx777-dev/SevenX-Engine/issues

---

**Escolha a versão certa para você! 🚀✨**