Skip to content

heyIsaac/Pacman

BranchesTags

Repository files navigation

Pacman Project

Jogo clássico Pac-Man reimplementado em C# / .NET 9 usando a Uno Platform, com suporte a múltiplas plataformas (desktop, navegador via WebAssembly, Android e iOS).
O foco é reproduzir as mecânicas originais (movimento em grid, IA dos fantasmas, power pellets, pontuação e vidas) com uma arquitetura de código limpa e bem organizada.

Visão geral

  • Nome do projeto: PacmanGameProject
  • Tecnologias principais:
    • C# / .NET 9
    • Uno Platform (WinUI + hosting multiplataforma)
    • XAML para a camada de UI (MenuPage, MainPage, ScorePage)
  • Projeto principal: PacmanGameProject/PacmanGameProject.csproj
  • Targets suportados (via TargetFrameworks):
    • net9.0-android
    • net9.0-ios
    • net9.0-browserwasm
    • net9.0-desktop

O arquivo PacmanGameProject/ReadMe.md contém apenas instruções genéricas da Uno Platform.
Este README.md na raiz é a documentação principal do jogo Pac-Man.

Stack e dependências

Assets gráficos e de áudio ficam principalmente em:

  • Ícones e splash: PacmanGameProject/Assets/Icons, PacmanGameProject/Assets/Splash
  • Outros assets (sons, tiles, etc.): subpastas dentro de PacmanGameProject/Assets

Como executar o projeto

Pré-requisitos

  • .NET 9 SDK instalado na máquina.
  • IDE recomendada:
    • Visual Studio, Rider ou VS Code com extensões para C#.

Build da solução pelo terminal

Na raiz do repositório (/home/sallein/pacmangame_project):

dotnet build

Executar versão Desktop

dotnet run -f net9.0-desktop --project PacmanGameProject

Isso inicia a aplicação usando o host desktop configurado em
PacmanGameProject/Platforms/Desktop/Program.cs (Win32, X11, etc.).

Executar versão WebAssembly (navegador)

dotnet run -f net9.0-browserwasm --project PacmanGameProject

O host WebAssembly definido em
PacmanGameProject/Platforms/WebAssembly/Program.cs sobe um servidor local.
Após o build, acesse o endereço indicado no terminal (normalmente algo como http://localhost:XXXX) no navegador.

Android / iOS

Para rodar em Android ou iOS, é recomendado usar uma IDE com suporte a deploy móvel:

  • Abra a solução na IDE
  • Selecione o target net9.0-android ou net9.0-ios
  • Configure emulador/dispositivo e execute o projeto

Detalhes de publicação em loja não estão cobertos neste README.

Gameplay e mecânicas

Entidades principais

  • Pacman

    • Implementado em PacmanGameProject/Game/Entities/Pacman.cs
    • Move-se em um grid de tiles (cada tile = 8px) e trabalha com:
      • CurrentDirection: direção atual
      • DesiredDirection: direção desejada (vinda do input)
    • Exposição da posição em grid via GridPosition:
      • Útil para IA dos fantasmas e lógica de colisão.
    • Teletransporte pelo túnel:
      • Se sair pela esquerda, reaparece à direita e vice-versa.

  • Fantasmas

    • Implementados em PacmanGameProject/Game/Entities/Ghost.cs
    • Cada fantasma tem:
      • Type (GhostType): Blinky, Pinky, Inky, Clyde
      • CurrentState (GhostState): Scatter, Chase, Frightened, Eaten, InHouse
      • GridPosition para tomada de decisão em tiles
    • A lógica de movimento usa:
      • GhostMover, GhostExitHandler, GhostDirectionService
      • GhostWaveService para alternar ondas Scatter/Chase.

  • Pellets

Estados dos fantasmas

Enumerados em PacmanGameProject/Game/Enums/GhostState.cs:

  • Scatter: cada fantasma mira um canto específico do mapa.
  • Chase: os comportamentos de IA perseguem o Pacman de formas diferentes:
  • Frightened: ativado por power pellets; fantasmas ficam mais lentos e podem ser comidos.
  • Eaten: fantasmas retornam rapidamente à casa para respawn.
  • InHouse: fantasmas dentro da casa aguardando liberação.

Pontuação, vidas e fim de jogo

  • Serviço de estado de jogo: PacmanGameProject/Game/Services/GameStateService.cs
    • Lives: vidas restantes (inicialmente 3)
    • Score: pontuação atual
    • Eventos importantes:
      • OnGameOver
      • OnLifeChanged
      • OnScoreChanged
      • OnGameWon
    • PacmanDied() decrementa vidas e dispara OnGameOver quando chega a 0.
    • AddScore(int points) soma pontos e notifica UI.

Arquitetura interna

Engine de jogo

  • GameLoop

    • Arquivo: PacmanGameProject/Game/Engine/GameLoop.cs
    • Responsável por:
      • Configurar um DispatcherTimer com intervalo de ~16ms (60 FPS)
      • Atualizar a cada tick:
        • GhostWaveService (ondas global de Scatter/Chase)
        • Input e movimento do Pacman
        • Movimento e IA dos fantasmas
      • Disparar o evento OnUpdate para que a tela redesenhe o frame.
    • Define constantes de tamanho do mapa (colunas e linhas) e lida com lógica de colisão com paredes.

  • MapData

    • Arquivo: PacmanGameProject/Game/Engine/MapData.cs
    • Representa o layout do mapa como uma matriz de inteiros (int[,] Layout).
    • Também fornece métodos auxiliares como IsWall(...) para identificar paredes.

Entidades e colisão

  • Interface de colisão

  • Serviços de colisão

    • CollisionService: detecção geral de colisão com paredes.
    • GhostCollisionService: colisões entre Pacman e fantasmas.
    • PelletService: gerenciamento de coleta de pellets e power pellets.
    • Interfaces relacionadas em Game/Services/interfaces.

IA dos fantasmas

  • Interface de comportamento

  • Implementações concretas

    • BlinkyBehavior, PinkyBehavior, InkyBehavior, ClydeBehavior em Game/AI.
    • Cada uma decide o tile alvo com uma estratégia diferente, reproduzindo o estilo do jogo original.

  • GhostWaveService

Rendering (mapa e sprites)

  • MapRenderer

    • Arquivo: PacmanGameProject/Game/Rendering/MapRenderer.cs
    • Responsável por:
      • Desenhar o mapa base (Tiles) em um Canvas.
      • Identificar tiles que representam pellets e criar:
        • Entidades Pellet
        • Sprites (Image) correspondentes, armazenados em PelletSprites.

  • SpriteRenderer

  • Assets

    • Tiles do mapa: PacmanGameProject/Assets/Tiles/*.png
    • Sons (por exemplo, chomping do Pacman): PacmanGameProject/Assets/sounds/...

Input e Views (UI)

Serviços de domínio

Serviços principais em PacmanGameProject/Game/Services:

  • GameStateService: vidas, pontuação, eventos de game over e vitória.
  • ScoreService: gerenciamento de ScoreEntry e persistência / carga de pontuações.
  • GameAudioService: reprodução de sons (chomping, morte, etc.).
  • EntitySpawnService: spawn inicial de Pacman, fantasmas e pellets.
  • FrightenedModeService: duração e controle do modo frightened após power pellet.
  • GameInitializerService: orquestra criação de mapa, entidades e serviços ao iniciar partida.

Estrutura de pastas (resumo)

Dentro de PacmanGameProject/:

  • Game/Engine: loop principal do jogo (GameLoop), definição e dados do mapa (MapData).
  • Game/Entities: entidades de domínio (Pacman, Ghost, Pellet, interfaces de colisão).
  • Game/AI: comportamentos de IA dos fantasmas e auxiliares.
  • Game/Rendering: renderização de mapa e sprites (MapRenderer, SpriteRenderer, TileSet).
  • Game/Services: serviços de negócio (estado de jogo, score, áudio, spawn, frightened, colisões).
  • Game/Views: páginas XAML (MenuPage, MainPage, ScorePage) e respectivos *.xaml.cs.
  • Game/Input: tratamento de input (teclado, etc.).
  • Platforms/*: bootstraps específicos de cada plataforma (Desktop, WebAssembly, Android, iOS).
  • Assets/*: imagens, ícones, tiles, sons, splash screen.

About

Projeto Pacman C#

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages