kotlin
@Suppress("unused")
@EventBusSubscriber( modid = Katton.MOD_ID, value = [Dist.DEDICATED_SERVER] )
modidNeoForge 平台的服务端玩家事件。 此对象提供与服务端玩家生命周期相关的事件，包括加入/离开/重生、经验值事件、物品拾取/投掷、合成等。
ServerPlayerEvent.onPlayerJoin
kotlin
@JvmField
@JvmField val onPlayerJoin当玩家加入服务器时触发。
ServerPlayerEvent.onPlayerLeave
kotlin
@JvmField
@JvmField val onPlayerLeave当玩家离开服务器时触发。
ServerPlayerEvent.onAfterPlayerRespawn
kotlin
@JvmField
@JvmField val onAfterPlayerRespawn当玩家重生后触发。
ServerPlayerEvent.onPlayerCopy
kotlin
@JvmField
@JvmField val onPlayerCopy当复制玩家数据时触发，例如在重生或维度切换时。
ServerPlayerEvent.onPlayerXpChange
kotlin
val onPlayerXpChange当玩家经验变化时触发。 可取消以阻止变化。
ServerPlayerEvent.onPlayerXpLevelChange
kotlin
val onPlayerXpLevelChange当玩家经验等级变化时触发。 可取消以阻止变化。
ServerPlayerEvent.onPlayerPickupXp
kotlin
val onPlayerPickupXp当玩家拾取经验球时触发。 可取消以阻止拾取。
ServerPlayerEvent.onStartTracking
kotlin
val onStartTracking当玩家开始跟踪某个实体时触发。
ServerPlayerEvent.onStopTracking
kotlin
val onStopTracking当玩家停止跟踪某个实体时触发。
ServerPlayerEvent.onPlayerLoadFromFile
kotlin
val onPlayerLoadFromFile当玩家数据从文件加载时触发。
ServerPlayerEvent.onPlayerSaveToFile
kotlin
val onPlayerSaveToFile当玩家数据保存到文件时触发。
ServerPlayerEvent.onItemToss
kotlin
val onItemToss当玩家投掷物品时触发。
ServerPlayerEvent.onItemPickupPre
kotlin
val onItemPickupPre当玩家拾取物品前触发。 可修改是否允许拾取。
ServerPlayerEvent.onItemPickupPost
kotlin
val onItemPickupPost当玩家拾取物品后触发。
ServerPlayerEvent.onPlayerItemCrafted
kotlin
val onPlayerItemCrafted当玩家合成物品时触发。
ServerPlayerEvent.onPlayerItemSmelted
kotlin
val onPlayerItemSmelted当玩家熔炼物品时触发。
ServerPlayerEvent.onPlayerSpawnPhantoms
kotlin
val onPlayerSpawnPhantoms当幻翼即将为某位玩家生成时触发。 可修改幻翼数量和生成结果。
ServerPlayerEvent.onPickFromBlock
kotlin
@JvmField
@JvmField val onPickFromBlock当玩家中键从方块中获取物品时触发。
返回值
要获取的 ItemStack，或返回 null 使用默认行为。
这是为了 NeoForge API 兼容性保留的占位事件。
ServerPlayerEvent.onPickFromEntity
kotlin
@JvmField
@JvmField val onPickFromEntity当玩家中键从实体中获取物品时触发。
返回值
要获取的 ItemStack，或返回 null 使用默认行为。
这是为了 NeoForge API 兼容性保留的占位事件。
ServerPlayerEvent.PlayerTrackingArg
kotlin
data class PlayerTrackingArg( val player: ServerPlayer, val target: Entity )玩家跟踪事件的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 正在跟踪目标的玩家。 |
target | 被跟踪的实体。 |
ServerPlayerEvent.PlayerFileArg
kotlin
data class PlayerFileArg( val player: ServerPlayer, val playerDirectory: File, val playerUUID: String )玩家文件操作的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 正在加载/保存的玩家。 |
playerDirectory | 包含玩家数据的目录。 |
playerUUID | 玩家 UUID。 |
ServerPlayerEvent.PlayerItemPickupPreArg
kotlin
data class PlayerItemPickupPreArg( val player: ServerPlayer, val item: ItemEntity, var canPickup: TriState )物品拾取前事件的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 正在拾取物品的玩家。 |
item | 正在被拾取的物品实体。 |
canPickup | 是否允许拾取（可修改）。 |
ServerPlayerEvent.PlayerItemPickupPostArg
kotlin
data class PlayerItemPickupPostArg( val player: ServerPlayer, val item: ItemEntity, val originalStack: ItemStack, val currentStack: ItemStack )物品拾取后事件的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 已拾取物品的玩家。 |
item | 已被拾取的物品实体。 |
originalStack | 原始物品堆栈。 |
currentStack | 拾取后的当前物品堆栈。 |
ServerPlayerEvent.PlayerCraftedItemArg
kotlin
data class PlayerCraftedItemArg( val player: ServerPlayer, val item: ItemStack, val inventory: Container )玩家合成物品事件的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 合成该物品的玩家。 |
item | 合成得到的物品堆栈。 |
inventory | 发生合成的容器。 |
ServerPlayerEvent.PlayerSmeltedItemArg
kotlin
data class PlayerSmeltedItemArg( val player: ServerPlayer, val item: ItemStack, val amountRemoved: Int )玩家熔炼物品事件的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 熔炼该物品的玩家。 |
item | 熔炼得到的物品堆栈。 |
amountRemoved | 从输入中移除的数量。 |
ServerPlayerEvent.PlayerSpawnPhantomsArg
kotlin
data class PlayerSpawnPhantomsArg( val player: ServerPlayer, var phantomsToSpawn: Int, var result: PlayerSpawnPhantomsEvent.Result )幻翼生成事件的参数类。
属性
| 属性 | 说明 |
|---|---|
player | 正在为其生成幻翼的玩家。 |
phantomsToSpawn | 要生成的幻翼数量（可修改）。 |
result | 生成结果（可修改）。 |