Skip to content

Butkii025/Xela_Arcade

Repository files navigation

Xela_Arcade ๐ŸŽฎ

My Game Project: Xela_Arcade is a high-performance, responsive web-based retro gaming hub engineered using Next.js, TypeScript, and Tailwind CSS. Optimized for seamless cross-platform performance, the matrix features zero-dependency implementations of classic arcade games built entirely on pure React state machines.


๐Ÿš€ Live Matrix

Deployed at: xela-arcade.vercel.app


๐Ÿ› ๏ธ Tech Stack & Architecture

Layer Technology Engineering Purpose
Framework Next.js (App Router) Client-side hydration & fast routing
Language TypeScript, Javascript Type safety and strict structural bounds
Styling Tailwind CSS Utility-first fluid styling, transitions, and layout matching
Icons React Icons (fa6, md) High-fidelity scalable vector interface triggers
Deployment Vercel Fast global edge delivery & production builds

๐ŸŽฏ Active Gaming Catalog

โ™Ÿ๏ธ Chess Matrix

  • Rule Enforcement: Features strict client-side validation logic for legal piece mechanics, handling coordinate-based rule tracking for pawn pushes and tactical diagonal captures.
  • Structural Board Alignment: Built on a responsive grid system wrapped in a rigid outer container, keeping cell boundaries perfectly intact without shifting shapes during intense piece manipulation.
  • Piece Development Focus: Optimized visual highlights to track piece trajectories, giving players immediate tactical feedback during openings, mid-game skirmishes, and tactical transitions.

๐Ÿ Retro Snake

  • Spawn Control: Programmed to begin from the lower grid coordinates ([7, 13]) for immediate accessibility.
  • Responsive D-Pad: Features a dedicated, cross-platform direction pad layout. It maps smoothly beneath the board on mobile screens and dynamically shifts to a side-by-side row split (lg:flex-row) on desktops.
  • Loop Synchronization: Implemented with explicit functional state mutations to eliminate race conditions and stale closures during high-frequency user keyboard or button inputs.

โŒ Tic-Tac-Toe (MATRIX_v1.0)

  • Warp-Proof Architecture: Grid items are bound by a rigid aspect ratio matrix (aspect-square) using absolute text placement wrappers (absolute inset-0). This halts browser layout recalculations and prevents container shifting when 'X' or 'O' tokens fill the grid blocks.
  • Intelligent Bot AI: Deploys defensive, predictive move-blocking logic before falling back to center-capture and randomized index paths.
  • Layout Stability: Utilizes a custom opacity transition container to pin UI elements in place. This prevents frame popping before the match begins or after a system reset.

๐Ÿ“‚ Project Folder Structure

To maintain long-term scalability and clean code separation, Xela_Arcade utilizes a strictly structured directory where each game's assets, routing, components, and independent state modules are fully compartmentalized.

โ”œโ”€โ”€ public/                  # Static application assets
โ”‚   โ””โ”€โ”€ assets/games/        # Game-specific assets (e.g., icons, custom audio, sprites)
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/                 # Next.js App Router Structure
โ”‚   โ”‚   โ”œโ”€โ”€ layout.tsx       # Root layout, global fonts, and context wrappers
โ”‚   โ”‚   โ”œโ”€โ”€ page.tsx         # Xela_Arcade Core Dashboard / Hub Interface
โ”‚   โ”‚   โ””โ”€โ”€ games/           # Dedicated route directory for all game instances
โ”‚   โ”‚       โ”œโ”€โ”€ chess/       
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ page.tsx 
โ”‚   โ”‚       โ”œโ”€โ”€ retrosnake/  
โ”‚   โ”‚       โ”‚   โ””โ”€โ”€ page.tsx 
โ”‚   โ”‚       โ””โ”€โ”€ tictactoe/   
โ”‚   โ”‚           โ””โ”€โ”€ page.tsx 
โ”‚   โ”œโ”€โ”€ components/          # Reusable UI System
โ”‚   โ”‚   โ”œโ”€โ”€ shared/          # Global application shell (Navbar, Footer)
โ”‚   โ”‚   โ””โ”€โ”€ games/           # Isolated component folders per game
โ”‚   โ”‚       โ”œโ”€โ”€ ChessBoard/  # Render layers for grid arrays and piece vectors
โ”‚   โ”‚       โ”œโ”€โ”€ RetroSnake/  # Grid rendering and game canvas setup
โ”‚   โ”‚       โ””โ”€โ”€ TicTacToe/   # Turn indicators and grid interaction matrix
โ”‚   โ”œโ”€โ”€ hooks/               # Custom hooks (game loops, timers, input handlers)
โ”‚   โ””โ”€โ”€ utils/               # Complex algorithms, state evaluators, and math helpers
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ README.md

๐Ÿ’ป Developer

Maintained by: P_vijay Hey there! I am actively working to add more web-based games in the future with a polished, modern UI.


โš–๏ธ Licensing & Intellectual Property Protection

This project operates under a strict Split-Licensing Model to maximize codebase transparency while legally protecting the platform from unauthorized commercial exploitation or closed-source forks.

1. Software & Game Logic (GNU GPLv3)

The entire underlying codebaseโ€”including the web environment, server backends, database configurations, and custom game enginesโ€”is licensed under the GNU General Public License v3 (GPLv3).

  • Copyleft Enforced: Anyone may clone and inspect this code, but any modified versions, feature additions, or alternative website deployments must remain 100% open-source under the exact same GPLv3 license.
  • Proprietary Block: You are legally prohibited from taking this code and locking it inside a private, closed-source repository or using it for a proprietary commercial gaming service.

2. Game Assets, Artwork, & Content (CC BY-NC-ND 4.0)

All visual assets, pixel art, animations, UI mockups, audio files, sound effects, and custom classic map designs are strictly protected under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

  • Non-Commercial: No individual or corporation may use the artistic assets of this project to generate revenue, sell in-game microtransactions, or run paid advertisements.
  • No Derivatives: Unauthorized altering, recoloring, or re-skinning of the custom game graphics for other external projects is strictly prohibited.

About

Next.Gen Game Engine Lobby : Full of Game Metrix

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors