API Reference KO

API 레퍼런스

진입점: DisplayAPI

모든 API 접근은 정적 DisplayAPI 클래스에서 시작합니다.

팩토리 메서드

DisplayAPI.text(Location)           → TextDisplayBuilder
DisplayAPI.block(Location)          → BlockDisplayBuilder
DisplayAPI.item(Location)           → ItemDisplayBuilder
DisplayAPI.popup(Location)          → PopupBuilder
DisplayAPI.interactive(Location)    → InteractiveBuilder
DisplayAPI.animate(SpawnedDisplay)  → AnimationBuilder
DisplayAPI.follow(SpawnedDisplay, Entity) → FollowDisplay
DisplayAPI.leaderboard(Location)    → Leaderboard
DisplayAPI.group(String id, Location) → DisplayGroup

관리 메서드

DisplayAPI.getById(String id)       → SpawnedDisplay
DisplayAPI.remove(String id)        → void
DisplayAPI.removeAll()              → void
DisplayAPI.getManager()             → DisplayManager
DisplayAPI.getPersistenceManager()  → PersistenceManager
DisplayAPI.getPlugin()              → Plugin
DisplayAPI.getDefaultViewRange()    → float

클래스 개요

빌더 (com.wjddusrb03.displayapi.builder)

클래스	설명
AbstractDisplayBuilder<T>	공통 속성을 가진 기본 빌더
TextDisplayBuilder	텍스트 홀로그램 빌더
BlockDisplayBuilder	블록 디스플레이 빌더
ItemDisplayBuilder	아이템 디스플레이 빌더
PopupBuilder	애니메이션 팝업 빌더
InteractiveBuilder	클릭 가능한 디스플레이 빌더

디스플레이 (com.wjddusrb03.displayapi.display)

클래스	설명
SpawnedDisplay	생성된 Display 엔티티 래퍼
DisplayGroup	여러 디스플레이 그룹 관리
InteractiveDisplay	Display + Interaction 엔티티 쌍
FollowDisplay	엔티티를 추적하는 디스플레이
Leaderboard	자동 갱신 순위 디스플레이

애니메이션 (com.wjddusrb03.displayapi.animation)

클래스	설명
AnimationBuilder	애니메이션 빌더 (프리셋 + 커스텀)
DisplayAnimation	실행 중인 애니메이션 컨트롤러
Keyframe	단일 애니메이션 키프레임
Easing	12종 이징 함수 enum

매니저 (com.wjddusrb03.displayapi.manager)

클래스	설명
DisplayManager	모든 활성 디스플레이, 그룹, 인터랙티브 추적
PersistenceManager	영속 디스플레이 YAML 저장/로드

유틸리티 (com.wjddusrb03.displayapi.util)

클래스	설명
PlaceholderUtil	안전한 PlaceholderAPI 연동

리스너 (com.wjddusrb03.displayapi.listener)

클래스	설명
DisplayListener	접속 시 플레이어별 가시성 처리
InteractionListener	클릭 이벤트를 InteractiveDisplay로 라우팅

패키지 구조

com.wjddusrb03.displayapi
├── DisplayAPI.java              (정적 진입점)
├── DisplayAPIPlugin.java        (플러그인 메인 클래스)
├── builder/
│   ├── AbstractDisplayBuilder   (기본 빌더)
│   ├── TextDisplayBuilder
│   ├── BlockDisplayBuilder
│   ├── ItemDisplayBuilder
│   ├── PopupBuilder
│   └── InteractiveBuilder
├── display/
│   ├── SpawnedDisplay           (생성된 엔티티 래퍼)
│   ├── DisplayGroup             (그룹 관리)
│   ├── InteractiveDisplay       (클릭 감지)
│   ├── FollowDisplay            (엔티티 추적)
│   └── Leaderboard              (순위 디스플레이)
├── animation/
│   ├── AnimationBuilder         (애니메이션 팩토리)
│   ├── DisplayAnimation         (애니메이션 실행기)
│   ├── Keyframe                 (애니메이션 데이터)
│   └── Easing                   (12종 이징 곡선)
├── manager/
│   ├── DisplayManager           (디스플레이 추적)
│   └── PersistenceManager       (YAML 영속성)
├── listener/
│   ├── DisplayListener          (가시성 이벤트)
│   └── InteractionListener      (클릭 이벤트)
├── util/
│   └── PlaceholderUtil          (PlaceholderAPI)
└── command/
    └── DisplayAPICommand        (관리자 명령어)