Custom Images

Custom Images는 마인크래프트 서버에서 이미지를 지도(Map)나 아이템 프레임을 통해 표시할 수 있게 해주는 플러그인이다. URL이나 로컬 파일의 이미지를 게임 내에서 그림으로 변환하여 사용할 수 있다.

주요 기능

이미지 렌더링

다양한 형식의 이미지를 마인크래프트 내에서 표시:

• PNG, JPG, GIF 지원
• 애니메이션 GIF 재생 가능
• 이미지 크기 자동 조절
• 디더링 옵션으로 색상 품질 향상

표시 방법

• 지도 아이템: 손에 들 수 있는 이미지
• 아이템 프레임: 벽에 걸 수 있는 이미지
• 대형 디스플레이: 여러 아이템 프레임을 조합한 큰 이미지

명령어

명령어	설명	권한
/images create <이름> <URL>	URL에서 이미지 생성	customimages.create
/images create <이름> file:<파일명>	로컬 파일에서 이미지 생성	customimages.create
/images list [페이지]	생성된 이미지 목록	customimages.list
/images get <이름>	이미지 아이템 받기	customimages.get
/images delete <이름>	이미지 삭제	customimages.delete
/images reload	플러그인 리로드	customimages.reload
/images place <이름> <너비> <높이>	대형 이미지 설치	customimages.place

설정

# config.yml 주요 설정
images:
  max-size: 10  # 최대 이미지 크기 (MB)
  cache-time: 86400  # 캐시 유지 시간 (초)
  allowed-domains:  # 허용된 도메인
    - imgur.com
    - i.imgur.com
    - media.discordapp.net
    
rendering:
  dithering: true  # 디더링 사용
  resize-algorithm: SMOOTH  # 크기 조절 알고리즘
  max-maps-per-image: 100  # 이미지당 최대 맵 수
  
animation:
  enabled: true  # GIF 애니메이션 지원
  max-frames: 100  # 최대 프레임 수
  min-delay: 50  # 최소 프레임 간격 (ms)

이미지 생성 과정

URL에서 이미지 생성

# 단일 맵 이미지
/images create logo https://example.com/logo.png

# 크기 지정
/images create banner https://example.com/banner.jpg 4x2

# 디더링 옵션
/images create photo https://example.com/photo.png FLOYD_STEINBERG

로컬 파일 사용

# plugins/CustomImages/images/ 폴더에 파일 배치 후
/images create myimage file:myimage.png

# 하위 폴더 지원
/images create icon file:icons/diamond.png

고급 기능

이미지 필터

생성 시 다양한 필터 적용 가능:

• GRAYSCALE: 흑백 변환
• SEPIA: 세피아 톤
• NEGATIVE: 색상 반전
• BRIGHTNESS: 밝기 조절
• CONTRAST: 대비 조절

권한별 제한

# 권한별 이미지 생성 제한
permissions:
  default:
    max-images: 5
    max-size: 2  # MB
  vip:
    max-images: 20
    max-size: 5
  admin:
    max-images: -1  # 무제한
    max-size: -1

대형 이미지 설치

자동 설치

# 3x3 크기의 이미지를 바라보는 방향에 설치
/images place poster 3 3

# 특정 좌표에 설치
/images place banner 5 2 100 64 200 NORTH

설치 옵션

• INVISIBLE_FRAMES: 투명 아이템 프레임 사용
• GLOWING: 발광 효과
• FIXED: 회전 방지

API 연동

다른 플러그인에서 Custom Images API 사용:

// 이미지 생성
CustomImagesAPI.createImage("dynamic", imageURL, player);

// 이미지 업데이트
CustomImagesAPI.updateImage("scoreboard", newImageData);

// 애니메이션 제어
CustomImagesAPI.startAnimation("banner");
CustomImagesAPI.pauseAnimation("banner");

활용 예시

• 서버 로고: 스폰 지역에 서버 로고 설치
• 안내판: 규칙이나 안내 사항을 이미지로 제작
• 광고판: 이벤트 포스터나 공지사항 표시
• 미술관: 실제 예술 작품 전시
• 상점 간판: 상품 이미지 표시
• 미니게임 스코어보드: 동적 이미지 업데이트

성능 최적화

• 이미지 캐싱으로 중복 다운로드 방지
• 청크 언로드 시 애니메이션 자동 정지
• 거리 기반 렌더링으로 성능 향상

문제 해결

• 이미지가 깨져 보일 때: 디더링 알고리즘 변경
• 색상이 이상할 때: 마인크래프트 팔레트 제한으로 인한 현상
• 애니메이션이 끊길 때: 프레임 수나 딜레이 조정
• 메모리 사용량이 높을 때: 캐시 크기 제한 설정

보안 설정

security:
  url-whitelist: true  # URL 화이트리스트 사용
  scan-uploads: true  # 업로드 파일 검사
  max-download-time: 30  # 최대 다운로드 시간 (초)
  block-adult-content: true  # 성인 콘텐츠 차단