No description

Find a file

caadiq a5e54e1ac6 fix: 로그 삭제 시 RustFS(S3)에서도 파일 삭제 - deleteFromS3 함수 import 추가 - s3_key 또는 s3_url에서 키 추출하여 S3에서 삭제 - S3 삭제 실패해도 DB 레코드는 삭제되도록 처리		2025-12-31 19:42:05 +09:00
backend	fix: 로그 삭제 시 RustFS(S3)에서도 파일 삭제	2025-12-31 19:42:05 +09:00
frontend	fix: 실행 중인 서버가 있으면 selectedServer 자동 설정	2025-12-29 17:50:35 +09:00
.env	회원가입/로그인, 프로필 추가	2025-12-22 09:36:23 +09:00
.gitignore	gitignore 수정	2025-12-16 11:40:53 +09:00
docker-compose.yml	feat: 서버 시작/종료 기능 구현	2025-12-29 13:43:43 +09:00
Dockerfile	fix: Dockerfile에 docker-cli 설치 추가	2025-12-29 13:45:27 +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