History

Caadiq d4faf31b73 feat: 화이트리스트 API 엔드포인트 추가 - GET /whitelist - 화이트리스트 조회 (whitelist.json, server.properties) - WhitelistPlayer, WhitelistResponse 데이터 클래스 추가 - white-list 값만 체크하여 활성화 상태 반환		2025-12-23 12:18:19 +09:00
..
gradle/wrapper	Initial commit: Essentials and ServerStatus mods	2025-12-17 18:41:31 +09:00
src/main	feat: 화이트리스트 API 엔드포인트 추가	2025-12-23 12:18:19 +09:00
build.gradle.kts	Initial commit: Essentials and ServerStatus mods	2025-12-17 18:41:31 +09:00
gradle.properties	Initial commit: Essentials and ServerStatus mods	2025-12-17 18:41:31 +09:00
gradlew	Initial commit: Essentials and ServerStatus mods	2025-12-17 18:41:31 +09:00
README.md	Initial commit: Essentials and ServerStatus mods	2025-12-17 18:41:31 +09:00
settings.gradle.kts	Initial commit: Essentials and ServerStatus mods	2025-12-17 18:41:31 +09:00

README.md

🌐 ServerStatus

HTTP API로 마인크래프트 서버 상태를 제공하는 NeoForge 모드입니다.

✨ 주요 기능

📊 서버 상태 API - 실시간 서버 정보 제공
👥 플레이어 목록 - 접속 중인 플레이어 정보
⚡ TPS 모니터링 - 서버 성능 지표
🗺️ 월드 정보 - 로드된 월드 및 청크 정보

📡 API 엔드포인트

기본 포트: 25580

서버 상태

GET /api/status

응답 예시:

{
  "online": true,
  "players": {
    "online": 5,
    "max": 20,
    "list": ["Player1", "Player2"]
  },
  "tps": 20.0,
  "version": "1.21.1"
}

🛠️ 기술 스택

기술	설명
NeoForge	Minecraft 모딩 플랫폼
Kotlin	주 개발 언어
Java HttpServer	내장 HTTP 서버
kotlinx.serialization	JSON 직렬화

📁 구조

ServerStatus/
├── src/main/
│   ├── kotlin/co/caadiq/serverstatus/
│   │   ├── api/           # HTTP API 핸들러
│   │   └── ServerStatus.kt
│   └── resources/
│       └── META-INF/      # 모드 메타데이터
└── build.gradle.kts

🚀 빌드

./gradlew build

빌드된 JAR: build/libs/serverstatus-1.0.0.jar