No description

Find a file

caadiq c82b24c989 refactor: 플레이어 통계 페이지 UI 개선 - 일반 통계 → 전투 통계로 변경 (Sword 아이콘) - 이동 거리 → 이동 통계로 변경, StatCard 스타일 적용 - 점프 횟수를 이동 통계 섹션으로 이동 - 이동 통계 아이콘 다양화 (Footprints, Plane, Waves, ChevronsUp) - 거리 표시 형식 변경: 1000m 이상은 km 단위 (소수점 둘째자리) - Tooltip 제거 (불필요)		2025-12-24 16:47:07 +09:00
backend	feat: 모드 번역 UI 개선 및 플레이어 통계 아이콘 추가	2025-12-24 16:20:36 +09:00
frontend	refactor: 플레이어 통계 페이지 UI 개선	2025-12-24 16:47:07 +09:00
.env	회원가입/로그인, 프로필 추가	2025-12-22 09:36:23 +09:00
.gitignore	gitignore 수정	2025-12-16 11:40:53 +09:00
docker-compose.yml	회원가입/로그인, 프로필 추가	2025-12-22 09:36:23 +09:00
Dockerfile	회원가입/로그인, 프로필 추가	2025-12-22 09:36:23 +09:00
README.md	Initial commit: Minecraft Dashboard	2025-12-16 08:40:32 +09:00

README.md

🎮 Minecraft Dashboard

마인크래프트 서버 상태를 실시간으로 모니터링하는 웹 대시보드입니다.

✨ 주요 기능

🟢 서버 상태 - 온라인/오프라인 상태 및 플레이어 수 실시간 표시
👥 플레이어 정보 - 접속 중인 플레이어 목록 및 3D 스킨 뷰어
🗺️ 월드 정보 - 서버 월드 목록 및 상세 정보
📊 플레이어 통계 - 개별 플레이어 활동 통계
⚡ WebSocket - Socket.IO 기반 실시간 데이터 업데이트

📁 프로젝트 구조

minecraft-web/
├── frontend/          # React + Vite 프론트엔드
├── backend/           # Node.js + Express 백엔드
├── Dockerfile         # 멀티스테이지 Docker 빌드
└── docker-compose.yml # Docker Compose 설정

🛠️ 기술 스택

Frontend

기술	설명
React 18	UI 라이브러리
Vite	빌드 도구
TailwindCSS	CSS 프레임워크
Socket.IO	실시간 통신
skinview3d	3D 스킨 렌더링

Backend

기술	설명
Node.js	런타임 환경
Express	웹 프레임워크
Socket.IO	실시간 통신
minecraft-server-util	서버 상태 조회
MySQL2	데이터베이스 연동

🚀 실행 방법

Docker (권장)

docker compose up -d --build

개발 모드

# 프론트엔드
cd frontend && npm install && npm run dev

# 백엔드
cd backend && npm install && npm start

⚙️ 환경 변수

.env 파일에 다음 변수들을 설정하세요:

DB_HOST=mariadb
DB_USER=minecraft
DB_PASSWORD=your_password
DB_NAME=minecraft
MOD_API_URL=http://minecraft-server:25566

🌐 접속

URL: https://minecraft.caadiq.co.kr

📄 라이선스

MIT License