이벤트
- 인 게임에서 정해진 조건에 따라 이벤트가 발생할 때 그에 맞춰서 발동하는 함수
- 이벤트에 맞춰서 발생하므로 추가적인 부하 없이 기능을 작성 가능
Listener
- 이벤트 클래스는 Listener 상속(implements Listener)이 필수
void Events(Event e)
- 이벤트시 호출되는 함수는 모두 위와 같은 형태를 취함
- 하나의 클래스 내에 여러 개의 이벤트가 존재하게 작성 가능
- 함수는 이노테이션으로
@EventHandler를 함수 위에 정의 해줘야함- 일종의 주석과 비슷한 개념으로 코드에서 이 함수가 이벤트용으로 만들어진 함수라고 인식함
등록
- 인게임에서 기본 이벤트가 발생했을 때 추가한 이벤트가 발생하기위해선 등록이 필요
Bukkit.getPluginManager().registerEvents(Listener listener, Plugin plugin);- 플러그인 매니저를 가져와 이벤트를 등록함
- Listener에는 작성한 이벤트 클래스를 기입
- Plugin은 메인 클래스가 들어가야함 (메인 클래스 호출은 메인 클래스 참조)
종류
블럭 이벤트
- BlockEvent : 블럭 관련 사건이 생기면 발생
- 디스펜서 관련
- BlockDispenseArmorEvent : 장착가능 아이템이 디스펜서로 발사되어 엔티티에게 장착되었을 때 발생
- BlockDispenseEvent : 디스펜서로 아이템 발사시 발생
- 생성 및 파괴
- BlockCanBuildEvent : 블럭 설치 시도시 발생
- BlockBurnEvent : 블럭이 불에 타서 없어지면 발생
- BlockExplodeEvent : 블럭이 폭발하면 발생
- BlockFadeEvent : 세계 설정 조건으로 눈, 얼음, 산호, 불, 거북알 등이 사라지면 발생
- BlockFertilizeEvent : 뼛가루로 비료를 뿌렸을 때 발생
- BlockFormEvent : 세계 설정 조건으로 눈, 얼음, 흑요석, 조약돌, 콘크리트 등이 형성되면 발생
- LeavesDecayEvent : 잎이 부식되는 경우 발생
- TNTPrimeEvent : TNT가 불이 붙은 경우 발생
- 공통 관련
- BlockPhysicsEvent : 블럭의 물리력이 검사 될 때 발생
- BlockIgniteEvent : 블럭에 불이 붙은 경우 발생
- BlockDropItemEvent : 블럭이 파괴되어 아이템을 떨어뜨린 경우 발생
- BlockExpEvent : 블럭이 경험치를 생성하는 경우 발생
- 상태 변환 관련
- BlockFromToEvent : 물, 용암, 드래곤 알 등이 원천 블럭과 대상 블럭이 있는 이벤트를 나타내는 경우 발생
- BlockPistonEvent : 블럭 피스톤이 작동할 때 발생
- BlockPistonExtendEvent : 블럭 피스톤이 확장할 때 발생
- BlockPistonRetractEvent : 블럭 피스톤이 축소할 때 발생
- BlockReceiveGameEvent : 스컬크 센서가 게임 이벤트를 수신하면 발생
- BlockRedstoneEvent : 레드스톤 상태 변경시 발생
- BlockShearEntityEvent : 디스펜서로 양털 깍을 때 발생
- BlockSpreadEvent : 버섯, 불, 균사체 등이 퍼질 때 발생
- EntityBlockFormEvent : 눈사람, 차가운 발걸음 인챈트에 의해 블럭 생성시 발생
- FluidLevelChangeEvent : 블럭의 액체 레벨이 변경시 발생
- BlockGrowEvent : 밀, 사탕수수, 선인장, 수박, 호박, 거북알 등이 성장하는 경우 발생
- BlockCookEvent : 블럭에서 음식이 구워지면 발생
- InventoryBlockStartEvent : 블럭이 인벤토리 사용시 발생
- FurnaceStartSmeltEvent : 화로 시작시 발생
- BrewingStartEvent : 양조기 시작시 발생
- CampfireStartEvent : 캠프파이어가 요리 시작시 발생
- MoistureChangeEvent : 고체 블럭의 수분 변경시 발생
- NotePlayEvent : 노트 블럭 작동시 발생
- SculkBloomEvent : 스컬크 촉매로 인해 새로운 스컬크 생성시 발생
- SignChangeEvent : 표지판 변경시 발생
- SpongeAbsorbEvent : 스폰지가 물을 빨아들인 경우 발생
- 디스펜서 관련
엔티티 이벤트
- EntityEvent : 엔티티와 관련된 사건이 생기면 발생
- 엔티티 상호작용 관련
- EntityAirChangeEvent : 엔티티의 공기(호흡) 변경시 발생
- EntityBreakDoorEvent : 엔티티가 문을 부술시 발생
- EntityBreedEvent : 엔티티가 교배 성공시 발생
- EntityChangeBlockEvent : 엔티티가 블럭 변경시 발생
- 엔티티 공통 관련
- EntityCombustEvent : 엔티티가 불타는 경우 발생
- EntityCombustByBlockEvent : 엔티티가 블럭에 의해 불타는 경우 발생
- EntityCombustByEntityEvent : 엔티티가 엔티티에 의해 불타는 경우 발생
- EntityDamageEvent : 엔티티가 피해를 입는 경우 발생
- EntityDamageByBlockEvent : 엔티티가 블럭에 의해 피해를 입는 경우 발생
- EntityDamageByEntityEvent : 엔티티가 엔티티에 의해 피해를 입는 경우 발생
- EntityDeathEvent : 엔티티가 사망하면 발생
- EntityDropItemEvent : 엔티티가 아이템을 떨어뜨리면 발생
- EntityEnterBlockEvent : 좀벌레, 벌 등의 엔티티가 블럭에 들어가면 발생
- EntityEnterLoveModeEvent : 엔티티가 사랑 모드에 들어가면 발생
- EntityKnockbackEvent : 엔티티가 넉백을 받을 시 발생
- EntityKnockbackByEntityEvent: 엔티티가 다른 엔티티에게 넉백을 받으면 발생
- EntityInteractEvent : 엔티티가 상호작용시 발생
- EntityPickupItemEvent : 엔티티가 아이템을 주으면 발생
- EntityPortalEvent : 플레이어가 아닌 엔티티가 포탈에 접근하여 텔레포트하는 경우 발생
- EntityPortalEnterEvent : 엔티티가 포탈에 접근하는 경우 발생
- EntityPortalExitEvent : 엔티티가 포탈을 나가기 직전에 발생
- EntityPoseChangeEvent : 엔티티가 포즈를 바꾸면 발생
- EntityPotionEffectEvent : 엔티티의 포션 효과가 바뀌면 발생
- EntityRegainHealthEvent : 엔티티가 체력을 회복하면 발생
- EntityRemoveEvent : 엔티티가 제거되면 발생
- EntityResurrectEvent : 엔티티가 죽어서 부활기회가 있을 때 발생
- EntityTargetEvent : 엔티티가 타겟을 바꾸거나 타겟이 없어지면 발생
- EntityTargetLivingEntityEvent : 엔티티가 리빙 엔티티를 타겟으로 삼으면 발생
- EntityTeleportEvent : 플레이어가 아닌 엔티티가 텔레포트시 발생
- EntityUnleashEvent : 엔티티가 끈에서 풀려나면 발생
- ArrowBodyCountChangeEvent : 몸에 박힌 화살의 개수가 변하면 발생
- 비생물 엔티티 관련
- LingeringPotionSplashEvent : 잔류형 포션이 터지면 발생
- AreaEffectCloudApplyEvent : 잔류형 포션에 영향을 받으면 발생
- FireworkExplodeEvent : 폭죽이 터지면 발생
- PotionSplashEvent : 투척용 포션이 부딪히면 발생
- ProjectileHitEvent : 투사체가 부딪히면 발생
- ProjectileLaunchEvent : 투사체가 발사되면 발생
- 생물 엔티티 관련
- CreeperPowerEvent : 크리퍼가 충전시 발생
- EntityShootBowEvent : 엔티티가 활을 발사하면 발생
- EntityExplodeEvent : 엔티티가 폭발하는 경우 발생
- ExplosionPrimeEvent : 엔티티가 폭발하기로 결정되면 발생
- BatToggleSleepEvent : 박쥐가 잠들면 발생
- EnderDragonChangePhaseEvent : 엔더드래곤의 페이즈 변경시 발생
- EntitySpellCastEvent : 소환사가 스펠을 시전하면 발생
- EntityTameEvent : 엔티티가 테이밍되면 발생
- HorseJumpEvent : 말이 점프하면 발생
- PiglinBarterEvent : 피글린 물물교환시 발생
- PigZombieAngerEvent : 돼지 좀비가 화가 나면 발생
- SheepDyeWoolEvent : 양의 털색깔이 변경되면 발생
- SheepRegrowWoolEvent : 양털이 다시 자라면 발생
- SlimeSplitEvent : 슬라임 분할 이벤트
- StriderTemperatureChangeEvent : 스트라이더가 온도로 바뀌면 발생
- VillagerAcquireTradeEvent : 주민이 새로운 거래를 얻을 때 발생
- VillagerCareerChangeEvent : 주민의 직업이 바뀔 때 발생
- VillagerReplenishTradeEvent : 주민의 물건이 재입고 될 때 발생
- 생성 관련
- EntityPlaceEvent : 갑옷 거치대, 배, 카트, 엔드 수정 등의 엔티티가 설치에 의해 생성시 발생
- EntitySpawnEvent : 엔티티가 생기면 발생
- CreatureSpawnEvent : 생물 생성시 발생
- EntityTransformEvent : 피그맨, 호글린, 스케렐톤, 좀비, 주민 등이 다른 엔티티로 대체(변형)될 때 발생
- ExpBottleEvent : 던져진 경험치병이 부딪혀 경험치 구슬이 생길 때 발생
- 아이템 관련
- ItemDespawnEvent : 아이템이 사라질 때 발생
- ItemMergeEvent : 아이템이 겹쳐서 합쳐질 때 발생
- ItemSpawnEvent : 아이템이 소환되면 발생
- PigZapEvent : 돼지가 번개를 맞아 피글린이 되면 발생
- SpawnerSpawnEvent : 스포너에 의해 엔티티가 소환되면 발생
- 행잉 엔티티 관련
- HangingBreakEvent : 행잉 엔티티가 파괴되면 발생
- HangingBreakByEntityEvent : 엔티티에 의해 행잉 엔티티가 파괴되면 발생
- HangingPlaceEvent : 행잉 엔티티가 설치되면 발생
- HangingBreakEvent : 행잉 엔티티가 파괴되면 발생
- 탈것 이벤트
- EntityMountEvent : 엔티티가 다른 엔티티에 탑승을 시도하면 발생
- EntityDismountEvent : 엔티티가 탈것을 타는 것을 멈추면 발생
- VehicleEvent : 탈것과 관련된 사건이 생기면 발생
- VehicleCreateEvent : 탈것이 생성되면 발생
- VehicleDamageEvent : 탈것이 피해를 입으면 발생
- VehicleDestroyEvent : 탈것이 파괴되면 발생
- VehicleEnterEvent : 엔티티가 탈것에 탑승하면 발생
- VehicleExitEvent : 엔티티가 탈것에서 내리면 발생
- VehicleMoveEvent : 탈것이 움직이면 발생
- VehicleUpdateEvent : 탈것이 업데이트되면 발생
- VehicleCollisionEvent : 탈것이 충돌시 발생
- VehicleBlockCollisionEvent : 탈것이 블럭과 충돌시 발생
- VehicleEntityCollisionEvent : 탈것이 엔티티와 충돌시 발생
- 엔티티 상호작용 관련
인벤토리 이벤트
- InventoryEvent : 인벤토리에 관련된 사건이 생기면 발생
- 인챈트 관련
- EnchantItemEvent : 인챈트가 성공적으로 추가됬을 때 발생
- PrepareItemEnchantEvent : 아이템이 인챈트 테이블에 추가 됬을 때 발생
- 공통 인벤토리 관련
- InventoryOpenEvent : 인벤토리가 열리면 발생
- InventoryCloseEvent : 인벤토리 닫을시 발생
- InventoryClickEvent : 인벤토리 클릭시 발생
- InventoryDragEvent : 드래그로 아이템을 흩뿌리거나하면 발생
- PrepareItemCraftEvent : 제작 계통 인벤토리에 아이템을 넣을 때 발생
- PrepareInventoryResultEvent : 결과 슬롯이 포함된 인벤토리에 아이템을 넣을 때 발생
- 아이템 관련
- CraftItemEvent : 아이템이 만들어지면 발생
- SmithItemEvent : 대장장이 작업대에서 아이템 레시피가 결정되면 발생
- InventoryCreativeEvent : 플레이어가 크리에이티브 모드 전용창에서 아이템을 꺼내거나 제거하면 발생
- 기능있는 인벤토리 관련
- BrewEvent : 양조기가 양조를 완성하면 발생
- BrewingStandFuelEvent : 양조기의 연료 레벨이 바뀌면 발생
- FurnaceBurnEvent : 화로 안에 연료가 타서 연료 레벨이 증가하면 발생
- FurnaceExtractEvent : 플레이어가 화로에서 물건을 꺼내면 발생
- FurnaceSmeltEvent : 화로 안에 물건이 녹으면 발생
- FurnaceStartSmeltEvent : 화로안에 물건이 녹기 시작하면 발생
- HopperInventorySearchEvent : 호퍼가 연결된 상자를 탐색할 때 발생
- PrepareAnvilEvent : 모루에 아이템을 넣을 시 작동
- PrepareGrindstoneEvent : 숫돌에 아이템을 넣을 시 작동
- PrepareSmithingEvent : 대장장이 작업대에 아이템을 넣을시 발생
- InventoryMoveItemEvent : 호퍼 등 일부 엔티티나 블럭이 아이템을 옮기면 발생
- InventoryPickupItemEvent : 호퍼나 호퍼가 실린 수레가 아이템을 주울 시 발생
- TradeSelectEvent : 거래창에서 사이드바에서 새로운 거래 품목을 골랐을 때 발생
- 인챈트 관련
플레이어 이벤트
- PlayerEvent : 플레이어와 관련 사건이 생기면 발생
- 설정 관련
- PlayerStatisticIncrementEvent : 플레이어의 통계가 증가했을 때 발생
- PlayerResourcePackStatusEvent : 플레이어가 서버 리소스팩에 관한 응답을 했을 때 발생
- PlayerLocaleChangeEvent : 플레이어가 로컬설정을 바꾸면 발생
- PlayerChangedMainHandEvent : 플레이어가 클라이언트 설정에서 주손을 바꾸면 발생
- 명령어 관련
- PlayerGameModeChangeEvent : 플레이어의 게임모드가 변경되면 발생
- PlayerCommandPreprocessEvent : 플레이어가 명령어 호출시 발생
- PlayerCommandSendEvent : 플레이어가 사용가능한 명령어를 전달받으면 발생
- 채팅 관련
- AsyncPlayerChatEvent : 비동기적 플레이어가 채팅을 친 경우 발생
- 배고픔 관련
- FoodLevelChangeEvent : 플레이어의 배고픔이 변경되면 발생
- EntityExhaustionEvent : 플레이어가 기진맥진을 쌓을 때마다 발생
- 로그인 관련
- AsyncPlayerPreLoginEvent : 비동기적 로그인 시도시 발생
- PlayerLoginEvent : 플레이어가 로그인 시도시 발생
- PlayerJoinEvent : 플레이어가 접속시 발생
- PlayerQuitEvent : 플레이어가 로그아웃시 발생
- PlayerKickEvent : 플레이어가 쫓겨나면 발생
- 업적 관련
- PlayerAdvancementDoneEvent : 업적 달성시 발생
- 사망 관련
- PlayerRespawnEvent : 플레이어가 부활하면 발생
- PlayerDeathEvent : 플레이어가 사망하면 발생
- 이동 관련
- PlayerAnimationEvent : 플레이어 애니메이션이 변경되면 발생
- PlayerMoveEvent : 플레이어가 직접 움직이면 발생
- PlayerTeleportEvent : 플레이어가 텔레포트시 발생
- PlayerPortalEvent : 플레이어가 포탈을 타려고할 때 발생(포탈 생성 포함)
- PlayerTeleportEvent : 플레이어가 텔레포트시 발생
- PlayerToggleFlightEvent : 플레이어의 플라이 상태가 변경시 발생
- PlayerToggleSneakEvent : 플레이어의 앉기 상태가 변경시 발생
- PlayerToggleSprintEvent : 플레이어의 달리기 상태가 변경시 발생
- EntityToggleGlideEvent : 플레이어의 겉날개 상태가 변경시 발생
- EntityToggleSwimEvent : 플레이어의 수영상태로 변경하면 발생
- PlayerVelocityEvent : 플레이어의 가속도가 변경되면 발생
- PlayerRiptideEvent : 플레이어가 급류 인챈트된 삼지창을 사용시 발생
- PlayerChangedWorldEvent : 플레이어가 월드를 바꾸면 발생
- 경험치 관련
- PlayerExpChangeEvent : 플레이어의 경험치가 바뀌면 발생
- PlayerLevelChangeEvent : 플레이어의 레벨이 변경되면 발생
- 아이템 관련
- PlayerDropItemEvent : 플레이어가 아이템을 떨어뜨리면 발생
- PlayerEditBookEvent : 플레이어가 책을 수정하면 발생
- PlayerTakeLecternBookEvent : 플레이어가 독서대에서 책을 가져가면 발생
- PlayerEggThrowEvent : 플레이어가 달걀을 던지면 발생
- PlayerItemBreakEvent : 플레이어의 아이템이 파괴될시 발생
- PlayerItemConsumeEvent : 플레이어가 소모성 아이템을 사용할 때 발생
- PlayerItemDamageEvent : 플레이어의 아이템 내구도에 피해를 입으면 발생
- PlayerItemHeldEvent : 플레이어가 핫바 슬롯을 바꾸면 발생
- PlayerItemMendEvent : 플레이어가 수선을 통해 아이템을 수리한 경우 발생
- PlayerPickupArrowEvent : 플레이어가 화살을 주우면 발생
- PlayerSwapHandItemsEvent : 플레이어가 주손과 보조손의 아이템을 교환하면 발생
- PlayerFishEvent : 플레이어가 낚시 관련 행동을 할 때마다 발생
- PlayerBucketEvent : 플레이어가 양동이를 사용시 발생
- PlayerBucketEmptyEvent : 플레어가 양동이를 비우면 발생
- PlayerBucketEntityEvent : 플레이어가 양동이로 엔티티를 잡으면 발생
- PlayerBucketFishEvent : 플레이어가 양동이로 물고기를 잡으면 발생
- PlayerBucketFillEvent : 플레이어가 양동이를 채우면 발생
- 블럭 관련
- BlockDamageAbortEvent : 플레이어가 블럭 부수기를 멈추면 발생
- BlockDamageEvent : 플레이어에 의해 블럭이 데미지를 입으면 발생
- BlockPlaceEvent : 플레이어가 블럭 설치시 발생
- BlockMultiPlaceEvent : 침대, 문, 피스톤 등을 한번에 다중으로 설치하는 경우 발생
- BlockBreakEvent : 블럭 파괴시 발동
- 블럭 상호 작용 관련
- PlayerInteractEvent : 플레이어가 블럭과 상호작용시 발생
- PlayerBedEnterEvent : 플레이어가 침대 들어가면 발생
- PlayerBedLeaveEvent : 플레이어가 침대에서 나오면 발생
- PlayerSignOpenEvent : 표지판이 열렸을 때 발생
- PlayerHarvestBlockEvent : 플레이어가 부숴서 수확하지 않는 형태의 작물을 수확하면 발생
- 엔티티 관련 상호작용
- PlayerLeashEntityEvent : 플레이어가 엔티티를 끈으로 묶으면 발생
- PlayerUnleashEntityEvent : 플레이어가 끈으로 묶인 엔티티를 풀어주면 발생
- PlayerInteractEntityEvent : 플레이어가 엔티티와 상호작용시 발생
- PlayerInteractAtEntityEvent : 클릭한 위치를 포함하는 엔티티와 상호작용시 발생
- PlayerArmorStandManipulateEvent : 아머스탠드를 조정시 발생
- PlayerHideEntityEvent : 플레이어로부터 엔티티를 숨기면 발생
- PlayerShowEntityEvent : 플레이어가 숨겨진 엔티티가 다시 보이게 됬을 때 발생
- PlayerShearEntityEvent : 플레이어가 양털을 깍을 시 발생
- 레시피 관련
- PlayerRecipeBookClickEvent : 플레이어 레시피북에서 레시피를 클릭하면 발생
- PlayerRecipeBookSettingsChangeEvent : 플레이어의 레시피북 설정이 바뀌면 발생
- PlayerRecipeDiscoverEvent : 플레이어가 레시피를 발견하면 발생
- 설정 관련
월드 이벤트
- WorldEvent : 월드내 사건이 생기면 발생
- 저장 관련
- WorldInitEvent : 월드가 생길 때 발생
- WorldSaveEvent : 월드가 저장될 때 발생
- WorldLoadEvent : 월드가 로드될 때 발생
- WorldUnloadEvent : 월드가 언로드될 때 발생
- 구조물 관련
- PortalCreateEvent : 포탈이 생성됬을 때 발생
- AsyncStructureGenerateEvent : 비동기적 인위적으로 구조물이 생성됬을 때 발생
- AsyncStructureSpawnEvent : 비동기적 자연적으로 구조물이 생성됬을 때 발생
- StructureGrowEvent : 유기 구조물(묘목, 버섯 등)이 성장하여 생성 됬을 때 발생
- 청크 관련
- ChunkEvent : 청크와 관련된 사건이 생기면 발생
- ChunkLoadEvent : 청크가 로드될 때 발생
- ChunkPopulateEvent : 새롭게 생성된 쳥크내에 블럭이 채우기가 완료되면 발생
- ChunkUnloadEvent : 쳥크가 언로드될 때 발생
- EntitiesLoadEvent : 엔티티들이 로드될 때 발생
- EntitiesUnloadEvent : 엔티티들이 언로드될 때 발생
- ChunkEvent : 청크와 관련된 사건이 생기면 발생
- 날씨 이벤트
- WeatherEvent : 날씨와 관련된 사건이 생기면 발생
- LightningStrikeEvent : 번개 생성시 발생
- ThunderChangeEvent : 날씨가 폭풍우로 변경시 발생
- WeatherChangeEvent : 날씨가 비 또는 맑음으로 바뀌면 발생
- WeatherEvent : 날씨와 관련된 사건이 생기면 발생
- 기타
- SpawnChangeEvent : 월드의 스폰이 변경됬을 때 발생
- TimeSkipEvent : 시간이 스킵이 일어났을때 발생
- LootGenerateEvent : 루트 테이블에 맞춰서 루트가 생성될 때 발생
- 저장 관련
서버 이벤트
- ServerEvent : 서버내 사건이 생기면 발생
- 서버 관련
- TabCompleteEvent : 콘솔이나 플레이어가 명령어 사용시 탭을 통해 자동완성을 시도하는 경우 발생
- BroadcastMessageEvent : 서버에서 전체에게 메세지를 보낼 때 발생
- MapInitializeEvent : 맵이 생성되면 발생
- ServerCommandEvent : 서버에서 명령어가 호출되면 발생
- ServerListPingEvent : 서버리스트에 핑이 들어올 때 발생
- ServerLoadEvent : 서버 로드가 완료되거나 Reload 이후 발생, onEnable(https://velog.io/@ghdtjdwo126/ServerEvent#)는 플러그인 로드시 발생하므로 서버가 켜졌는지 확인을 원하는 경우는 이 이벤트
- PluginEvent : 플러그인이 활성화되거니 비활성화되면 발생
- PluginDisableEvent : 플러그인이 비활성화되면 발생
- PluginEnableEvent : 플러그인이 활성화되면 발생
- 레이드 관련
- RaidEvent : 레이드 관련 사건이 생기면 발생
- RaidFinishEvent : 레이드 종료시 발생
- RaidSpawnWaveEvent : 레이드 웨이브 생성시 발생
- RaidStopEvent : 레이드가 멈추면 발생
- RaidTriggerEvent : 레이드가 시작되면 발생
- BellResonateEvent : 종이 울린 후 근처 약탈자를 강조하면서 발동
- BellRingEvent : 종이 작동시 발동
- RaidEvent : 레이드 관련 사건이 생기면 발생
- 서버 관련
신입 개발자