UNIVERSITY OF WEST ATTICA
SCHOOL OF ENGINEERING
DEPARTMENT OF COMPUTER ENGINEERING AND INFORMATICS
Human-Computer Interaction
Vasileios Evangelos Athanasiou
Student ID: 19390005
Viktor Romanyuk
Student ID: 713242017024
Panagiotis Petropoulos
Student ID: 20390188
Georgios Theocharis
Student ID: 19390283
Supervisor: Christos Troussas, Assistant Professor
Co-Supervisor: Panagiotis Strousopoulos, Postdoctoral Researcher
Athens, July 2024
Virtual Gym is an interactive fitness simulation developed using the Unity Engine (version 2022.3.31f1).
It allows users to perform virtual exercises on various gym equipment, receive guidance from a virtual trainer, and follow personalized nutritional plans.
| Section | Folder / File | Description |
|---|---|---|
| 1 | src/ |
Unity project source code |
| 1.1 | src/Assets/Scripts/ |
C# source files (.cs) |
| 1.1.1 | src/Assets/Scripts/Controllers/ |
Player and camera control logic |
| 1.1.1.1 | PlayerController.cs |
Handles player movement and interaction |
| 1.1.1.2 | CameraController.cs |
Manages camera movement and rotation |
| 1.1.2 | src/Assets/Scripts/Exercises/ |
Exercise mechanics and animations |
| 1.1.2.1 | ExerciseBase.cs |
Abstract base class for exercises |
| 1.1.2.2 | TreadmillExercise.cs |
Treadmill exercise logic |
| 1.1.2.3 | BikeExercise.cs |
Stationary bike exercise logic |
| 1.1.2.4 | WeightsExercise.cs |
Free-weights exercise logic |
| 1.1.3 | src/Assets/Scripts/Trainer/ |
Virtual trainer behavior |
| 1.1.3.1 | TrainerController.cs |
Controls trainer guidance and feedback |
| 1.1.4 | src/Assets/Scripts/User/ |
User data and profiles |
| 1.1.4.1 | UserProfile.cs |
Stores user personal and fitness data |
| 1.1.5 | src/Assets/Scripts/Nutrition/ |
Nutrition and diet planning |
| 1.1.5.1 | NutritionPlan.cs |
Manages nutritional recommendations |
| 1.1.6 | src/Assets/Scripts/Utilities/ |
Helper and utility classes |
| 1.1.6.1 | GameManager.cs |
Global game state management |
| 1.1.6.2 | DataManager.cs |
Saves and loads user progress |
| 2 | assign/ |
Project assignment documents |
| 2.1 | assign/Final Project_ac.year 2023-2024.pdf |
Final project description (English) |
| 2.2 | assign/Τελική Εργασία_ακ. έτους 2023-2024.pdf |
Final project description (Greek) |
| 3 | build/ |
Compiled application build |
| 3.1 | build/Build.zip |
Executable build of the Virtual Gym |
| 4 | diagram/ |
System and task analysis diagrams |
| 4.1 | diagram/Hierarchical-Task-Analysis.drawio |
Hierarchical Task Analysis (editable) |
| 4.2 | diagram/Hierarchical-Task-Analysis.png |
Hierarchical Task Analysis (image) |
| 4.3 | diagram/Ιεραρχική-Ανάλυση-Εργασιών.png |
Hierarchical Task Analysis (Greek) |
| 5 | docs/ |
Project documentation |
| 5.1 | docs/Technical-Manual.pdf |
Technical manual (English) |
| 5.2 | docs/User-Manual.pdf |
User manual (English) |
| 5.3 | docs/Τεχνικό-Εγχειρίδιο.pdf |
Technical manual (Greek) |
| 5.4 | docs/Εγχειρίδιο-Χρήστη.pdf |
User manual (Greek) |
| 6 | README.md |
Project documentation |
-
Interactive Exercises
Perform workouts on treadmills, bicycles, bars, weights, and more. -
Fitness Instructor
Receive personalized gym programs based on user-provided data such as weight, age, and height. -
Virtual Nutritionist
Access dietary advice and nutrition programs tailored to the user’s fitness status. -
In-Game Economy
Earn in-game currency by completing exercises and spend it on fitness products at the vending machine. -
Dynamic Animations
Realistic walking, running, and exercise animations implemented using the Unity Animator.
| Action | Control |
|---|---|
| Movement | WASD or Arrow Keys |
| Camera | Mouse Movement |
| Interaction | E key (e.g., exit door) |
| Inventory | D key |
| Online Help | F1 key |
| Exit Menu | Esc key |
- Engine: Unity
- Programming Language: C#
- Assets:
- 3D models sourced from Sketchfab (gym environment)
- Character animations sourced from Mixamo
-
State Machine
Uses a node-based Animator to transition between states such as Idle, Walking, and various exercise actions based on user input and collisions. -
Collision System
Triggers specific exercise modes when the player enters the collision zone of gym equipment.
This guide explains how to install, configure, and run the Virtual Gym project.
The application is developed with Unity and does NOT require WebGL.
A pre-built Windows executable (.exe) is already included in the repository.
- Windows 10 / Windows 11 (required for running the
.exebuild)
If you only want to run the application, no additional software is required.
If you want to open or modify the project, you will need:
- Install the exact Unity version defined in: ProjectSettings/ProjectVersion.txt
Do not upgrade the Unity version unless explicitly required.
A ready-to-run executable is already provided.
git clone https://github.com/Human-Computer-Interaction/Virtual-Gym.gitor download the ZIP and extract it.
Navigate to the build/ directory
Locate the application file:
VirtualGym.exeDouble-click the .exe file to launch the application
No Unity installation is required to run the executable
-
Add Project
Open Unity Hub and select Add, then choose theVirtual-Gymproject folder. -
Build Application
- Open the project in the Unity Editor.
- Press
Ctrl + Shift + Bto open Build Settings. - Press
Ctrl + Bto build and run the executable.
-
Launch
Navigate to the generated Build folder and runVirtualGym.exe.
Only follow this section if you want to edit, inspect, or extend the project.
- Launch Unity Hub
- Click Add → Add project from disk
- Select the Virtual-Gym project folder
- Open the project using the specified Unity version
- Open the main scene (usually located in
Assets/Scenes/) - Press the ▶ Play button
- Interact with the Virtual Gym environment
To rebuild the executable:
- File → Build Settings
- Platform: PC, Mac & Linux Standalone
- Target Platform: Windows
- Architecture: x86_64
- Click Build
The output will generate a new .exe inside a selected folder.
- Navigate to the
docs/directory - Open the report corresponding to your preferred language:
- English:
User-Manual.pdf,Technical-Manual.pdf - Greek:
Εγχειρίδιο-Χρήστη.pdf,Τεχνικό-Εγχειρίδιο.pdf
- English: