Back to Home

Project Wiki

1. Introduction

Welcome to the project wiki! This site contains documentation, guides, and technical details for various software and game projects developed by M4rioLS.

Use the table of contents to navigate through the different sections, or browse the project categories below.

2. Software Projects

Details about standalone applications, tools, and utilities.

2.1 Project "Coding-Challenge"

Coding-Challenge is an interactive web application for learning Python programming through gamified coding challenges. Students solve programming exercises, earn points and achievements, maintain daily streaks, and track their progress over time. The platform features secure Docker-based code execution, real-time testing, and comprehensive progress tracking.

Tech Stack: Flask 3.1.0+, MySQL 8.0, SQLAlchemy 2.0+, Docker 7.1.0+, Flask-Login, Flask-Mail, Gradio

Key Features:

  • Secure Code Execution: Docker-based sandboxing with resource limits, network isolation, and read-only filesystem
  • Gamification System: Points, achievements, daily streaks, and leaderboards to motivate learning
  • Task Management: JSON-based task definitions with test cases, difficulty levels, and hints
  • User Authentication: Flask-Login integration with secure password hashing (PBKDF2)
  • Progress Tracking: Submission history, completed tasks, earned achievements, and streak monitoring
  • Task Designer: Gradio-based UI for creating and managing coding challenges without manual JSON editing
  • Email Integration: Password reset functionality via Flask-Mail and Gmail SMTP
  • Real-time Feedback: Instant test case execution with detailed output and error messages

Security Features: Multi-layered defense including Docker isolation (--network none, --pids-limit, --memory limits), SQLAlchemy ORM (SQL injection prevention), Jinja2 autoescaping (XSS protection), and timeout protection against infinite loops.

Architecture: Modular Flask application with JSON-based content management, SQLAlchemy ORM with many-to-many relationships, and defense-in-depth security model. Task Designer runs on separate port (7860) for content creation.

2.2 UtiliBot (TBD)

UtiliBot is a versatile Discord bot framework written in Python, designed to be easily extensible with custom modules and commands.

3. Game Projects

Information about games, game modifications, and related tools.

3.1 DN RPG Engine

DN RPG Engine is a traditional turn-based RPG framework built in GameMaker Studio 2. Features include a complete party management system, turn-based combat with status effects, dialogue and NPC interactions, inventory and shop mechanics, and save/load functionality. The engine provides a solid foundation for creating story-driven RPGs with minimal setup.

Tech Stack: GameMaker Studio 2 (GML), JSON-based localization system

Key Features:

  • Turn-based battle system with multiple party members
  • Status effect system (poison, regeneration, stun, silence, curse, blindness)
  • NPC dialogue and merchant systems
  • Inventory management with item targeting options
  • Audio management with separate volume controls
  • Screen effects (fade transitions, screen shake)

3.2 Dedin's Nightmare: UNITED

Dedin's Nightmare: UNITED is a cooperative multiplayer survival horror game with puzzle-solving elements. Two players must work together to survive through numerous levels, solving puzzles and overcoming horror-themed challenges. Features a custom 3D engine built within GameMaker Studio 2.

Tech Stack: GameMaker Studio 2, Custom 3D Rendering Engine (SMF), GLSL Shaders, Network Multiplayer

Key Features:

  • 2-player cooperative multiplayer with IP/port configuration
  • Custom 3D rendering with skeletal animation (SMF format)
  • Multiple enemy types (Ghost, Psycho, Alien, Robot, Creep)
  • Inventory system with usable items (flashlight, weapons, tools)
  • Dynamic lighting and fog effects with custom shaders
  • Hub-based level progression with 7+ game levels
  • Achievement tracking system

Project Website: https://m4riols.github.io

3.3 Swarm Defender

Swarm Defender is a 3D multiplayer co-op tower defense game built in Godot Engine 4.6. Players cooperate to defend a central core structure against waves of enemy NPCs with advanced AI behaviors. Features Steam integration for multiplayer lobbies and sophisticated enemy pathfinding systems.

Tech Stack: Godot Engine 4.6, GDScript, GodotSteam, Steam Multiplayer Peer

Key Features:

  • Steam-based multiplayer with lobby system (up to 4 players)
  • Advanced enemy AI with NavigationAgent3D pathfinding
  • Multiple enemy types: Standard Melee, Tank (350 HP), Ranged Thrower, Hopper, Floater
  • Server-authoritative multiplayer architecture
  • Core defense mechanic with health and healing between waves
  • Patrol path system with auto-discovery and line-of-sight detection
  • First-person shooter mechanics with stamina system
  • Interactive environment (doors, platforms, pressure plates)

3.4 DedinMod (Minecraft Fabric Mod)

DedinMod is a comprehensive Minecraft mod for version 1.21.11, built using the Fabric modding framework. The mod significantly expands Minecraft with 30+ custom blocks, numerous items, custom entities, status effects, and world generation features. Features include a teleportation network system, custom boss entities, and specialized tools and weapons.

Tech Stack: Java 21, Fabric Loader 0.18.2, Fabric API 0.139.5, Gradle 8.x, Yarn Mappings

Key Features:

  • Custom Blocks: 30+ unique blocks including teleporters, phase blocks, trampolines, and sensors
  • Custom Items: Specialized tools, weapons, hookshots, compass variants, totems, and consumables
  • Custom Entities: NPCs (Kasper), Puppet entities, custom projectiles, and boss entities
  • Status Effects: 9+ unique effects (anti-gravity, phase drifting, minimized, etc.)
  • World Generation: Custom ores, biome modifications, and placed features
  • Game Systems: Teleportation network, custom commands (/heal, /home), custom GUIs
  • Technical Features: Block entities, client-server networking, persistent data, Mixin integration

Architecture: Uses centralized initialization pattern with split source sets for client/server code, data generation API for recipes and models, and custom registry pattern for cleaner content registration.

3.5 Villager's Adventure (Retro Game)

Villager's Adventure is a top-down arcade game inspired by classic "rage-games". Built using GMS2.