hesukastro/match3-unity
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Optimization and Documentation

Browse Source
This commit is contained in:
Jesus Castro
2025-12-18 03:44:51 +08:00
parent 1d134ffc40
commit 668bd03f63
10 changed files with 204 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

155
Assets/Scripts/Services/GameBoardService.cs
View File

@@ -9,7 +9,6 @@ using ScriptableObjects;
using Services.Interfaces;
using Structs;
using UnityEngine;
using UnityEngine.UIElements;
using Utils;
using VContainer.Unity;
using Views;
@@ -30,7 +29,6 @@ namespace Services {
private readonly ScorePresenter scorePresenter;
private readonly AudioPresenter audioPresenter;
private readonly Transform gemsHolder;
private readonly Transform backgroundHolder;
#endregion
@@ -49,7 +47,6 @@ namespace Services {
IScoreService scoreService,
ScorePresenter scorePresenter,
AudioPresenter audioPresenter,
Transform gemsHolder,
Transform backgroundHolder) {
this.gameVariables = gameVariables;
this.gameBoard = gameBoard;
@@ -59,10 +56,12 @@ namespace Services {
this.scoreService = scoreService;
this.scorePresenter = scorePresenter;
this.audioPresenter = audioPresenter;
this.gemsHolder = gemsHolder;
this.backgroundHolder = backgroundHolder;
}
/// <summary>
/// Global tick. Update replacement of VContainer-managed objects.
/// </summary>
public void Tick() {
foreach (GemPresenter gemPresenter in gemPresenters) {
gemPresenter.Tick(this.gameVariables.gemSpeed);
@@ -71,8 +70,9 @@ namespace Services {
this.scorePresenter.Tick(this.gameVariables.scoreSpeed);
}
//Instantiates background tiles and calls SpawnGems
//Uses MatchService.MatchesAt to avoid matching Gems
/// <summary>
/// Initiates the game board by placing gems randomly.
/// </summary>
public void Setup() {
List<Gem> gemsToSpawn = new List<Gem>();
for (int x = 0; x < this.gameBoard.Width; x++)
@@ -91,9 +91,22 @@ namespace Services {
gemsToSpawn.Add(SetGemAt(position.ToVector2Int(), gemToUse));
}
SpawnCascade(gemsToSpawn);
SpawnCascade(gemsToSpawn).Forget();
}
/// <summary>
/// Create a Gem object and place it on the GameBoard.
/// </summary>
/// <param name="position">
/// Position on the GameBoard to place the Gem.
/// </param>
/// <param name="gemType">
/// Type of Gem to create.
/// </param>
/// <param name="isBomb">
/// Whether the Gem is a Bomb or not.
/// </param>
/// <returns></returns>
private Gem SetGemAt(Vector2Int position, GemType gemType, bool isBomb = false) {
GemTypeValues gemValue = GemUtils.GetGemValues(gemType, this.gameVariables.gemsPrefabs);
Gem gem = new Gem(isBomb ? GemType.Bomb : gemType, position, gemValue, gemType);
@@ -102,6 +115,15 @@ namespace Services {
return gem;
}
/// <summary>
/// Spawns a GemView object and binds it to the Gem object.
/// </summary>
/// <param name="gem">
/// Gem to bind to the GemView.
/// </param>
/// <param name="isBomb">
/// Whether the Gem is a Bomb or not.
/// </param>
private void SpawnGemGameObject(Gem gem, bool isBomb = false) {
GemView gemView = this.objectPool.Get(isBomb ? GemType.Bomb : gem.Type, gem.Position, isBomb ? 0 : this.gameVariables.dropHeight);
gemView.name = "Gem - " + gem.Position.x + ", " + gem.Position.y + ' ' + gem.Type;
@@ -112,6 +134,18 @@ namespace Services {
this.gemToView.Add(gem, gemView);
}
/// <summary>
/// Calls SetGemAt and SpawnGemGameObject.
/// </summary>
/// <param name="position">
/// Position on the GameBoard to place the Gem.
/// </param>
/// <param name="gemType">
/// Type of Gem to create.
/// </param>
/// <param name="isBomb">
/// Whether the Gem is a Bomb or not.
/// </param>
private void SetAndSpawnGem(Vector2Int position, GemType gemType, bool isBomb) {
if(isBomb)
ReleaseMatchedGems(position);
@@ -119,13 +153,28 @@ namespace Services {
SpawnGemGameObject(SetGemAt(position, gemType, isBomb), isBomb);
}
/// <summary>
/// Spawns a background tile at the given position. Only for setup.
/// </summary>
/// <param name="position">
/// Position on the GameBoard to place the tile.
/// </param>
private void SpawnBackgroundTile(Vector2 position) {
GameObject backgroundTile = Object.Instantiate(this.gameVariables.bgTilePrefabs, position, Quaternion.identity);
backgroundTile.transform.SetParent(this.backgroundHolder);
backgroundTile.name = "BG Tile - " + position.x + ", " + position.y;
}
//Listens to InputService OnSwapRequest
/// <summary>
/// Attempts to swap two gems on the GameBoard.
/// </summary>
/// <param name="from">
/// Original position of the gem to swap.
/// </param>
/// <param name="to">
/// Destination position of the gem to swap.
/// </param>
/// <returns></returns>
public async UniTask<bool> TrySwap(Vector2Int from, Vector2Int to) {
if (this.currentState != GameState.Move)
return false;
@@ -158,10 +207,17 @@ namespace Services {
return true;
}
public async UniTask<bool> TrySwitch(Vector2Int position) {
/// <summary>
/// For debug purposes. Switches the Gem at the given position to a different GemType.
/// </summary>
/// <param name="position">
/// Position of the Gem to switch.
/// </param>
/// <returns></returns>
public void TrySwitch(Vector2Int position) {
Gem gem = this.gameBoard.GetGemAt(position);
if(gem == null)
return false;
return;
GemType[] normalTypes = Enum.GetValues(typeof(GemType))
.Cast<GemType>()
@@ -169,7 +225,7 @@ namespace Services {
.ToArray();
if (normalTypes.Length == 0)
return false;
return;
bool nextIsBomb;
GemType nextTypeOrMatchColor;
@@ -198,12 +254,20 @@ namespace Services {
}
}
// Replace both model+view by releasing current and respawning at same position.
// Replace both model+view by releasing current and respawning at the same position.
ReleaseMatchedGems(position);
SpawnGemGameObject(SetGemAt(position, nextTypeOrMatchColor, nextIsBomb), nextIsBomb);
return true;
}
/// <summary>
/// Helper function for TrySwap. Swaps the Gems in the GameBoard.
/// </summary>
/// <param name="from">
/// Original position of the gem to swap.
/// </param>
/// <param name="to">
/// Destination position of the gem to swap.
/// </param>
private void ApplySwap(Vector2Int from, Vector2Int to) {
Gem fromGem = this.gameBoard.GetGemAt(from);
Gem toGem = this.gameBoard.GetGemAt(to);
@@ -216,22 +280,23 @@ namespace Services {
this.gameBoard.SetGemAt(to, fromGem);
}
/// <summary>
/// Destroys all matches on the GameBoard.
/// </summary>
/// <param name="protectedPositions">
/// Gems we don't want to instantly destroy.
/// </param>
private async UniTask DestroyMatchesAsync(List<Vector2Int> protectedPositions) {
List<Vector2Int> matchPositions = await this.matchService.GetMatchPositionsAsync(protectedPositions);
HashSet<Vector2Int> uniqueMatchPositions = new HashSet<Vector2Int>(matchPositions);
List<Vector2Int> bombCandidates = uniqueMatchPositions.ToList();
List<Vector2Int> initialBombs = await this.bombService.GetInitialBombs(protectedPositions, bombCandidates);
HashSet<Vector2Int> matchPositions = await this.matchService.GetMatchPositionsAsync(protectedPositions);
List<Vector2Int> initialBombs = await this.bombService.GetInitialBombs(protectedPositions, matchPositions);
// If a bomb is part of the match, do NOT destroy matching pieces immediately.
// Let the bomb's manhattan-distance explosion destroy them in sequence.
if (initialBombs.Count > 0) {
await this.bombService.DetonateChainAsync(
initialBombs,
DestroyAtAsync,
this.gameBoard);
foreach (Vector2Int p in uniqueMatchPositions)
foreach (Vector2Int p in matchPositions)
await DestroyAtAsync(p);
await UniTask.Delay(this.gameVariables.fillBoardDelayMs);
@@ -242,7 +307,7 @@ namespace Services {
// For audio SFX
bool willBreakAnyNonBombGem = false;
foreach (Vector2Int pos in uniqueMatchPositions) {
foreach (Vector2Int pos in matchPositions) {
Gem g = this.gameBoard.GetGemAt(pos);
if (g != null && g.Type != GemType.Bomb) {
willBreakAnyNonBombGem = true;
@@ -253,18 +318,25 @@ namespace Services {
this.audioPresenter.OnMatch(this.gameVariables.matchSfx);
// For score counting
foreach (Vector2Int pos in uniqueMatchPositions) {
foreach (Vector2Int pos in matchPositions) {
Gem gem = this.gameBoard.GetGemAt(pos);
if (gem == null) continue;
if (gem.Type == GemType.Bomb) continue;
this.scoreService.ScoreCheck(gem.ScoreValue);
this.scoreService.AddScore(gem.ScoreValue);
ReleaseMatchedGems(pos);
}
await UniTask.Delay(this.gameVariables.fillBoardDelayMs);
await MoveGemsDown();
}
/// <summary>
/// Destroys the Gem at the given position.
/// </summary>
/// <param name="pos">
/// Position of the Gem to destroy.
/// </param>
/// <returns></returns>
private UniTask DestroyAtAsync(Vector2Int pos) {
Gem gem = this.gameBoard.GetGemAt(pos);
if (gem == null)
@@ -273,11 +345,17 @@ namespace Services {
if (gem.Type == GemType.Bomb)
this.audioPresenter.OnBombExplosion(this.gameVariables.bombExplodeSfx);
this.scoreService.ScoreCheck(gem.ScoreValue);
this.scoreService.AddScore(gem.ScoreValue);
ReleaseMatchedGems(pos);
return UniTask.CompletedTask;
}
/// <summary>
/// Returns the GemView to the Object Pool and sets the Position in the GameBoard to null.
/// </summary>
/// <param name="position">
/// Position of the Gem to release.
/// </param>
private void ReleaseMatchedGems(Vector2Int position) {
Gem currentGem = this.gameBoard.GetGemAt(position);
if (currentGem != null)
@@ -291,11 +369,13 @@ namespace Services {
}
}
/// <summary>
/// Moves Gems Down to free spaces.
/// </summary>
private async UniTask MoveGemsDown() {
List<FallMove> moves = new List<FallMove>();
while (true) {
moves.Clear();
// Build moves from a snapshot of the current grid state (no mid-wave chaining)
for (int x = 0; x < this.gameBoard.Width; x++)
{
for (int y = 1; y < this.gameBoard.Height; y++)
@@ -333,6 +413,9 @@ namespace Services {
await FillBoard();
}
/// <summary>
/// Fills the GameBoard with gems. If there are resulting matches, process them.
/// </summary>
private async UniTask FillBoard() {
await RefillBoard();
@@ -340,13 +423,15 @@ namespace Services {
if (this.matchService.CurrentMatches.Count > 0) {
await UniTask.Delay(this.gameVariables.fillBoardDelayMs);
// In cascades, there is no "creating slot" bomb protection.
await DestroyMatchesAsync(new List<Vector2Int>());
} else {
this.currentState = GameState.Move;
}
}
/// <summary>
/// Refills the GameBoard with gems.
/// </summary>
private async UniTask RefillBoard() {
List<Gem> gemsToSpawn = new List<Gem>();
for (int x = 0; x < this.gameBoard.Width; x++)
@@ -358,13 +443,13 @@ namespace Services {
GemType gemToUse = RandomUtils.RandomGemType();
int iterations = 0;
while (this.matchService.MatchesAt(new Vector2Int(x, y), (GemType)gemToUse) && iterations < 100)
while (this.matchService.MatchesAt(new Vector2Int(x, y), gemToUse) && iterations < 100)
{
gemToUse = RandomUtils.RandomGemType();
iterations++;
}
gemsToSpawn.Add(SetGemAt(new Vector2Int(x,y), (GemType)gemToUse));
gemsToSpawn.Add(SetGemAt(new Vector2Int(x,y), gemToUse));
}
}
}
@@ -372,6 +457,12 @@ namespace Services {
await SpawnCascade(gemsToSpawn);
}
/// <summary>
/// Spawns gems in cascade.
/// </summary>
/// <param name="gemsToSpawn">
/// List of gems to spawn.
/// </param>
private async UniTask SpawnCascade(List<Gem> gemsToSpawn)
{
List<IGrouping<int, Gem>> groups = gemsToSpawn
@@ -392,6 +483,12 @@ namespace Services {
this.currentState = GameState.Move;
}
/// <summary>
/// Removes the Presenter for the given GemView from the list to avoid calling its Tick method.
/// </summary>
/// <param name="gemView">
/// GemView to remove from the List of presenters.
/// </param>
private void RemovePresenterFor(GemView gemView) {
if (gemView is null) {
return;