@minecraft/server 2.10.0-beta.1.26.40-preview.24 → 2.10.0-beta.1.26.40-preview.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +276 -106
  2. package/package.json +2 -2
package/index.d.ts CHANGED
@@ -864,7 +864,6 @@ export enum EntityComponentTypes {
864
864
  Color2 = 'minecraft:color2',
865
865
  CursorInventory = 'minecraft:cursor_inventory',
866
866
  /**
867
- * @rc
868
867
  * @remarks
869
868
  * Represents this entity's ender inventory properties.
870
869
  *
@@ -1530,7 +1529,6 @@ export enum EntityHealCause {
1530
1529
  */
1531
1530
  SelfHeal = 'SelfHeal',
1532
1531
  /**
1533
- * @rc
1534
1532
  * @remarks
1535
1533
  * Healing caused when Totem of Undying is activated.
1536
1534
  *
@@ -2377,7 +2375,6 @@ export enum LiquidType {
2377
2375
  }
2378
2376
 
2379
2377
  /**
2380
- * @rc
2381
2378
  * Enum representing the different reasons why a locator bar
2382
2379
  * operation may fail.
2383
2380
  */
@@ -3112,7 +3109,6 @@ export enum WatchdogTerminateReason {
3112
3109
  }
3113
3110
 
3114
3111
  /**
3115
- * @rc
3116
3112
  * Enum representing different texture icons that can be
3117
3113
  * displayed for waypoints on the locator bar.
3118
3114
  */
@@ -4858,7 +4854,6 @@ export class BlockComponentBlockBreakEvent extends BlockEvent {
4858
4854
  }
4859
4855
 
4860
4856
  /**
4861
- * @rc
4862
4857
  * Contains information regarding a specific block permutation
4863
4858
  * that was changed from a previous permutation.
4864
4859
  */
@@ -5128,7 +5123,6 @@ export class BlockComponentTickEvent extends BlockEvent {
5128
5123
  }
5129
5124
 
5130
5125
  /**
5131
- * @rc
5132
5126
  * Contains information regarding a specific container block
5133
5127
  * being closed.
5134
5128
  */
@@ -5146,7 +5140,6 @@ export class BlockContainerClosedAfterEvent extends BlockEvent {
5146
5140
  }
5147
5141
 
5148
5142
  /**
5149
- * @rc
5150
5143
  * Manages callbacks that are connected to when a block
5151
5144
  * container is closed.
5152
5145
  */
@@ -5180,7 +5173,6 @@ export class BlockContainerClosedAfterEventSignal {
5180
5173
  }
5181
5174
 
5182
5175
  /**
5183
- * @rc
5184
5176
  * Contains information regarding a specific container block
5185
5177
  * being opened.
5186
5178
  */
@@ -5198,7 +5190,6 @@ export class BlockContainerOpenedAfterEvent extends BlockEvent {
5198
5190
  }
5199
5191
 
5200
5192
  /**
5201
- * @rc
5202
5193
  * Manages callbacks that are connected to when a block
5203
5194
  * container is opened.
5204
5195
  */
@@ -5243,12 +5234,11 @@ export class BlockCustomComponentInstance extends BlockComponent {
5243
5234
  /**
5244
5235
  * @beta
5245
5236
  * Represents the dynamic properties of a block in the world.
5246
- * Only available with block entities. Up to 1KBytes of data
5247
- * can be stored per block entity in their dynamic properties
5248
- * storage.
5237
+ * Only available with block entities. Up to 1KB per content
5238
+ * pack, per block entity in their dynamic properties storage.
5249
5239
  * @example rememberPlayerInteraction.ts
5250
5240
  * ```typescript
5251
- * import { system } from '@minecraft/server-wrapper';
5241
+ * import { system } from '@minecraft/server-v2';
5252
5242
  *
5253
5243
  * system.beforeEvents.startup.subscribe(initEvent => {
5254
5244
  * initEvent.blockComponentRegistry.registerCustomComponent('scripting_demo_pack:block_entity_onPlayerInteract', {
@@ -5309,7 +5299,8 @@ export class BlockDynamicPropertiesComponent extends BlockComponent {
5309
5299
  * set dynamic properties for other content packs. Values can
5310
5300
  * be either a Number, a String or a Vector3. Setting a
5311
5301
  * property with an undefined value will remove it from the
5312
- * storage.
5302
+ * storage. Storage size usage is counted towards the 1KBytes
5303
+ * limit per content pack.
5313
5304
  *
5314
5305
  * This function can't be called in restricted-execution mode.
5315
5306
  *
@@ -5327,7 +5318,9 @@ export class BlockDynamicPropertiesComponent extends BlockComponent {
5327
5318
  /**
5328
5319
  * @remarks
5329
5320
  * Returns the current size, in bytes, of the dynamic
5330
- * properties storage for this block entity.
5321
+ * properties storage for this block entity. The byte count
5322
+ * only accounts for properties set by your content pack. The
5323
+ * 1KBytes limit is per content pack.
5331
5324
  *
5332
5325
  * @throws This function can throw errors.
5333
5326
  *
@@ -5987,7 +5980,6 @@ export class BlockPrecipitationInteractionsComponent extends BlockComponent {
5987
5980
  */
5988
5981
  accumulatesSnow(): boolean;
5989
5982
  /**
5990
- * @rc
5991
5983
  * @remarks
5992
5984
  * Returns `true` if this block can have snow within it, like a
5993
5985
  * flower submerged in snow. Returns `false` if this block
@@ -7063,7 +7055,6 @@ export class ChatSendBeforeEventSignal {
7063
7055
  export class ClientSystemInfo extends SystemInfo {
7064
7056
  private constructor();
7065
7057
  /**
7066
- * @rc
7067
7058
  * @remarks
7068
7059
  * The locale selected by the client (e.g., en_US, fr_FR,
7069
7060
  * ja_JP). Note that in most cases, server scripts should not
@@ -8385,6 +8376,38 @@ export class Dimension {
8385
8376
  *
8386
8377
  */
8387
8378
  readonly localizationKey: string;
8379
+ /**
8380
+ * @rc
8381
+ * @remarks
8382
+ * Calculates the location of the closest biome of a particular
8383
+ * type from the world seed. Note that
8384
+ * calculateClosestBiomeFromSeed can be an expensive operation,
8385
+ * so avoid using many of these calls within a particular tick.
8386
+ * The result is derived purely from the world generation
8387
+ * algorithm and the world seed, so the returned location may
8388
+ * not reflect the actual current terrain if biomes have been
8389
+ * modified after generation.
8390
+ *
8391
+ * @param pos
8392
+ * Starting location to look for a biome to find.
8393
+ * @param biomeToFind
8394
+ * Identifier of the biome to look for.
8395
+ * @param options
8396
+ * Additional selection criteria for a biome search.
8397
+ * @returns
8398
+ * Returns a location of the biome, or undefined if a biome
8399
+ * could not be found.
8400
+ * @throws This function can throw errors.
8401
+ *
8402
+ * {@link minecraftcommon.EngineError}
8403
+ *
8404
+ * {@link Error}
8405
+ */
8406
+ calculateClosestBiomeFromSeed(
8407
+ pos: Vector3,
8408
+ biomeToFind: BiomeType | string,
8409
+ options?: BiomeSearchOptions,
8410
+ ): Vector3 | undefined;
8388
8411
  /**
8389
8412
  * @remarks
8390
8413
  * Checks if an area contains the specified biomes. If the area
@@ -8541,30 +8564,6 @@ export class Dimension {
8541
8564
  block: BlockPermutation | BlockType | string,
8542
8565
  options?: BlockFillOptions,
8543
8566
  ): ListBlockVolume;
8544
- /**
8545
- * @beta
8546
- * @remarks
8547
- * Finds the location of the closest biome of a particular
8548
- * type. Note that the findClosestBiome operation can take some
8549
- * time to complete, so avoid using many of these calls within
8550
- * a particular tick.
8551
- *
8552
- * @param pos
8553
- * Starting location to look for a biome to find.
8554
- * @param biomeToFind
8555
- * Identifier of the biome to look for.
8556
- * @param options
8557
- * Additional selection criteria for a biome search.
8558
- * @returns
8559
- * Returns a location of the biome, or undefined if a biome
8560
- * could not be found.
8561
- * @throws This function can throw errors.
8562
- *
8563
- * {@link minecraftcommon.EngineError}
8564
- *
8565
- * {@link Error}
8566
- */
8567
- findClosestBiome(pos: Vector3, biomeToFind: BiomeType | string, options?: BiomeSearchOptions): Vector3 | undefined;
8568
8567
  /**
8569
8568
  * @remarks
8570
8569
  * Returns the biome type at the specified location.
@@ -9267,7 +9266,6 @@ export class Dimension {
9267
9266
  }
9268
9267
 
9269
9268
  /**
9270
- * @rc
9271
9269
  * Provides the functionality for registering custom
9272
9270
  * dimensions. Custom dimensions can only be registered during
9273
9271
  * the system startup event.
@@ -9816,7 +9814,6 @@ export class Entity {
9816
9814
  */
9817
9815
  readonly location: Vector3;
9818
9816
  /**
9819
- * @rc
9820
9817
  * @remarks
9821
9818
  * Boolean which determines if the player nameplate should be
9822
9819
  * depth tested for visibility.
@@ -9826,7 +9823,6 @@ export class Entity {
9826
9823
  */
9827
9824
  nameplateDepthTested: boolean;
9828
9825
  /**
9829
- * @rc
9830
9826
  * @remarks
9831
9827
  * Float that determines the render distance of this entity's
9832
9828
  * nameplate.
@@ -11284,7 +11280,6 @@ export class EntityComponent extends Component {
11284
11280
  }
11285
11281
 
11286
11282
  /**
11287
- * @rc
11288
11283
  * Contains information regarding a specific entity container
11289
11284
  * being closed.
11290
11285
  */
@@ -11300,7 +11295,6 @@ export class EntityContainerClosedAfterEvent {
11300
11295
  }
11301
11296
 
11302
11297
  /**
11303
- * @rc
11304
11298
  * Manages callbacks that are connected to when an entity
11305
11299
  * container is closed.
11306
11300
  */
@@ -11334,7 +11328,6 @@ export class EntityContainerClosedAfterEventSignal {
11334
11328
  }
11335
11329
 
11336
11330
  /**
11337
- * @rc
11338
11331
  * Contains information regarding a specific entity container
11339
11332
  * being opened.
11340
11333
  */
@@ -11350,7 +11343,6 @@ export class EntityContainerOpenedAfterEvent {
11350
11343
  }
11351
11344
 
11352
11345
  /**
11353
- * @rc
11354
11346
  * Manages callbacks that are connected to when an entity
11355
11347
  * container is opened.
11356
11348
  */
@@ -11477,7 +11469,6 @@ export class EntityDieAfterEventSignal {
11477
11469
  }
11478
11470
 
11479
11471
  /**
11480
- * @rc
11481
11472
  * Represents this entity's ender inventory properties. This
11482
11473
  * component is always present on players and any items in its
11483
11474
  * container will display for the player when they access an
@@ -14227,7 +14218,6 @@ export class EntityUnderwaterMovementComponent extends EntityAttributeComponent
14227
14218
  }
14228
14219
 
14229
14220
  /**
14230
- * @rc
14231
14221
  * Contains information related to firing of a data driven
14232
14222
  * entity version upgrade.
14233
14223
  */
@@ -14255,7 +14245,6 @@ export class EntityUpgradeAfterEvent {
14255
14245
  }
14256
14246
 
14257
14247
  /**
14258
- * @rc
14259
14248
  * Contains event registration related to firing of a data
14260
14249
  * driven entity version upgrade.
14261
14250
  */
@@ -14317,7 +14306,6 @@ export class EntityWantsJockeyComponent extends EntityComponent {
14317
14306
  }
14318
14307
 
14319
14308
  /**
14320
- * @rc
14321
14309
  * Waypoint that tracks an entity's position. The waypoint
14322
14310
  * automatically updates as the entity moves and becomes
14323
14311
  * invalid when the entity is removed.
@@ -15094,7 +15082,8 @@ export class ISerializable {
15094
15082
  * @beta
15095
15083
  * Represents the dynamic properties of a block. Only available
15096
15084
  * from block entities. Up to 1KBytes of data can be stored per
15097
- * block entity in their dynamic properties storage.
15085
+ * content pack per block entity in their dynamic properties
15086
+ * storage.
15098
15087
  */
15099
15088
  // @ts-ignore Class inheritance allowed for native defined classes
15100
15089
  export class ItemBlockDynamicPropertiesComponent extends ItemComponent {
@@ -15114,10 +15103,29 @@ export class ItemBlockDynamicPropertiesComponent extends ItemComponent {
15114
15103
  * {@link InvalidItemStackError}
15115
15104
  */
15116
15105
  get(key: string): boolean | number | string | Vector3 | undefined;
15106
+ /**
15107
+ * @remarks
15108
+ * Sets a dynamic property with the provided key and value.
15109
+ * Keys are unique to each content pack and cannot be used to
15110
+ * set dynamic properties for other content packs. Values can
15111
+ * be either a Number, a String or a Vector3. Setting a
15112
+ * property with an undefined value will remove it from the
15113
+ * storage. Storage size usage is counted towards the 1KBytes
15114
+ * limit per content pack.
15115
+ *
15116
+ * @throws This function can throw errors.
15117
+ *
15118
+ * {@link Error}
15119
+ *
15120
+ * {@link InvalidItemStackError}
15121
+ */
15122
+ set(key: string, value?: boolean | number | string | Vector3): void;
15117
15123
  /**
15118
15124
  * @remarks
15119
15125
  * Returns the current size, in bytes, of the dynamic
15120
- * properties storage for this block.
15126
+ * properties storage for this block. The byte count only
15127
+ * accounts for properties set by your content pack. The
15128
+ * 1KBytes limit is per content pack.
15121
15129
  *
15122
15130
  * @throws This function can throw errors.
15123
15131
  *
@@ -17291,7 +17299,6 @@ export class ListBlockVolume extends BlockVolumeBase {
17291
17299
  }
17292
17300
 
17293
17301
  /**
17294
- * @rc
17295
17302
  * Waypoint that points to a fixed location in the world.
17296
17303
  * Unlike entity waypoints, location waypoints always remain
17297
17304
  * valid and their position can be updated.
@@ -17319,7 +17326,6 @@ export class LocationWaypoint extends Waypoint {
17319
17326
  }
17320
17327
 
17321
17328
  /**
17322
- * @rc
17323
17329
  * Manages the collection of waypoints displayed on a player's
17324
17330
  * locator bar. Allows adding, removing, and querying waypoints
17325
17331
  * with a maximum capacity limit.
@@ -18285,7 +18291,6 @@ export class Player extends Entity {
18285
18291
  */
18286
18292
  readonly level: number;
18287
18293
  /**
18288
- * @rc
18289
18294
  * @remarks
18290
18295
  * The player's Locator Bar. This property is used for managing
18291
18296
  * waypoints displayed on the HUD.
@@ -18539,7 +18544,7 @@ export class Player extends Entity {
18539
18544
  * }
18540
18545
  * ```
18541
18546
  */
18542
- playSound(soundId: string, soundOptions?: PlayerSoundOptions): SoundInstance;
18547
+ playSound(soundId: SoundDefinition | string, soundOptions?: PlayerSoundOptions): SoundInstance;
18543
18548
  /**
18544
18549
  * @beta
18545
18550
  * @remarks
@@ -19096,7 +19101,7 @@ export class PlayerButtonInputAfterEventSignal {
19096
19101
  }
19097
19102
 
19098
19103
  /**
19099
- * @beta
19104
+ * @rc
19100
19105
  * Contains information regarding an event after a player
19101
19106
  * cancels breaking a block.
19102
19107
  */
@@ -19139,7 +19144,7 @@ export class PlayerCancelBreakingBlockAfterEvent extends BlockEvent {
19139
19144
  }
19140
19145
 
19141
19146
  /**
19142
- * @beta
19147
+ * @rc
19143
19148
  * Manages callbacks that are connected to when a player
19144
19149
  * cancels breaking a block.
19145
19150
  */
@@ -20360,7 +20365,7 @@ export class PlayerSpawnAfterEventSignal {
20360
20365
  }
20361
20366
 
20362
20367
  /**
20363
- * @beta
20368
+ * @rc
20364
20369
  * Contains information regarding an event after a player
20365
20370
  * starts breaking a block.
20366
20371
  */
@@ -20396,7 +20401,7 @@ export class PlayerStartBreakingBlockAfterEvent extends BlockEvent {
20396
20401
  }
20397
20402
 
20398
20403
  /**
20399
- * @beta
20404
+ * @rc
20400
20405
  * Manages callbacks that are connected to when a player starts
20401
20406
  * breaking a block.
20402
20407
  */
@@ -20568,7 +20573,6 @@ export class PlayerUseNameTagAfterEventSignal {
20568
20573
  }
20569
20574
 
20570
20575
  /**
20571
- * @rc
20572
20576
  * Waypoint that tracks a player's position. Extends {@link
20573
20577
  * EntityWaypoint} with additional player-specific visibility
20574
20578
  * rules such as hidden state and spectator mode.
@@ -20802,7 +20806,6 @@ export class PressurePlatePushAfterEventSignal {
20802
20806
  }
20803
20807
 
20804
20808
  /**
20805
- * @rc
20806
20809
  * The base class for a text primitive. Represents an object in
20807
20810
  * the world and its base properties.
20808
20811
  */
@@ -20906,7 +20909,6 @@ export class PrimitiveShape {
20906
20909
  }
20907
20910
 
20908
20911
  /**
20909
- * @rc
20910
20912
  * Primitive Shapes class used to allow adding and removing
20911
20913
  * text primitives to the world.
20912
20914
  */
@@ -22262,6 +22264,73 @@ export class SoundCompletedAfterEventSignal {
22262
22264
  unsubscribe(callback: (arg0: SoundCompletedAfterEvent) => void): void;
22263
22265
  }
22264
22266
 
22267
+ /**
22268
+ * @beta
22269
+ * Static metadata about a sound declared in a
22270
+ * sound_definitions.json file.
22271
+ */
22272
+ export class SoundDefinition {
22273
+ private constructor();
22274
+ /**
22275
+ * @remarks
22276
+ * Duration metadata declared for this sound. Undefined when
22277
+ * the sound definition does not specify a duration.
22278
+ *
22279
+ */
22280
+ readonly durationInfo?: SoundDefinitionDurationInfo;
22281
+ /**
22282
+ * @remarks
22283
+ * Music metadata declared for this sound. Undefined when the
22284
+ * sound definition does not specify a music_info block.
22285
+ *
22286
+ */
22287
+ readonly musicInfo?: SoundDefinitionMusicInfo;
22288
+ /**
22289
+ * @remarks
22290
+ * Identifier of the sound event this definition declares, in
22291
+ * the form 'namespace:name'.
22292
+ *
22293
+ */
22294
+ readonly soundEventId: string;
22295
+ /**
22296
+ * @remarks
22297
+ * Tag metadata declared for this sound, as a record mapping
22298
+ * each tag name to its declared values. A tag declared with a
22299
+ * single string value is exposed as a single-element array.
22300
+ * Undefined when the sound definition does not specify any
22301
+ * tags.
22302
+ *
22303
+ */
22304
+ readonly tags?: Record<string, string[]>;
22305
+ }
22306
+
22307
+ /**
22308
+ * @beta
22309
+ * Provides read-only access to the sound definitions loaded
22310
+ * for the current world.
22311
+ */
22312
+ export class SoundDefinitionRegistry {
22313
+ private constructor();
22314
+ /**
22315
+ * @remarks
22316
+ * Returns the sound definitions in the registry, optionally
22317
+ * narrowed by a filter.
22318
+ *
22319
+ * @param filter
22320
+ * Optional filter applied to each definition. When omitted,
22321
+ * every definition is returned.
22322
+ * @returns
22323
+ * All sound definitions matching the filter, or every sound
22324
+ * definition when no filter is supplied.
22325
+ * @throws
22326
+ * An error will be thrown if filter.minDuration is greater
22327
+ * than filter.maxDuration.
22328
+ *
22329
+ * {@link minecraftcommon.InvalidArgumentError}
22330
+ */
22331
+ getDefinitions(filter?: SoundDefinitionFilter): SoundDefinition[];
22332
+ }
22333
+
22265
22334
  /**
22266
22335
  * @beta
22267
22336
  * Provides duration and playback information for a sound whose
@@ -22469,7 +22538,6 @@ export class StartupEvent {
22469
22538
  */
22470
22539
  readonly customCommandRegistry: CustomCommandRegistry;
22471
22540
  /**
22472
- * @rc
22473
22541
  * @remarks
22474
22542
  * This property can be read in early-execution mode.
22475
22543
  *
@@ -22725,7 +22793,6 @@ export class StructureManager {
22725
22793
  */
22726
22794
  get(identifier: string): Structure | undefined;
22727
22795
  /**
22728
- * @rc
22729
22796
  * @remarks
22730
22797
  * Returns a list of all structures contained in behavior
22731
22798
  * packs. Does not include structures saved to the world or in
@@ -23225,7 +23292,6 @@ export class TargetBlockHitAfterEventSignal {
23225
23292
  }
23226
23293
 
23227
23294
  /**
23228
- * @rc
23229
23295
  * A primitive shape class that represents a text label in the
23230
23296
  * world with a background.
23231
23297
  */
@@ -23598,7 +23664,6 @@ export class WatchdogTerminateBeforeEventSignal {
23598
23664
  }
23599
23665
 
23600
23666
  /**
23601
- * @rc
23602
23667
  * Base class for waypoints displayed on the player's locator
23603
23668
  * bar. Waypoints can track locations or entities and are
23604
23669
  * rendered with customizable textures and colors.
@@ -23867,7 +23932,6 @@ export class World {
23867
23932
  readonly gameRules: GameRules;
23868
23933
  readonly isHardcore: boolean;
23869
23934
  /**
23870
- * @rc
23871
23935
  * @remarks
23872
23936
  * Manager for adding and removing primitive text objects in
23873
23937
  * the world.
@@ -23887,6 +23951,14 @@ export class World {
23887
23951
  *
23888
23952
  */
23889
23953
  readonly seed: string;
23954
+ /**
23955
+ * @beta
23956
+ * @remarks
23957
+ * Provides read-only access to the sound definitions loaded
23958
+ * for this world.
23959
+ *
23960
+ */
23961
+ readonly soundDefinitionRegistry: SoundDefinitionRegistry;
23890
23962
  /**
23891
23963
  * @remarks
23892
23964
  * Returns the manager for {@link Structure} related APIs.
@@ -24108,7 +24180,6 @@ export class World {
24108
24180
  */
24109
24181
  getMoonPhase(): MoonPhase;
24110
24182
  /**
24111
- * @rc
24112
24183
  * @remarks
24113
24184
  * Returns a map of pack setting name and value pairs.
24114
24185
  *
@@ -24371,7 +24442,6 @@ export class World {
24371
24442
  export class WorldAfterEvents {
24372
24443
  private constructor();
24373
24444
  /**
24374
- * @rc
24375
24445
  * @remarks
24376
24446
  * This event fires when a block container is closed.
24377
24447
  *
@@ -24380,7 +24450,6 @@ export class WorldAfterEvents {
24380
24450
  */
24381
24451
  readonly blockContainerClosed: BlockContainerClosedAfterEventSignal;
24382
24452
  /**
24383
- * @rc
24384
24453
  * @remarks
24385
24454
  * This event fires when a block container is opened.
24386
24455
  *
@@ -24436,7 +24505,6 @@ export class WorldAfterEvents {
24436
24505
  */
24437
24506
  readonly effectAdd: EffectAddAfterEventSignal;
24438
24507
  /**
24439
- * @rc
24440
24508
  * @remarks
24441
24509
  * This event fires when an entity container is closed.
24442
24510
  *
@@ -24445,7 +24513,6 @@ export class WorldAfterEvents {
24445
24513
  */
24446
24514
  readonly entityContainerClosed: EntityContainerClosedAfterEventSignal;
24447
24515
  /**
24448
- * @rc
24449
24516
  * @remarks
24450
24517
  * This event fires when an entity container is opened.
24451
24518
  *
@@ -24570,7 +24637,6 @@ export class WorldAfterEvents {
24570
24637
  */
24571
24638
  readonly entityTamed: EntityTamedAfterEventSignal;
24572
24639
  /**
24573
- * @rc
24574
24640
  * @remarks
24575
24641
  * This property can be read in early-execution mode.
24576
24642
  *
@@ -24710,7 +24776,7 @@ export class WorldAfterEvents {
24710
24776
  */
24711
24777
  readonly playerButtonInput: PlayerButtonInputAfterEventSignal;
24712
24778
  /**
24713
- * @beta
24779
+ * @rc
24714
24780
  * @remarks
24715
24781
  * This event fires when a player cancels breaking a block.
24716
24782
  *
@@ -24824,7 +24890,7 @@ export class WorldAfterEvents {
24824
24890
  */
24825
24891
  readonly playerSpawn: PlayerSpawnAfterEventSignal;
24826
24892
  /**
24827
- * @beta
24893
+ * @rc
24828
24894
  * @remarks
24829
24895
  * This event fires when a player starts breaking a block.
24830
24896
  *
@@ -25159,7 +25225,7 @@ export interface BiomeFilter {
25159
25225
  }
25160
25226
 
25161
25227
  /**
25162
- * @beta
25228
+ * @rc
25163
25229
  * Contains additional options for searches for the
25164
25230
  * dimension.findNearestBiome API.
25165
25231
  */
@@ -25206,7 +25272,6 @@ export interface BlockBoundingBox {
25206
25272
  }
25207
25273
 
25208
25274
  /**
25209
- * @rc
25210
25275
  * Options used to filter block container access events.
25211
25276
  */
25212
25277
  export interface BlockContainerAccessEventOptions {
@@ -25238,9 +25303,6 @@ export interface BlockCustomComponent {
25238
25303
  *
25239
25304
  */
25240
25305
  beforeOnPlayerPlace?: (arg0: BlockComponentPlayerPlaceBeforeEvent, arg1: CustomComponentParameters) => void;
25241
- /**
25242
- * @rc
25243
- */
25244
25306
  onBlockStateChange?: (arg0: BlockComponentBlockStateChangeEvent, arg1: CustomComponentParameters) => void;
25245
25307
  /**
25246
25308
  * @remarks
@@ -25736,7 +25798,6 @@ export interface CompoundBlockVolumeItem {
25736
25798
  }
25737
25799
 
25738
25800
  /**
25739
- * @rc
25740
25801
  * Represents the source of a container access.
25741
25802
  */
25742
25803
  export interface ContainerAccessSource {
@@ -25749,7 +25810,6 @@ export interface ContainerAccessSource {
25749
25810
  }
25750
25811
 
25751
25812
  /**
25752
- * @rc
25753
25813
  * Options for use when filtering container access sources.
25754
25814
  */
25755
25815
  export interface ContainerAccessSourceFilter {
@@ -25888,9 +25948,6 @@ export interface CustomCommandResult {
25888
25948
  status: CustomCommandStatus;
25889
25949
  }
25890
25950
 
25891
- /**
25892
- * @rc
25893
- */
25894
25951
  export interface CustomTexture {
25895
25952
  /**
25896
25953
  * @remarks
@@ -26053,7 +26110,6 @@ export interface EntityApplyDamageOptions {
26053
26110
  }
26054
26111
 
26055
26112
  /**
26056
- * @rc
26057
26113
  * Options used to filter entity container access events.
26058
26114
  */
26059
26115
  export interface EntityContainerAccessEventOptions {
@@ -26764,7 +26820,6 @@ export interface EntityTamedEventFilter {
26764
26820
  }
26765
26821
 
26766
26822
  /**
26767
- * @rc
26768
26823
  * Controls when a waypoint is visible based on the state of
26769
26824
  * the entity it tracks. These rules allow filtering waypoint
26770
26825
  * visibility by entity conditions like sneaking, invisibility,
@@ -27270,7 +27325,7 @@ export interface PlayerAimAssistSettings {
27270
27325
  }
27271
27326
 
27272
27327
  /**
27273
- * @beta
27328
+ * @rc
27274
27329
  * An interface that is passed into {@link
27275
27330
  * PlayerStartBreakingBlockAfterEventSignal.subscribe} or
27276
27331
  * {@link PlayerCancelBreakingBlockAfterEventSignal.subscribe}
@@ -27360,7 +27415,6 @@ export interface PlayerSwingEventOptions {
27360
27415
  }
27361
27416
 
27362
27417
  /**
27363
- * @rc
27364
27418
  * Controls when a waypoint is visible based on player-specific
27365
27419
  * states. Extends {@link EntityVisibilityRules} with
27366
27420
  * additional rules for player-only states like hidden mode and
@@ -27713,6 +27767,136 @@ export interface ScriptEventMessageFilterOptions {
27713
27767
  namespaces: string[];
27714
27768
  }
27715
27769
 
27770
+ /**
27771
+ * @beta
27772
+ * Duration metadata declared in a sound definition.
27773
+ */
27774
+ export interface SoundDefinitionDurationInfo {
27775
+ /**
27776
+ * @remarks
27777
+ * Total duration of the sound in seconds, as declared in the
27778
+ * sound definition.
27779
+ *
27780
+ */
27781
+ duration: number;
27782
+ }
27783
+
27784
+ /**
27785
+ * @beta
27786
+ * Criteria used to narrow a set of sound definitions. Each
27787
+ * field is optional and applies its constraint only when
27788
+ * defined; a definition must satisfy every defined field to
27789
+ * pass.
27790
+ */
27791
+ export interface SoundDefinitionFilter {
27792
+ /**
27793
+ * @remarks
27794
+ * Artist names to match against the definition's
27795
+ * music_info.artist. Comparison is case-insensitive. When
27796
+ * defined as a non-empty array, a definition passes only when
27797
+ * its declared artist matches one of the supplied values. When
27798
+ * undefined, no constraint on artist is applied.
27799
+ *
27800
+ */
27801
+ artists?: string[];
27802
+ /**
27803
+ * @remarks
27804
+ * Genres to match against the definition's music_info.genres.
27805
+ * Comparison is case-insensitive. When defined as a non-empty
27806
+ * array, a definition passes only when at least one of its
27807
+ * declared genres matches one of the supplied values. When
27808
+ * undefined, no constraint on genres is applied.
27809
+ *
27810
+ */
27811
+ genres?: string[];
27812
+ /**
27813
+ * @remarks
27814
+ * Upper bound in seconds, inclusive. When defined, definitions
27815
+ * with a longer duration and definitions without a declared
27816
+ * duration are excluded. When undefined, no upper bound is
27817
+ * applied.
27818
+ *
27819
+ */
27820
+ maxDuration?: number;
27821
+ /**
27822
+ * @remarks
27823
+ * Lower bound in seconds, inclusive. When defined, definitions
27824
+ * with a shorter duration and definitions without a declared
27825
+ * duration are excluded. When undefined, no lower bound is
27826
+ * applied.
27827
+ *
27828
+ */
27829
+ minDuration?: number;
27830
+ /**
27831
+ * @remarks
27832
+ * Moods to match against the definition's music_info.moods.
27833
+ * Comparison is case-insensitive. When defined as a non-empty
27834
+ * array, a definition passes only when at least one of its
27835
+ * declared moods matches one of the supplied values. When
27836
+ * undefined, no constraint on moods is applied.
27837
+ *
27838
+ */
27839
+ moods?: string[];
27840
+ /**
27841
+ * @remarks
27842
+ * Tag constraints to match against the definition's tags.
27843
+ * Comparisons of tag names and values are case-insensitive.
27844
+ * When defined as a non-empty record, a definition passes only
27845
+ * when, for each entry with a non-empty value array, the tag
27846
+ * name is present on the definition with at least one matching
27847
+ * value. When undefined, no constraint on tags is applied.
27848
+ *
27849
+ */
27850
+ tags?: Record<string, string[]>;
27851
+ /**
27852
+ * @remarks
27853
+ * Titles to match against the definition's music_info.title.
27854
+ * Comparison is case-insensitive. When defined as a non-empty
27855
+ * array, a definition passes only when its declared title
27856
+ * matches one of the supplied values. When undefined, no
27857
+ * constraint on title is applied.
27858
+ *
27859
+ */
27860
+ titles?: string[];
27861
+ }
27862
+
27863
+ /**
27864
+ * @beta
27865
+ * Music metadata declared on a sound definition. Each field is
27866
+ * optional and is undefined when the sound definition does not
27867
+ * declare a value for it.
27868
+ */
27869
+ export interface SoundDefinitionMusicInfo {
27870
+ /**
27871
+ * @remarks
27872
+ * Artist declared for this sound. Undefined when no artist was
27873
+ * declared.
27874
+ *
27875
+ */
27876
+ artist?: string;
27877
+ /**
27878
+ * @remarks
27879
+ * Genres declared for this sound. Undefined when no genres
27880
+ * were declared.
27881
+ *
27882
+ */
27883
+ genres?: string[];
27884
+ /**
27885
+ * @remarks
27886
+ * Moods declared for this sound. Undefined when no moods were
27887
+ * declared.
27888
+ *
27889
+ */
27890
+ moods?: string[];
27891
+ /**
27892
+ * @remarks
27893
+ * Title declared for this sound. Undefined when no title was
27894
+ * declared.
27895
+ *
27896
+ */
27897
+ title?: string;
27898
+ }
27899
+
27716
27900
  /**
27717
27901
  * Contains additional options for spawning an Entity.
27718
27902
  */
@@ -28089,7 +28273,6 @@ export interface VectorXZ {
28089
28273
  }
28090
28274
 
28091
28275
  /**
28092
- * @rc
28093
28276
  * Defines a texture and the distance range in which it should
28094
28277
  * be displayed. Used within a {@link WaypointTextureSelector}
28095
28278
  * to create distance-based texture switching.
@@ -28124,7 +28307,6 @@ export interface WaypointTextureBounds {
28124
28307
  }
28125
28308
 
28126
28309
  /**
28127
- * @rc
28128
28310
  * Defines how waypoint textures change based on distance.
28129
28311
  * Contains a list of texture bounds that determine which
28130
28312
  * texture is displayed at different distance ranges.
@@ -28291,7 +28473,6 @@ export class CustomComponentNameError extends Error {
28291
28473
  }
28292
28474
 
28293
28475
  /**
28294
- * @rc
28295
28476
  * Thrown when trying to register a custom dimension with a
28296
28477
  * name that has already been registered.
28297
28478
  */
@@ -28301,7 +28482,6 @@ export class CustomDimensionAlreadyRegisteredError extends Error {
28301
28482
  }
28302
28483
 
28303
28484
  /**
28304
- * @rc
28305
28485
  * Thrown when trying to register a custom dimension outside of
28306
28486
  * the system startup event.
28307
28487
  */
@@ -28311,7 +28491,6 @@ export class CustomDimensionInvalidRegistryError extends Error {
28311
28491
  }
28312
28492
 
28313
28493
  /**
28314
- * @rc
28315
28494
  * Thrown when trying to register a custom dimension with a
28316
28495
  * name that contains invalid characters.
28317
28496
  */
@@ -28321,7 +28500,6 @@ export class CustomDimensionNameError extends Error {
28321
28500
  }
28322
28501
 
28323
28502
  /**
28324
- * @rc
28325
28503
  * Thrown after using the /reload command when trying to
28326
28504
  * register a custom dimension that was not previously
28327
28505
  * registered. New custom dimensions cannot be added during a
@@ -28467,7 +28645,6 @@ export class InvalidStructureError extends Error {
28467
28645
  }
28468
28646
 
28469
28647
  /**
28470
- * @rc
28471
28648
  * Error thrown when attempting to perform operations on an
28472
28649
  * invalid waypoint. A waypoint becomes invalid when it is
28473
28650
  * removed or when the entity it tracks is no longer valid.
@@ -28477,9 +28654,6 @@ export class InvalidWaypointError extends Error {
28477
28654
  private constructor();
28478
28655
  }
28479
28656
 
28480
- /**
28481
- * @rc
28482
- */
28483
28657
  // @ts-ignore Class inheritance allowed for native defined classes
28484
28658
  export class InvalidWaypointTextureSelectorError extends Error {
28485
28659
  private constructor();
@@ -28542,7 +28716,6 @@ export class LocationOutOfWorldBoundariesError extends Error {
28542
28716
  }
28543
28717
 
28544
28718
  /**
28545
- * @rc
28546
28719
  * Error thrown when a locator bar operation fails. Contains a
28547
28720
  * reason code indicating the specific cause of the error.
28548
28721
  */
@@ -28580,9 +28753,6 @@ export class PlaceJigsawError extends Error {
28580
28753
  private constructor();
28581
28754
  }
28582
28755
 
28583
- /**
28584
- * @rc
28585
- */
28586
28756
  // @ts-ignore Class inheritance allowed for native defined classes
28587
28757
  export class PrimitiveShapeError extends Error {
28588
28758
  private constructor();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@minecraft/server",
3
- "version": "2.10.0-beta.1.26.40-preview.24",
3
+ "version": "2.10.0-beta.1.26.40-preview.29",
4
4
  "description": "",
5
5
  "contributors": [
6
6
  {
@@ -14,7 +14,7 @@
14
14
  ],
15
15
  "peerDependencies": {
16
16
  "@minecraft/common": "^1.2.0",
17
- "@minecraft/vanilla-data": ">=1.20.70 || 1.26.40-preview.24"
17
+ "@minecraft/vanilla-data": ">=1.20.70 || 1.26.40-preview.29"
18
18
  },
19
19
  "license": "MIT"
20
20
  }