Projeto – 7Team

🎮 Descrição

Projeto desenvolvido pela equipa 7Team em Unity 6 com Unity Hub, seguindo a arquitetura Model–View–Controller (MVC) segundo o modelo clássico de Krasner & Pope (1988).

Cada entidade principal do jogo — Player, Obstacles e Background, foi
implementada com o seu próprio módulo Model, View e Controller, garantindo
uma separação clara de responsabilidades e facilitando a manutenção do código.

Durante o desenvolvimento, utilizámos o editor JetBrains Rider como ambiente principal de programação, em conjunto com GitHub Desktop para controlo de versões.

---

✅ Como usar este repositório

1. Clonar o projeto

Usa o GitHub Desktop:

Abre o GitHub Desktop
Vai a “File > Clone repository”
Cola o link: https://github.com/Coachhero/JayRabbit.git
Escolhe uma pasta local
Clica em Clone

2. Abrir o projeto no Unity

Abre o Unity Hub
Clica em Add project
Seleciona a pasta clonada
Abre o projeto normalmente

2.1. Configuração recomendada no Unity para Git

Para abrir o projecto corretamente utilizando o Raider (JetBrains):

1. Abre o Unity
2. Vá a Settings... > External Tools
   1. External Script Editor: Raider 20xx.x.x - confirme que selecionou o Raider. Devem de ser exibidas algumas novas checkboxes, podemos ignorá-las.
   2. Abaixo destas deve de haver um novo botão com o conteúdo: Regenerate Project Files. Carregue nele. 3. Este passo é importante pois irá criar os ficheiros .csproject e .sln o que permite que o projecto seja corretamente reconhecido pelo Raider.

Para garantir compatibilidade total com Git e evitar conflitos, deves aplicar estas definições no Unity:

1. Abre o Unity
2. Vai a Edit > Project Settings > Editor
   • Version Control: Visible Meta Files
   • Asset Serialization: Force Text

Estas opções garantem que o Git consegue seguir corretamente as alterações aos ficheiros do projeto, incluindo meta-informação e serialização.

2.2 💾 Instalar Git LFS no Windows

Este projeto utiliza Git LFS (Large File Storage) para gerir ficheiros grandes como .png, .fbx, .mp4, .psd, entre outros.
Para garantir compatibilidade, é necessário instalar o Git LFS uma única vez.

1. Acede a: https://git-lfs.github.com

2. Faz download do instalador para Windows

3. Abre o ficheiro .exe e segue os passos da instalação

4. Depois da instalação, abre o Git Bash ou PowerShell

5. Ativa o Git LFS com o seguinte comando:

   git lfs install

6. Verifica se está tudo OK com:

   git lfs version

   Exemplo de saída esperada:

   git-lfs/3.x.x (GitHub; Windows ...)
   

Após isso, o teu sistema estará pronto para trabalhar com os ficheiros grandes do projeto.

3. Regras de trabalho em equipa

Antes de começares a trabalhar:

Abre o GitHub Desktop
Clica em Fetch/Pull origin

Depois de terminares:

Escreve o que fizeste no campo “Summary”
Clica em Commit to main
Depois em Push origin

---

⚠️ Boas práticas

NUNCA faças pull com o Unity aberto – fecha sempre primeiro
Faz commits pequenos e frequentes
Usa mensagens claras (ex: Adicionado salto ao Player)
Em caso de conflito, fala com a equipa antes de tentar resolver

---

📂 Estrutura do Projeto

Assets/
├── Sources/
│ ├── Player/
│ │ ├── PlayerModel.cs
│ │ ├── PlayerView.cs
│ │ ├── PlayerController.cs
│ │ ├── IPlayerModel.cs
│ │ └── IPlayerView.cs
│ ├── Obstacles/
│ │ ├── ObstacleModel.cs
│ │ ├── ObstacleView.cs
│ │ ├── ObstacleController.cs
│ │ ├── CollisonModel.cs
│ │ ├── CollisonView.cs
│ │ ├── CollisonController.cs
│ │ ├── ObstacleSpawner.cs
│ │ └── IObstacleSpawner.cs
│ ├── Background/
│ │ ├── ScrollingBackgroundModel.cs
│ │ ├── ScrollingBackgroundView.cs
│ │ ├── ScrollingBackgroundController.cs
│ │ └── IScrollable.cs
│ ├── Menus/
│ │ ├── BaseMenu.cs
│ │ ├── GameOverModel.cs
│ │ ├── GameOverView.cs
│ │ ├── GameOverController.cs
│ │ ├── PauseView.cs
│ │ ├── PauseModel.cs
│ │ ├── PauseMenu.cs
│ │ ├── StartMenu.cs
│ │ ├── MenuState.cs
│ │ ├── ScoreModel.cs
│ │ ├── ScoreView.cs
│ │ ├── ScoreController.cs
│ │ └── IMenu.cs
│ └── Tests/
│ ├── TestAcoplamentoMenus.cs
│ ├── TestSeparacaoMVC.cs
│ ├── TesteMenuPause.cs
│ ├── TesteGameOverMenu.cs
│ ├── TestObstaclesEventos.cs
│ ├── TestPlayerEventos.cs
│ ├── TestCamadas.cs
│ ├── TestCoelhoDiversos.cs
│ ├── TestStartMenuEventos.cs
│ ├── TestPauseMenuEventos..cs
│ ├── TesteStartMenu.cs
│ ├── TestBackgroundEventos.cs
│ └── TestGameOverEventos.cs

---

🧩 Atualização do pacote JetBrains Rider (opcional)

O Unity pode indicar que há uma nova versão do pacote de integração com o JetBrains Rider disponível.

Para atualizar:

1. Abre o Unity
2. Vai ao menu Window > Package Manager
3. Garante que estás a ver Packages: In Project
4. Procura por JetBrains Rider Editor
5. Se aparecer a opção Update, clica para atualizar para a versão mais recente (ex: 3.0.36)

Este pacote permite que o Unity se integre diretamente com o editor JetBrains Rider, com suporte a abrir scripts, usar autocomplete, debugging e ligação à estrutura interna do projeto Unity.