Unity · Open Source · Educação · Diversidade · Mobile
🎮 Jogar • 👩💻 Contribuir • 📚 Documentação • 🎯 Good First Issues
Na cidade de Ogama, as mulheres não têm direito ao ensino superior. Sofia, uma jovem inconformada com essa realidade, embarca em uma jornada para questionar as regras estabelecidas e lutar pelo seu direito à educação.
"Diários de Sofia" é um jogo narrativo 2D que combina:
- 🎭 Storytelling envolvente sobre inclusão educacional
- 🎮 Gameplay mobile-first com mecânicas acessíveis
- 🎓 Objetivo educacional de promover discussões sobre diversidade
- 🌟 Desenvolvimento aberto e colaborativo
docs/
├── index.md # 🏠 Landing page da documentação
├── jogo/ # 🎮 Documentação do jogo
│ ├── game.md # Sobre o jogo e requisitos
│ ├── scripts.md # Arquitetura e sistemas
│ ├── good_issues.md # First good issues para novos contribuidores
│ ├── backlog.md # Backlog e funcionalidades
│ └── clean_code.md # Padrões de código
├── projeto/ # 📋 Gestão do projeto
│ ├── concepts.md # Conceitos e metodologia
│ ├── devprocess.md # Processo de desenvolvimento
│ ├── sprints.md # Planejamento de sprints
│ └── releases/ # Documentação das releases
├── tutoriais/ # 📚 Tutoriais Unity for Women
├── CONTRIBUTING.md # 🤝 Guia de contribuição
├── CODE_OF_CONDUCT.md # 📜 Código de conduta
├── ONBOARDING.md # 🚀 Onboarding para novos membros
└── checklist_oss.md # ✅ Checklist open source
Siga este passo a passo para rodar a documentação do projeto na sua máquina local usando o MkDocs com o tema Material for MkDocs.
Antes de tudo, você precisa ter o seguinte instalado:
Verifique se estão instalados com:
python3 --version
pip3 --version
mkdocs --version
pip show mkdocs-material
Se for a primeira vez, execute:
mkdocs build
Logo depois, você pode rodar o servidor localmente usando:
mkdocs serve
Ele irá rodar em: http://localhost:8000
O servidor atualiza automaticamente a documentação sempre que você salva alterações nos arquivos
.md
.
É uma iniciativa aberta que combina:
- 🎮 "Diários de Sofia": Jogo narrativo 2D
- 🛠️ Workshop "Unity for Women": Tutoriais gratuitos para iniciantes em Unity, com foco em inclusão de mulheres na tecnologia.
Projeto | Descrição | Links Úteis |
---|---|---|
Jogo | Na cidade de Ogama, as coisas são como são e ninguém discorda de nenhuma das regras. A principal delas: mulheres não têm direito ao ensino superior. Para Sofia, isso sempre foi motivo de incômodo, mas nunca viu ninguém ao seu redor lutar para que algo diferente aconteça. | Documentação |
Workshop | Aprenda Unity do zero criando um jogo 2D passo a passo. | Tutoriais Roadmap Glossário |
Você pode contribuir com o jogo Diários de Sofia de várias maneiras, como reportando bugs, sugerindo melhorias ou até mesmo contribuindo com código. Para começar, você precisará estar em conformidade com os Guias de Conduta e Contribuição do projeto.
Certifique-se de ter o seguinte instalado:
Caso não tenha o Unity Hub instalado, siga as instruções de instalação no site oficial da Unity.
Após instalar o Unity Hub, você precisará adicionar a versão do Unity que será utilizada no projeto. Para isso, siga os passos abaixo:
- Abra o Unity Hub.
- Vá para a aba "Installs" (Instalações).
- Clique em "Add" (Adicionar) e selecione a versão 2022.3.20f1.
- Certifique-se de incluir os módulos necessários, como suporte ao Android e iOS, considerando que o intuito do jogo é rodar em dispositivos mobile. Não se preocupe, você poderá rodar o jogo no computador também.
Para rodar o jogo localmente, siga os seguintes passos:
- Clone o repositório do jogo:
git clone https://github.com/FGA-GCES/Jogo-Unity-BOSS.git
- Abra o Unity Hub.
- Vá para a aba "Projects" (Projetos).
- Clique em "Add" (Adicionar) e selecione a pasta do repositório clonado.
- Selecione o diretório "Unity-Project" e clique em "Open" (Abrir).
- O Unity irá carregar o projeto. Aguarde até que todos os pacotes sejam baixados e o projeto esteja pronto.
Para compilar o jogo, siga os seguintes passos:
- No Unity, vá para o menu "File" (Arquivo).
- Selecione "Build Settings" (Configurações de Compilação).
- Selecione a plataforma desejada (Android, iOS, PC, etc.).
- Clique em "Build" (Compilar) e escolha o local onde deseja salvar o arquivo compilado.
- Aguarde a compilação ser concluída. O Unity irá gerar o arquivo executável do jogo para a plataforma desejada.
- Atualmente, o jogo está em desenvolvimento, então cada cena pode conter elementos que ainda não estão finalizados. Sinta-se à vontade para explorar as cenas e contribuir com melhorias, correções de bugs ou novas funcionalidades.
- Erros conhecidos na hora de rodar o jogo localmente podem ser encontrados na página de Erros Conhecidos.
- Se quiser contribuir com o jogo, talvez seja interessante começar por uma
GoodFirstIssue
ou umaHelpWanted
, que são issues mais fáceis de resolver e podem te ajudar a entender melhor o projeto. Você pode encontrar essas issues na página de Issues do repositório. - Para acessar as fases (cenas) disponíveis atualmente, você pode navegar até a pasta
Assets/Scenes
dentro do projeto Unity. Lá, você encontrará as cenas disponíveis para jogar e contribuir.- Menu Principal: A cena inicial do jogo, onde você pode iniciar a jornada de Sofia e acessar as configurações.
- City Map: Mapa da cidade, onde poderá interagir com os NPCs e visitar outros locais.
- Library: A segunda fase do jogo, onde você continua a história de Sofia.
- SofiaHouse: Fase inicial do jogo, onde você conhece a casa de Sofia.
- Equipe T2G6 (jogo) • BOSS Mentoring (mentoria) • BRISA (apoio educacional).
- Protótipo dos Roadmaps: https://www.figma.com/proto/bJClgWeiEKf9FRT5vYPFCE/GCES-BOSS?node-id=5501-11994&p=f&t=xZvszHu4zbFG1fHr-1&scaling=min-zoom&content-scaling=fixed&page-id=1444%3A5903
Feito com ❤️ para democratizar o desenvolvimento de jogos.
Este projeto está licenciado sob os termos da Licença MIT. Veja o arquivo LICENSE para mais detalhes.