Home_pt
Select your language / Choisissez votre langue / Wählen Sie Ihre Sprache:
English | Français | Deutsch | Italiano | Español | Português | Slovenščina | Українська | Русский
Um ambiente de desenvolvimento de jogos visual inspirado no GameMaker 7.0
PyGameMaker é uma IDE de código aberto que torna a criação de jogos 2D acessível através de programação visual baseada em blocos (Google Blockly) e um sistema de eventos-ações. Crie jogos sem conhecimentos profundos de programação e depois exporte-os para Windows, Linux, HTML5 ou plataformas móveis.
PyGameMaker usa predefinições para controlar quais eventos e ações estão disponíveis. Isso ajuda iniciantes a focar nas funcionalidades essenciais enquanto permite que usuários experientes acessem o conjunto completo de ferramentas.
| Predefinição | Ideal Para | Funcionalidades |
|---|---|---|
| Iniciante | Novos em desenvolvimento de jogos | O essencial — movimento, colisões, pontuação, salas |
| Intermediário | Alguma experiência | Adiciona vidas, saúde, som, alarmes, desenho |
| Avançado (Completo) | Usuários experientes | Tudo — os 37 eventos e 109 ações |
Novos usuários: Comece com a Predefinição Iniciante para aprender os fundamentos sem se sentir sobrecarregado.
Veja o Guia de Predefinições para uma visão completa do sistema de predefinições.
| Funcionalidade | Descrição |
|---|---|
| Programação Visual | Codificação arrastar e soltar com Google Blockly 12.x |
| Sistema Eventos-Ações | Lógica baseada em eventos compatível com GameMaker 7.0 |
| Predefinições por Nível | Conjuntos de funcionalidades Iniciante, Intermediário e Avançado |
| Vista 2.5D / Primeira pessoa | Renderização raycast opcional no estilo Doom/Wolfenstein — veja Vista 3D |
| Exportação Multi-Plataforma | Windows EXE, app macOS, HTML5, Linux, Kivy (móvel/desktop) |
| Gestão de Recursos | Sprites, sons, fundos, fontes e salas |
| Interface Multilingue | Inglês, Francês, Alemão, Italiano, Espanhol, Português, Esloveno, Ucraniano, Russo |
| Extensível | Sistema de extensões e plugins para ações e renderizadores personalizados |
- Python 3.10 ou superior
- Sistema Operacional: Windows, Linux ou macOS
-
Clone o repositório:
git clone https://github.com/Gabe1290/pythongm.git cd pythongm -
Crie um ambiente virtual (recomendado):
python -m venv venv source venv/bin/activate # Linux/macOS # ou venv\Scripts\activate # Windows
-
Instale as dependências:
pip install -r requirements.txt
-
Execute o PyGameMaker:
python main.py
Entidades do jogo com sprites, propriedades e comportamentos. Cada objeto pode ter múltiplos eventos com ações associadas.
Gatilhos que executam ações quando condições específicas ocorrem:
- Create - Quando uma instância é criada
- Step - Cada frame (tipicamente 60 FPS)
- Draw - Fase de renderização personalizada
- Destroy - Quando uma instância é destruída
- Keyboard - Tecla pressionada, solta ou mantida
- Mouse - Cliques, movimento, entrada/saída
- Collision - Quando instâncias se tocam
- Alarm - Temporizadores de contagem regressiva (12 disponíveis)
Veja a Referência de Eventos para documentação completa.
Operações realizadas quando eventos são disparados. 109 ações integradas para:
- Movimento e física
- Desenho e sprites
- Pontuação, vidas e saúde
- Som e música
- Gestão de instâncias e salas
- Vista 3D (renderização em primeira pessoa com raycast)
Veja a Referência Completa de Ações para documentação completa.
Níveis do jogo onde você posiciona instâncias de objetos, define fundos e a área de jogo.
PyGameMaker integra Google Blockly para programação visual. Os blocos são organizados em categorias:
- Eventos - Create, Step, Draw, Keyboard, Mouse
- Movimento - Velocidade, direção, posição, gravidade
- Temporização - Alarmes e atrasos
- Desenho - Formas, texto, sprites
- Pontuação/Vidas/Saúde - Rastreamento do estado do jogo
- Instância - Criar e destruir objetos
- Sala - Navegação e gestão
- Valores - Variáveis e expressões
- Som - Reprodução de áudio
- Saída - Debug e exibição
Executáveis Windows independentes usando PyInstaller. Nenhum Python necessário na máquina de destino.
Pacotes .app nativos para macOS via PyInstaller.
Jogos web de arquivo único que funcionam em qualquer navegador moderno. Comprimidos com gzip para carregamento rápido.
Executáveis Linux nativos para ambientes Python 3.10+.
Aplicações multiplataforma para móvel (iOS/Android) e desktop via Buildozer.
nome_projeto/
├── project.json # Configuração do projeto
├── backgrounds/ # Imagens de fundo e metadados
├── data/ # Arquivos de dados personalizados
├── fonts/ # Definições de fontes
├── objects/ # Definições de objetos (JSON)
├── rooms/ # Layouts de salas (JSON)
├── scripts/ # Scripts personalizados
├── sounds/ # Arquivos de áudio e metadados
├── sprites/ # Imagens de sprites e metadados
└── thumbnails/ # Miniaturas de recursos geradas
- Guia de Predefinições - Visão geral do sistema de predefinições
- Predefinição Iniciante - Funcionalidades essenciais para novos usuários
- Predefinição Intermediário - Funcionalidades adicionais
- Referência de Eventos - Documentação completa de eventos
- Referência de Ações - Documentação completa de ações
- Vista 3D - Renderização em primeira pessoa no estilo Doom (raycast)
- Extensões - Ações e renderizadores adicionais (como a Vista 3D é distribuída)
- Editor de Objetos - Trabalhar com objetos do jogo
- Editor de Salas - Projetar níveis
- Editor de Sprites - Desenhar e animar sprites
- Editor de Código - Escrever (e gerar) Python real para um objeto
- Eventos e Ações - Referência de lógica do jogo
- Programação Visual - Usar blocos Blockly
- Gestor de Recursos - Rastreio de utilização, Lixo, e procura de ficheiros não utilizados/órfãos
- Exportar Jogos - Compilar para diferentes plataformas
- Atalhos de Teclado - Referência dos atalhos do editor
- Resolução de Problemas - Problemas comuns e onde procurar
- FAQ - Perguntas frequentes
- Tutoriais - Todos os tutoriais em um só lugar
- Primeiros Passos - Primeiros passos com PyGameMaker
- Crie Seu Primeiro Jogo - Tutorial passo a passo
- Tutorial Pong - Crie um jogo Pong clássico para dois jogadores
- Tutorial Breakout - Crie um jogo Breakout clássico
- Tutorial Sokoban - Crie um jogo de puzzle de empurrar caixas
- Tutorial Labirinto - Navegue pelos corredores até a saída
- Tutorial Platformer - Corra, pule e colete moedas
- Tutorial Pouso Lunar - Pouse uma nave na lua
- Introdução à Criação de Jogos - Tutorial completo para iniciantes
A documentação do PyGameMaker está dividida em três lugares, cada um adequado a um tipo de pergunta diferente:
| Se você quer... | Consulte aqui |
|---|---|
| Aprofundar um conceito ou funcionalidade (editores, eventos, ações, exportação) | Este wiki |
| Seguir uma lição guiada, clique a clique, dentro do aplicativo | O painel Tutoriais do IDE (Ajuda > Tutoriais) — um currículo de 9 lições, do primeiro projeto até um jogo completo com vitória/derrota |
Entender um projeto de exemplo específico (samples/) incluído com o PyGameMaker |
O guia próprio desse exemplo — clique em 📖 Sample guides na aba de Boas-vindas (botão ainda não traduzido para o português — ver TODO.md); cada exemplo inclui um README.md (traduzido por idioma) escrito especificamente para ele |
Relatórios de bugs, solicitações de funcionalidades e pull requests são bem-vindos no issue tracker.
O código-fonte do PyGameMaker é licenciado sob a Licença MIT. Esta documentação é licenciada sob CC BY 4.0.
Gabriel Thullen, 2025-2026