🎯 주요 특징

• 🗄️ 플레이어당 최대 9개의 가상창고 (486칸)
• 🎫 창고 확장권 아이템으로 쉬운 창고 획득
• ⚡ 비동기 처리로 서버 성능 최적화
• 💾 자동 백업 시스템으로 데이터 안정성 보장
• 🎨 YAML 설정으로 UI 자유롭게 커스터마이징

📋 명령어

👥 플레이어 명령어

/창고

가상 창고 목록 창을 엽니다.

사용 예시:

/창고

소유한 모든 창고 목록이 표시되며, 클릭하여 창고를 열 수 있습니다.

👑 관리자 명령어

/창고관리

관리자 전용 명령어입니다. 여러 하위 명령어를 포함합니다.

하위 명령어 목록:

사용 예시:

/창고관리 지급 Steve
/창고관리 열기 Alex
/창고관리 모니터

🔑 권한 (Permissions)

🛠️ 설정 (Configuration)

UI 커스터마이징

plugins/SimpleContainers/UI_CONFIG.yml 파일을 수정하여 창고 메뉴 UI를 자유롭게 꾸밀 수 있습니다.

설정 가능 항목:

• 메뉴 제목 및 크기
• 창고 아이콘 및 이름
• 버튼 위치 및 디자인
• 색상 및 효과

예시 설정:

menu:
  title: "§6§l나의 창고"
  rows: 6
  
container-icon:
  material: CHEST
  name: "§e창고 #{number}"
  lore:
    - "§7클릭하여 열기"
    - ""
    - "§8ID: {id}"

💡 기술적 특징

데이터 관리 시스템

가상창고는 매우 빈번한 데이터 변경이 발생합니다. SimpleContainers는 안정성과 성능을 모두 잡기 위한 특별한 데이터 관리 방식을 사용합니다.

1️⃣ 비동기 백업

문제점:

• 갑작스러운 서버 종료 시 데이터 유실 위험
• 동기식 저장은 서버 렉 유발

해결 방법:

• ⏰ 10초마다 자동 백업 실행
• 🔄 비동기 스레드에서 처리하여 메인 스레드 영향 없음
• 💾 변경된 데이터만 선택적 저장

[메인 스레드] ────┐
                   │ (데이터 변경 감지)
                   ↓
[백업 스레드] ← 비동기 큐 ← 10초마다
                   ↓
              [데이터베이스]

2️⃣ In-Memory 캐싱

문제점:

• 매번 DB 접근 시 I/O 지연 발생
• 빈번한 접근으로 성능 저하

해결 방법:

• 🧠 자주 사용되는 데이터를 메모리에 캐싱
• ⚡ 10배 이상 빠른 읽기 속도
• 📊 LRU(Least Recently Used) 캐시 정책 적용

성능 비교:

DB 직접 접근:  ~50ms
캐시 사용:     ~5ms  (10배 개선!)

3️⃣ 비동기 Prefetching

문제점:

• 플레이어 로그인 시 창고 로딩 대기 시간

해결 방법:

• 🚀 플레이어 로그인 감지 시 미리 데이터 로드
• 🎯 백그라운드에서 처리하여 체감 지연 없음
• 📦 필요한 데이터를 캐시에 미리 준비

[플레이어 로그인]
        ↓
[Prefetch 작업 시작] ← 비동기
        ↓
[캐시에 데이터 준비]
        ↓
[플레이어 명령어 실행] ← 즉시 응답!

🎮 사용 시나리오

일반 플레이어

1. /창고 명령어로 창고 목록 열기
2. 원하는 창고 클릭하여 아이템 보관/꺼내기
3. 창고 확장권 아이템 사용으로 창고 추가

서버 관리자

1. /창고관리 확장권으로 확장권 아이템 생성
2. 이벤트 보상으로 플레이어에게 지급
3. /창고관리 열기로 문제 발생 시 직접 확인
4. 정기적으로 /창고관리 모니터로 성능 체크

❓ FAQ

Q: 창고는 최대 몇 개까지 소유할 수 있나요?

A: 플레이어당 최대 9개의 창고를 소유할 수 있으며, 각 창고는 54칸(더블 체스트)입니다.

Q: 서버가 갑자기 꺼지면 데이터가 사라지나요?

A: 아니요. 10초마다 자동 백업이 되므로 최대 10초 이내의 데이터만 유실될 수 있습니다.

Q: 많은 플레이어가 동시에 사용해도 괜찮나요?

A: 네! 비동기 처리와 캐싱으로 수백 명이 동시에 사용해도 안정적입니다.

Q: UI를 마음대로 바꿀 수 있나요?

A: 네! UI_CONFIG.yml 파일에서 모든 텍스트를 자유롭게 수정할 수 있습니다.

📝 라이선스

이 플러그인은 개인 및 상업적 용도로 자유롭게 사용할 수 있습니다.
하지만, 무단 수정 및 재배포는 금지합니다.