Popup KO

팝업

위로 올라가면서 작아지고 투명해지는 애니메이션 텍스트입니다. 데미지 숫자, 힐량 표시, 경험치 알림 등에 적합합니다.

기본 사용법

DisplayAPI.popup(location)
    .text(Component.text("-25").color(NamedTextColor.RED))
    .duration(30)
    .spawn();

메서드

메서드	설명	기본값
.text(Component)	팝업 텍스트	빈 텍스트
.text(String)	일반 텍스트 간편 메서드	빈 텍스트
.duration(int ticks)	사라지기까지 시간	20 (1초)
.riseSpeed(float)	틱당 상승 속도	0.05
.startScale(float)	시작 크기	1.0
.endScale(float)	사라지기 전 최종 크기	0.5
.billboard(Billboard)	바라보기 모드	CENTER
.visibleTo(Player...)	특정 플레이어에게만 표시	전체
.background(Color)	배경색	투명
.noBackground()	투명 배경 강제	-
.shadowed(boolean)	텍스트 그림자	true

동작 방식

팝업은 자동으로:

1. riseSpeed 만큼 매 틱 위로 올라감
2. startScale에서 endScale로 크기 변화
3. 투명도가 255에서 0으로 감소
4. duration 틱 후 자동 제거

정리 작업이 필요 없습니다 - 엔티티가 완전히 자동 관리됩니다.

예제

데미지 숫자

DisplayAPI.popup(entity.getLocation().add(0, 1.5, 0))
    .text(Component.text("-" + damage).color(NamedTextColor.RED))
    .duration(25)
    .startScale(1.5f)
    .endScale(0.3f)
    .visibleTo(attacker)
    .spawn();

힐량 표시

DisplayAPI.popup(player.getLocation().add(0, 2, 0))
    .text(Component.text("+" + healAmount).color(NamedTextColor.GREEN))
    .duration(20)
    .visibleTo(player)
    .spawn();

경험치 알림

DisplayAPI.popup(player.getLocation().add(0, 2.5, 0))
    .text(Component.text("+50 XP").color(NamedTextColor.YELLOW))
    .duration(40)
    .riseSpeed(0.03f)
    .spawn();