Custom Images 문서 원본 보기

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

== 주요 기능 ==
=== 이미지 렌더링 ===
다양한 형식의 이미지를 마인크래프트 내에서 표시:
* PNG, JPG, GIF 지원
* 애니메이션 GIF 재생 가능
* 이미지 크기 자동 조절
* 디더링 옵션으로 색상 품질 향상

=== 표시 방법 ===
* '''지도 아이템''': 손에 들 수 있는 이미지
* '''아이템 프레임''': 벽에 걸 수 있는 이미지
* '''대형 디스플레이''': 여러 아이템 프레임을 조합한 큰 이미지

== 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /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
|}

== 설정 ==
<pre>
# 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)
</pre>

== 이미지 생성 과정 ==
=== URL에서 이미지 생성 ===
<pre>
# 단일 맵 이미지
/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
</pre>

=== 로컬 파일 사용 ===
<pre>
# plugins/CustomImages/images/ 폴더에 파일 배치 후
/images create myimage file:myimage.png

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

== 고급 기능 ==
=== 이미지 필터 ===
생성 시 다양한 필터 적용 가능:
* '''GRAYSCALE''': 흑백 변환
* '''SEPIA''': 세피아 톤
* '''NEGATIVE''': 색상 반전
* '''BRIGHTNESS''': 밝기 조절
* '''CONTRAST''': 대비 조절

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

== 대형 이미지 설치 ==
=== 자동 설치 ===
<pre>
# 3x3 크기의 이미지를 바라보는 방향에 설치
/images place poster 3 3

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

=== 설치 옵션 ===
* '''INVISIBLE_FRAMES''': 투명 아이템 프레임 사용
* '''GLOWING''': 발광 효과
* '''FIXED''': 회전 방지

== API 연동 ==
다른 플러그인에서 Custom Images API 사용:
<pre>
// 이미지 생성
CustomImagesAPI.createImage("dynamic", imageURL, player);

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

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

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

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

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

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

[[분류:마인크래프트]]