Skip to content

forestByTheSeashore/maze_explorer_rpg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

29 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Maze Fighting Explorer - Advanced 2D Maze RPG

A sophisticated 2D top-down maze exploration RPG built with Godot Engine 4.2. This project demonstrates enterprise-level game development practices with advanced systems architecture, comprehensive security measures, and professional-grade polish.

๐ŸŽฎ Game Overview

Navigate through procedurally configured maze levels as a brave adventurer. Fight enemies, collect items, unlock doors, and progress through increasingly challenging levels while your character grows stronger.

Video Demo

The raw file lives in video_demo/Hongyu Lin-2543143-game demo.mp4; clone the repo and open it locally if the embedded player does not load on your platform.

Core Gameplay Loop

  • Exploration: Navigate maze environments with intelligent pathfinding hints
  • Combat: Engage enemies using a tactical combat system with various weapons
  • Progression: Gain EXP, level up, and increase your power
  • Puzzle Solving: Find keys to unlock doors and progress to the next level
  • Inventory Management: Collect and manage weapons, healing items, and keys

๐Ÿ—๏ธ Architecture & Systems

Advanced System Architecture

The game follows a clean 4-layer modular architecture:

๐Ÿ“ Project Structure
โ”œโ”€โ”€ Foundation Layer (12 Autoloaded Managers)
โ”‚   โ”œโ”€โ”€ GameManager - Core game state management
โ”‚   โ”œโ”€โ”€ LevelManager - Multi-level progression system
โ”‚   โ”œโ”€โ”€ SaveManager - Encrypted save/load system
โ”‚   โ”œโ”€โ”€ AudioManager - Complete audio engine
โ”‚   โ”œโ”€โ”€ EffectsManager - Particle effects system
โ”‚   โ”œโ”€โ”€ TutorialManager - Interactive tutorial system
โ”‚   โ”œโ”€โ”€ VictoryManager - Achievement tracking
โ”‚   โ”œโ”€โ”€ NotificationManager - UI notification system
โ”‚   โ”œโ”€โ”€ EncryptionManager - Data security
โ”‚   โ”œโ”€โ”€ InputValidator - Input sanitization
โ”‚   โ”œโ”€โ”€ EthicsManager - Content filtering
โ”‚   โ””โ”€โ”€ PerformanceMonitor - Performance tracking
โ”‚
โ”œโ”€โ”€ Game Logic Layer
โ”‚   โ”œโ”€โ”€ Player System - Advanced character controller
โ”‚   โ”œโ”€โ”€ Enemy AI - FSM-based intelligent enemies
โ”‚   โ”œโ”€โ”€ Inventory System - Dynamic inventory management
โ”‚   โ””โ”€โ”€ Weapon System - Equipment management
โ”‚
โ”œโ”€โ”€ UI Layer
โ”‚   โ”œโ”€โ”€ Main Menu - Complete navigation system
โ”‚   โ”œโ”€โ”€ In-Game HUD - Status bars, minimap
โ”‚   โ”œโ”€โ”€ Settings Menu - Audio and display controls
โ”‚   โ””โ”€โ”€ Pause Menu - Save/load functionality
โ”‚
โ””โ”€โ”€ Content Layer
    โ”œโ”€โ”€ 5 Progressive Levels - Increasing difficulty
    โ”œโ”€โ”€ 3 Enemy Types - Goblin, Skeleton, Slime
    โ””โ”€โ”€ Multiple Items - Keys, weapons, healing items

Technical Features

๐Ÿค– Intelligent AI System

  • Finite State Machine: IDLE โ†’ CHASE โ†’ ATTACK โ†’ DEATH states
  • A Pathfinding*: Uses Godot's Navigation2D for smart enemy movement
  • Multiple AI Behaviors: Different enemy types with unique strategies
  • Dynamic Difficulty: Enemy counts and behaviors scale with level progression

๐ŸŽต Professional Audio Engine

  • Object Pooling: Efficient audio resource management
  • Dynamic Loading: Gracefully handles missing audio files
  • Multi-Channel: Background music, sound effects, UI sounds
  • Volume Control: Master, music, and SFX volume controls

โœจ Rich Visual Effects

  • Particle Systems: Combat hits, item pickups, celebrations
  • Screen Effects: Death overlay, victory flashes
  • Animation System: Smooth character and UI animations
  • Visual Feedback: Damage numbers, status indicators

๐Ÿ’พ Secure Save System

  • XOR Encryption: Save file protection
  • Integrity Verification: Magic headers and checksums
  • Version Control: Backward compatibility support
  • Quick Save/Load: F5/F6 hotkeys for rapid saving

๐Ÿ” Security & Ethics Implementation

Data Security

  • Multi-layer Encryption: XOR + checksum + magic number validation
  • Input Validation: Sanitization of all user inputs
  • Path Security: Prevention of directory traversal attacks
  • Frequency Limiting: Anti-spam protection for attacks

Ethical Design

  • Content Filtering: Automatic inappropriate content detection
  • Age Appropriate: E-rating compliant design
  • Privacy Protection: No data collection, local storage only
  • Accessibility: Keyboard navigation and visual clarity

๐ŸŽฏ Key Features

๐Ÿ—๏ธ Progressive Level System

  • 5 Unique Levels: Each with increasing difficulty
  • Dynamic Configuration: Enemies, items, and maze complexity scale
  • Smart Pathfinding: F1/F2 hotkeys show routes to objectives
  • Completion Tracking: Statistics and achievement system

โš”๏ธ Advanced Combat System

  • Weapon Variety: Multiple sword types with different attack power
  • Real-time Combat: Immediate feedback with effects and sounds
  • EXP System: Character progression through enemy defeats
  • Tactical Elements: Positioning and timing matter

๐ŸŽ“ Interactive Tutorial

  • 7-Step Guided Learning: Progressive skill introduction
  • Context-Sensitive Help: F7 hotkey for instant guidance
  • Skippable Design: Veteran-friendly options
  • Visual Indicators: Clear UI highlighting and instructions

๐Ÿ“Š Complete UI Suite

  • Status Bar: HP, EXP, weapon info display
  • Mini-map: M key toggles overview navigation
  • Inventory Panel: I key opens item management
  • Settings Menu: Audio controls and preferences
  • Victory Screen: Detailed statistics and achievements

๐ŸŽฎ Controls

Key Action Key Action
WASD Movement J Attack
F Interact I Toggle Inventory
1-4 Select Weapon Tab Cycle Weapons
M Toggle Minimap F1/F2 Show Path to Key/Door
ESC Pause Menu Enter Confirm

๐Ÿš€ Getting Started

Prerequisites

  • Godot Engine 4.2 or newer

Installation & Running

  1. Clone this repository to your local machine
  2. Open Godot Engine and click "Import"
  3. Navigate to the project folder and select project.godot
  4. Press F5 or click "Play" to start the game
  5. Main Scene: Automatically starts from main_menu.tscn

Project Structure

Maze Fighting Explorer/
โ”œโ”€โ”€ scenes/          # All game scenes and scripts
โ”œโ”€โ”€ levels/          # Level definitions and management
โ”œโ”€โ”€ ui/              # User interface components
โ”œโ”€โ”€ scripts/         # Core system managers
โ”œโ”€โ”€ assets/          # Art and visual resources
โ”œโ”€โ”€ audio/           # Sound effects and music
โ””โ”€โ”€ documents/       # Technical documentation

๐Ÿ“š Documentation

This project includes comprehensive technical documentation:

  • Architecture_Design.md - System architecture and design patterns
  • Security_Ethics_Report.md - Security measures and ethical considerations

๐ŸŽ–๏ธ Development Standards

This project demonstrates:

  • โœ… Professional Architecture - Clean, modular, maintainable codebase
  • โœ… Security Best Practices - Enterprise-level data protection
  • โœ… Performance Optimization - Object pooling, caching, monitoring
  • โœ… Comprehensive Testing - Input validation and error handling
  • โœ… User Experience - Intuitive controls and helpful guidance
  • โœ… Code Quality - Full documentation and commenting
  • โœ… Scalability - Easy to extend with new features

Maze Fighting Explorer represents a complete, commercial-quality game development project showcasing advanced Godot Engine techniques and professional software development practices.

About

A game, a combination of maze exploration and RPG fight.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors