@minecraft/server 2.13.0-beta.1.26.70-preview.20 → 2.13.0-beta.1.26.70-preview.22

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 +224 -67
  2. package/package.json +2 -2
package/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  // Type definitions for Minecraft Bedrock Edition script APIs
2
- // Project: https://docs.microsoft.com/minecraft/creator/
2
+ // Project: https://learn.microsoft.com/minecraft/creator/
3
3
  // Definitions by: Jake Shirley <https://github.com/JakeShirley>
4
- // Mike Ammerlaan <https://github.com/mammerla>
4
+ // Raphael Landaverde <https://github.com/rlandav>
5
5
 
6
6
  /* *****************************************************************************
7
7
  Copyright (c) Microsoft Corporation.
@@ -61,6 +61,14 @@ export enum BlockComponentTypes {
61
61
  *
62
62
  */
63
63
  Inventory = 'minecraft:inventory',
64
+ /**
65
+ * @beta
66
+ * @remarks
67
+ * Represents an item frame block and provides access to the
68
+ * item displayed in the frame.
69
+ *
70
+ */
71
+ ItemFrame = 'minecraft:item_frame',
64
72
  /**
65
73
  * @remarks
66
74
  * Represents the color of a block when displayed on a map.
@@ -2152,6 +2160,13 @@ export enum InputMode {
2152
2160
  *
2153
2161
  */
2154
2162
  Gamepad = 'Gamepad',
2163
+ /**
2164
+ * @rc
2165
+ * @remarks
2166
+ * Gamepad and mouse input.
2167
+ *
2168
+ */
2169
+ GamepadAndMouse = 'GamepadAndMouse',
2155
2170
  /**
2156
2171
  * @remarks
2157
2172
  * Keyboard and mouse input.
@@ -2261,7 +2276,7 @@ export enum InputPermissionCategory {
2261
2276
  * function ItemStack.getComponent.
2262
2277
  */
2263
2278
  export enum ItemComponentTypes {
2264
- BlockDynamicProperties = 'minecraft:block_actor_dynamic_properties',
2279
+ BlockDynamicProperties = 'minecraft:block_dynamic_properties',
2265
2280
  /**
2266
2281
  * @beta
2267
2282
  */
@@ -2302,6 +2317,62 @@ export enum ItemComponentTypes {
2302
2317
  Potion = 'minecraft:potion',
2303
2318
  }
2304
2319
 
2320
+ /**
2321
+ * @beta
2322
+ * Specifies the rotation of the item displayed in an item
2323
+ * frame.
2324
+ */
2325
+ export enum ItemFrameRotation {
2326
+ /**
2327
+ * @remarks
2328
+ * The displayed item is rotated 135 degrees clockwise.
2329
+ *
2330
+ */
2331
+ Clockwise135 = 'Clockwise135',
2332
+ /**
2333
+ * @remarks
2334
+ * The displayed item is rotated 180 degrees clockwise.
2335
+ *
2336
+ */
2337
+ Clockwise180 = 'Clockwise180',
2338
+ /**
2339
+ * @remarks
2340
+ * The displayed item is rotated 225 degrees clockwise.
2341
+ *
2342
+ */
2343
+ Clockwise225 = 'Clockwise225',
2344
+ /**
2345
+ * @remarks
2346
+ * The displayed item is rotated 270 degrees clockwise.
2347
+ *
2348
+ */
2349
+ Clockwise270 = 'Clockwise270',
2350
+ /**
2351
+ * @remarks
2352
+ * The displayed item is rotated 315 degrees clockwise.
2353
+ *
2354
+ */
2355
+ Clockwise315 = 'Clockwise315',
2356
+ /**
2357
+ * @remarks
2358
+ * The displayed item is rotated 45 degrees clockwise.
2359
+ *
2360
+ */
2361
+ Clockwise45 = 'Clockwise45',
2362
+ /**
2363
+ * @remarks
2364
+ * The displayed item is rotated 90 degrees clockwise.
2365
+ *
2366
+ */
2367
+ Clockwise90 = 'Clockwise90',
2368
+ /**
2369
+ * @remarks
2370
+ * The displayed item has no additional rotation.
2371
+ *
2372
+ */
2373
+ None = 'None',
2374
+ }
2375
+
2305
2376
  /**
2306
2377
  * Describes how an an item can be moved within a container.
2307
2378
  */
@@ -2771,7 +2842,7 @@ export enum PlayerWaypointsMode {
2771
2842
  }
2772
2843
 
2773
2844
  /**
2774
- * @beta
2845
+ * @rc
2775
2846
  * Specifies how a block point-of-interest query filters
2776
2847
  * instances by ticket occupancy.
2777
2848
  */
@@ -3212,12 +3283,14 @@ export type BlockComponentTypeMap = {
3212
3283
  fluid_container: BlockFluidContainerComponent;
3213
3284
  instrument_sound: BlockInstrumentComponent;
3214
3285
  inventory: BlockInventoryComponent;
3286
+ item_frame: BlockItemFrameComponent;
3215
3287
  map_color: BlockMapColorComponent;
3216
3288
  'minecraft:dynamic_properties': BlockDynamicPropertiesComponent;
3217
3289
  'minecraft:entity_storage': BlockEntityStorageComponent;
3218
3290
  'minecraft:fluid_container': BlockFluidContainerComponent;
3219
3291
  'minecraft:instrument_sound': BlockInstrumentComponent;
3220
3292
  'minecraft:inventory': BlockInventoryComponent;
3293
+ 'minecraft:item_frame': BlockItemFrameComponent;
3221
3294
  'minecraft:map_color': BlockMapColorComponent;
3222
3295
  'minecraft:movable': BlockMovableComponent;
3223
3296
  'minecraft:piston': BlockPistonComponent;
@@ -3408,7 +3481,7 @@ export type ItemComponentReturnType<T extends string> = T extends keyof ItemComp
3408
3481
  : ItemCustomComponentInstance;
3409
3482
 
3410
3483
  export type ItemComponentTypeMap = {
3411
- block_actor_dynamic_properties: ItemBlockDynamicPropertiesComponent;
3484
+ block_dynamic_properties: ItemBlockDynamicPropertiesComponent;
3412
3485
  block_entity_storage: ItemBlockEntityStorageComponent;
3413
3486
  book: ItemBookComponent;
3414
3487
  compostable: ItemCompostableComponent;
@@ -3418,7 +3491,7 @@ export type ItemComponentTypeMap = {
3418
3491
  enchantable: ItemEnchantableComponent;
3419
3492
  food: ItemFoodComponent;
3420
3493
  inventory: ItemInventoryComponent;
3421
- 'minecraft:block_actor_dynamic_properties': ItemBlockDynamicPropertiesComponent;
3494
+ 'minecraft:block_dynamic_properties': ItemBlockDynamicPropertiesComponent;
3422
3495
  'minecraft:block_entity_storage': ItemBlockEntityStorageComponent;
3423
3496
  'minecraft:book': ItemBookComponent;
3424
3497
  'minecraft:compostable': ItemCompostableComponent;
@@ -5920,6 +5993,79 @@ export class BlockInventoryComponent extends BlockComponent {
5920
5993
  static readonly componentId = 'minecraft:inventory';
5921
5994
  }
5922
5995
 
5996
+ /**
5997
+ * @beta
5998
+ * Represents the frame holding an item of a block in the
5999
+ * world. You can replace the item, remove it, drop it into the
6000
+ * world, or get and set its rotation.
6001
+ */
6002
+ // @ts-ignore Class inheritance allowed for native defined classes
6003
+ export class BlockItemFrameComponent extends BlockComponent {
6004
+ private constructor();
6005
+ static readonly componentId = 'minecraft:item_frame';
6006
+ /**
6007
+ * @remarks
6008
+ * Removes the framed item and drops it into the world.
6009
+ *
6010
+ * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
6011
+ *
6012
+ * @throws This function can throw errors.
6013
+ *
6014
+ * {@link InvalidBlockComponentError}
6015
+ */
6016
+ dropFramedItem(): void;
6017
+ /**
6018
+ * @remarks
6019
+ * Gets the item stack currently displayed in the frame.
6020
+ *
6021
+ * @returns
6022
+ * The framed item stack, or undefined if the frame is empty.
6023
+ * @throws This function can throw errors.
6024
+ *
6025
+ * {@link InvalidBlockComponentError}
6026
+ */
6027
+ getFramedItem(): ItemStack | undefined;
6028
+ /**
6029
+ * @remarks
6030
+ * Gets the current rotation of the item frame.
6031
+ *
6032
+ * @returns
6033
+ * The current {@link ItemFrameRotation} of the item frame.
6034
+ * @throws This function can throw errors.
6035
+ *
6036
+ * {@link InvalidBlockComponentError}
6037
+ */
6038
+ getRotation(): ItemFrameRotation;
6039
+ /**
6040
+ * @remarks
6041
+ * Sets or replaces the item displayed in the frame. Pass
6042
+ * undefined to remove the item without dropping it.
6043
+ *
6044
+ * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
6045
+ *
6046
+ * @param itemStack
6047
+ * The item stack to display in the frame, or undefined to
6048
+ * clear it without dropping it.
6049
+ * @throws This function can throw errors.
6050
+ *
6051
+ * {@link InvalidBlockComponentError}
6052
+ */
6053
+ setFramedItem(itemStack?: ItemStack): void;
6054
+ /**
6055
+ * @remarks
6056
+ * Sets the rotation of the item frame.
6057
+ *
6058
+ * @privilege no-restricted-execution - This function can't be called in restricted-execution mode.
6059
+ *
6060
+ * @param rotation
6061
+ * The {@link ItemFrameRotation} to apply to the item frame.
6062
+ * @throws This function can throw errors.
6063
+ *
6064
+ * {@link InvalidBlockComponentError}
6065
+ */
6066
+ setRotation(rotation: ItemFrameRotation): void;
6067
+ }
6068
+
5923
6069
  /**
5924
6070
  * A BlockLocationIterator returns the next block location of
5925
6071
  * the block volume across which it is iterating.
@@ -8664,7 +8810,7 @@ export class Dimension {
8664
8810
  */
8665
8811
  readonly localizationKey: string;
8666
8812
  /**
8667
- * @beta
8813
+ * @rc
8668
8814
  * @remarks
8669
8815
  * Provides access to point-of-interest (POI) managers for this
8670
8816
  * dimension. This property is available only when the POI
@@ -8945,7 +9091,7 @@ export class Dimension {
8945
9091
  * The options to decide if a block is a valid result.
8946
9092
  * @throws This function can throw errors.
8947
9093
  */
8948
- getBlockAbove(location: Vector3, options?: BlockRaycastOptions): Block | undefined;
9094
+ getBlockAbove(location: Vector3, options?: BlockSearchOptions): Block | undefined;
8949
9095
  /**
8950
9096
  * @remarks
8951
9097
  * Gets the first block found below a given block location
@@ -8958,7 +9104,7 @@ export class Dimension {
8958
9104
  * The options to decide if a block is a valid result.
8959
9105
  * @throws This function can throw errors.
8960
9106
  */
8961
- getBlockBelow(location: Vector3, options?: BlockRaycastOptions): Block | undefined;
9107
+ getBlockBelow(location: Vector3, options?: BlockSearchOptions): Block | undefined;
8962
9108
  /**
8963
9109
  * @remarks
8964
9110
  * Gets the first block that intersects with a vector emanating
@@ -9552,7 +9698,6 @@ export class Dimension {
9552
9698
  */
9553
9699
  spawnParticle(effectName: string, location: Vector3, molangVariables?: MolangVariableMap): void;
9554
9700
  /**
9555
- * @rc
9556
9701
  * @remarks
9557
9702
  * Spawns an experience orb at a specified location in the
9558
9703
  * dimension.
@@ -12742,7 +12887,6 @@ export class EntityIsStunnedComponent extends EntityComponent {
12742
12887
  export class EntityIsTamedComponent extends EntityComponent {
12743
12888
  private constructor();
12744
12889
  /**
12745
- * @rc
12746
12890
  * @remarks
12747
12891
  * Returns the player that has tamed the entity, or 'undefined'
12748
12892
  * if the entity has no player owner.
@@ -12753,7 +12897,6 @@ export class EntityIsTamedComponent extends EntityComponent {
12753
12897
  */
12754
12898
  readonly tamedToPlayer?: Player;
12755
12899
  /**
12756
- * @rc
12757
12900
  * @remarks
12758
12901
  * Returns the id of the player that has tamed the entity, or
12759
12902
  * 'undefined' if the entity has no player owner.
@@ -15490,7 +15633,7 @@ export class ISerializable {
15490
15633
  // @ts-ignore Class inheritance allowed for native defined classes
15491
15634
  export class ItemBlockDynamicPropertiesComponent extends ItemComponent {
15492
15635
  private constructor();
15493
- static readonly componentId = 'minecraft:block_actor_dynamic_properties';
15636
+ static readonly componentId = 'minecraft:block_dynamic_properties';
15494
15637
  /**
15495
15638
  * @remarks
15496
15639
  * Returns a DynamicProperty that was stored with the provided
@@ -21398,7 +21541,7 @@ export class PlayerWaypoint extends EntityWaypoint {
21398
21541
  }
21399
21542
 
21400
21543
  /**
21401
- * @beta
21544
+ * @rc
21402
21545
  * Describes a block point-of-interest instance returned by a
21403
21546
  * query.
21404
21547
  */
@@ -21426,7 +21569,7 @@ export class PoiBlockInstance {
21426
21569
  }
21427
21570
 
21428
21571
  /**
21429
- * @beta
21572
+ * @rc
21430
21573
  * Provides methods for querying and managing block-based
21431
21574
  * points of interest in a dimension.
21432
21575
  */
@@ -21615,7 +21758,7 @@ export class PoiBlockManager {
21615
21758
  }
21616
21759
 
21617
21760
  /**
21618
- * @beta
21761
+ * @rc
21619
21762
  * Describes a block point-of-interest type.
21620
21763
  */
21621
21764
  export class PoiBlockType {
@@ -21675,7 +21818,7 @@ export class PoiBlockType {
21675
21818
  }
21676
21819
 
21677
21820
  /**
21678
- * @beta
21821
+ * @rc
21679
21822
  * Provides access to point-of-interest (POI) data in a
21680
21823
  * dimension.
21681
21824
  */
@@ -21911,7 +22054,13 @@ export class PrimitiveShape {
21911
22054
  */
21912
22055
  color: RGBA;
21913
22056
  /**
21914
- * @beta
22057
+ * @rc
22058
+ * @remarks
22059
+ * Defaults to true. If set to true, we default to being
22060
+ * visible to all players if visibleTo is empty - hiddenFrom
22061
+ * still applies afterwards. If set to false, we default to
22062
+ * hiding the shape from all players if visibleTo is empty.
22063
+ *
21915
22064
  */
21916
22065
  defaultVisibleToAll: boolean;
21917
22066
  /**
@@ -21929,7 +22078,12 @@ export class PrimitiveShape {
21929
22078
  */
21930
22079
  readonly hasDuration: boolean;
21931
22080
  /**
21932
- * @beta
22081
+ * @rc
22082
+ * @remarks
22083
+ * The list of players that this shape will be hidden from. If
22084
+ * a player is listed in both this and visibleTo, this takes
22085
+ * priority (it will be hidden from the player).
22086
+ *
21933
22087
  */
21934
22088
  hiddenFrom: Player[];
21935
22089
  /**
@@ -23598,7 +23752,6 @@ export class SoundInstance {
23598
23752
  */
23599
23753
  readonly soundEventId: string;
23600
23754
  /**
23601
- * @rc
23602
23755
  * @remarks
23603
23756
  * Fades this sound instance from its current volume multiplier
23604
23757
  * to the target multiplier over the specified duration. Volume
@@ -23618,7 +23771,6 @@ export class SoundInstance {
23618
23771
  */
23619
23772
  fade(duration: number, targetVolume: number): void;
23620
23773
  /**
23621
- * @rc
23622
23774
  * @remarks
23623
23775
  * Pauses this sound.
23624
23776
  *
@@ -23627,7 +23779,6 @@ export class SoundInstance {
23627
23779
  */
23628
23780
  pause(): void;
23629
23781
  /**
23630
- * @rc
23631
23782
  * @remarks
23632
23783
  * Resumes this sound after a pause.
23633
23784
  *
@@ -23636,7 +23787,6 @@ export class SoundInstance {
23636
23787
  */
23637
23788
  resume(): void;
23638
23789
  /**
23639
- * @rc
23640
23790
  * @remarks
23641
23791
  * Sets the playback position of this sound instance.
23642
23792
  *
@@ -23653,7 +23803,6 @@ export class SoundInstance {
23653
23803
  */
23654
23804
  seekTo(seconds: number): void;
23655
23805
  /**
23656
- * @rc
23657
23806
  * @remarks
23658
23807
  * Sets the pitch of this sound instance.
23659
23808
  *
@@ -23666,7 +23815,6 @@ export class SoundInstance {
23666
23815
  */
23667
23816
  setPitch(pitch: number): void;
23668
23817
  /**
23669
- * @rc
23670
23818
  * @remarks
23671
23819
  * Sets the volume multiplier of this sound instance relative
23672
23820
  * to the volume of the selected sound variant.
@@ -23752,7 +23900,6 @@ export class StartupEvent {
23752
23900
  */
23753
23901
  readonly itemComponentRegistry: ItemComponentRegistry;
23754
23902
  /**
23755
- * @rc
23756
23903
  * @remarks
23757
23904
  * @privilege early-execution-readable - This property can be read in early-execution mode.
23758
23905
  *
@@ -24531,7 +24678,6 @@ export class TextPrimitive extends PrimitiveShape {
24531
24678
  */
24532
24679
  depthTest: boolean;
24533
24680
  /**
24534
- * @rc
24535
24681
  * @remarks
24536
24682
  * This value determines the gap between lines for the
24537
24683
  * TextPrimitive. By default the line gap height is 0.
@@ -24679,7 +24825,6 @@ export class TickingAreaManager {
24679
24825
  }
24680
24826
 
24681
24827
  /**
24682
- * @rc
24683
24828
  * A named point in time on a world clock that can occur once
24684
24829
  * or periodically.
24685
24830
  */
@@ -25274,7 +25419,6 @@ export class World {
25274
25419
  */
25275
25420
  getAllPlayers(): Player[];
25276
25421
  /**
25277
- * @rc
25278
25422
  * @remarks
25279
25423
  * Retrieves a world clock by its name.
25280
25424
  *
@@ -26280,7 +26424,6 @@ export class WorldAfterEvents {
26280
26424
  */
26281
26425
  readonly weatherChange: WeatherChangeAfterEventSignal;
26282
26426
  /**
26283
- * @rc
26284
26427
  * @remarks
26285
26428
  * This event fires when a {@link WorldClock} is paused.
26286
26429
  *
@@ -26289,7 +26432,6 @@ export class WorldAfterEvents {
26289
26432
  */
26290
26433
  readonly worldClockOnPaused: WorldClockOnPausedAfterEventSignal;
26291
26434
  /**
26292
- * @rc
26293
26435
  * @remarks
26294
26436
  * This event fires when a {@link WorldClock} is resumed.
26295
26437
  *
@@ -26298,7 +26440,6 @@ export class WorldAfterEvents {
26298
26440
  */
26299
26441
  readonly worldClockOnResumed: WorldClockOnResumedAfterEventSignal;
26300
26442
  /**
26301
- * @rc
26302
26443
  * @remarks
26303
26444
  * This event fires when the time of a {@link WorldClock} hits
26304
26445
  * a {@link TimeMarker} on the clock. This can happen during a
@@ -26309,7 +26450,6 @@ export class WorldAfterEvents {
26309
26450
  */
26310
26451
  readonly worldClockOnTimeMarker: WorldClockOnTimeMarkerAfterEventSignal;
26311
26452
  /**
26312
- * @rc
26313
26453
  * @remarks
26314
26454
  * This event fires when a {@link WorldClock} time is changed.
26315
26455
  * This can happen when the time is directly set through
@@ -26498,7 +26638,6 @@ export class WorldBeforeEvents {
26498
26638
  */
26499
26639
  readonly weatherChange: WeatherChangeBeforeEventSignal;
26500
26640
  /**
26501
- * @rc
26502
26641
  * @remarks
26503
26642
  * This event fires when a {@link WorldClock} reaches its
26504
26643
  * maximum time and is about to restart.
@@ -26510,7 +26649,6 @@ export class WorldBeforeEvents {
26510
26649
  }
26511
26650
 
26512
26651
  /**
26513
- * @rc
26514
26652
  * A class that represents a particular clock within a world.
26515
26653
  */
26516
26654
  export class WorldClock {
@@ -26637,7 +26775,6 @@ export class WorldClock {
26637
26775
  }
26638
26776
 
26639
26777
  /**
26640
- * @rc
26641
26778
  * Contains information related to a {@link WorldClock} being
26642
26779
  * paused.
26643
26780
  */
@@ -26652,7 +26789,6 @@ export class WorldClockOnPausedAfterEvent {
26652
26789
  }
26653
26790
 
26654
26791
  /**
26655
- * @rc
26656
26792
  * Manages callbacks that are connected to a {@link WorldClock}
26657
26793
  * being paused.
26658
26794
  */
@@ -26686,7 +26822,6 @@ export class WorldClockOnPausedAfterEventSignal {
26686
26822
  }
26687
26823
 
26688
26824
  /**
26689
- * @rc
26690
26825
  * Contains information related to a {@link WorldClock}
26691
26826
  * restarting.
26692
26827
  */
@@ -26717,7 +26852,6 @@ export class WorldClockOnRestartBeforeEvent {
26717
26852
  }
26718
26853
 
26719
26854
  /**
26720
- * @rc
26721
26855
  * Manages callbacks that are connected to a {@link WorldClock}
26722
26856
  * restarting.
26723
26857
  */
@@ -26757,7 +26891,6 @@ export class WorldClockOnRestartBeforeEventSignal {
26757
26891
  }
26758
26892
 
26759
26893
  /**
26760
- * @rc
26761
26894
  * Contains information related to a {@link WorldClock} being
26762
26895
  * resumed.
26763
26896
  */
@@ -26772,7 +26905,6 @@ export class WorldClockOnResumedAfterEvent {
26772
26905
  }
26773
26906
 
26774
26907
  /**
26775
- * @rc
26776
26908
  * Manages callbacks that are connected to a {@link WorldClock}
26777
26909
  * being resumed.
26778
26910
  */
@@ -26806,7 +26938,6 @@ export class WorldClockOnResumedAfterEventSignal {
26806
26938
  }
26807
26939
 
26808
26940
  /**
26809
- * @rc
26810
26941
  * Contains information related to when the time of a
26811
26942
  * {@link WorldClock} hits a {@link TimeMarker}.
26812
26943
  */
@@ -26827,7 +26958,6 @@ export class WorldClockOnTimeMarkerAfterEvent {
26827
26958
  }
26828
26959
 
26829
26960
  /**
26830
- * @rc
26831
26961
  * Manages callbacks that are connected to when the time of a
26832
26962
  * {@link WorldClock} hits a {@link TimeMarker}.
26833
26963
  */
@@ -26861,7 +26991,6 @@ export class WorldClockOnTimeMarkerAfterEventSignal {
26861
26991
  }
26862
26992
 
26863
26993
  /**
26864
- * @rc
26865
26994
  * Contains information related to changes to the time of a
26866
26995
  * {@link WorldClock}.
26867
26996
  */
@@ -26876,7 +27005,6 @@ export class WorldClockOnTimeModifiedAfterEvent {
26876
27005
  }
26877
27006
 
26878
27007
  /**
26879
- * @rc
26880
27008
  * Manages callbacks that are connected to changes to the time
26881
27009
  * of a {@link WorldClock}.
26882
27010
  */
@@ -26910,7 +27038,6 @@ export class WorldClockOnTimeModifiedAfterEventSignal {
26910
27038
  }
26911
27039
 
26912
27040
  /**
26913
- * @rc
26914
27041
  * Provides the functionality for registering custom world
26915
27042
  * clocks. World clocks can only be registered during the
26916
27043
  * system startup event.
@@ -27379,7 +27506,43 @@ export interface BlockRaycastOptions extends BlockFilter {
27379
27506
  includePassableBlocks?: boolean;
27380
27507
  /**
27381
27508
  * @remarks
27382
- * Maximum distance, in blocks, to process the raycast.
27509
+ * Maximum raycast distance, in blocks.
27510
+ *
27511
+ * Bounds: [-2147483648, 2147483647]
27512
+ */
27513
+ maxDistance?: number;
27514
+ /**
27515
+ * @beta
27516
+ * @remarks
27517
+ * When true, keeps fractional distances and checks the full
27518
+ * ray. Defaults to false.
27519
+ *
27520
+ */
27521
+ usePreciseRaycast?: boolean;
27522
+ }
27523
+
27524
+ /**
27525
+ * Options for finding blocks.
27526
+ */
27527
+ // @ts-ignore Class inheritance allowed for native defined classes
27528
+ export interface BlockSearchOptions extends BlockFilter {
27529
+ /**
27530
+ * @remarks
27531
+ * When true, includes liquid blocks.
27532
+ *
27533
+ */
27534
+ includeLiquidBlocks?: boolean;
27535
+ /**
27536
+ * @remarks
27537
+ * When true, includes passable blocks, such as vines and
27538
+ * flowers.
27539
+ *
27540
+ */
27541
+ includePassableBlocks?: boolean;
27542
+ /**
27543
+ * @remarks
27544
+ * Maximum search distance, in blocks. Vertical searches use
27545
+ * whole blocks.
27383
27546
  *
27384
27547
  */
27385
27548
  maxDistance?: number;
@@ -28558,10 +28721,20 @@ export interface EntityRaycastOptions extends EntityFilter {
28558
28721
  includePassableBlocks?: boolean;
28559
28722
  /**
28560
28723
  * @remarks
28561
- * Maximum distance, in blocks, to process the raycast.
28724
+ * Maximum raycast distance, in blocks.
28562
28725
  *
28726
+ * Bounds: [-2147483648, 2147483647]
28563
28727
  */
28564
28728
  maxDistance?: number;
28729
+ /**
28730
+ * @beta
28731
+ * @remarks
28732
+ * When true, keeps fractional distances and checks the full
28733
+ * ray. Defaults to false. When true, negative distances throw
28734
+ * InvalidArgumentError.
28735
+ *
28736
+ */
28737
+ usePreciseRaycast?: boolean;
28565
28738
  }
28566
28739
 
28567
28740
  /**
@@ -29179,7 +29352,6 @@ export interface PlayerSoundOptions {
29179
29352
  */
29180
29353
  location?: Vector3;
29181
29354
  /**
29182
- * @rc
29183
29355
  * @remarks
29184
29356
  * Number of additional times to repeat the sound after the
29185
29357
  * initial play. `0` (the default) plays the sound once, `-1`
@@ -29263,7 +29435,7 @@ export interface PlayerVisibilityRules extends EntityVisibilityRules {
29263
29435
  }
29264
29436
 
29265
29437
  /**
29266
- * @beta
29438
+ * @rc
29267
29439
  * Associates a block point-of-interest instance with its
29268
29440
  * squared distance from a query center.
29269
29441
  */
@@ -29284,7 +29456,7 @@ export interface PoiDistancePair {
29284
29456
  }
29285
29457
 
29286
29458
  /**
29287
- * @beta
29459
+ * @rc
29288
29460
  * Selects block point-of-interest types by their exact
29289
29461
  * namespaced identifier.
29290
29462
  */
@@ -29298,7 +29470,7 @@ export interface PoiNameFilter {
29298
29470
  }
29299
29471
 
29300
29472
  /**
29301
- * @beta
29473
+ * @rc
29302
29474
  * Selects block point-of-interest types that have all
29303
29475
  * specified tags.
29304
29476
  */
@@ -30096,7 +30268,6 @@ export interface TickingAreaOptions {
30096
30268
  }
30097
30269
 
30098
30270
  /**
30099
- * @rc
30100
30271
  * Options for creating time markers for world clocks.
30101
30272
  */
30102
30273
  export interface TimeMarkerOptions {
@@ -30264,7 +30435,6 @@ export interface WaypointTextureSelector {
30264
30435
  }
30265
30436
 
30266
30437
  /**
30267
- * @rc
30268
30438
  * Contains parameters for world clock events that filters out
30269
30439
  * which events are passed to the provided callback.
30270
30440
  */
@@ -30278,7 +30448,6 @@ export interface WorldClockEventOptions {
30278
30448
  }
30279
30449
 
30280
30450
  /**
30281
- * @rc
30282
30451
  * Contains additional options for registering world clocks.
30283
30452
  */
30284
30453
  export interface WorldClockRegistrationOptions {
@@ -30292,7 +30461,6 @@ export interface WorldClockRegistrationOptions {
30292
30461
  }
30293
30462
 
30294
30463
  /**
30295
- * @rc
30296
30464
  * Contains parameters for world clock time marker events that
30297
30465
  * filters out which events are passed to the provided
30298
30466
  * callback.
@@ -30320,7 +30488,6 @@ export interface WorldClockTimeMarkerEventOptions {
30320
30488
  export interface WorldSoundOptions {
30321
30489
  isBroadcast?: boolean;
30322
30490
  /**
30323
- * @rc
30324
30491
  * @remarks
30325
30492
  * Number of additional times to repeat the sound after the
30326
30493
  * initial play. `0` (the default) plays the sound once, `-1`
@@ -30797,7 +30964,6 @@ export class UnloadedChunksError extends Error {
30797
30964
  }
30798
30965
 
30799
30966
  /**
30800
- * @rc
30801
30967
  * Error thrown by {@link WorldClock.addTimeMarker} when
30802
30968
  * failing to add a time marker to a world clock.
30803
30969
  */
@@ -30807,7 +30973,6 @@ export class WorldClockAddTimeMarkerError extends Error {
30807
30973
  }
30808
30974
 
30809
30975
  /**
30810
- * @rc
30811
30976
  * Thrown when trying to register a world clock outside of the
30812
30977
  * system startup event.
30813
30978
  */
@@ -30817,7 +30982,6 @@ export class WorldClockInvalidRegistryError extends Error {
30817
30982
  }
30818
30983
 
30819
30984
  /**
30820
- * @rc
30821
30985
  * Error thrown when a time marker is invalid. This can occur
30822
30986
  * when trying to access data on a time marker that has been
30823
30987
  * removed.
@@ -30828,7 +30992,6 @@ export class WorldClockInvalidTimeMarkerError extends Error {
30828
30992
  }
30829
30993
 
30830
30994
  /**
30831
- * @rc
30832
30995
  * Error thrown when a world clock is not found in the world
30833
30996
  * clock registry.
30834
30997
  */
@@ -30838,7 +31001,6 @@ export class WorldClockNotFoundError extends Error {
30838
31001
  }
30839
31002
 
30840
31003
  /**
30841
- * @rc
30842
31004
  * Error thrown by {@link WorldClockRegistry.registerClock}
30843
31005
  * when failing to register a world clock.
30844
31006
  */
@@ -30848,7 +31010,6 @@ export class WorldClockRegistrationError extends Error {
30848
31010
  }
30849
31011
 
30850
31012
  /**
30851
- * @rc
30852
31013
  * Thrown after using the /reload command when trying to
30853
31014
  * register a world clock that was not previously registered.
30854
31015
  * New world clocks cannot be added during a reload.
@@ -30859,7 +31020,6 @@ export class WorldClockReloadNewWorldClockError extends Error {
30859
31020
  }
30860
31021
 
30861
31022
  /**
30862
- * @rc
30863
31023
  * Error thrown after using the /reload command when trying to
30864
31024
  * re-register an existing world clock with an invalid time
30865
31025
  * marker.
@@ -30870,7 +31030,6 @@ export class WorldClockReloadTimeMarkerError extends Error {
30870
31030
  }
30871
31031
 
30872
31032
  /**
30873
- * @rc
30874
31033
  * Error thrown by {@link WorldClock.removeTimeMarker} when
30875
31034
  * trying to remove a time marker with the 'minecraft'
30876
31035
  * namespace from a world clock.
@@ -30881,7 +31040,6 @@ export class WorldClockRemoveMinecraftTimeMarkerError extends Error {
30881
31040
  }
30882
31041
 
30883
31042
  /**
30884
- * @rc
30885
31043
  * Error thrown by {@link WorldClock.rewindTo} when the world
30886
31044
  * clock's time is already before the time marker's first
30887
31045
  * occurrence.
@@ -30892,7 +31050,6 @@ export class WorldClockRewindError extends Error {
30892
31050
  }
30893
31051
 
30894
31052
  /**
30895
- * @rc
30896
31053
  * Error thrown when performing actions on a world clock with a
30897
31054
  * time marker that does not exist.
30898
31055
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@minecraft/server",
3
- "version": "2.13.0-beta.1.26.70-preview.20",
3
+ "version": "2.13.0-beta.1.26.70-preview.22",
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.70-preview.20"
17
+ "@minecraft/vanilla-data": ">=1.20.70 || 1.26.70-preview.22"
18
18
  },
19
19
  "license": "MIT"
20
20
  }