mm_os 3.3.1 → 4.0.0

package/common/model/msg/model.json

@@ -0,0 +1,401 @@
+{
+  // 名称
+  "name": "msg",
+  // 标题
+  "title": "消息模型",
+  // 描述
+  "description": "用于端于端之间通讯",
+  // 主文件
+  "main": "index.js",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 100,
+  // 模型包含字段
+  "fields": {
+    "msg_id": {
+      // 值类型
+      "type": "string",
+      // 数据类型
+      "data_type": "varchar",
+      // 标题
+      "title": "消息ID",
+      // 描述
+      "description": "消息的唯一标识符",
+      // 最小长度
+      "min": 1,
+      // 最大长度
+      "max": 64,
+      // 默认值
+      "default": "",
+      // 是否主键
+      "primary_key": true
+    },
+    "msg_type": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "消息类型",
+      "description": "消息的类型",
+      "min": 1,
+      "max": 32,
+      "default": "text",
+      "enum": [
+        {
+          "value": "text",
+          "label": "文本消息"
+        },
+        {
+          "value": "image",
+          "label": "图片消息"
+        },
+        {
+          "value": "voice",
+          "label": "语音消息"
+        },
+        {
+          "value": "video",
+          "label": "视频消息"
+        },
+        {
+          "value": "event",
+          "label": "事件消息"
+        },
+        {
+          "value": "notice",
+          "label": "通知消息"
+        },
+        {
+          "value": "card",
+          "label": "卡片消息"
+        },
+        {
+          "value": "list",
+          "label": "列表消息"
+        },
+        {
+          "value": "chat",
+          "label": "聊天消息"
+        },
+        {
+          "value": "mail",
+          "label": "邮件消息"
+        },
+        {
+          "value": "trade",
+          "label": "交易消息"
+        }
+      ]
+    },
+    "event_type": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "事件类型",
+      "description": "当消息类型为event时使用",
+      "min": 0,
+      "max": 32,
+      "default": "",
+      "enum": [
+        {
+          "value": "combat",
+          "label": "战斗事件"
+        },
+        {
+          "value": "quest",
+          "label": "任务事件"
+        },
+        {
+          "value": "level",
+          "label": "等级事件"
+        },
+        {
+          "value": "achievement",
+          "label": "成就事件"
+        },
+        {
+          "value": "friend",
+          "label": "好友事件"
+        },
+        {
+          "value": "guild",
+          "label": "公会事件"
+        },
+        {
+          "value": "team",
+          "label": "队伍事件"
+        },
+        {
+          "value": "invite",
+          "label": "邀请事件"
+        },
+        {
+          "value": "login",
+          "label": "登录事件"
+        },
+        {
+          "value": "logout",
+          "label": "登出事件"
+        },
+        {
+          "value": "reward",
+          "label": "奖励事件"
+        },
+        {
+          "value": "activity",
+          "label": "活动事件"
+        }
+      ]
+    },
+    "msg_group": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "消息范围",
+      "description": "消息的发送范围",
+      "min": 1,
+      "max": 32,
+      "default": "system",
+      "enum": [
+        {
+          "value": "private",
+          "label": "私聊"
+        },
+        {
+          "value": "channel",
+          "label": "频道"
+        },
+        {
+          "value": "world",
+          "label": "世界"
+        },
+        {
+          "value": "guild",
+          "label": "公会"
+        },
+        {
+          "value": "system",
+          "label": "系统"
+        }
+      ]
+    },
+    "sender_id": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "发送者ID",
+      "description": "消息发送者的ID",
+      "min": 1,
+      "max": 64,
+      "default": "system"
+    },
+    "sender_name": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "发送者名称",
+      "description": "消息发送者的名称",
+      "min": 0,
+      "max": 64,
+      "default": "系统"
+    },
+    "receiver_id": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "接收者ID",
+      "description": "消息接收者的ID",
+      "min": 0,
+      "max": 64,
+      "default": ""
+    },
+    "receiver_name": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "接收者名称",
+      "description": "消息接收者的名称",
+      "min": 0,
+      "max": 64,
+      "default": ""
+    },
+    "content": {
+      "type": "string",
+      "data_type": "text",
+      "title": "消息内容",
+      "description": "消息的文本内容",
+      "min": 0,
+      "max": 65535,
+      "default": ""
+    },
+    "data": {
+      "type": "string",
+      "data_type": "text",
+      "title": "消息数据",
+      "description": "消息的JSON格式数据",
+      "min": 0,
+      "max": 65535,
+      "default": "{}"
+    },
+    "event_key": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "事件键",
+      "description": "事件消息的键值",
+      "min": 0,
+      "max": 64,
+      "default": ""
+    },
+    "priority": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "优先级",
+      "description": "消息的优先级",
+      "min": 1,
+      "max": 16,
+      "default": "normal",
+      "enum": [
+        {
+          "value": "low",
+          "label": "低"
+        },
+        {
+          "value": "normal",
+          "label": "普通"
+        },
+        {
+          "value": "high",
+          "label": "高"
+        },
+        {
+          "value": "urgent",
+          "label": "紧急"
+        }
+      ]
+    },
+    "need_confirm": {
+      "type": "number",
+      "data_type": "tinyint",
+      "title": "需要确认",
+      "description": "是否需要用户确认",
+      "min": 0,
+      "max": 1,
+      "default": 0
+    },
+    "title": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "标题",
+      "description": "消息标题（通知消息使用）",
+      "min": 0,
+      "max": 255,
+      "default": ""
+    },
+    "subtitle": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "副标题",
+      "description": "消息副标题",
+      "min": 0,
+      "max": 255,
+      "default": ""
+    },
+    "icon": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "图标",
+      "description": "消息图标URL",
+      "min": 0,
+      "max": 255,
+      "default": ""
+    },
+    "actions": {
+      "type": "string",
+      "data_type": "text",
+      "title": "操作按钮",
+      "description": "操作按钮的JSON数组",
+      "min": 0,
+      "max": 65535,
+      "default": "[]"
+    },
+    "format": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "格式",
+      "description": "文本消息的格式",
+      "min": 1,
+      "max": 16,
+      "default": "plain",
+      "enum": [
+        {
+          "value": "plain",
+          "label": "纯文本"
+        },
+        {
+          "value": "markdown",
+          "label": "Markdown"
+        },
+        {
+          "value": "html",
+          "label": "HTML"
+        }
+      ]
+    },
+    "emoji_support": {
+      "type": "number",
+      "data_type": "tinyint",
+      "title": "表情支持",
+      "description": "是否支持表情",
+      "min": 0,
+      "max": 1,
+      "default": 1
+    },
+    "expire_time": {
+      "type": "string",
+      "data_type": "datetime",
+      "title": "过期时间",
+      "description": "消息过期时间",
+      "min": 0,
+      "max": 20,
+      "default": "1970-01-01 00:00:00"
+    },
+    "timestamp": {
+      "type": "string",
+      "data_type": "datetime",
+      "title": "时间戳",
+      "description": "消息发送时间",
+      "min": 0,
+      "max": 20,
+      "default": "now()"
+    },
+    "ext_data": {
+      "type": "string",
+      "data_type": "text",
+      "title": "扩展数据",
+      "description": "扩展数据的JSON格式",
+      "min": 0,
+      "max": 65535,
+      "default": "{}"
+    },
+    "state": {
+      "type": "number",
+      "data_type": "int",
+      "title": "状态",
+      "description": "消息状态",
+      "min": 0,
+      "max": 100,
+      "default": 1,
+      "enum": [
+        {
+          "value": 1,
+          "label": "正常"
+        },
+        {
+          "value": 2,
+          "label": "已读"
+        },
+        {
+          "value": 3,
+          "label": "已删除"
+        },
+        {
+          "value": 4,
+          "label": "已过期"
+        }
+      ]
+    }
+  }
+}

package/common/model/player/index.js

@@ -0,0 +1,63 @@
+
+module.exports = {
+  methods: {
+    /**
+     * 检查玩家是否在线
+     * @returns {boolean} 是否在线
+     */
+    isOnline() {
+      return this.state === 1 && this.login === 1;
+    },
+
+    /**
+     * 增加金币
+     * @param {number} amount 金币数量
+     * @returns {boolean} 是否成功
+     */
+    gainGold(amount) {
+      if (typeof amount !== 'number' || amount < 0) {
+        throw new TypeError('金币数量必须是非负数');
+      }
+      var new_gold = this.gold + amount;
+      if (new_gold > 999999999) {
+        this.gold = 999999999;
+      } else {
+        this.gold = new_gold;
+      }
+      return true;
+    },
+
+    /**
+     * 转换为JSON字符串
+     * @returns {string} JSON字符串
+     */
+    toJson() {
+      return JSON.stringify(this.getInfo());
+    },
+
+    /**
+     * 从数据对象初始化玩家
+     * @param {object} data 玩家数据
+     * @returns {object} 玩家实例
+     */
+    from(data) {
+      if (typeof data !== 'object' || data === null) {
+        throw new TypeError('玩家数据必须是对象');
+      }
+      for (var key in data) {
+        if (this.hasOwnProperty(key)) {
+          this[key] = data[key];
+        }
+      }
+      return this;
+    }
+  },
+
+  /**
+   * 添加玩家模型方法
+   * @param {object} model 玩家模型实例
+   */
+  addMethods(model) {
+    Object.assign(model, this.methods);
+  }
+};

package/common/model/player/model.json

@@ -0,0 +1,185 @@
+{
+  // 名称
+  "name": "player",
+  // 标题
+  "title": "游戏玩家模型",
+  // 描述
+  "description": "定义游戏玩家模型的组件，包含账户信息和游戏状态",
+  // 主文件
+  "main": "index.js",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 100,
+  // 模型包含字段
+  "fields": {
+    "player_id": {
+      // 值类型
+      "type": "string",
+      // 数据类型
+      "data_type": "varchar",
+      // 标题
+      "title": "玩家ID",
+      // 描述
+      "description": "玩家的唯一标识符",
+      // 最小长度
+      "min": 1,
+      // 最大长度
+      "max": 32,
+      // 默认值
+      "default": "",
+      // 是否主键
+      "primary_key": true,
+      // 是否自动增长
+      "auto": false
+    },
+    "user_id": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "用户ID",
+      "description": "玩家关联的用户ID",
+      "min": 1,
+      "max": 32,
+      "default": ""
+    },
+    "client_id": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "客户端ID",
+      "description": "玩家关联的客户端ID",
+      "min": 1,
+      "max": 32,
+      "default": ""
+    },
+    "avatar": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "头像",
+      "description": "玩家的头像",
+      "min": 1,
+      "max": 255,
+      "default": "/avatar.jpg"
+    },
+    "name": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "名称",
+      "description": "玩家的显示名称",
+      "min": 0,
+      "max": 24,
+      "default": ""
+    },
+    "state": {
+      "type": "number",
+      "data_type": "int",
+      "title": "状态",
+      "description": "账户的状态",
+      "min": 0,
+      "max": 4,
+      "default": 1,
+      "enum": [
+        {
+          "value": 0,
+          "label": "离线"
+        },
+        {
+          "value": 1,
+          "label": "在线"
+        },
+        {
+          "value": 2,
+          "label": "异常"
+        },
+        {
+          "value": 3,
+          "label": "已冻结"
+        },
+        {
+          "value": 4,
+          "label": "已注销"
+        }
+      ]
+    },
+    "level": {
+      "type": "number",
+      "data_type": "int",
+      "title": "玩家等级",
+      "description": "玩家的游戏等级",
+      "min": 0,
+      "max": 1000,
+      "default": 0
+    },
+    "channel_id": {
+      "type": "number",
+      "data_type": "int",
+      "title": "频道ID",
+      "description": "玩家当前所在的频道ID",
+      "min": 0,
+      "max": 100,
+      "default": 0
+    },
+    "room_id": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "房间ID",
+      "description": "玩家当前所在的房间ID",
+      "min": 0,
+      "max": 10000,
+      "default": 0
+    },
+    "world_id": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "世界ID",
+      "description": "玩家当前所在的世界ID",
+      "min": 0,
+      "max": 10000,
+      "default": 0
+    },
+    "returning": {
+      "type": "number",
+      "data_type": "tinyint",
+      "title": "回归状态",
+      "description": "玩家是否为回归玩家（0：否，1：是）",
+      "min": 0,
+      "max": 1,
+      "default": 0
+    },
+    "gold": {
+      "type": "number",
+      "data_type": "int",
+      "title": "金币",
+      "description": "玩家的金币数量",
+      "min": 0,
+      "max": 999999999,
+      "default": 0
+    },
+    "zone": {
+      "type": "string",
+      "data_type": "varchar",
+      "title": "所在分区",
+      "description": "玩家当前所在的分区名称",
+      "min": 0,
+      "max": 50,
+      "default": ""
+    },
+    "login": {
+      "type": "number",
+      "data_type": "tinyint",
+      "title": "登录状态",
+      "description": "玩家是否已登录（0：否，1：是）",
+      "min": 0,
+      "max": 1,
+      "default": 0
+    },
+    "is_ready": {
+      "type": "number",
+      "data_type": "tinyint",
+      "title": "准备状态",
+      "description": "玩家是否已准备（0：否，1：是）",
+      "min": 0,
+      "max": 1,
+      "default": 0
+    }
+  }
+}

package/common/model/user/index.js

@@ -0,0 +1,11 @@
+/**
+ * 富血模型
+ */
+module.exports = {
+  /**
+   * 添加玩家模型方法
+   * @param {object} model 玩家模型实例
+   */
+  addMethods(model) {
+  }
+};