Skip to content
cse23-moraPublic

Repository files navigation

Neural Combat 2025 - LAN Party Website

A cyberpunk-themed gaming tournament registration website built with Astro and Svelte for the University of Moratuwa Computer Science & Engineering Department.

🎮 About

Neural Combat 2025 is a LAN party gaming tournament featuring three exciting competitions:

  • Call of Duty 4: Modern Warfare - 5v5 tactical team battles
  • Blur Racing Championship - High-speed arcade racing with power-ups
  • Clash Royale Tournament - Strategic card-based PvP battles

The event is scheduled for August 16, 2025 at the L3 Lab, Sumanadasa Building, University of Moratuwa.

🚀 Tech Stack

  • Framework: Astro with Svelte integration
  • Styling: Tailwind CSS
  • 3D Graphics: Three.js for visual effects
  • Database: PostgreSQL (schema defined in database.dbml)
  • Security: Cloudflare Turnstile CAPTCHA protection
  • Deployment: Configured for neuralcombat.cse23.org

📁 Project Structure

/
├── public/              # Static assets (images, icons, fonts)
│   ├── background.avif  # Main background image
│   ├── neural.svg       # Neural Combat logo SVG
│   ├── combat.svg       # Combat logo SVG
│   └── frame/          # Grunge frame assets
├── src/
│   ├── components/      # Reusable components
│   │   ├── BootSequence.astro       # Boot animation
│   │   ├── GameSelection.svelte     # Main registration form
│   │   ├── GameSelectionEventInfo.svelte  # Event info display
│   │   └── Header.svelte           # Navigation header
│   ├── layouts/
│   │   └── GameLayout.astro        # Main page layout
│   ├── pages/          # Route pages
│   │   ├── index.astro             # Landing page
│   │   ├── menu.astro              # Main menu
│   │   ├── start-mission.astro     # Competition briefing
│   │   ├── character-select.astro   # Team registration
│   │   ├── event-info.astro        # Event information
│   │   └── mission-briefing.astro  # Timeline & schedule
│   ├── styles/
│   │   └── global.css              # Global styles & animations
│   └── config.ts                   # Site configuration
└── database.dbml                   # Database schema

🎯 Features

Registration System

  • Multi-game registration: Support for team and individual tournaments
  • Real-time validation: Email (@uom.lk), phone, and index number validation
  • Secure submission: Cloudflare Turnstile CAPTCHA integration
  • Live lobby status: Real-time participant count updates

Gaming Tournaments

  1. Call of Duty 4: Modern Warfare

    • Team-based (5 players per team)
    • Search & Destroy mode
    • Up to 50 participants
  2. Blur Racing Championship

    • Solo competition
    • Arcade racing with power-ups
    • Up to 70 participants
  3. Clash Royale Tournament

    • 1v1 strategy battles
    • Card-based gameplay
    • Up to 70 participants

UI/UX Design

  • Cyberpunk aesthetic: Dark theme with neon accents
  • Responsive design: Mobile-first approach
  • Interactive elements: Hover effects and animations
  • Gaming-inspired UI: Terminal-style interfaces and glitch effects

🛠️ Development

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn

Installation

# Clone the repository
git clone <repository-url>
cd lan-party

# Install dependencies
npm install

# Start development server
npm run dev

Available Scripts

Command Action
npm run dev Start development server at localhost:4321
npm run build Build production site to ./dist/
npm run preview Preview production build locally
npm run format Format code with Prettier
npm run format:check Check code formatting

Environment Configuration

The site is configured to deploy to https://neuralcombat.cse23.org as specified in astro.config.mjs.

🎨 Styling & Theming

Color Palette

  • Primary Yellow: #fbe108 (accent-yellow)
  • Accent Red: #ff003c (accent-red)
  • Background: Dark with cyberpunk imagery
  • Text: High contrast black/white scheme

Custom Components

  • Grunge frames: Styled containers with distressed borders
  • Glitch animations: CSS keyframe animations for cyberpunk effect
  • Progress bars: Live lobby status indicators
  • Modal system: Registration status feedback

🔐 Security Features

  • CAPTCHA Protection: Cloudflare Turnstile integration
  • Input Validation: Client-side and server-side validation
  • CORS Configuration: Secure API communication
  • Rate Limiting: Registration attempt protection

📊 Database Schema

The application uses PostgreSQL with the following main tables:

  • members: User registration data
  • call_of_duty: Team tournament registrations
  • blur_racing: Individual racing registrations
  • clash_royale: Individual strategy game registrations

See database.dbml for the complete schema definition.

🚦 API Integration

The frontend communicates with a Cloudflare Worker backend at https://neurallink.cse23.org/ for:

  • Registration submission
  • Live lobby status updates
  • Tournament data management

📱 Responsive Design

The site is fully responsive with breakpoints for:

  • Mobile devices (< 768px)
  • Tablets (768px - 1024px)
  • Desktop (> 1024px)

🎭 Gaming Theme Elements

  • Boot sequence animation on landing page
  • Terminal-style menus with ASCII art
  • Glitch effects on logos and text
  • Sci-fi sound design placeholder elements
  • Matrix-inspired loading states and transitions

🤝 Contributing

This project was developed for the University of Moratuwa Computer Science & Engineering Department's gaming tournament. For questions or modifications, please contact the development team.

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Created for Neural Combat 2025 - University of Moratuwa CSE Department.

Releases

Packages

Contributors

Languages