Advanced Programming course - Swiss Game Academy

• Focus: Attributes, Enums, Scriptable Objects, Inheritance & Liskov Substitution.
• Student Objective: Configure data scripts to be powerful and easy to use for designers.
  1. ItemData.cs: Add [Header], [Tooltip], [Space], and other attributes to organize the Inspector.
  2. ItemType.cs: Create the ItemType enum.
  3. UsableItemData.cs: Analyze this script to understand inheritance from ItemData (Liskov Principle).
  4. HealthPotionData.cs: Uncomment the code and see how it inherits from UsableItemData.
  5. PlayerInventoryManager.cs: Implement the UpdateStatus() method using switch and ternary operators.

• Focus: Delegates, Events (Observer Pattern), and UI scripting.
• Student Objective: Decouple the game’s data layer from its presentation (UI) layer.
  1. PlayerInventoryManager.cs: Declare a public Action event OnInventoryChanged and invoke it in AddItem() and RemoveItem().
  2. InventoryUI.cs: In OnEnable() and OnDisable(), subscribe and unsubscribe the RedrawUI() method to the manager’s event.
  3. InventorySlotUI.cs: Implement the OnSlotClicked() method to allow players to use or remove items from the inventory.

• Focus: Interfaces (ISP), Raycasting, Coroutines, and Gizmos.
• Student Objective: Build a “move-then-interact” system for the player.
  1. PlayerInteraction.cs:
     • Implement the Update() method to fire a raycast on mouse click.
     • Start the FollowAndInteract coroutine if an interactable is hit.
     • In the coroutine, use a switch with type pattern matching to check for ICollectable, IActivatable, etc., and call the correct method.
     • Add OnDrawGizmosSelected to visualize the interaction radius.
  2. WorldItem.cs: Uncomment the ICollectable interface.
  3. IngredientStation.cs / CraftingTable.cs: Implement the IActivatable interface and its Activate() method.

• Focus: Advanced Delegates, JSON Serialization, Singleton Pattern.
• Student Objective: Implement a system to save and load the player’s state.
  1. PlayerHealth.cs:
     • Implement the ISaveable interface (CaptureState and RestoreState).
     • Create and invoke a delegate/event for health changes.
  2. PlayerHealthBarUI.cs: Subscribe to the PlayerHealth event to update the UI automatically.
  3. WorldItemManager.cs: Implement the Singleton pattern to track all WorldItem objects.
  4. WorldItem.cs: In OnEnable() and OnDisable(), register/unregister with the WorldItemManager.
  5. GameManager.cs: Uncomment the code and fill in the SaveGame() and LoadGame() methods to handle saving player data and world item locations.

• Focus: Reviewing all concepts and ensuring the final project is robust and complete.
• Student Objective: This version represents the completed project. It serves as a reference and a demonstration of how all the systems work together in harmony.

The .bat script

@echo off
:: Windows batch wrapper for gototag PowerShell script
:: This script is designed to be placed in your Unity project's root folder.

:: Get the tag name from the first argument
set TAG=%1


:: Call PowerShell script with ExecutionPolicy Bypass
powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0gototag.ps1" %TAG%

The .ps1 script

param (
    [string]$TagName,
    [switch]$Clean
)

# This script is designed to be placed in your Unity project's root folder.
# It automates checking out a specific Git tag and launching the corresponding Unity Editor version.

if (-not $TagName) {
    Write-Host "Usage: gototag <tag-name> [--clean]"
    Write-Host ""
    Write-Host "Arguments:"
    Write-Host "  <tag-name>  The Git tag to checkout (e.g., v1.0, development)"
    Write-Host ""
    Write-Host "Options:"
    Write-Host "  --clean     Performs a 'git clean -xfd' before checking out the tag."
    Write-Host "              Use with caution: this will remove untracked files and directories."
    Write-Host ""
    Write-Host "Example:"
    Write-Host "  gototag v2.5 --clean"
    Write-Host "  gototag feature/new-ui"
    exit 1
}

Write-Host "`Closing Unity if running..."
Get-Process Unity -ErrorAction SilentlyContinue | Stop-Process

Start-Sleep -Seconds 2

Write-Host "Cleaning working directory (pre-checkout)..."
git reset --hard
if($Clean){
    Write-Host "Performing git clean -xfd..."
    git clean -xfd
}

Write-Host "`Checking out tag: $TagName"
git checkout tags/$TagName
if ($LASTEXITCODE -ne 0) {
    Write-Host "Failed to checkout tag '$TagName'. Does it exist?"
    exit 1
}

Write-Host "`Final reset and clean after switching..."
git reset --hard
if($Clean){
    Write-Host "Performing git clean -xfd..."
    git clean -xfd
}

# Read Unity version from ProjectSettings/ProjectVersion.txt
$versionFile = Join-Path -Path (Get-Location) -ChildPath "ProjectSettings\ProjectVersion.txt"

if (-Not (Test-Path $versionFile)) {
    Write-Host "Cannot find ProjectVersion.txt. Are you in a Unity project folder?"
    exit 1
}

$content = Get-Content $versionFile
$versionLine = $content | Where-Object { $_ -match 'm_EditorVersion:' }
if (-not $versionLine) {
    Write-Host "Could not find Unity version line in ProjectVersion.txt"
    exit 1
}

$unityVersion = $versionLine -replace 'm_EditorVersion:\s*',''
Write-Host "`Detected Unity version: $unityVersion"

# Construct Unity Editor path (adjust if your install path differs)
$unityPath = "C:\Program Files\Unity\Hub\Editor\$unityVersion\Editor\Unity.exe"

if (-Not (Test-Path $unityPath)) {
    Write-Host "Unity Editor not found at $unityPath"
    Write-Host "Please install Unity version $unityVersion via Unity Hub or update this path."
    exit 1
}

Write-Host "`Launching Unity Editor..."
Start-Process -FilePath $unityPath -ArgumentList "-projectPath `"$PWD`""

Write-Host "`Done. Tag '$TagName' is now active.`n"

#!/bin/bash

# This script is designed to be placed in your Unity project's root folder.
# It automates checking out a specific Git tag and launching the corresponding Unity Editor version.

## Configuration (Optional)
# If your Unity Hub Editor installations are in a non-standard location, you can uncomment and modify this line:
# UNITY_HUB_EDITORS_PATH="/Applications/Unity/Hub/Editor"
# For Windows, this would typically be handled by the PowerShell script.

## Script Logic

if [ -z "$1" ]; then
    echo "Error: No tag name pro12313vided."
    echo "Usage: gototag <tag-name>"
    exit 1
fi

TAG=$1

echo "Closing Unity if running..."
pkill -x "Unity" 2>/dev/null
sleep 2

echo "Cleaning working directory (pre-checkout)..."
git reset --hard
git clean -xfd

echo "Checking out tag: $TAG"
git checkout tags/$TAG
if [ $? -ne 0 ]; then
    echo "Failed to checkout tag \'$TAG\'. Does the tag exist?"
    exit 1
fi

echo "Final reset and clean after switching..."
git reset --hard
git clean -xfd

# Extract Unity version from ProjectSettings
UNITY_VERSION_FILE="ProjectSettings/ProjectVersion.txt"
if [ ! -f "$UNITY_VERSION_FILE" ]; then
    echo "Cannot find $UNITY_VERSION_FILE. Is this a Unity project?"
    exit 1
fi

UNITY_VERSION=$(grep -oP 'm_EditorVersion: \K.*' "$UNITY_VERSION_FILE" || grep -o 'm_EditorVersion: .*' "$UNITY_VERSION_FILE" | cut -d' ' -f2)

# Determine Unity Editor path based on OS
if [[ "$(uname)" == "Darwin" ]]; then
    # macOS path
    UNITY_PATH="${UNITY_HUB_EDITORS_PATH:-/Applications/Unity/Hub/Editor}/$UNITY_VERSION/Unity.app/Contents/MacOS/Unity"
elif [[ "$(uname -s)" == "Linux" ]]; then
    # Linux path (common for Unity on Linux, adjust if needed)
    UNITY_PATH="${UNITY_HUB_EDITORS_PATH:-/opt/Unity/Hub/Editor}/$UNITY_VERSION/Editor/Unity"
else
    echo "Unsupported operating system for direct Unity launch via this script."
    echo "Please use the Windows PowerShell script (gototag.ps1) on Windows."
    exit 1
fi

if [ ! -f "$UNITY_PATH" ]; then
    echo "Unity Editor not found at: $UNITY_PATH"
    echo "Please make sure that version $UNITY_VERSION is installed via Unity Hub and the path is correct."
    exit 1
fi

echo "Launching Unity Editor version $UNITY_VERSION..."
"$UNITY_PATH" -projectPath "$(pwd)"

echo "Done. Tag \'$TAG\' is now active."