**Lineage Relic** is a comprehensive full-stack web platform designed to serve as the central hub for a Lineage 2 private server ecosystem. Built with **Next.js 15** and **TypeScript**, the application bridges the gap between web and game server data, providing a seamless experience for user account management, real-time game statistics, and digital commerce.

Project Overview
Lineage Relic is a comprehensive full-stack web platform designed to serve as the central hub for a Lineage 2 private server ecosystem. Built with Next.js 15 and TypeScript, the application bridges the gap between web and game server data, providing a seamless experience for user account management, real-time game statistics, and digital commerce.
Design Philosophy & UI/UX
The application features a modern, immersive interface that pays homage to the game's medieval fantasy aesthetic while adhering to contemporary web standards.
- Aesthetic Direction: A dark-themed, high-contrast visual style enhanced by atmospheric particle effects and smooth animations (powered by Framer Motion).
- Component Architecture: Utilizes a modular UI built with Shadcn/UI and Tailwind CSS, ensuring consistency and accessibility across all views.
- Responsive Layout: Fully responsive design optimized for seamless navigation across desktop, tablet, and mobile devices.
- Interactive Elements: Features sophisticated modal interactions for media galleries, legal documentation, and detailed ranking views, keeping users engaged without leaving the context of the page.
Key Features
1. Public Portal & Content Management
- Dynamic CMS Integration: Powered by Hygraph (Headless CMS) to deliver real-time news, updates, and featured content without requiring code deployments.
- Live Server Statistics: Displays real-time server status, player counts, and castle siege information directly from the game database.
- Competitive Rankings: sophisticated leaderboards tracking PvP/PK statistics, clan standings, and player achievements with detailed character inspection capabilities.
2. User Dashboard & Account Management
- Secure Authentication: Custom authentication system featuring brute-force protection, ReCaptcha verification, and secure session management.
- Character Intelligence: Deep integration with the game server's MySQL database allows users to view detailed character stats (HP/MP/CP), class information, clan affiliation, and online status in real-time.
- Security Suite: empowering users with self-service security tools, including account password management and in-game character PIN verification/reset functionality.
3. Digital Commerce (Store)
- Virtual Economy System: A robust "Donate Token" currency system that facilitates in-game item purchases.
- Payment Processing: Secure integration with PayPal and Stripe APIs for seamless token acquisition.
- Inventory Management: Users can browse a categorized catalog of in-game items and services, with automated validation to ensure character eligibility and server availability before purchase.
- Admin Administration: A dedicated administration panel for managing product catalogs, monitoring transaction logs, and overseeing user token balances.
Technical Stack
- Frontend: Next.js 16 (App Router), React, TypeScript, Tailwind CSS, Framer Motion
- Backend: Next.js Server Actions & API Routes
- Database: MySQL (Direct Game Server Integration)
- CMS: Hygraph (GraphQL)
- Payments: PayPal SDK, Stripe SDK
- Security: Zod Validation, Rate Limiting, BCrypt
