-
Notifications
You must be signed in to change notification settings - Fork 0
Paper Event Decorators
@shamoo/paper-raw exports 422 generated Paper event decorators from the pinned Paper API 1.21.8-R0.1-20250906.215025-55. Each decorator:
- is imported from
@shamoo/paper-raw; - targets one method;
- is invoked with no arguments, for example
@OnPlayerJoinEvent(); - records its fully qualified Java event name in compiler metadata;
- normally marks the method as a Paper event invocation when its export name ends in
Event.
import { Component, Context } from '@shamoo/decorators';
import { OnPlayerJoinEvent } from '@shamoo/paper-raw';
@Component()
export class Listener {
@OnPlayerJoinEvent()
public joined(
@Context() payload: { readonly type: string; readonly asynchronous: boolean },
): void {
console.info(payload.type);
}
}The generated package also exports event interface declarations and a cancellability map. Those declarations model the pinned JVM API, but the current bundled Runtime adapter does not pass a live Bukkit/Paper event object to JavaScript. It passes only copied { type, asynchronous } data, registers at Bukkit priority NORMAL, sets ignoreCancelled to false, and ignores live-event mutation APIs. The Java bridge itself can synchronously preserve native event state for a host adapter that deliberately wires it, but generated TypeScript types alone do not provide that wiring.
Name collisions across Java packages receive deterministic _2 suffixes. The six suffixed exports below are part of the 422 and must be imported exactly as listed. Current limitation: compiler and bundled-adapter event classification uses an endsWith('Event') test, so the _2 decorators are recorded but are not classified or registered as event invocations. Until that classifier is corrected, use the generic core decorator with the generated Runtime type string, for example @EventHandler('BellRingEvent_2'), to select the colliding event. The unsuffixed generated decorator selects the event from the other Java package.
OnAnvilDamagedEvent, OnBeaconEffectEvent, OnBlockDestroyEvent, OnTNTPrimeEvent
OnAsyncPlayerSendCommandsEvent, OnAsyncPlayerSendSuggestionsEvent, OnCommandRegisteredEvent
OnCreeperIgniteEvent, OnEnderDragonFireballHitEvent, OnEnderDragonFlameEvent, OnEnderDragonShootFireballEvent, OnEndermanAttackPlayerEvent, OnEndermanEscapeEvent, OnEntityAddToWorldEvent, OnEntityJumpEvent, OnEntityKnockbackByEntityEvent, OnEntityPathfindEvent, OnEntityRemoveFromWorldEvent, OnEntityTeleportEndGatewayEvent, OnEntityZapEvent, OnExperienceOrbMergeEvent, OnPhantomPreSpawnEvent, OnPlayerNaturallySpawnCreaturesEvent, OnPreCreatureSpawnEvent, OnPreSpawnerSpawnEvent, OnProjectileCollideEvent, OnSkeletonHorseTrapEvent, OnSlimeChangeDirectionEvent, OnSlimePathfindEvent, OnSlimeSwimEvent, OnSlimeTargetLivingEntityEvent, OnSlimeWanderEvent, OnThrownEggHatchEvent, OnTurtleGoHomeEvent, OnTurtleLayEggEvent, OnTurtleStartDiggingEvent, OnWitchConsumePotionEvent, OnWitchReadyPotionEvent, OnWitchThrowPotionEvent
OnPrepareGrindstoneEvent, OnPrepareResultEvent
OnIllegalPacketEvent, OnPlayerAdvancementCriterionGrantEvent, OnPlayerArmorChangeEvent, OnPlayerAttackEntityCooldownResetEvent, OnPlayerClientOptionsChangeEvent, OnPlayerConnectionCloseEvent, OnPlayerElytraBoostEvent, OnPlayerHandshakeEvent, OnPlayerJumpEvent, OnPlayerLaunchProjectileEvent, OnPlayerPickupExperienceEvent, OnPlayerPostRespawnEvent, OnPlayerReadyArrowEvent, OnPlayerRecipeBookClickEvent, OnPlayerSetSpawnEvent, OnPlayerStartSpectatingEntityEvent, OnPlayerStopSpectatingEntityEvent, OnPlayerTeleportEndGatewayEvent, OnPlayerUseUnknownEntityEvent
OnFillProfileEvent, OnLookupProfileEvent, OnPreFillProfileEvent, OnPreLookupProfileEvent, OnProfileWhitelistVerifyEvent
OnAsyncTabCompleteEvent, OnGS4QueryEvent, OnPaperServerListPingEvent, OnServerExceptionEvent, OnServerTickEndEvent, OnServerTickStartEvent, OnWhitelistToggleEvent
OnLootableInventoryReplenishEvent
OnBeaconActivatedEvent, OnBeaconDeactivatedEvent, OnBellRevealRaiderEvent, OnBellRingEvent, OnBlockBreakBlockEvent, OnBlockBreakProgressUpdateEvent, OnBlockFailedDispenseEvent, OnBlockLockCheckEvent, OnBlockPreDispenseEvent, OnCompostItemEvent, OnDragonEggFormEvent, OnPlayerShearBlockEvent, OnTargetHitEvent, OnVaultChangeStateEvent
OnPlayerConnectionValidateLoginEvent
OnAsyncPlayerConnectionConfigureEvent, OnPlayerConnectionInitialConfigureEvent, OnPlayerConnectionReconfigureEvent
OnElderGuardianAppearanceEvent, OnEntityAttemptSmashAttackEvent, OnEntityAttemptSpinAttackEvent, OnEntityCompostItemEvent, OnEntityDamageItemEvent, OnEntityDyeEvent, OnEntityEffectTickEvent, OnEntityEquipmentChangedEvent, OnEntityFertilizeEggEvent, OnEntityInsideBlockEvent, OnEntityKnockbackEvent, OnEntityLoadCrossbowEvent, OnEntityMoveEvent, OnEntityPortalReadyEvent, OnEntityPushedByEntityAttackEvent, OnEntityToggleSitEvent, OnFishHookStateChangeEvent, OnPufferFishStateChangeEvent, OnShulkerDuplicateEvent, OnTameableDeathMessageEvent, OnWardenAngerChangeEvent, OnWaterBottleSplashEvent
OnClientTickEndEvent, OnPlayerChunkLoadEvent, OnPlayerChunkUnloadEvent, OnUncheckedSignChangeEvent
OnAsyncChatCommandDecorateEvent, OnAsyncChatDecorateEvent, OnAsyncChatEvent, OnCartographyItemEvent, OnChatEvent, OnPlayerArmSwingEvent, OnPlayerBedFailEnterEvent, OnPlayerChangeBeaconEffectEvent, OnPlayerClientLoadedWorldEvent, OnPlayerDeepSleepEvent, OnPlayerFailMoveEvent, OnPlayerFlowerPotManipulateEvent, OnPlayerInsertLecternBookEvent, OnPlayerInventorySlotChangeEvent, OnPlayerItemCooldownEvent, OnPlayerItemFrameChangeEvent, OnPlayerItemGroupCooldownEvent, OnPlayerLecternPageChangeEvent, OnPlayerLoomPatternSelectEvent, OnPlayerMapFilledEvent, OnPlayerNameEntityEvent, OnPlayerOpenSignEvent, OnPlayerPickBlockEvent, OnPlayerPickEntityEvent, OnPlayerPurchaseEvent, OnPlayerServerFullCheckEvent, OnPlayerShieldDisableEvent, OnPlayerSignCommandPreprocessEvent, OnPlayerStonecutterRecipeSelectEvent, OnPlayerStopUsingItemEvent, OnPlayerTrackEntityEvent, OnPlayerTradeEvent, OnPlayerUntrackEntityEvent, OnPrePlayerAttackEntityEvent
OnServerResourcesReloadedEvent, OnWhitelistStateUpdateEvent
OnStructuresLocateEvent, OnWorldDifficultyChangeEvent, OnWorldGameRuleChangeEvent
OnWorldBorderBoundsChangeEvent, OnWorldBorderBoundsChangeFinishEvent, OnWorldBorderCenterChangeEvent
OnRegionizedServerInitEvent
OnBellResonateEvent, OnBellRingEvent_2, OnBlockBreakEvent, OnBlockBurnEvent, OnBlockCanBuildEvent, OnBlockCookEvent, OnBlockDamageAbortEvent, OnBlockDamageEvent, OnBlockDispenseArmorEvent, OnBlockDispenseEvent, OnBlockDispenseLootEvent, OnBlockDropItemEvent, OnBlockExpEvent, OnBlockExplodeEvent, OnBlockFadeEvent, OnBlockFertilizeEvent, OnBlockFormEvent, OnBlockFromToEvent, OnBlockGrowEvent, OnBlockIgniteEvent, OnBlockMultiPlaceEvent, OnBlockPhysicsEvent, OnBlockPistonExtendEvent, OnBlockPistonRetractEvent, OnBlockPlaceEvent, OnBlockReceiveGameEvent, OnBlockRedstoneEvent, OnBlockShearEntityEvent, OnBlockSpreadEvent, OnBrewingStartEvent, OnCampfireStartEvent, OnCauldronLevelChangeEvent, OnCrafterCraftEvent, OnEntityBlockFormEvent, OnFluidLevelChangeEvent, OnInventoryBlockStartEvent, OnLeavesDecayEvent, OnMoistureChangeEvent, OnNotePlayEvent, OnSculkBloomEvent, OnSignChangeEvent, OnSpongeAbsorbEvent, OnTNTPrimeEvent_2, OnVaultDisplayItemEvent
OnUnknownCommandEvent
OnEnchantItemEvent, OnPrepareItemEnchantEvent
OnAreaEffectCloudApplyEvent, OnArrowBodyCountChangeEvent, OnBatToggleSleepEvent, OnCreatureSpawnEvent, OnCreeperPowerEvent, OnEnderDragonChangePhaseEvent, OnEntityAirChangeEvent, OnEntityBreakDoorEvent, OnEntityBreedEvent, OnEntityChangeBlockEvent, OnEntityCombustByBlockEvent, OnEntityCombustByEntityEvent, OnEntityCombustEvent, OnEntityCreatePortalEvent, OnEntityDamageByBlockEvent, OnEntityDamageByEntityEvent, OnEntityDamageEvent, OnEntityDeathEvent, OnEntityDismountEvent, OnEntityDropItemEvent, OnEntityEnterBlockEvent, OnEntityEnterLoveModeEvent, OnEntityExhaustionEvent, OnEntityExplodeEvent, OnEntityInteractEvent, OnEntityKnockbackByEntityEvent_2, OnEntityKnockbackEvent_2, OnEntityMountEvent, OnEntityPickupItemEvent, OnEntityPlaceEvent, OnEntityPortalEnterEvent, OnEntityPortalEvent, OnEntityPortalExitEvent, OnEntityPoseChangeEvent, OnEntityPotionEffectEvent, OnEntityRegainHealthEvent, OnEntityRemoveEvent, OnEntityResurrectEvent, OnEntityShootBowEvent, OnEntitySpawnEvent, OnEntitySpellCastEvent, OnEntityTameEvent, OnEntityTargetEvent, OnEntityTargetLivingEntityEvent, OnEntityTeleportEvent, OnEntityToggleGlideEvent, OnEntityToggleSwimEvent, OnEntityTransformEvent, OnEntityUnleashEvent, OnExpBottleEvent, OnExplosionPrimeEvent, OnFireworkExplodeEvent, OnFoodLevelChangeEvent, OnHorseJumpEvent, OnItemDespawnEvent, OnItemMergeEvent, OnItemSpawnEvent, OnLingeringPotionSplashEvent, OnPiglinBarterEvent, OnPigZapEvent, OnPigZombieAngerEvent, OnPlayerDeathEvent, OnPlayerLeashEntityEvent, OnPotionSplashEvent, OnProjectileHitEvent, OnProjectileLaunchEvent, OnSheepDyeWoolEvent, OnSheepRegrowWoolEvent, OnSlimeSplitEvent, OnSpawnerSpawnEvent, OnStriderTemperatureChangeEvent, OnTrialSpawnerSpawnEvent, OnVillagerAcquireTradeEvent, OnVillagerCareerChangeEvent, OnVillagerReplenishTradeEvent
OnHangingBreakByEntityEvent, OnHangingBreakEvent, OnHangingPlaceEvent
OnBrewEvent, OnBrewingStandFuelEvent, OnCraftItemEvent, OnFurnaceBurnEvent, OnFurnaceExtractEvent, OnFurnaceSmeltEvent, OnFurnaceStartSmeltEvent, OnHopperInventorySearchEvent, OnInventoryClickEvent, OnInventoryCloseEvent, OnInventoryCreativeEvent, OnInventoryDragEvent, OnInventoryEvent, OnInventoryMoveItemEvent, OnInventoryOpenEvent, OnInventoryPickupItemEvent, OnPrepareAnvilEvent, OnPrepareGrindstoneEvent_2, OnPrepareInventoryResultEvent, OnPrepareItemCraftEvent, OnPrepareSmithingEvent, OnSmithItemEvent, OnTradeSelectEvent
OnAsyncPlayerChatEvent, OnAsyncPlayerChatPreviewEvent, OnAsyncPlayerPreLoginEvent, OnPlayerAdvancementDoneEvent, OnPlayerAnimationEvent, OnPlayerArmorStandManipulateEvent, OnPlayerAttemptPickupItemEvent, OnPlayerBedEnterEvent, OnPlayerBedLeaveEvent, OnPlayerBucketEmptyEvent, OnPlayerBucketEntityEvent, OnPlayerBucketFillEvent, OnPlayerBucketFishEvent, OnPlayerChangedMainHandEvent, OnPlayerChangedWorldEvent, OnPlayerChatEvent, OnPlayerChatTabCompleteEvent, OnPlayerCommandPreprocessEvent, OnPlayerCommandSendEvent, OnPlayerDropItemEvent, OnPlayerEditBookEvent, OnPlayerEggThrowEvent, OnPlayerExpChangeEvent, OnPlayerExpCooldownChangeEvent, OnPlayerFishEvent, OnPlayerGameModeChangeEvent, OnPlayerHarvestBlockEvent, OnPlayerHideEntityEvent, OnPlayerInputEvent, OnPlayerInteractAtEntityEvent, OnPlayerInteractEntityEvent, OnPlayerInteractEvent, OnPlayerItemBreakEvent, OnPlayerItemConsumeEvent, OnPlayerItemDamageEvent, OnPlayerItemHeldEvent, OnPlayerItemMendEvent, OnPlayerJoinEvent, OnPlayerKickEvent, OnPlayerLevelChangeEvent, OnPlayerLinksSendEvent, OnPlayerLocaleChangeEvent, OnPlayerLoginEvent, OnPlayerMoveEvent, OnPlayerPickupArrowEvent, OnPlayerPickupItemEvent, OnPlayerPortalEvent, OnPlayerPreLoginEvent, OnPlayerQuitEvent, OnPlayerRecipeBookClickEvent_2, OnPlayerRecipeBookSettingsChangeEvent, OnPlayerRecipeDiscoverEvent, OnPlayerRegisterChannelEvent, OnPlayerResourcePackStatusEvent, OnPlayerRespawnEvent, OnPlayerRiptideEvent, OnPlayerShearEntityEvent, OnPlayerShowEntityEvent, OnPlayerSignOpenEvent, OnPlayerSpawnChangeEvent, OnPlayerStatisticIncrementEvent, OnPlayerSwapHandItemsEvent, OnPlayerTakeLecternBookEvent, OnPlayerTeleportEvent, OnPlayerToggleFlightEvent, OnPlayerToggleSneakEvent, OnPlayerToggleSprintEvent, OnPlayerUnleashEntityEvent, OnPlayerUnregisterChannelEvent, OnPlayerVelocityEvent
OnRaidFinishEvent, OnRaidSpawnWaveEvent, OnRaidStopEvent, OnRaidTriggerEvent
OnBroadcastMessageEvent, OnMapInitializeEvent, OnPluginDisableEvent, OnPluginEnableEvent, OnRemoteServerCommandEvent, OnServerCommandEvent, OnServerListPingEvent, OnServerLoadEvent, OnServiceRegisterEvent, OnServiceUnregisterEvent, OnTabCompleteEvent
OnVehicleBlockCollisionEvent, OnVehicleCreateEvent, OnVehicleDamageEvent, OnVehicleDestroyEvent, OnVehicleEnterEvent, OnVehicleEntityCollisionEvent, OnVehicleExitEvent, OnVehicleMoveEvent, OnVehicleUpdateEvent
OnLightningStrikeEvent, OnThunderChangeEvent, OnWeatherChangeEvent
OnAsyncStructureGenerateEvent, OnAsyncStructureSpawnEvent, OnChunkLoadEvent, OnChunkPopulateEvent, OnChunkUnloadEvent, OnEntitiesLoadEvent, OnEntitiesUnloadEvent, OnGenericGameEvent, OnLootGenerateEvent, OnPortalCreateEvent, OnSpawnChangeEvent, OnStructureGrowEvent, OnTimeSkipEvent, OnWorldInitEvent, OnWorldLoadEvent, OnWorldSaveEvent, OnWorldUnloadEvent
Source: generated Paper event exports and package-grouped generated sources.