@minecraft/server 1.4.0-rc.1.20.30-preview.25 → 1.4.0-rc.1.20.40-preview.21

package/index.d.ts

@@ -16,7 +16,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.6.0-internal.1.20.30-preview.25"
+ *   "version": "1.7.0-internal.1.20.40-preview.21"
  * }
  * ```
  *
@@ -72,10 +72,29 @@ export enum Direction {
 
 /**
  * @beta
+ * Specifies a mechanism for displaying scores on a scoreboard.
  */
 export enum DisplaySlotId {
+    /**
+     * @beta
+     * @remarks
+     * Displays the score below the player's name.
+     *
+     */
     BelowName = 'BelowName',
+    /**
+     * @beta
+     * @remarks
+     * Displays the score as a list on the pause screen.
+     *
+     */
     List = 'List',
+    /**
+     * @beta
+     * @remarks
+     * Displays the score on the side of the player's screen.
+     *
+     */
     Sidebar = 'Sidebar',
 }
 
@@ -1994,7 +2013,9 @@ export class EntityGroundOffsetComponent extends EntityComponent {
     private constructor();
     /**
      * @remarks
-     * Value of this particular ground offset.
+     * Value of this particular ground offset. Note that this value
+     * is effectively read only; setting the ground offset value
+     * will not have an impact on the related entity.
      *
      * This property can't be edited in read-only mode.
      *
@@ -2973,6 +2994,16 @@ export class ItemReleaseUseAfterEventSignal {
  * Defines a collection of items.
  */
 export class ItemStack {
+    /**
+     * @remarks
+     * Number of the items in the stack. Valid values range between
+     * 1-255. The provided value will be clamped to the item's
+     * maximum stack size.
+     *
+     * @throws
+     * Throws if the value is outside the range of 1-255.
+     */
+    readonly amount: number;
     /**
      * @remarks
      * Returns whether the item is stackable. An item is considered
@@ -2981,6 +3012,19 @@ export class ItemStack {
      *
      */
     readonly isStackable: boolean;
+    /**
+     * @remarks
+     * Gets or sets whether the item is kept on death.
+     *
+     */
+    readonly keepOnDeath: boolean;
+    /**
+     * @remarks
+     * Gets or sets the item's lock mode. The default value is
+     * `ItemLockMode.none`.
+     *
+     */
+    readonly lockMode: ItemLockMode;
     /**
      * @remarks
      * The maximum stack size. This value varies depending on the
@@ -2989,6 +3033,16 @@ export class ItemStack {
      *
      */
     readonly maxAmount: number;
+    /**
+     * @remarks
+     * Given name of this stack of items. The name tag is displayed
+     * when hovering over the item. Setting the name tag to an
+     * empty string or `undefined` will remove the name tag.
+     *
+     * @throws
+     * Throws if the length exceeds 255 characters.
+     */
+    readonly nameTag?: string;
     /**
      * @remarks
      * The type of the item.
@@ -3693,8 +3747,6 @@ export class Player extends Entity {
      *
      * This function can't be called in read-only mode.
      *
-     * @param soundID
-     * Identifier of the sound to play.
      * @param soundOptions
      * Additional optional options for the sound.
      * @throws This function can throw errors.
@@ -3723,7 +3775,7 @@ export class Player extends Entity {
      *   players[0].playSound("bucket.fill_water", playerSoundOptions);
      * ```
      */
-    playSound(soundID: string, soundOptions?: PlayerSoundOptions): void;
+    playSound(soundId: string, soundOptions?: PlayerSoundOptions): void;
     /**
      * @beta
      * @remarks
@@ -4109,6 +4161,12 @@ export class ScoreboardIdentity {
      * @throws This function can throw errors.
      */
     getEntity(): Entity | undefined;
+    /**
+     * @remarks
+     * Returns true if the ScoreboardIdentity reference is still
+     * valid.
+     *
+     */
     isValid(): boolean;
 }
 
@@ -4176,6 +4234,12 @@ export class ScoreboardObjective {
      * @throws This function can throw errors.
      */
     hasParticipant(participant: Entity | ScoreboardIdentity | string): boolean;
+    /**
+     * @remarks
+     * Returns true if the ScoreboardObjective reference is still
+     * valid.
+     *
+     */
     isValid(): boolean;
     /**
      * @remarks
@@ -4754,7 +4818,7 @@ export class World {
      *   players[0].playSound("bucket.fill_water", playerSoundOptions);
      * ```
      */
-    playMusic(trackID: string, musicOptions?: MusicOptions): void;
+    playMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
      * @beta
      * @remarks
@@ -4792,7 +4856,7 @@ export class World {
      *   players[0].playSound("bucket.fill_water", playerSoundOptions);
      * ```
      */
-    playSound(soundID: string, location: Vector3, soundOptions?: WorldSoundOptions): void;
+    playSound(soundId: string, location: Vector3, soundOptions?: WorldSoundOptions): void;
     /**
      * @beta
      * @remarks
@@ -4801,12 +4865,16 @@ export class World {
      *
      * This function can't be called in read-only mode.
      *
+     * @param trackId
+     * Identifier of the music track to play.
+     * @param musicOptions
+     * Additional options for the music track.
      * @throws
      * An error will be thrown if volume is less than 0.0.
      * An error will be thrown if fade is less than 0.0.
      *
      */
-    queueMusic(trackID: string, musicOptions?: MusicOptions): void;
+    queueMusic(trackId: string, musicOptions?: MusicOptions): void;
     /**
      * @beta
      * @remarks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "1.4.0-rc.1.20.30-preview.25",
+  "version": "1.4.0-rc.1.20.40-preview.21",
   "description": "",
   "contributors": [
     {