cd ..
GodotCustom Engine Solo University of L'Aquila · Thesis project

YuiToYuki

An educational pixel-art horror RPG built twice: once in Godot 4 and once on a JavaScript engine written from scratch.

cover.png
YuiToYuki cover art
features.idx (8 features)
  1. overview
  2. what_i_did
  3. features/
  4. 01Dual-Paradigm Engine Architecture
  5. 02Normalized Kinematic Locomotion
  6. 03Modular Actionable & Interaction Framework
  7. 04Dynamic Dialogue & Branching Choice System
  8. 05On-Screen Notification HUD
  9. 06Area Overlap & Room Transition Pipeline
  10. 07Room-Level Lifecycle & State Persistence
  11. 08Pixel-Perfect Rendering Setup

Project overview

YuiToYuki is an educational 2D top-down pixel-art RPG developed as an academic thesis project ("Orientare all'informatica coinvolgendo: lo sviluppo di un RPG") to counter high university dropout rates in computer science by demonstrating programming through a complete video game. Set inside a mysterious mansion, the player explores rooms, solves environmental puzzles, collects keys and tools, interacts with characters, and overcomes obstacles. The project uniquely realizes two related games across two distinct paradigms: a high-level game engine implementation in Godot 4 (GDScript) and an engine-from-scratch implementation in Vanilla JavaScript and HTML5 Canvas. As highlighted in the thesis, JavaScript was specifically chosen to introduce learners to one of the most widely used programming languages in the world and an essential, highly in-demand skill in modern web development, using game development as an engaging medium to build foundational web programming competence.

What I did

Designed and developed the entire project as a solo creator. Implemented the complete 2D RPG in Godot 4 and built a lightweight, modular component-based game engine from scratch in Vanilla JavaScript/HTML5 Canvas to introduce students to one of the major languages used for web development while teaching fundamental engine structures (game loop, scene tree, node hierarchy). Authored the comprehensive programming manual and course curriculum "Cosa si cela Dietro ai Pixel" (including exercises, modular architectures, and demo/short/full courses).

Solo project · Solo Developer (Game Designer, Programmer, Author & Educator)

Features I implemented

01

Dual-Paradigm Engine Architecture

Developed the game natively in Godot 4 with GDScript while simultaneously building a modular game engine from scratch in Vanilla JavaScript / HTML5 Canvas (implementing GameObject, GameLoop, SceneTree, Node2D, CharacterBody2D, and Sprite2D), introducing students to core web technologies alongside game engine concepts.

02

Normalized Kinematic Locomotion

Implemented responsive 4-directional and diagonal movement for analog gamepad and keyboard inputs, normalizing directional vectors and utilizing move_and_slide() for smooth obstacle collision sliding without diagonal overspeeding.

03

Modular Actionable & Interaction Framework

Designed a decoupled actionable interaction system (Actionable) allowing player interaction with diverse environmental props (doors, chests, keys, barrels) via localized room callbacks without rigid class coupling.

04

Dynamic Dialogue & Branching Choice System

Created a data-driven dialogue system parsing external CSV tables and hierarchical JSON files to drive micro-conversations, character portrait displays, and player choices with branching story consequences.

05

On-Screen Notification HUD

Implemented real-time contextual UI feedback banners informing the player of acquired items, locked pathways, and quest milestones.

06

Area Overlap & Room Transition Pipeline

Built trigger volumes (Area2D) managing room transitions, spatial boundaries, and hazard hurtboxes when the player steps across thresholds.

07

Room-Level Lifecycle & State Persistence

Structured per-room controller scripts (levels/) managing entity setups, puzzle progression, item visibility, and persistent scene states across mansion floors.

08

Pixel-Perfect Rendering Setup

Configured native 640x480 viewport dimensions with canvas_items stretch mode and nearest-neighbor texture filtering to eliminate sprite blurring across various display scales.

Like what you see?

Get in touch to talk about how it was built.