sevenx_engine 0.2.11

Engine de jogos 2D/3D completa com suporte Android, física, áudio, partículas, tilemap, UI, eventos e sistema 3D avançado com PBR.
Documentation
# 🚀 Como Instalar e Usar a SevenX Engine


## 📦 Instalação


### 1. Instalar Rust


**Windows:**
- Baixe: https://rustup.rs/
- Execute o instalador
- Reinicie o terminal

**Linux/macOS:**
```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

### 2. Instalar a SevenX CLI


```bash
cargo install --git https://github.com/sevenx777-dev/SevenX-Engine sevenx
```

Ou clone e instale localmente:
```bash
git clone https://github.com/sevenx777-dev/SevenX-Engine
cd SevenX-Engine
cargo install --path . --bin sevenx
```

## 🎮 Usar a Engine


### Criar Novo Projeto


```bash
sevenx new meu_jogo
cd meu_jogo
cargo run
```

### Usar Templates Prontos


```bash
# Ver templates disponíveis

sevenx template

# Criar de um template

sevenx template platformer meu_platformer
sevenx template fps meu_fps
sevenx template rpg meu_rpg
```

### Templates Disponíveis


1. **platformer** - Jogo de plataforma 2D
   - Movimento horizontal
   - Pulo e gravidade
   - Chão

2. **topdown** - Jogo top-down 2D
   - Movimento em 8 direções
   - Visão de cima

3. **fps** - FPS 3D
   - Renderização 3D
   - Câmera primeira pessoa
   - Meshes 3D

4. **rpg** - RPG completo
   - Inventário
   - Sistema de quests
   - Gold

5. **empty** - Projeto vazio
   - Apenas estrutura básica

## 🔧 Comandos


```bash
sevenx new <nome>           # Cria novo projeto
sevenx template [tipo]      # Lista ou cria de template
sevenx run                  # Roda o projeto
sevenx build                # Compila para release
sevenx help                 # Ajuda
```

## 📁 Estrutura do Projeto


```
meu_jogo/
├── Cargo.toml          # Configuração do projeto
├── README.md           # Documentação
├── src/
│   └── main.rs         # Código principal
└── assets/             # Imagens, sons, etc
```

## 🎯 Workflow


### 1. Criar Projeto

```bash
sevenx template platformer meu_platformer
cd meu_platformer
```

### 2. Desenvolver

Edite `src/main.rs` com qualquer editor:
- VS Code (recomendado)
- Notepad++
- Sublime Text
- Vim/Neovim
- Qualquer editor de texto

### 3. Testar

```bash
cargo run
```

### 4. Compilar

```bash
cargo build --release
```

O executável estará em `target/release/meu_platformer.exe`

### 5. Distribuir

Copie o `.exe` e distribua! Não precisa de nada instalado.

## 💡 Dicas


### Desenvolvimento Rápido


```bash
# Cria e roda em um comando

sevenx template platformer teste && cd teste && cargo run
```

### Hot Reload


Use `cargo watch` para recompilar automaticamente:
```bash
cargo install cargo-watch
cargo watch -x run
```

### Otimizar Tamanho


Adicione ao `Cargo.toml`:
```toml
[profile.release]
opt-level = "z"
lto = true
strip = true
```

## 📚 Próximos Passos


1. ✅ Instale Rust
2. ✅ Instale SevenX CLI
3. ✅ Crie um projeto
4. ✅ Rode e teste
5. ✅ Leia a [documentação]README.md
6. ✅ Veja os [exemplos]examples/
7. ✅ Crie seu jogo!

## 🎉 Pronto!


Agora você tem tudo para criar jogos com SevenX Engine!

**Não precisa de:**
- ❌ Editor de código específico
- ❌ IDE pesada
- ❌ Configuração complexa

**Só precisa de:**
- ✅ Rust instalado
- ✅ SevenX CLI
- ✅ Qualquer editor de texto
- ✅ Sua criatividade!

---

**Dúvidas?** Abra uma issue no GitHub!