#@minecraft/server 更新日志

官方原文：Microsoft Learn

#版本映射表

由 npm 已发布版本号推断（如 2.9.0-rc.1.26.50-preview.20 → 预览分支 MC 1.26.50.20）。

#相对稳定版的变更

对比：稳定 2.9.0 ↔ 预览（当前文档） 2.11.0-beta.1.26.50-preview.20

#新增导出符号

• BannerPattern
• BlockBoundingBoxUtils
• BlockDynamicPropertiesComponent
• BlockInstrumentComponent
• BlockQueryOptions
• CameraShakeOptions
• CameraShakeType
• CarryOverBlockEntityDataFunction
• ChatSendAfterEvent
• ChatSendAfterEventSignal
• ChatSendBeforeEvent
• ChatSendBeforeEventSignal
• CloneMode
• EntityIdentifierType
• EntityNpcComponent
• EntitySneakingChangedEventOptions
• EntityStartSneakingAfterEvent
• EntityStartSneakingAfterEventSignal
• EntityStopSneakingAfterEvent
• EntityStopSneakingAfterEventSignal
• EntityTamedAfterEvent
• EntityTamedAfterEventSignal
• EntityTamedBeforeEvent
• EntityTamedBeforeEventSignal
• EntityTamedEventOptions
• FogSettings
• FogSettingsError
• ItemBlockDynamicPropertiesComponent
• MessageReceiveAfterEvent
• PackSettingChangeAfterEvent
• PackSettingChangeAfterEventSignal
• PlayerPlaceBlockBeforeEvent
• PlayerPlaceBlockBeforeEventSignal
• PlayerUseNameTagAfterEvent
• PlayerUseNameTagAfterEventSignal
• PlayerWaypointsMode
• PrimitiveShapeQueryOptions
• ServerMessageAfterEventSignal
• SoundCompletedAfterEvent
• SoundCompletedAfterEventSignal
• SoundDefinition
• SoundDefinitionDurationInfo
• SoundDefinitionFilter
• SoundDefinitionMusicInfo
• SoundDefinitionRegistry
• SoundDurationInfo
• VanillaEntityIdentifier
• WatchdogTerminateBeforeEvent
• WatchdogTerminateBeforeEventSignal
• WatchdogTerminateReason

#既有符号的新增成员

• Block: canPlace, getMapColor, isSolid, trySetPermutation
• BlockComponentRedstoneUpdateEvent: firstUpdate
• BlockComponentTypes: DynamicProperties, Instrument
• BlockLocationIterator: isValid
• BlockVolumeBase: getBoundingBox, getClosest, getFarthest
• Camera: addShake, setCameraWithEase, stopShaking
• CustomCommandErrorReason: UnexpectedEnumName
• CustomCommandParameter: enumName
• DefinitionModifier: triggers
• Dimension: cloneBlocks, getGeneratedStructures, getWeather, spawnXp, stopAllSounds, stopSound
• Entity: target
• EntityBreathableComponent: airSupply, canBreathe
• EntityComponentTypes: Npc
• EquipmentSlot: Body
• GameRule: PlayerWaypoints
• GameRules: playerWaypoints
• ItemComponentTypes: BlockDynamicProperties
• Player: chatDisplayName, chatMessagePrefix, chatNamePrefix, chatNameSuffix, eatItem, fogSettings, getPing, getSplitScreenSlot, persistentId, postClientMessage, stopAllSounds, stopSound
• PlayerSoundOptions: loopCount
• PrimitiveShapesManager: getShapes
• SetBannerDetailsFunction: baseColor, patterns
• SoundInstance: durationInfo, fade, id, pause, recipient, resume, seekTo, setPitch, setVolume, soundEventId
• SystemBeforeEvents: watchdogTerminate
• TextPrimitive: lineGapHeight
• World: allowCheats, broadcastClientMessage, soundDefinitionRegistry
• WorldAfterEvents: chatSend, entityStartSneaking, entityStopSneaking, entityTamed, messageReceive, packSettingChange, playerUseNameTag, soundCompleted
• WorldBeforeEvents: chatSend, entityTamed, playerPlaceBlock
• WorldSoundOptions: loopCount

查看官方完整更新日志

#稳定版 2.9.0

#Changed Block

• Added function getParts

#Changed Dimension

• Added function calculateClosestBiomeFromSeed

#Changed LootItem

• Added property conditions

#Added PlayerCancelBreakingBlockAfterEvent

#Added PlayerCancelBreakingBlockAfterEventSignal

#Added PlayerStartBreakingBlockAfterEvent

#Added PlayerStartBreakingBlockAfterEventSignal

#Changed SoundInstance

• Added function stop

#Changed WorldAfterEvents

• Added property playerCancelBreakingBlock
• Added property playerStartBreakingBlock

#Added enum PlayerSplitScreenSlot

#预览版 2.10.0-rc.1.26.50-preview.24

官方文档对应条目：2.11.0-beta.1.26.50-preview.24（近似匹配）

#Changed AimAssistCategorySettings

• Changed function setBlockPriorities
  • Changed return type from void to void
  • Changed argument blockPriorities type from Record<string, number> to Record<keyof typeof minecraftvanilladata.MinecraftBlockTypes | string, number>
• Changed function setBlockTagPriorities
  • Changed return type from void to void
  • Changed argument blockTagPriorities type from Record<string, number> to Record<string, number>
• Changed function setEntityPriorities
  • Changed return type from void to void
  • Changed argument entityPriorities type from Record<string, number> to Record<keyof typeof minecraftvanilladata.MinecraftEntityTypes | string, number>
• Changed function setEntityTypeFamilyPriorities
  • Changed return type from void to void
  • Changed argument entityTypeFamilyPriorities type from Record<string, number> to Record<string, number>

#Changed AimAssistPresetSettings

• Changed function setExcludedBlockTagTargets
  • Changed return type from void to void
  • Added argument targets
  • Removed argument blockTagTargets
• Changed function setExcludedBlockTargets
  • Changed return type from void to void
  • Added argument targets
  • Removed argument blockTargets
• Changed function setExcludedEntityTargets
  • Changed return type from void to void
  • Added argument targets
  • Removed argument entityTargets
• Changed function setExcludedEntityTypeFamilyTargets
  • Changed return type from void to void
  • Added argument targets
  • Removed argument entityTypeFamilyTargets
• Changed function setItemSettings
  • Changed return type from void to void
  • Changed argument itemSettings type from Record<string, string> to Record<keyof typeof minecraftvanilladata.MinecraftItemTypes | string, string>
• Changed function setLiquidTargetingItems
  • Changed return type from void to void
  • Changed argument items type from string[] to (minecraftvanilladata.MinecraftItemTypes | string)[]

#Added BannerPattern

#Changed Block

• Added property isSolid
• Added function canPlace
• Added function getMapColor
• Added function trySetPermutation

#Added BlockBoundingBoxUtils

#Changed BlockComponentRedstoneUpdateEvent

• Added property firstUpdate

#Added BlockDynamicPropertiesComponent

#Added BlockInstrumentComponent

#Changed BlockLocationIterator

• Added function isValid

#Changed BlockVolumeBase

• Added function getBoundingBox
• Added function getClosest
• Added function getFarthest

#Changed Camera

• Added function addShake
• Added function setCameraWithEase
• Added function stopShaking

#Added CarryOverBlockEntityDataFunction

#Added ChatSendAfterEvent

#Added ChatSendAfterEventSignal

#Added ChatSendBeforeEvent

#Added ChatSendBeforeEventSignal

#Changed Dimension

• Added function cloneBlocks
• Added function getBlocks
• Added function getGeneratedStructures
• Added function getWeather
• Changed function spawnEntity
  • Changed return type from *Entity* (throws exceptions) to Entity (throws exceptions)
  • Changed argument identifier type from *EntityType* | string to EntityIdentifierType<NoInfer>
  • Changed argument location type from *Vector3* to Vector3
  • Changed argument options type from *SpawnEntityOptions* to SpawnEntityOptions
• Added function spawnXp
• Added function stopAllSounds
• Added function stopSound

#Changed Entity

• Added property target

#Changed EntityBreathableComponent

• Added property airSupply
• Added property canBreathe

#Added EntityNpcComponent

#Added EntityStartSneakingAfterEvent

#Added EntityStartSneakingAfterEventSignal

#Added EntityStopSneakingAfterEvent

#Added EntityStopSneakingAfterEventSignal

#Added EntityTamedAfterEvent

#Added EntityTamedAfterEventSignal

#Added EntityTamedBeforeEvent

#Added EntityTamedBeforeEventSignal

#Changed EntityTypes

• Changed function get
  • Changed return type from *EntityType* to EntityType | undefined
  • Changed argument identifier type from string to EntityIdentifierType<NoInfer>

#Added FogSettings

#Changed GameRules

• Added property playerWaypoints

#Added ItemBlockDynamicPropertiesComponent

#Added MessageReceiveAfterEvent

#Added PackSettingChangeAfterEvent

#Added PackSettingChangeAfterEventSignal

#Changed Player

• Added property chatDisplayName
• Added property chatMessagePrefix
• Added property chatNamePrefix
• Added property chatNameSuffix
• Added property fogSettings
• Added property persistentId
• Added function eatItem
• Added function getPing
• Added function getSplitScreenSlot
• Added function postClientMessage
• Added function stopAllSounds
• Added function stopSound

#Added PlayerPlaceBlockBeforeEvent

#Added PlayerPlaceBlockBeforeEventSignal

#Added PlayerUseNameTagAfterEvent

#Added PlayerUseNameTagAfterEventSignal

#Changed Potions

• Changed function resolve
  • Changed return type from *ItemStack* (throws exceptions) to ItemStack (throws exceptions)
  • Changed argument potionEffectType type from *PotionEffectType* | string to PotionEffectType | T
  • Changed argument potionDeliveryType type from *PotionDeliveryType* | string to PotionDeliveryType | U

#Changed PrimitiveShapesManager

• Added function getShapes

#Added ServerMessageAfterEventSignal

#Changed SetBannerDetailsFunction

• Added property baseColor
• Added property patterns

#Added SoundCompletedAfterEvent

#Added SoundCompletedAfterEventSignal

#Changed SoundDefinition

• Added property durationInfo
• Added property musicInfo
• Added property soundEventId
• Added property tags

#Added SoundDefinitionRegistry

#Added SoundDurationInfo

#Changed SoundInstance

• Added property durationInfo
• Added property id
• Added property recipient
• Added property soundEventId
• Added function fade
• Added function pause
• Added function resume
• Added function seekTo
• Added function setPitch
• Added function setVolume

#Changed StartupEvent

• Added property worldClockRegistry

#Changed SystemBeforeEvents

• Added property watchdogTerminate

#Changed TextPrimitive

• Added property lineGapHeight

#Added WatchdogTerminateBeforeEvent

#Added WatchdogTerminateBeforeEventSignal

#Changed World

• Added property allowCheats
• Added property soundDefinitionRegistry
• Added function broadcastClientMessage
• Added function getClock

#Changed WorldAfterEvents

• Added property chatSend
• Added property entityStartSneaking
• Added property entityStopSneaking
• Added property entityTamed
• Added property messageReceive
• Added property packSettingChange
• Added property playerUseNameTag
• Added property soundCompleted

#Changed WorldBeforeEvents

• Added property chatSend
• Added property entityTamed
• Added property playerPlaceBlock

#Added WorldClock

#Added WorldClockRegistry

#Changed enum BlockComponentTypes

• Added value DynamicProperties
• Added value Instrument

#Added enum CameraShakeType

#Added enum CloneMode

#Changed enum CustomCommandErrorReason

• Added value UnexpectedEnumName

#Changed enum EntityComponentTypes

• Added value Npc

#Changed enum EquipmentSlot

• Added value Body

#Changed enum GameRule

• Added value PlayerWaypoints

#Changed enum ItemComponentTypes

• Added value BlockDynamicProperties

#Added enum PlayerWaypointsMode

#Added enum WatchdogTerminateReason