sapdon 2.0.2 → 2.1.0

package/src/core/item/armor.js

@@ -1,89 +1,117 @@
-import { Attachable } from "./Attachable.js";
-import { Item } from "./item.js";
-import { ItemComponent } from "./ItemComponents.js";
-
-
-// 定义 Armor 基类
-export class Armor {
-    constructor(identifier, category, item_texture, texture_path, options = {}) {
-        this.identifier = identifier;
-        // 创建物品
-        this.item = new Item(identifier, category, item_texture, options);
-        // 创建附加物
-        this.attachable = new Attachable(identifier, texture_path, "armor");
-
-        // 配置附加物
-        this.attachable
-            .addTexture("default", texture_path) // 添加默认纹理
-            .addMaterial("default", "armor") // 添加默认材质
-            .addMaterial("enchanted", "armor_enchanted") // 添加附魔材质
-            .addTexture("enchanted", "textures/misc/enchanted_actor_glint") // 添加附魔纹理
-            .addGeometry("default", "geometry.player.armor.chestplate") // 添加几何模型
-            .addRenderController("controller.render.armor") // 添加渲染控制器
-            .setScript("parent_setup", "v.chest_layer_visible = 0.0;"); // 设置脚本
-    }
-}
-
-// 扩展 Armor 类，实现胸甲
-export class Chestplate extends Armor {
-    constructor(identifier, item_texture, texture_path, options = {}) {
-        super(identifier, "equipment", item_texture, texture_path, options);
-
-        // 自定义胸甲物品
-        this.item.addComponent(
-            ItemComponent.combineComponents(
-                ItemComponent.setDisplayName("我的自定义胸甲"), // 设置显示名称
-                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
-                ItemComponent.setWearable(5, "slot.armor.chest") // 设置为可穿戴，并指定装备槽
-            )
-        );
-    }
-}
-
-// 扩展 Armor 类，实现靴子
-export class Boot extends Armor {
-    constructor(identifier, item_texture, texture_path, options = {}) {
-        super(identifier, "equipment", item_texture, texture_path, options);
-
-        // 自定义靴子物品
-        this.item.addComponent(
-            ItemComponent.combineComponents(
-                ItemComponent.setDisplayName("我的自定义靴子"), // 设置显示名称
-                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
-                ItemComponent.setWearable(4, "slot.armor.feet") // 设置为可穿戴，并指定装备槽
-            )
-        );
-    }
-}
-
-// 扩展 Armor 类，实现裤子
-export class Leggings extends Armor {
-    constructor(identifier, item_texture, texture_path, options = {}) {
-        super(identifier, "equipment", item_texture, texture_path, options);
-
-        // 自定义裤子物品
-        this.item.addComponent(
-            ItemComponent.combineComponents(
-                ItemComponent.setDisplayName("我的自定义裤子"), // 设置显示名称
-                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
-                ItemComponent.setWearable(6, "slot.armor.legs") // 设置为可穿戴，并指定装备槽
-            )
-        );
-    }
-}
-
-// 扩展 Armor 类，实现头盔
-export class Helmet extends Armor {
-    constructor(identifier, item_texture, texture_path, options = {}) {
-        super(identifier, "equipment", item_texture, texture_path, options);
-
-        // 自定义头盔物品
-        this.item.addComponent(
-            ItemComponent.combineComponents(
-                ItemComponent.setDisplayName("我的自定义头盔"), // 设置显示名称
-                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
-                ItemComponent.setWearable(3, "slot.armor.head") // 设置为可穿戴，并指定装备槽
-            )
-        );
-    }
-}
+import { Attachable } from "./Attachable.js";
+import { Item } from "./Item.js";
+import { ItemComponent } from "./ItemComponents.js";
+
+
+// 定义 Armor 基类
+export class Armor {
+    constructor(identifier, category, item_texture, texture_path, options = {}) {
+        this.identifier = identifier;
+        //默认分组
+        options["group"]= "minecraft:itemGroup.name.chestplate";
+        // 创建物品
+        this.item = new Item(identifier, category, item_texture, options);
+        // 创建附加物
+        this.attachable = new Attachable(identifier);
+
+        // 配置附加物
+        this.attachable
+            .addTexture("default", texture_path) // 添加默认纹理
+            .addMaterial("default", "armor") // 添加默认材质
+            .addMaterial("enchanted", "armor_enchanted") // 添加附魔材质
+            .addTexture("default",texture_path)
+            .addTexture("enchanted", "textures/misc/enchanted_actor_glint") // 添加附魔纹理
+            .addRenderController("controller.render.armor") // 添加渲染控制器
+            //默认类型 胸甲
+            .addGeometry("default", "geometry.player.armor.chestplate") // 添加几何模型
+            .setScript("parent_setup", "v.chest_layer_visible = 0.0;"); // 设置脚本
+    }
+    setArrachableGeometry(key, geometry){
+        this.attachable.addGeometry(key,geometry);
+        return this;
+    }
+}
+
+// 扩展 Armor 类，实现胸甲
+export class Chestplate extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+
+        options["group"]= "minecraft:itemGroup.name.chestplate";
+
+          //头盔专属
+         this.attachable.addGeometry("default", "geometry.player.armor.chestplate") // 添加几何模型
+         .setScript("parent_setup", "v.chest_layer_visible = 0.0;"); // 设置脚本
+
+        // 自定义胸甲物品
+        this.item.addComponent(
+            ItemComponent.combineComponents(
+                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+                ItemComponent.setWearable(5, "slot.armor.chest") // 设置为可穿戴，并指定装备槽
+            )
+        );
+    }
+}
+
+// 扩展 Armor 类，实现靴子
+export class Boot extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+
+        options["group"]= "minecraft:itemGroup.name.boots";
+
+         //头盔专属
+         this.attachable.addGeometry("default", "geometry.player.armor.boots") // 添加几何模型
+         .setScript("parent_setup", "v.boot_layer_visible = 0.0;"); // 设置脚本
+
+        // 自定义靴子物品
+        this.item.addComponent(
+            ItemComponent.combineComponents(
+                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+                ItemComponent.setWearable(4, "slot.armor.feet") // 设置为可穿戴，并指定装备槽
+            )
+        );
+    }
+}
+
+// 扩展 Armor 类，实现裤子
+export class Leggings extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+
+        options["group"]= "minecraft:itemGroup.name.leggings";
+
+         //头盔专属
+         this.attachable.addGeometry("default", "geometry.player.armor.leggings") // 添加几何模型
+         .setScript("parent_setup", "v.leg_layer_visible = 0.0;"); // 设置脚本
+
+        // 自定义裤子物品
+        this.item.addComponent(
+            ItemComponent.combineComponents(
+                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+                ItemComponent.setWearable(6, "slot.armor.legs") // 设置为可穿戴，并指定装备槽
+            )
+        );
+    }
+}
+
+// 扩展 Armor 类，实现头盔
+export class Helmet extends Armor {
+    constructor(identifier, item_texture, texture_path, options = {}) {
+        super(identifier, "equipment", item_texture, texture_path, options);
+
+        options["group"]= "minecraft:itemGroup.name.helmet";
+
+        //头盔专属
+        this.attachable.addGeometry("default", "geometry.player.armor.helmet") // 添加几何模型
+        .setScript("parent_setup", "v.helmet_layer_visible = 0.0;"); // 设置脚本
+
+        // 自定义头盔物品
+        this.item.addComponent(
+            ItemComponent.combineComponents(
+                ItemComponent.setMaxStackSize(1), // 设置最大堆叠数量
+                ItemComponent.setWearable(3, "slot.armor.head") // 设置为可穿戴，并指定装备槽
+            )
+        );
+    }
+}

package/src/core/item/attachable.js

@@ -1,34 +1,34 @@
-import { AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription } from "../addon/item/attachable.js";
-
-
-export class Attachable extends AddonAttachableDescription{
-    constructor(identifier){
-        super(identifier);
-    }
-
-    getId() {
-        return this.identifier;
-    }
-    
-    toJson() {
-        const entity = new AddonAttachable(
-            "1.8.0",
-            new AddonAttachableDefinition(this)
-        );
-        return entity.toJson();
-    }
-}
-
-/*
-const attachable = new Attachable("test")
-      attachable.addMaterial("default", "armor")
-      attachable.addMaterial("enchanted","armor_enchanted")
-      attachable.addTexture("default","textures/models/armor/custom_main")
-      attachable.addTexture("enchanted", "textures/misc/enchanted_actor_glint")
-      attachable.addGeometry("default", "geometry.player.armor.chestplate")
-      attachable.addRenderController("controller.render.armor")
-      attachable.setScript("parent_setup","v.chest_layer_visible = 0.0;")
-
-      console.log(JSON.stringify(attachable.toJson(),null,2))
-debugger
+import { AddonAttachable, AddonAttachableDefinition, AddonAttachableDescription } from "../addon/item/attachable.js";
+
+
+export class Attachable extends AddonAttachableDescription{
+    constructor(identifier){
+        super(identifier);
+    }
+
+    getId() {
+        return this.identifier;
+    }
+    
+    toJson() {
+        const entity = new AddonAttachable(
+            "1.8.0",
+            new AddonAttachableDefinition(this)
+        );
+        return entity.toJson();
+    }
+}
+
+/*
+const attachable = new Attachable("test")
+      attachable.addMaterial("default", "armor")
+      attachable.addMaterial("enchanted","armor_enchanted")
+      attachable.addTexture("default","textures/models/armor/custom_main")
+      attachable.addTexture("enchanted", "textures/misc/enchanted_actor_glint")
+      attachable.addGeometry("default", "geometry.player.armor.chestplate")
+      attachable.addRenderController("controller.render.armor")
+      attachable.setScript("parent_setup","v.chest_layer_visible = 0.0;")
+
+      console.log(JSON.stringify(attachable.toJson(),null,2))
+debugger
 */

package/src/core/item/food.js

@@ -1,62 +1,62 @@
-import { ItemComponent } from "./ItemComponents.js";
-import { Item } from "./item.js";
-
-export class Food extends Item {
-    /**
-     * 物品类
-     * @param {string} identifier 物品唯一标识符
-     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
-     * @param {string} texture 物品纹理
-     * @param {Object} options 可选参数
-     * @param {string} options.group 分组 
-     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
-     * @param {string} options.animation 使用动画，默认为 "eat"
-     * @param {boolean} options.canAlwaysEat 是否总是可以食用，默认为 false
-     * @param {number} options.nutrition 营养价值，默认为 0
-     * @param {number} options.saturationModifier 饱和度修正值，默认为 1
-     */
-    constructor(identifier, category, texture, options = {}) {
-        // 继承父类
-        super(identifier, category, texture, options);
-
-        // 解构 options 并设置默认值
-        const {
-            animation = "eat",
-            movement = 1,
-            useDuration = 1,
-            canAlwaysEat = false,
-            nutrition = 0,
-            saturationModifier = 1,
-        } = options;
-
-        // 参数验证
-        if (typeof nutrition !== "number" || nutrition < 0) {
-            throw new Error('nutrition 必须是一个非负数');
-        }
-        if (typeof saturationModifier !== "number" || saturationModifier <= 0) {
-            throw new Error('saturationModifier 必须是一个正数');
-        }
-        if (typeof animation !== "string") {
-            throw new Error('animation 必须是字符串类型');
-        }
-        if (typeof canAlwaysEat !== "boolean") {
-            throw new Error('canAlwaysEat 必须是布尔类型');
-        }
-
-        // 添加组件
-        this.addComponent(
-            ItemComponent.combineComponents(
-                ItemComponent.setUseModifiers(
-                    movement,
-                    useDuration
-                ),
-                ItemComponent.setFoodComponent(
-                    canAlwaysEat,
-                    nutrition,
-                    saturationModifier
-                ),
-                ItemComponent.setUseAnimation(animation)
-            )
-        );
-    }
+import { ItemComponent } from "./ItemComponents.js";
+import { Item } from "./Item.js";
+
+export class Food extends Item {
+    /**
+     * 物品类
+     * @param {string} identifier 物品唯一标识符
+     * @param {string} category 菜单栏分类 可选："construction", "nature", "equipment", "items", and "none"
+     * @param {string} texture 物品纹理
+     * @param {Object} options 可选参数
+     * @param {string} options.group 分组 
+     * @param {boolean} options.hide_in_command 是否在命令中隐藏，默认为 false
+     * @param {string} options.animation 使用动画，默认为 "eat"
+     * @param {boolean} options.canAlwaysEat 是否总是可以食用，默认为 false
+     * @param {number} options.nutrition 营养价值，默认为 0
+     * @param {number} options.saturationModifier 饱和度修正值，默认为 1
+     */
+    constructor(identifier, category, texture, options = {}) {
+        // 继承父类
+        super(identifier, category, texture, options);
+
+        // 解构 options 并设置默认值
+        const {
+            animation = "eat",
+            movement = 1,
+            useDuration = 1,
+            canAlwaysEat = false,
+            nutrition = 0,
+            saturationModifier = 1,
+        } = options;
+
+        // 参数验证
+        if (typeof nutrition !== "number" || nutrition < 0) {
+            throw new Error('nutrition 必须是一个非负数');
+        }
+        if (typeof saturationModifier !== "number" || saturationModifier <= 0) {
+            throw new Error('saturationModifier 必须是一个正数');
+        }
+        if (typeof animation !== "string") {
+            throw new Error('animation 必须是字符串类型');
+        }
+        if (typeof canAlwaysEat !== "boolean") {
+            throw new Error('canAlwaysEat 必须是布尔类型');
+        }
+
+        // 添加组件
+        this.addComponent(
+            ItemComponent.combineComponents(
+                ItemComponent.setUseModifiers(
+                    movement,
+                    useDuration
+                ),
+                ItemComponent.setFoodComponent(
+                    canAlwaysEat,
+                    nutrition,
+                    saturationModifier
+                ),
+                ItemComponent.setUseAnimation(animation)
+            )
+        );
+    }
 }

package/src/core/registry.js

@@ -1,17 +1,17 @@
-
-export class GRegistry {
-	 static dataList = [];
-	 /**
-	  * 生成注册器
-	  * @param {string} name 文件名字
-	  * @param {string} root 根目录，如 "behavior"、"resource" 等
-	  * @param {string} path 数据的路径，如 "blocks/"、"items/"、"recipes/" 等
-	  * @param {string} data 实例 必须包含 toJson 方法
-	  */
-	 static register(name, root, path, data){
-		GRegistry.dataList.push({name, root, path, data});
-	 }
-	 static getDataList(){
-		return [...GRegistry.dataList];
-	 }
+
+export class GRegistry {
+	 static dataList = [];
+	 /**
+	  * 生成注册器
+	  * @param {string} name 文件名字
+	  * @param {string} root 根目录，如 "behavior"、"resource" 等
+	  * @param {string} path 数据的路径，如 "blocks/"、"items/"、"recipes/" 等
+	  * @param {string} data 实例 必须包含 toJson 方法
+	  */
+	 static register(name, root, path, data){
+		GRegistry.dataList.push({name, root, path, data});
+	 }
+	 static getDataList(){
+		return [...GRegistry.dataList];
+	 }
 }

package/src/core/ui/Properties/{Grid.js → GridProp.js}

@@ -1,7 +1,7 @@
 /**
  * Grid 类
  * 
- * 该类表示一个网格控件，用于管理网格布局及其相关属性。
+ * 该类表示一个网格控件属性，用于管理网格布局及其相关属性。
  * 
  * 属性：
  * - grid_dimensions: Vector [columns, rows] - 网格的列数和行数
@@ -13,7 +13,7 @@
  * - precached_grid_item_count: int - 预缓存的网格项目数量
  */
 
-export class Grid {
+export class GridProp {
     constructor() {
         /*
         this.grid_dimensions = null;

package/src/core/ui/Properties/Sound.js

@@ -0,0 +1,72 @@
+/**
+ * Sound 类
+ * 
+ * 该类表示一个声音控件，用于管理声音播放及其相关属性。
+ * 
+ * 属性：
+ * - sound_name: string - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
+ * - sound_volume: float - 声音音量（默认值：1.0）
+ * - sound_pitch: float - 声音音调（默认值：1.0）
+ * - sounds: Array of sound objects - 触发事件时播放的声音数组
+ */
+
+export class Sound {
+    constructor() {
+        /*
+        this.sound_name = '';
+        this.sound_volume = 1.0;
+        this.sound_pitch = 1.0;
+        this.sounds = [];
+        */
+    }
+
+    /**
+     * 设置声音名称。
+     * @param {string} name - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
+     * @returns {Sound} 返回当前实例以支持链式调用
+     */
+    setSoundName(name) {
+        this.sound_name = name;
+        return this;
+    }
+
+    /**
+     * 设置声音音量。
+     * @param {number} volume - 音量（范围：0.0 到 1.0，默认值：1.0）
+     * @returns {Sound} 返回当前实例以支持链式调用
+     */
+    setSoundVolume(volume = 1.0) {
+        this.sound_volume = volume;
+        return this;
+    }
+
+    /**
+     * 设置声音音调。
+     * @param {number} pitch - 音调（默认值：1.0）
+     * @returns {Sound} 返回当前实例以支持链式调用
+     */
+    setSoundPitch(pitch = 1.0) {
+        this.sound_pitch = pitch;
+        return this;
+    }
+
+    /**
+     * 设置触发事件时播放的声音数组。
+     * @param {object[]} sounds - 声音对象数组
+     * @returns {Sound} 返回当前实例以支持链式调用
+     */
+    setSounds(sounds) {
+        this.sounds = sounds;
+        return this;
+    }
+
+    /**
+     * 添加一个声音对象到声音数组。
+     * @param {object} sound - 声音对象
+     * @returns {Sound} 返回当前实例以支持链式调用
+     */
+    addSound(sound) {
+        this.sounds.push(sound);
+        return this;
+    }
+}

package/src/core/ui/elements/Button.js

@@ -0,0 +1,111 @@
+/**
+ * Button ​
+    Property Name	Type	Default Value	Description
+    default_control	string		Name of the child control that will be displayed only in the default state
+    hover_control	string		Name of the child control that will be displayed only in the hover state
+    pressed_control	string		Name of the child control that will be displayed only in the pressed state
+    locked_control	string		Name of the child control that will be displayed only in the locked state
+ */
+
+import { Control } from "../Properties/Control.js";
+import { DataBinding } from "../Properties/DataBinding.js";
+import { Factory } from "../Properties/Factory.js";
+import { Input } from "../Properties/Input.js";
+import { Layout } from "../Properties/Layout.js";
+import { Sound } from "../Properties/Sound.js";
+import { UIElement } from "./UIElement.js";
+
+export class Button extends UIElement{
+    constructor(id,template){
+        super(id,"button",template);
+        this.input = new Input();
+        this.sound = new Sound();
+        this.control = new Control();
+        this.layout = new Layout();
+        this.dataBinding = new DataBinding();
+        this.factory = new Factory();
+    }
+    setDefaultControl(default_control){
+        this.addProp("default_control",default_control);
+        return this;
+    }
+    setHoverControl(hover_control){
+        this.addProp("hover_control",hover_control);
+        return this;
+    }
+    setPressedControl(pressed_control){
+        this.addProp("pressed_control",pressed_control);
+        return this;
+    }
+    setLockedControl(locked_control){
+        this.addProp("locked_control",locked_control);
+        return this;
+    }
+    
+    setInput(input){
+        if(!(input instanceof Input)) new Error("需求Input类");
+        this.input = input;
+        return this;
+    }
+
+    setSound(sound){
+        if(!(sound instanceof Sound)) new Error("需求Sound类");
+        this.sound = sound;
+        return this;
+    }
+
+    setLayout(layout){
+        if(!(layout instanceof Layout)) new Error("参数需要Layout类")
+        this.layout = layout;
+        return this;
+    }
+
+    serialize(){
+        //序列化
+
+        // 复制Layout的属性
+        for (const key in this.layout) {
+            if (this.layout.hasOwnProperty(key)) {
+                this.properties.set(key, this.layout[key]);
+            }
+        }
+
+        // 复制input的属性
+        for (const key in this.input) {
+            if (this.input.hasOwnProperty(key)) {
+                this.properties.set(key, this.input[key]);
+            }
+        }
+
+        // 复制sound的属性
+        for (const key in this.sound) {
+            if (this.sound.hasOwnProperty(key)) {
+                this.properties.set(key, this.sound[key]);
+            }
+        }
+
+        // 复制DataBinding的属性
+        for (const key in this.dataBinding) {
+            if (this.dataBinding.hasOwnProperty(key)) {
+                this.properties.set(key, this.dataBinding[key]);
+            }
+        }
+
+         // 复制Factory的属性
+         for (const key in this.factory) {
+            if (this.factory.hasOwnProperty(key)) {
+                this.properties.set(key, this.factory[key]);
+            }
+        }
+
+        // 复制Control的属性
+        for (const key in this.control) {
+            if (this.control.hasOwnProperty(key)) {
+                this.properties.set(key, this.control[key]);
+            }
+        }
+
+        // 调用父类的serialize方法
+        return super.serialize();
+    }
+}