mm_os 3.3.0 → 4.0.0

package/core/scene/map.js

@@ -0,0 +1,28 @@
+const {
+  Drive
+} = require('mm_machine');
+
+/**
+ * 地图类
+ */
+class Map extends Drive {
+  static config = {
+    id: 0,
+    name: '',
+    description: '',
+    width: 0,
+    height: 0,
+    tiles: [],
+  };
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   */
+  constructor(config) {
+    super({ ...Map.config, ...config || {}});
+  }
+}
+
+exports = {
+  Map
+};

package/core/scene/script.tpl.js

@@ -0,0 +1,22 @@
+/**
+ * 场景
+ */
+module.exports = {
+  /**
+   * 初始化
+   * @param {object} entity 实体对象
+   * @param {object} system 系统对象
+   */
+  async _init(entity, system) {
+    // 初始化代码写在这
+    this.log('debug', 'scene _init 被调用', { entity, system });
+  },
+  /**
+   * 主要逻辑
+   * @param {...any} args 参数列表
+   */
+  async main(...args) {
+    // 主要代码写在这
+    this.log('debug', 'scene main 被调用', { args });
+  }
+};

package/core/sender/config.tpl.json

@@ -0,0 +1,14 @@
+{
+  // 名称
+  "name": "${name}",
+  // 标题
+  "title": "${title || '发送器'}",
+  // 描述
+  "description": "${description || '发送器'}",
+  // 主文件
+  "main": "${main || 'index.js'}",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 100
+}

package/core/sender/index.js

@@ -0,0 +1,79 @@
+const { Drive } = require('mm_machine');
+
+/**
+ * 消息发送器基类
+ * 发送消息到其他服务端
+ */
+class Sender extends Drive {
+  static config = {
+    // 消息发送器名称
+    name: 'default'
+  };
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父对象
+   */
+  constructor(config, parent) {
+    super({ ...Sender.config, ...config || {} }, parent);
+  }
+}
+
+/**
+ * 获取模板目录
+ * @returns {string} 模板目录
+ */
+Sender.prototype.getTplDir = function() {
+  return __dirname;
+};
+
+/**
+ * 初始化核心
+ * @param {object} eventer 事件总线
+ * @param {object} logger 日志管理器
+ */
+Sender.prototype._initCore = async function(eventer, logger) {
+  // 初始化依赖项
+  if (logger) {
+    this.setLogger(logger);
+  }
+  if (eventer) {
+    this.getEventer = function () {
+      return eventer;
+    };
+  }
+};
+
+/**
+ * 启动
+ */
+Sender.prototype._start = async function() {
+  this.log('info', 'started');
+};
+
+/**
+ * 停止模型
+ */
+Sender.prototype._stop = async function() {
+  this.log('info', 'stopped');
+};
+
+/**
+ * 销毁
+ */
+Sender.prototype._destroy = function() {
+  try {
+    // 清理存储引用
+    this._store = {};
+    this._data_validator = null;
+
+    this.log('info', 'destroyed');
+
+    // 移除所有监听器
+    this.removeAllListeners();
+  } catch (error) {
+    this.log('error', `销毁失败`, error);
+  }
+};
+
+exports.Sender = Sender;

package/core/sender/script.tpl.js

@@ -0,0 +1,20 @@
+/**
+ * 消息发送器
+ */
+module.exports = {
+  /**
+   * 初始化
+   * @param {object} eventer 事件总线
+   */
+  async _init(eventer) {
+    // this.log('debug', '初始化');
+  },
+  /**
+   * 主要逻辑
+   * @param {object} msg 消息对象
+   */
+  async main(msg) {
+    // 主要代码写在这，可将消息发送到第三方服务器
+    this.log('debug', 'sender main 被调用', { msg });
+  }
+};

package/core/service/config.tpl.json

@@ -0,0 +1,14 @@
+{
+  // 名称
+  "name": "${name}",
+  // 标题
+  "title": "${title || '服务'}",
+  // 描述
+  "description": "${description || '服务'}",
+  // 主文件
+  "main": "${main || 'index.js'}",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 100
+}

package/core/service/index.js

@@ -0,0 +1,100 @@
+const {
+  Drive
+} = require('mm_machine');
+
+/**
+ * 领域服务基类
+ * 负责协调多个模型和业务逻辑，提供业务操作的高级抽象
+ */
+class Service extends Drive {
+  static config = {
+    // 服务名称
+    name: 'default',
+    // 依赖的富血模型
+    models: [],
+  };
+  /**
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父对象
+   */
+  constructor(config, parent) {
+    super({ ...Service.config, ...config || {} }, parent);
+    // 模型实例集合
+    this._model = {};
+  }
+}
+
+/**
+ * 获取模板目录
+ * @returns {string} 模板目录
+ */
+Service.prototype.getTplDir = function() {
+  return __dirname;
+};
+
+/**
+ * 初始化核心
+ * @param {object} model 模型实例集合
+ * @param {object} eventer 事件管理器
+ * @param {object} logger 日志管理器
+ */
+Service.prototype._initCore = async function(model, eventer, logger) {
+  // 初始化依赖项
+  if (logger) {
+    this.setLogger(logger);
+  }
+  if (eventer) {
+    this.getEventer = function () {
+      return eventer;
+    };
+  }
+  if (model) {
+    this._model = model;
+  }
+
+  this._checkDeps();
+};
+
+/**
+ * 检查依赖项
+ * @private
+ */
+Service.prototype._checkDeps = function() {
+  let {
+    models
+  } = this.config;
+
+  for (var i = 0; i < models.length; i++) {
+    var name = models[i];
+    if (!this._model[name]) {
+      this.log('error', `model ${name} 未找到`);
+    }
+  }
+};
+
+/**
+ * 销毁服务
+ */
+Service.prototype._destroy = function() {
+  // 清理依赖引用
+  this._model = {};
+
+  // 移除所有监听器
+  this.removeAllListeners();
+};
+
+/**
+ * 获取模型实例
+ * @param {string} name 模型名称
+ * @returns {object | null} 模型实例或null
+ */
+Service.prototype.getModel = function(name) {
+  if (!name || typeof name !== 'string') {
+    throw new Error('模型名称必须是非空字符串');
+  }
+
+  return this._model[name] || null;
+};
+
+exports.Service = Service;

package/core/service/script.tpl.js

@@ -0,0 +1,25 @@
+/**
+ * 领域服务
+ */
+module.exports = {
+  /**
+   * 初始化
+   * @param {object} model 模型对象
+   * @param {object} eventer 事件总线
+   */
+  async _init(model, eventer) {
+    // 初始化代码写在这，如：
+    // this.timer = setInterval(() => {
+    //   console.log('定时任务')
+    // }, 1000);
+    this.log('debug', 'service _init 被调用');
+  },
+  /**
+   * 主要逻辑
+   * @param {...any} args 参数列表
+   */
+  async main(...args) {
+    // 主要代码写在这
+    this.log('debug', 'service main 被调用', { args });
+  }
+};

package/core/store/config.tpl.json

@@ -0,0 +1,26 @@
+{
+  // 名称
+  "name": "${name}",
+  // 标题
+  "title": "${title || '存储'}",
+  // 描述
+  "description": "${description || '存储'}",
+  // 主文件
+  "main": "${main || 'index.js'}",
+  // 状态 0：禁用 1：启用
+  "state": 1,
+  // 排序，越小越靠前
+  "sort": 100,
+  // 缓存方式 none、memory、redis、mongodb
+  "cache_type": "memory",
+  // 保存方式 none、sqlite、mysql、json
+  "save_type": "none",
+  // 表名
+  "table": "store",
+  // 主键
+  "key": "id",
+  // ID
+  "id": "id",
+  // 默认分页大小
+  "page_size": 30 
+}