var terndefs_f6783a0a_522d_417e_8407_94c67b692e50 = [ { '!name': 'browser', Node: { '!type': 'fn()', prototype: { nextSibling: { '!type': '+Element', '!doc': '返回紧接其父节点的childNodes列表中指定节点之后的节点;如果指定节点是该列表中的最后一个节点,则返回null.' }, previousSibling: { '!type': '+Element', '!doc': '返回紧接其父节点的childNodes列表中指定节点之前的节点,如果指定节点是该列表中的第一个节点,则返回null.' }, lastChild: { '!type': '+Element', '!doc': '返回节点的最后一个孩子.' }, firstChild: { '!type': '+Element', '!doc': '返回树中该节点的第一个子节点;如果该节点为无子节点,则返回null.如果该节点是Document,则返回其直接子节点列表中的第一个节点.' }, childNodes: { '!type': '+NodeList', '!doc': '返回给定元素的子节点的集合.' }, parentNode: { '!type': '+Element', '!doc': '返回DOM树中指定节点的父级.' }, tagName: { '!type': 'string', '!doc': '将当前节点的名称作为字符串返回.' }, insertBefore: { '!type': 'fn(newElt: +Element, before: +Element) -> +Element', '!doc': '将指定的节点插入到参考元素之前,作为当前节点的子级.' }, removeChild: { '!type': 'fn(oldNode: +Element) -> +Element', '!doc': '从DOM中删除一个子节点.返回已删除的节点.' }, appendChild: { '!type': 'fn(newNode: +Element) -> +Element', '!doc': '将一个节点添加到指定父节点的子节点列表的末尾.如果该节点已经存在,则将其从当前父节点中删除,然后添加到新的父节点中.' }, cloneNode: { '!type': 'fn(deep: bool) -> +Element', '!doc': '返回在其上调用此方法的节点的副本.' }, addEventListener: { '!type': 'fn(type: string, listener: fn(e: +Event), capture: bool)', '!doc': '在单个目标上注册单个事件侦听器.事件目标可以是文档中的单个元素,文档本身,窗口或XMLHttpRequest.' }, removeEventListener: { '!type': 'fn(type: string, listener: fn(), capture: bool)', '!doc': '允许从事件目标中删除事件侦听器.' }, innerText: { '!type': 'string', '!doc': '获取或设置节点及其后代的文本内容.' } }, '!doc': '节点是一个接口,许多DOM类型都从该接口继承,并允许类似地对待(或测试)这些各种类型.' }, Element: { '!type': 'fn()', prototype: { '!proto': 'Node.prototype', getAttribute: { '!type': 'fn(name: string) -> string', '!doc': '返回指定元素上的命名属性的值.如果命名属性不存在,则返回的值将为null或" "(空字符串).' }, setAttribute: { '!type': 'fn(name: string, value: string)', '!doc': '在指定元素上添加新属性或更改现有属性的值.' }, removeAttribute: { '!type': 'fn(name: string)', '!doc': '从指定元素中删除属性.' }, getElementsByTagName: { '!type': 'fn(tagName: string) -> +NodeList', '!doc': '返回具有给定标签名的元素列表.搜索指定元素下面的子树,不包括元素本身.返回的列表是活动的,这意味着它将自动使用DOM树进行更新.因此,无需使用相同的元素和参数多次调用element.getElementsByTagName.' }, getElementsByClassName: { '!type': 'fn(name: string) -> +NodeList', '!doc': '返回具有所有给定类名称的一组元素.在文档对象上调用时,将搜索整个文档,包括根节点.您还可以在任何元素上调用getElementsByClassName;它将仅返回元素,它们是具有给定类名的指定根元素的后代.' }, children: { '!type': '+HTMLCollection', '!doc': '返回给定元素的子元素的集合.' }, className: { '!type': 'string', '!doc': '获取并设置指定元素的class属性的值.' }, style: { cssText: 'string', alignmentBaseline: 'string', background: 'string', backgroundAttachment: 'string', backgroundClip: 'string', backgroundColor: 'string', backgroundImage: 'string', backgroundOrigin: 'string', backgroundPosition: 'string', backgroundPositionX: 'string', backgroundPositionY: 'string', backgroundRepeat: 'string', backgroundRepeatX: 'string', backgroundRepeatY: 'string', backgroundSize: 'string', baselineShift: 'string', border: 'string', borderBottom: 'string', borderBottomColor: 'string', borderBottomLeftRadius: 'string', borderBottomRightRadius: 'string', borderBottomStyle: 'string', borderBottomWidth: 'string', borderCollapse: 'string', borderColor: 'string', borderImage: 'string', borderImageOutset: 'string', borderImageRepeat: 'string', borderImageSlice: 'string', borderImageSource: 'string', borderImageWidth: 'string', borderLeft: 'string', borderLeftColor: 'string', borderLeftStyle: 'string', borderLeftWidth: 'string', borderRadius: 'string', borderRight: 'string', borderRightColor: 'string', borderRightStyle: 'string', borderRightWidth: 'string', borderSpacing: 'string', borderStyle: 'string', borderTop: 'string', borderTopColor: 'string', borderTopLeftRadius: 'string', borderTopRightRadius: 'string', borderTopStyle: 'string', borderTopWidth: 'string', borderWidth: 'string', bottom: 'string', boxShadow: 'string', boxSizing: 'string', captionSide: 'string', clear: 'string', clip: 'string', clipPath: 'string', clipRule: 'string', color: 'string', colorInterpolation: 'string', colorInterpolationFilters: 'string', colorProfile: 'string', colorRendering: 'string', content: 'string', counterIncrement: 'string', counterReset: 'string', cursor: 'string', direction: 'string', display: 'string', dominantBaseline: 'string', emptyCells: 'string', enableBackground: 'string', fill: 'string', fillOpacity: 'string', fillRule: 'string', filter: 'string', float: 'string', floodColor: 'string', floodOpacity: 'string', font: 'string', fontFamily: 'string', fontSize: 'string', fontStretch: 'string', fontStyle: 'string', fontVariant: 'string', fontWeight: 'string', glyphOrientationHorizontal: 'string', glyphOrientationVertical: 'string', height: 'string', imageRendering: 'string', kerning: 'string', left: 'string', letterSpacing: 'string', lightingColor: 'string', lineHeight: 'string', listStyle: 'string', listStyleImage: 'string', listStylePosition: 'string', listStyleType: 'string', margin: 'string', marginBottom: 'string', marginLeft: 'string', marginRight: 'string', marginTop: 'string', marker: 'string', markerEnd: 'string', markerMid: 'string', markerStart: 'string', mask: 'string', maxHeight: 'string', maxWidth: 'string', minHeight: 'string', minWidth: 'string', opacity: 'string', orphans: 'string', outline: 'string', outlineColor: 'string', outlineOffset: 'string', outlineStyle: 'string', outlineWidth: 'string', overflow: 'string', overflowWrap: 'string', overflowX: 'string', overflowY: 'string', padding: 'string', paddingBottom: 'string', paddingLeft: 'string', paddingRight: 'string', paddingTop: 'string', page: 'string', pageBreakAfter: 'string', pageBreakBefore: 'string', pageBreakInside: 'string', pointerEvents: 'string', position: 'string', quotes: 'string', resize: 'string', right: 'string', shapeRendering: 'string', size: 'string', speak: 'string', src: 'string', stopColor: 'string', stopOpacity: 'string', stroke: 'string', strokeDasharray: 'string', strokeDashoffset: 'string', strokeLinecap: 'string', strokeLinejoin: 'string', strokeMiterlimit: 'string', strokeOpacity: 'string', strokeWidth: 'string', tabSize: 'string', tableLayout: 'string', textAlign: 'string', textAnchor: 'string', textDecoration: 'string', textIndent: 'string', textLineThrough: 'string', textLineThroughColor: 'string', textLineThroughMode: 'string', textLineThroughStyle: 'string', textLineThroughWidth: 'string', textOverflow: 'string', textOverline: 'string', textOverlineColor: 'string', textOverlineMode: 'string', textOverlineStyle: 'string', textOverlineWidth: 'string', textRendering: 'string', textShadow: 'string', textTransform: 'string', textUnderline: 'string', textUnderlineColor: 'string', textUnderlineMode: 'string', textUnderlineStyle: 'string', textUnderlineWidth: 'string', top: 'string', unicodeBidi: 'string', unicodeRange: 'string', vectorEffect: 'string', verticalAlign: 'string', visibility: 'string', whiteSpace: 'string', width: 'string', wordBreak: 'string', wordSpacing: 'string', wordWrap: 'string', writingMode: 'string', zIndex: 'string', zoom: 'string', '!doc': '返回一个表示元素的style属性的对象.' }, classList: { '!type': '+DOMTokenList', '!doc': '返回元素的class属性的标记列表.' }, title: { '!type': 'string', '!doc': ' "\u5efa\u7acb\u5f53\u9f20\u6807\u60ac\u505c\u5728\u663e\u793a\u7684\u8282\u70b9\u4e0a\u65f6\u5728"\u5de5\u5177\u63d0\u793a"\u5f39\u51fa\u7a97\u53e3\u4e2d\u663e\u793a\u7684\u6587\u672c.",' }, width: { '!type': 'number', '!doc': '返回元素的布局宽度.' }, height: { '!type': 'number', '!doc': '元素相对于元素的offsetParent的高度.' }, getContext: { '!type': 'fn(id: string) -> CanvasRenderingContext2D', '!doc': ' DOM画布元素公开了HTMLCanvasElement接口,该接口提供了用于操纵画布元素的布局和表示的属性和方法.HTMLCanvasElement接口继承了元素对象接口的属性和方法.' }, innerHTML: { '!type': 'string', '!doc': '设置或获取描述元素后代的HTML语法.' } }, '!doc': '表示HTML或XML文档中的元素.' }, Document: { '!type': 'fn()', prototype: { '!proto': 'Node.prototype', height: { '!type': 'number', '!doc': '返回当前文档的元素的高度.' }, width: { '!type': 'number', '!doc': '以像素为单位返回当前文档的元素的宽度.' }, body: { '!type': '+Element', '!doc': '返回当前文档的或节点.' }, cookie: { '!type': 'string', '!doc': '获取并设置与当前文档关联的cookie.' }, URL: 'string', title: { '!type': 'string', '!doc': '获取或设置文档的标题.' }, getElementById: { '!type': 'fn(id: string) -> +Element', '!doc': '通过元素ID返回对该元素的引用.' }, getElementsByTagName: { '!type': 'fn(tagName: string) -> +NodeList', '!doc': '返回具有给定标签名称的元素的NodeList.将搜索整个文档,包括根节点.返回的NodeList处于活动状态,这意味着它会自动更新自身以与DOM树保持同步,而无需再次调用document.getElementsByTagName.' }, getElementsByName: { '!type': 'fn(name: string) -> +HTMLCollection', '!doc': '返回HTML文档中具有给定名称的元素列表.' }, getElementsByClassName: 'Element.prototype.getElementsByClassName' }, '!doc': '浏览器中加载的每个网页都有其自己的文档对象.此对象用作网页内容(DOM树,包括诸如和之类的元素)的入口点,并提供文档的全局功能(例如获取页面的URL和在文档中创建新元素).' }, document: { '!type': '+Document', '!doc': '浏览器中加载的每个网页都有其自己的文档对象.此对象用作网页内容(DOM树,包括诸如和
之类的元素)的入口点,并提供文档的全局功能(例如获取页面的URL和在文档中创建新元素).' }, Event: { '!type': 'fn()', prototype: { stopPropagation: { '!type': 'fn()', '!doc': '防止当前事件进一步传播.' }, preventDefault: { '!type': 'fn()', '!doc': '如果可以取消事件,则取消该事件,而不停止事件的进一步传播.' }, stopImmediatePropagation: { '!type': 'fn()', '!doc': '防止同一事件的其他侦听器被调用.' }, type: { '!type': 'string', '!doc': '返回包含事件类型的字符串.' }, target: { '!type': '+Element', '!doc': ' EventTarget是由对象实现的DOM接口,这些对象可以接收DOM事件并具有侦听器.最常见的EventTarget是DOM元素,尽管其他对象也可以是EventTarget,例如文档,窗口,XMLHttpRequest,和别的.' }, clientX: { '!type': 'number', '!doc': '返回事件发生的应用程序客户区域内的水平坐标(与页面内的坐标相反).例如,单击客户区域左上角将始终显示clientX值为0的鼠标事件,无论页面是否水平滚动.' }, clientY: { '!type': 'number', '!doc': '返回事件发生在应用程序客户区中的垂直坐标(与页面中的坐标相反).例如,单击客户区左上角将始终显示不管页面是否垂直滚动,clientY值为0的鼠标事件.' }, keyCode: { '!type': 'number', '!doc': '返回按键事件中的非字符键或任何其他类型的键盘事件中的任何键的Unicode值.' }, charCode: { '!type': 'number', '!doc': '返回在按键事件期间按下的字符键的Unicode值.' }, which: { '!type': 'number', '!doc': '返回所按下键的数字keyCode或所按下字母数字键的字符代码(charCode).' }, button: { '!type': 'number', '!doc': '指示导致事件的鼠标按钮.' }, shiftKey: { '!type': 'bool', '!doc': '指示事件触发时是否按下SHIFT键.' }, ctrlKey: { '!type': 'bool', '!doc': '指示事件触发时是否按下了CTRL键.' }, altKey: { '!type': 'bool', '!doc': '指示事件触发时是否按下ALT键.' } } }, Storage: { length: { '!type': 'number', '!doc': '存储接口的length只读属性返回一个整数,该整数表示存储在存储对象中的数据项的数量.' }, setItem: { '!type': 'fn(name: string, value: string)', '!doc': '存储接口的setItem()方法在传递键名称和值时,会将该键添加到存储中,或者更新该键的值(如果已存在).' }, getItem: { '!type': 'fn(name: string) -> string', '!doc': '存储接口的getItem()方法在传递键名时将返回该键的值.' }, key: { '!type': 'fn(index: number) -> string', '!doc': '存储接口的key()方法传递数字n时,返回存储中第n个键的名称.键的顺序是用户代理定义的,因此您不应依赖它.' }, removeItem: { '!type': 'fn(key: string)', '!doc': '存储接口的removeItem()方法在传递了键名后,将从存储中删除该键.' }, clear: { '!type': 'fn()', '!doc': '存储接口的clear()方法在被调用时将从存储中清空所有键.' } }, localStorage: { '!type': 'Storage', '!doc': ' localStorage属性允许您访问本地存储对象.localStorage与sessionStorage类似.唯一的区别是,虽然存储在localStorage中的数据没有到期时间,但是浏览会话时存储在sessionStorage中的数据将被清除.结束-也就是说,当浏览器关闭时. n n请注意,存储在localStorage或sessionStorage中的数据特定于页面协议.' }, console: { assert: { '!type': 'fn(assertion: bool, text: string)', '!doc': '如果断言为false,则将错误消息写入控制台.' }, error: { '!type': 'fn(...msg: ?)', '!doc': '将错误消息输出到Web控制台.' }, info: { '!type': 'fn(...msg: ?)', '!doc': '将参考消息输出到Web控制台.' }, log: { '!type': 'fn(...msg: ?)', '!doc': '将消息输出到Web控制台.' }, time: { '!type': 'fn(label: string)', '!doc': '启动计时器,您可以使用该计时器来跟踪操作需要多长时间.' }, timeEnd: { '!type': 'fn(label: string)', '!doc': '停止以前通过调用console.time()启动的计时器.' }, trace: { '!type': 'fn()', '!doc': '将堆栈跟踪输出到Web控制台.' }, warn: { '!type': 'fn(...msg: ?)', '!doc': '将警告消息输出到Web控制台.' }, '!doc': '控制台对象提供对浏览器调试控制台的访问.其工作方式的细节因浏览器而异,但实际上提供了一组事实上的功能.' }, window: { '!type': '', '!doc': '窗口对象代表一个包含DOM文档的窗口.' }, self: { '!type': '', '!doc': '将对象引用返回到窗口对象.' }, devicePixelRatio: 'number', requestAnimationFrame: { '!type': 'fn(callback: fn(timestamp: number)) -> number', '!doc': ' Window.requestAnimationFrame()方法告诉浏览器您希望执行动画,并请求浏览器在下一次重绘之前调用指定的函数来更新动画.该方法将回调作为参数在重新粉刷之前被调用.' }, cancelAnimationFrame: { '!type': 'fn(number)n', '!doc': '取消先前安排的动画帧请求.' }, alert: { '!type': 'fn(message: string)', '!doc': '显示具有指定内容和确定按钮的警报对话框.' }, confirm: { '!type': 'fn(message: string) -> bool', '!doc': '显示带有消息和两个按钮(确定和取消)的模式对话框.' }, prompt: { '!type': 'fn(message: string, value: string) -> string', '!doc': '显示一个对话框,提示用户输入一些文本.' }, setTimeout: { '!type': 'fn(f: fn(), ms: number) -> number', '!doc': '在指定的延迟后调用函数或执行代码段.' }, clearTimeout: { '!type': 'fn(timeout: number)', '!doc': '清除window.setTimeout()设置的延迟.' }, setInterval: { '!type': 'fn(f: fn(), ms: number) -> number', '!doc': '反复调用一个函数或执行代码段,每次调用该函数之间有固定的时间延迟.' }, clearInterval: { '!type': 'fn(interval: number)', '!doc': '取消使用setInterval设置的重复操作.' }, atob: { '!type': 'fn(encoded: string) -> string', '!doc': '解码使用base-64编码编码的数据字符串.' }, btoa: { '!type': 'fn(data: string) -> string', '!doc': '从一串二进制数据创建一个base-64编码的ASCII字符串.' }, getComputedStyle: { '!type': 'fn(node: +Element, pseudo?: string) -> Element.prototype.style', '!doc': '给出元素的所有CSS属性的最终使用值.' }, CanvasRenderingContext2D: { canvas: '+Element', width: 'number', height: 'number', commit: 'fn()', save: 'fn()', restore: 'fn()', currentTransform: '?', scale: 'fn(x: number, y: number)', rotate: 'fn(angle: number)', translate: 'fn(x: number, y: number)', transform: 'fn(a: number, b: number, c: number, d: number, e: number, f: number)', setTransform: 'fn(a: number, b: number, c: number, d: number, e: number, f: number)', resetTransform: 'fn()', globalAlpha: 'number', globalCompositeOperation: 'string', imageSmoothingEnabled: 'bool', strokeStyle: 'string', fillStyle: 'string', createLinearGradient: 'fn(x0: number, y0: number, x1: number, y1: number) -> ?', createPattern: 'fn(image: ?, repetition: string) -> ?', shadowOffsetX: 'number', shadowOffsetY: 'number', shadowBlur: 'number', shadowColor: 'string', clearRect: 'fn(x: number, y: number, w: number, h: number)', fillRect: 'fn(x: number, y: number, w: number, h: number)', strokeRect: 'fn(x: number, y: number, w: number, h: number)', fillRule: 'string', fill: 'fn()', beginPath: 'fn()', stroke: 'fn()', clip: 'fn()', resetClip: 'fn()', fillText: 'fn(text: string, x: number, y: number, maxWidth: number)', strokeText: 'fn(text: string, x: number, y: number, maxWidth: number)', measureText: 'fn(text: string) -> ?', drawImage: 'fn(image: ?, dx: number, dy: number)', createImageData: 'fn(sw: number, sh: number) -> ?', getImageData: 'fn(sx: number, sy: number, sw: number, sh: number) -> ?', putImageData: 'fn(imagedata: ?, dx: number, dy: number)', lineWidth: 'number', lineCap: 'string', lineJoin: 'string', miterLimit: 'number', setLineDash: 'fn(segments: [number])', getLineDash: 'fn() -> [number]', lineDashOffset: 'number', font: 'string', textAlign: 'string', textBaseline: 'string', direction: 'string', closePath: 'fn()', moveTo: 'fn(x: number, y: number)', lineTo: 'fn(x: number, y: number)', quadraticCurveTo: 'fn(cpx: number, cpy: number, x: number, y: number)', bezierCurveTo: 'fn(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number)', arcTo: 'fn(x1: number, y1: number, x2: number, y2: number, radius: number)', rect: 'fn(x: number, y: number, w: number, h: number)', arc: 'fn(x: number, y: number, radius: number, startAngle: number, endAngle: number, anticlockwise?: bool)', ellipse: 'fn(x: number, y: number, radiusX: number, radiusY: number, rotation: number, startAngle: number, endAngle: number, anticlockwise: bool)' } }, { '!name': 'ecmascript', Infinity: { '!type': 'number', '!doc': '代表无穷大的数值.' }, undefined: { '!type': '?', '!doc': '该值未定义.' }, NaN: { '!type': 'number', '!doc': '代表非数字的值.' }, Object: { '!type': 'fn()', create: { '!type': 'fn(proto: ?) -> !custom:Object_create', '!doc': '使用指定的原型对象和属性创建一个新对象.' }, defineProperty: { '!type': 'fn(obj: ?, prop: string, desc: propertyDescriptor) -> !custom:Object_defineProperty', '!doc': '直接在对象上定义新属性,或修改对象上的现有属性,然后返回对象.如果想了解如何将Object.defineProperty方法与类似二进制标志的语法一起使用,请参阅本文.' }, keys: { '!type': 'fn(obj: ?) -> [string]', '!doc': '返回一个给定对象自己的可枚举属性的数组,其顺序与for-in循环所提供的顺序相同(不同之处在于for-in循环也枚举了原型链中的属性). ' }, assign: { '!type': 'fn(target: ?, source: ?, source?: ?) -> !0', '!effects': ['copy !1 !0', 'copy !2 !0', 'copy !3 !0'], '!doc': ' Object.assign()方法用于将所有可枚举的自身属性的值从一个或多个源对象复制到目标对象.它将返回目标对象.,' }, prototype: { '!stdProto': 'Object', toString: { '!type': 'fn() -> string', '!doc': '返回表示对象的字符串.' }, hasOwnProperty: { '!type': 'fn(prop: string) -> bool', '!doc': '返回一个布尔值,指示对象是否具有指定的属性.' } } }, Function: { '!type': 'fn(body: string) -> fn()', prototype: { '!stdProto': 'Function', apply: { '!type': 'fn(this: ?, args: [?])', '!effects': [ 'call and return !this this=!0 !1. !1. !1.' ], '!doc': '调用具有给定值的函数,并以数组(或类似对象的数组)形式提供参数.' }, call: { '!type': 'fn(this: ?, args?: ?) -> !this.!ret', '!effects': ['call and return !this this=!0 !1 !2 !3 !4'], '!doc': '调用具有给定值和单独提供的参数的函数.' }, bind: { '!type': 'fn(this: ?, args?: ?) -> !custom:Function_bind', '!doc': '创建一个新函数,该函数在被调用时将其this关键字设置为提供的值,并在调用新函数时提供给定的参数序列.' }, prototype: '?' } }, Array: { '!type': 'fn(size: number) -> !custom:Array_ctor', isArray: { '!type': 'fn(value: ?) -> bool', '!doc': '如果对象是数组,则返回true,否则返回false.' }, from: { '!type': 'fn(arrayLike: ?, mapFn?: fn(elt: ?, i: number) -> ?, thisArg?: ?) -> [!0.]', '!effects': ['call !1 this=!2 !0. number'], '!doc': ' Array.from()方法从类似数组或可迭代的对象创建一个新的Array实例.,' }, of: { '!type': 'fn(elementN: ?) -> [!0]', '!doc': ' Array.of()方法创建一个新的Array实例,该实例具有可变数量的参数,而不考虑参数的数量或类型.,' }, prototype: { '!stdProto': 'Array', length: { '!type': 'number', '!doc': '一个无符号的32位整数,指定数组中的元素数.' }, concat: { '!type': 'fn(other: [?]) -> !this', '!doc': '返回一个新数组,该数组由该数组与其他数组和/或值组成.' }, join: { '!type': 'fn(separator?: string) -> string', '!doc': '将数组的所有元素连接到字符串中.' }, splice: { '!type': 'fn(pos: number, amount: number, newelt?: ?) -> [?]', '!doc': '更改数组的内容,在删除旧元素的同时添加新元素.' }, pop: { '!type': 'fn() -> !this.', '!doc': '从数组中删除最后一个元素并返回该元素.' }, push: { '!type': 'fn(newelt: ?) -> number', '!effects': ['propagate !0 !this.'], '!doc': '通过添加给定元素并返回数组的新长度来更改数组.' }, shift: { '!type': 'fn() -> !this.', '!doc': '从数组中删除第一个元素并返回该元素.此方法更改数组的长度.' }, unshift: { '!type': 'fn(newelt: ?) -> number', '!effects': ['propagate !0 !this.'], '!doc': '将一个或多个元素添加到数组的开头,并返回数组的新长度.' }, slice: { '!type': 'fn(from?: number, to?: number) -> !this', '!doc': '返回数组一部分的浅表副本.' }, reverse: { '!type': 'fn()', '!doc': '就地反转数组.第一个数组元素变为最后一个,而最后一个数组变为第一个.' }, sort: { '!type': 'fn(compare?: fn(a: ?, b: ?) -> number)', '!effects': ['call !0 !this. !this.'], '!doc': '将数组中的元素排序并返回数组.' }, indexOf: { '!type': 'fn(elt: ?, from?: number) -> number', '!doc': '返回在数组中可以找到给定元素的第一个索引;如果不存在,则返回-1.' }, lastIndexOf: { '!type': 'fn(elt: ?, from?: number) -> number', '!doc': '返回在数组中找到给定元素的最后一个索引,如果不存在则返回-1.从fromIndex开始向后搜索数组.' }, filter: { '!type': 'fn(test: fn(elt: ?, i: number, array: +Array) -> bool, context?: ?) -> !this', '!effects': ['call !0 this=!1 !this. number !this'], '!doc': '创建一个新数组,其中包含所有通过提供的功能实现的测试的元素.' }, forEach: { '!type': 'fn(f: fn(elt: ?, i: number, array: +Array), context?: ?)', '!effects': ['call !0 this=!1 !this. number !this'], '!doc': '每个数组元素执行一次提供的功能.' }, map: { '!type': 'fn(f: fn(elt: ?, i: number, array: +Array) -> ?, context?: ?) -> [!0.!ret]', '!effects': ['call !0 this=!1 !this. number !this'], '!doc': '创建一个新数组,其结果是对该数组中的每个元素调用提供的函数.' }, reduce: { '!type': 'fn(combine: fn(sum: ?, elt: ?, i: number, array: +Array) -> ?, init?: ?) -> !0.!ret', '!effects': ['call !0 !1 !this. number !this'], '!doc': '对一个累加器和数组的每个值(从左到右)应用一个函数,以将其减小为单个值.' }, fill: { '!type': 'fn(value: ?, start?: number, end?: number) -> !this', '!doc': ' fill()方法使用静态值填充数组的所有元素,从开始索引到结束索引.,' }, find: { '!type': 'fn(callback: fn(element: ?, index: number, array: [?]) -> bool, thisArg?: ?) -> !this.', '!effects': ['call !0 this=!2 !this. number'], '!doc': '如果数组中的元素满足提供的测试功能,则find()方法将在数组中返回一个值.否则,返回undefined.,' }, findIndex: { '!type': 'fn(callback: fn(element: ?, index: number, array: [?]), thisArg?: ?) -> number', '!effects': ['call !0 this=!2 !this. number'], '!doc': '如果数组中的元素满足提供的测试功能,则findIndex()方法将返回数组中的索引.否则返回-1.,' }, keys: { '!type': 'fn() -> +iter[:t=number]', '!doc': ' keys()方法返回一个新的数组迭代器,其中包含数组中每个索引的键.,' }, values: { '!type': 'fn() -> +iter[:t=!this.]', '!doc': ' values()方法返回一个新的Array Iterator对象,该对象包含数组中每个索引的值.,' }, includes: { '!type': 'fn(value: ?, fromIndex?: number) -> bool', '!doc': '确定数组是否包含某个元素,并根据需要返回true或false.,' } } }, String: { '!type': 'fn(value: ?) -> string', prototype: { '!stdProto': 'String', length: { '!type': 'number', '!doc': '表示字符串的长度.' }, '': 'string', charAt: { '!type': 'fn(i: number) -> string', '!doc': '从字符串中返回指定的字符.' }, charCodeAt: { '!type': 'fn(i: number) -> number', '!doc': '返回给定索引处字符的数字Unicode值(Unicode代码点> 0x10000除外).' }, indexOf: { '!type': 'fn(char: string, from?: number) -> number', '!doc': '返回指定值首次出现的调用String对象中的索引,从fromIndex开始搜索, n如果未找到该值,则返回-1.' }, lastIndexOf: { '!type': 'fn(char: string, from?: number) -> number', '!doc': '返回指定值最后一次出现的调用String对象内的索引,如果未找到则返回-1.从fromIndex开始向后搜索调用字符串.' }, substring: { '!type': 'fn(from: number, to?: number) -> string', '!doc': '返回一个索引与另一个索引之间或字符串末尾的字符串子集.
from为起始位置,to为终止位置.' }, substr: { '!type': 'fn(from: number, length?: number) -> string', '!doc': '以指定的字符数返回从指定位置开始的字符串中的字符.
from为起始位置,length为长度' }, slice: { '!type': 'fn(from: number, to?: number) -> string', '!doc': '提取字符串的一部分并返回新的字符串.' }, padStart: { '!type': 'fn(targetLength: number, padString?: string) -> string', '!doc': '用另一个字符串(如果需要,重复)填充当前字符串,以使结果字符串达到给定的长度.' }, padEnd: { '!type': 'fn(targetLength: number, padString?: string) -> string', '!doc': '用给定的字符串(如果需要,重复)填充当前字符串,以使结果字符串达到给定的长度.' }, trim: { '!type': 'fn() -> string', '!doc': '从字符串的两端删除空格.' }, trimStart: { '!type': 'fn() -> string', '!doc': '从字符串的开头删除空格.' }, trimEnd: { '!type': 'fn() -> string', '!doc': '从字符串末尾删除空格.' }, toUpperCase: { '!type': 'fn() -> string', '!doc': '返回转换为大写的调用字符串值.' }, toLowerCase: { '!type': 'fn() -> string', '!doc': '返回转换为小写的调用字符串值.' }, split: { '!type': 'fn(pattern?: string|+RegExp, limit?: number) -> [string]', '!doc': '通过将字符串分成子字符串,将String对象拆分为字符串数组.' }, concat: { '!type': 'fn(other: string) -> string', '!doc': '将两个或多个字符串的文本合并,并返回一个新字符串.' }, match: { '!type': 'fn(pattern: +RegExp) -> [string]', '!doc': '用于将字符串与正则表达式匹配时用于检索匹配.' }, replace: { '!type': 'fn(pattern: string|+RegExp, replacement: string) -> string', '!doc': '返回一个新字符串,该字符串的某个或所有匹配项都由替换项替换.该模式可以是字符串或RegExp,并且替换项可以是字符串或每个匹配项将调用的函数. ' }, endsWith: { '!type': 'fn(searchString: string, position?: number) -> bool', '!doc': ' endsWith()方法确定一个字符串是否以另一个字符串的字符结尾,并根据需要返回true或false.,' }, startsWith: { '!type': 'fn(searchString: string, position?: number) -> bool', '!doc': ' startsWith()方法确定一个字符串是否以另一个字符串的字符开头,并根据需要返回true或false.,' } } }, Number: { '!type': 'fn(value: ?) -> number', MAX_VALUE: { '!type': 'number', '!doc': ' JavaScript中可表示的最大数值.' }, MIN_VALUE: { '!type': 'number', '!doc': ' JavaScript中可表示的最小正数值.' }, POSITIVE_INFINITY: { '!type': 'number', '!doc': '代表正无穷大值的值.' }, NEGATIVE_INFINITY: { '!type': 'number', '!doc': '代表负无穷大值的值.' }, prototype: { '!stdProto': 'Number', toString: { '!type': 'fn(radix?: number) -> string', '!doc': '返回代表指定Number对象的字符串' }, toFixed: { '!type': 'fn(digits: number) -> string', '!doc': '使用定点符号格式化数字' }, toExponential: { '!type': 'fn(digits: number) -> string', '!doc': '返回以指数表示形式表示Number对象的字符串' }, toPrecision: { '!type': 'fn(digits: number) -> string', '!doc': ' toPrecision()方法返回一个字符串,该数字表示指定精度的数字.' } }, EPSILON: { '!type': 'number', '!doc': ' Number.EPSILON属性表示一个数值与可以表示为Number的最小值之间的差异.,' }, MAX_SAFE_INTEGER: { '!type': 'number', '!doc': ' Number.MAX_SAFE_INTEGER常量表示JavaScript中的最大安全整数(2 ^ 53-1).,' }, MIN_SAFE_INTEGER: { '!type': 'number', '!doc': ' Number.MIN_SAFE_INTEGER常量表示JavaScript(-(2 ^ 53-1))中的最小安全整数.,' }, isFinite: { '!type': 'fn(testValue: ?) -> bool', '!doc': ' Number.isFinite()方法确定传递的值是否为有限值.,' }, isInteger: { '!type': 'fn(testValue: ?) -> bool', '!doc': ' Number.isInteger()方法确定传递的值是否为整数.,' }, isNaN: { '!type': 'fn(testValue: ?) -> bool', '!doc': ' Number.isNaN()方法确定传递的值是否为NaN.原始全局isNaN()的更可靠的版本.,' }, isSafeInteger: { '!type': 'fn(testValue: ?) -> bool', '!doc': ' Number.isSafeInteger()方法确定所提供的值是否是一个安全整数的数字.安全整数是该数字的整数.' }, parseFloat: { '!type': 'fn(string: string) -> number', '!doc': ' Number.parseFloat()方法解析字符串参数并返回浮点数.,' }, parseInt: { '!type': 'fn(string: string, radix?: number) -> number', '!doc': ' Number.parseInt()方法解析字符串参数并返回指定基数或基数的整数.,' } }, Boolean: { '!type': 'fn(value: ?) -> bool', prototype: { '!stdProto': 'Boolean' } }, abstract: '?', arguments: '?', boolean: '?', break: '?', byte: '?', case: '?', catch: '?', char: '?', const: '?', continue: '?', debugger: '?', default: '?', delete: '?', do: '?', double: '?', else: '?', eval: '?', false: 'bool', final: '?', finally: '?', float: '?', for: '?', function: '?', goto: '?', if: '?', implements: '?', in: '?', instanceof: '?', int: '?', interface: '?', long: '?', native: '?', new: '?', null: '?', package: '?', private: '?', protected: '?', public: '?', return: '?', short: '?', static: '?', switch: '?', synchronized: '?', this: '?', throw: '?', throws: '?', transient: '?', true: 'bool', try: '?', typeof: '?', var: '?', void: '?', volatile: '?', while: '?', with: '?', yield: '?', RegExp: { '!type': 'fn(source: string, flags?: string)', prototype: { '!stdProto': 'RegExp', exec: { '!type': 'fn(input: string) -> [string]', '!doc': '搜索指定字符串中的匹配项.返回结果数组,或者为null.' }, test: { '!type': 'fn(input: string) -> bool', '!doc': '执行正则表达式和指定字符串之间的匹配搜索.返回true或false.' } }, '!doc': '创建正则表达式对象以将文本与模式匹配.' }, parseInt: { '!type': 'fn(string: string, radix?: number) -> number', '!doc': '解析字符串参数并返回指定基数或基数的整数.' }, parseFloat: { '!type': 'fn(string: string) -> number', '!doc': '解析字符串参数并返回浮点数.' }, isNaN: { '!type': 'fn(value: number) -> bool', '!doc': '确定值是否为NaN.请注意,此函数已损坏.您可能对ECMAScript 6 Number.isNaN感兴趣.' }, isFinite: { '!type': 'fn(value: number) -> bool', '!doc': '确定传递的值是否为有限数字.' }, eval: { '!type': 'fn(code: string) -> ?', '!doc': '评估以字符串形式表示的JavaScript代码.' }, encodeURI: { '!type': 'fn(uri: string) -> string', '!doc': '通过用表示字符的UTF-8编码的一个,两个,三个或四个转义序列替换某些字符的每个实例来编码统一资源标识符(URI)(对于字符而言将仅是四个转义序列由两个"代理"字符组成).' }, encodeURIComponent: { '!type': 'fn(uri: string) -> string', '!doc': '通过用表示字符的UTF-8编码的一个,两个,三个或四个转义序列替换某些字符的每个实例来编码统一资源标识符(URI)组件(对于由两个"代理"字符组成的字符).' }, decodeURI: { '!type': 'fn(uri: string) -> string', '!doc': '解码以前由encodeURI或类似例程创建的统一资源标识符(URI).' }, decodeURIComponent: { '!type': 'fn(uri: string) -> string', '!doc': '解码以前由encodeURIComponent或类似例程创建的统一资源标识符(URI)组件.' }, Math: { E: { '!type': 'number', '!doc': '自然对数的底数,e约为2.718.' }, LN2: { '!type': 'number', '!doc': ' 2的自然对数,大约为0.693.' }, LN10: { '!type': 'number', '!doc': ' 10的自然对数,大约为2.302.' }, LOG2E: { '!type': 'number', '!doc': ' E的以2为底的对数(大约1.442).' }, LOG10E: { '!type': 'number', '!doc': ' E的以10为底的对数(约0.434).' }, SQRT1_2: { '!type': 'number', '!doc': ' 1/2的平方根;等效于2的平方根上的1,大约为0.707.' }, SQRT2: { '!type': 'number', '!doc': ' 2的平方根,大约为1.414.' }, PI: { '!type': 'number', '!doc': '圆的周长与其直径之比,大约为3.14159.' }, abs: { '!type': 'fn(number) -> number', '!doc': '返回数字的绝对值.' }, cos: { '!type': 'fn(number) -> number', '!doc': '返回数字的余弦.' }, sin: { '!type': 'fn(number) -> number', '!doc': '返回数字的正弦.' }, tan: { '!type': 'fn(number) -> number', '!doc': '返回数字的正切值.' }, acos: { '!type': 'fn(number) -> number', '!doc': '返回数字的反余弦(以弧度为单位).' }, asin: { '!type': 'fn(number) -> number', '!doc': '返回数字的反正弦(以弧度为单位).' }, atan: { '!type': 'fn(number) -> number', '!doc': '返回数字的反正切(以弧度为单位).' }, atan2: { '!type': 'fn(y: number, x: number) -> number', '!doc': '返回其参数商的反正切值.' }, ceil: { '!type': 'fn(number) -> number', '!doc': '返回大于或等于数字的最小整数.' }, floor: { '!type': 'fn(number) -> number', '!doc': '返回小于或等于数字的最大整数.' }, round: { '!type': 'fn(number) -> number', '!doc': '返回四舍五入到最接近整数的数字的值.' }, exp: { '!type': 'fn(number) -> number', '!doc': '返回E ^ x,其中x是自变量,E是欧拉常数,自然对数的底.' }, log: { '!type': 'fn(number) -> number', '!doc': '返回数字的自然对数(以E为底).' }, sqrt: { '!type': 'fn(number) -> number', '!doc': '返回数字的平方根.' }, pow: { '!type': 'fn(number, number) -> number', '!doc': '将基数返回指数幂,即baseexponent.' }, max: { '!type': 'fn(number, number) -> number', '!doc': '返回零个或多个数字中的最大值.' }, min: { '!type': 'fn(number, number) -> number', '!doc': '返回零个或多个数字中的最小值.' }, random: { '!type': 'fn() -> number', '!doc': '返回一个浮点伪随机数,范围为[0,1),即从0(包括)到不包括1(排除),然后您可以缩放到所需的值范围.' }, log10: { '!type': 'fn(x: number) -> number', '!doc': ' Math.log10()函数返回数字的以10为底的对数.' }, log2: { '!type': 'fn(x: number) -> number', '!doc': ' Math.log2()函数返回数字的以2为底的对数.' }, sign: { '!type': 'fn(x: number) -> number', '!doc': ' Math.sign()函数返回数字的符号,指示数字是正数,负数还是零.,' }, trunc: { '!type': 'fn(x: number) -> number', '!doc': ' Math.trunc()函数通过删除任何小数位来返回数字的整数部分.它不舍入任何数字.该函数可以用floor()和ceil()函数表示: ,' }, '!doc': '一个内置对象,具有用于数学常数和函数的属性和方法.' }, JSON: { parse: { '!type': 'fn(json: string, reviver?: fn(key: string, value: ?) -> ?) -> ?', '!doc': '将字符串解析为JSON,可以选择转换解析产生的值.' }, stringify: { '!type': 'fn(value: ?, replacer?: fn(key: string, value: ?) -> ?, space?: string|number) -> string', '!doc': '将值转换为JSON,如果指定了replacer函数,则可以选择替换值,如果指定了replacer数组,则可以选择仅包括指定的属性.' }, '!doc': ' JSON(JavaScript对象表示法)是一种数据交换格式.尽管它不是严格的子集,但它非常类似于JavaScript语法的子集.(有关详细信息,请参见JavaScript参考中的JSON.)在编写任何类型的基于JavaScript的应用程序(包括网站和浏览器扩展程序)时非常有用.例如,您可以将JSON格式的用户信息存储在cookie中,或者可以将扩展名首选项以JSON形式存储在字符串值的浏览器首选项中.' } }, { '!name': 'core', '!define': { image: { '!doc': '图片信息', width: 'number', height: 'number', src: 'string' }, audio: { '!doc': '音乐音效信息', currentTime: 'number', play: 'fn()', pause: 'fn()', paused: 'bool', duration: 'number', volume: 'number' }, flag: { '!doc': '当前变量', hard: { '!type': 'number', '!doc': '当前难度编号' }, hatred: { '!type': 'number', '!doc': '当前仇恨值' }, poison: { '!type': 'bool', '!doc': '是否处于中毒状态' }, weak: { '!type': 'number', '!doc': '是否处于衰弱状态' }, curse: { '!type': 'number', '!doc': '是否处于诅咒状态' }, no_zone: { '!type': 'bool', '!doc': '无视领域伤害' }, no_repulse: { '!type': 'bool', '!doc': '无视阻击伤害' }, no_lasel: { '!type': 'bool', '!doc': '无视激光伤害' }, no_ambush: { '!type': 'bool', '!doc': '无视捕捉' }, __bgm__: { '!type': 'string', '!doc': '背景音乐' }, __weather__: { '!doc': '天气' }, __color__: { '!doc': '色调' }, __volume__: { '!type': 'number', '!doc': '音量' }, skill: { '!type': 'number', '!doc': '当前开启的技能编号' }, skillName: { '!type': 'string', '!doc': '当前开启的技能名' }, input: { '!type': 'string|number', '!doc': '等待用户输入后的存放值' }, type: { '!type': 'number', '!doc': '等待用户操作后获得的操作类型' }, keycode: { '!type': 'number', '!doc': '等待用户操作后用户按键的键值' }, x: { '!type': 'number', '!doc': '等待用户操作后用户点击的网格横坐标' }, y: { '!type': 'number', '!doc': '等待用户操作后用户点击的网格纵坐标' }, px: { '!type': 'number', '!doc': '等待用户操作后用户点击的像素横坐标' }, py: { '!type': 'number', '!doc': '等待用户操作后用户点击的像素纵坐标' }, __visited__: { '!doc': '当前访问过的楼层' }, __leaveLoc__: { '!doc': '每个楼层的离开位置,用于楼传平面塔模式' }, cannotMoveDirectly: { '!type': 'bool', '!doc': '当前是否全局不可瞬移' } }, hero: { '!doc': '勇士当前属性', image: { '!type': 'string', '!doc': '行走图' }, animate: { '!type': 'bool', '!doc': '是否开启帧动画' }, name: { '!type': 'string', '!doc': '勇士名' }, lv: { '!type': 'number', '!doc': '勇士等级' }, hpmax: { '!type': 'number', '!doc': '勇士生命上限' }, hp: { '!type': 'number', '!doc': '勇士当前生命值' }, atk: { '!type': 'number', '!doc': '勇士当前攻击力' }, def: { '!type': 'number', '!doc': '勇士当前防御力' }, manamax: { '!type': 'number', '!doc': '勇士当前魔力上限,负数无效' }, mana: { '!type': 'number', '!doc': '勇士当前魔力值' }, mdef: { '!type': 'number', '!doc': '勇士当前护盾值' }, money: { '!type': 'number', '!doc': '勇士当前金币' }, exp: { '!type': 'number', '!doc': '勇士当前经验' }, equipment: { '!type': '[string]', '!doc': '勇士当前装备' }, items: { '!doc': '勇士当前道具', constants: { '!doc': '永久道具' }, tools: { '!doc': '消耗道具', yellowKey: { '!type': 'number', '!doc': '黄钥匙个数' }, blueKey: { '!type': 'number', '!doc': '蓝钥匙个数' }, redKey: { '!type': 'number', '!doc': '红钥匙个数' }, greenKey: { '!type': 'number', '!doc': '绿钥匙个数' }, steelKey: { '!type': 'number', '!doc': '铁门钥匙个数' } }, equips: { '!doc': '在背包中未装备上的装备' } }, loc: { '!doc': '勇士当前坐标和朝向', x: 'number', y: 'number', direction: { '!doc': '朝向,只能为 up,down,left,right 之一', '!type': 'string' } }, flags: { '!type': 'flag', '!doc': '当前游戏中用到的变量' }, followers: { '!type': '[?]', '!doc': '跟随者信息' }, steps: { '!type': 'number', '!doc': '当前步数' } }, block: { '!doc': '地图图块信息', x: { '!type': 'number', '!doc': '图块的x坐标' }, y: { '!type': 'number', '!doc': '图块的y坐标' }, id: { '!type': 'number', '!doc': '图块的数字' }, event: { '!doc': '图块上的事件信息', id: { '!type': 'string', '!doc': '图块的ID' }, cls: { '!type': 'string', '!doc': '图块的类别,一般为所在图片名去掉后缀' }, disabled: { '!type': 'bool', '!doc': '启用状态' } } }, blockInfo: { '!doc': '图块的更多信息', animate: { '!type': 'number', '!doc': '动画帧数' }, cls: { '!type': 'string', '!doc': '图块类别' }, faceIds: { '!doc': '行走图朝向', up: 'string', down: 'string', left: 'string', right: 'string' }, height: { '!type': 'number', '!doc': '图块高度' }, id: { '!type': 'string', '!doc': '图块ID' }, image: { '!type': 'image', '!doc': '图块所在的图片' }, name: { '!type': 'string', '!doc': '图块名称' }, number: { '!type': 'number', '!doc': '图块使用的数字' }, posX: { '!type': 'number', '!doc': '图块在图片上的横坐标' }, posY: { '!type': 'number', '!doc': '图块在图片上的纵坐标' } }, enemy: { '!doc': '怪物信息', id: { '!type': 'string', '!doc': '怪物ID' }, name: { '!type': 'string', '!doc': '怪物名称' }, displayIdInBook: { '!type': 'string', '!doc': '在怪物手册映射ID' }, hp: { '!type': 'number', '!doc': '怪物生命值' }, atk: { '!type': 'number', '!doc': '怪物攻击' }, def: { '!type': 'number', '!doc': '怪物防御' }, money: { '!type': 'number', '!doc': '怪物金币' }, exp: { '!type': 'number', '!doc': '怪物经验' }, special: { '!type': '[number]', '!doc': '怪物特殊属性' }, point: { '!type': 'number', '!doc': '怪物加点' }, value: { '!type': 'number', '!doc': '怪物特殊属性值:阻激夹域伤害值;吸血比例;光环增加生命比例' }, zoneSquare: { '!type': 'bool', '!doc': '领域怪是否九宫格伤害;区域光环是否九宫格范围' }, range: { '!type': 'number', '!doc': '领域伤害的范围;区域光环范围' }, notBomb: { '!type': 'bool', '!doc': '怪物不可炸' }, n: { '!type': 'number', '!doc': '多连击的连击数;净化比例' }, add: { '!type': 'bool', '!doc': '吸血是否加到自身;光环是否叠加' }, atkValue: { '!type': 'number', '!doc': '反击比例;退化扣除攻击;光环增加攻击;' }, defValue: { '!type': 'number', '!doc': '破甲比例;退化扣除防御;光环增加防御' }, damage: { '!type': 'number', '!doc': '固伤值' } }, item: { '!doc': '道具信息', id: { '!type': 'string', '!doc': '道具ID' }, cls: { '!type': 'string', '!doc': '道具类型' }, name: { '!type': 'string', '!doc': '道具名称' }, text: { '!type': 'string', '!doc': '道具描述' }, hideInToolbox: { '!type': 'bool', '!doc': '不显示在道具栏' }, equip: { '!doc': '装备属性', type: { '!type': 'number|string', '!doc': '装备类型' }, animate: { '!type': 'string', '!doc': '装备动画' }, value: { '!doc': '数值加成' }, percentage: { '!doc': '比例加成' } }, hideInReplay: { '!type': 'bool', '!doc': '回放不绘制道具栏' } }, floor: { '!doc': '楼层信息', floorId: { '!type': 'string', '!doc': '楼层ID' }, title: { '!type': 'string', '!doc': '楼层中文名' }, name: { '!type': 'string', '!doc': '状态栏显示值' }, width: { '!type': 'number', '!doc': '地图宽' }, height: { '!type': 'number', '!doc': '地图高' }, canFlyTo: { '!type': 'bool', '!doc': '该楼是否可以楼传飞到' }, canFlyFrom: { '!type': 'bool', '!doc': '该楼是否可以楼传飞出' }, canUseQuickShop: { '!type': 'bool', '!doc': '该楼是否可快捷商店' }, cannotViewMap: { '!type': 'bool', '!doc': '该层是否不允许被浏览地图看到,也不统计' }, cannotMoveDirectly: { '!type': 'bool', '!doc': '该层是否不允许瞬间移动' }, upFloor: { '!type': '[number]', '!doc': '上楼点' }, downFloor: { '!type': '[number]', '!doc': '下楼点' }, flyPoint: { '!type': '[number]', '!doc': '楼传落点' }, color: { '!doc': '楼层色调' }, weather: { '!doc': '楼层天气' }, bgm: { '!type': 'string', '!doc': '楼层背景音乐' }, ratio: { '!type': 'number', '!doc': '宝石/血瓶效果' }, map: { '!type': '[[number]]', '!doc': '地图数据' }, blocks: { '!type': '[block]', '!doc': '本层图块信息' } }, animate: { '!doc': '动画信息', se: { '!type': 'string', '!doc': '动画音效' } } }, core: { '!doc': '核心游戏控制', __SIZE__: { '!type': 'number', '!doc': '窗口宽度,为13或15' }, __PIXELS__: { '!type': 'number', '!doc': '窗口像素宽度,为416或480' }, __HALF_SIZE__: { '!type': 'number', '!doc': '窗口宽度的一半,为6或7' }, floorIds: { '!type': '[string]', '!doc': '全部楼层ID列表' }, floors: { '!doc': '全部楼层信息' }, floorPartitions: { '!type': '[[string]]', '!doc': '楼层分区信息' }, material: { '!doc': '游戏所用到的资源', animates: { '!doc': '注册的动画' }, images: { '!doc': '注册的图片' }, bgms: { '!doc': '注册的背景音乐' }, sounds: { '!doc': '注册的音效' }, enemys: { '!doc': '怪物定义' }, items: { '!doc': '道具定义' } }, timeout: { '!doc': '当前异步事件句柄' }, interval: { '!doc': '当前异步事件延时' }, animateFrame: { '!doc': '当前各个帧动画' }, musicStatus: { '!doc': '音乐音效状态', bgmStatus: { '!type': 'bool', '!doc': '是否播放BGM' }, soundStatus: { '!type': 'bool', '!doc': '是否播放SE' }, playingBgm: { '!type': 'string', '!doc': '正在播放的bgm' }, lastBgm: { '!type': 'string', '!doc': '上次播放的bgm' }, playingSounds: { '!doc': '正在播放的SE' }, volume: { '!type': 'number', '!doc': '当前bgm音量' } }, platform: { '!doc': '平台信息', isPC: 'bool', isAndroid: 'bool', isIOS: 'bool' }, domStyle: { '!doc': '界面样式', scale: { '!type': 'number', '!doc': '当前界面放缩比例' }, ratio: { '!type': 'number', '!doc': '高清UI放缩比例' }, hdCanvas: { '!type': '[string]', '!doc': '高清UI的系统画布' }, availableScale: { '!type': '[number]', '!doc': '当前界面支持的放缩比例' }, isVertical: { '!type': 'bool', '!doc': '当前是否是竖屏' }, showStatusBar: { '!type': 'bool', '!doc': '当前是否显示状态栏' }, toolbarBtn: { '!type': 'bool', '!doc': '当前工具栏是否是1-8的按钮' } }, bigmap: { '!doc': '大地图信息', canvas: { '!type': '[string]', '!doc': '大地图的画布' }, width: { '!type': 'number', '!doc': '大地图高度' }, height: { '!type': 'number', '!doc': '大地图宽度' }, offsetX: { '!type': 'number', '!doc': '大地图视角横向偏移量' }, offsetY: { '!type': 'number', '!doc': '大地图视角纵向偏移量' }, posX: { '!type': 'number', '!doc': '大地图视角横向基准格' }, posY: { '!type': 'number', '!doc': '大地图视角纵向基准格' }, v2: { '!type': 'bool', '!doc': '是否是新版大地图绘制方式' }, threshold: { '!type': 'number', '!doc': '新版大地图绘制方式的分界线' }, extend: { '!type': 'number', '!doc': '新版大地图模式下向每一侧额外计算的数量' }, scale: { '!type': 'number', '!doc': '缩略图的比例放缩' }, tempCanvas: { '!type': 'CanvasRenderingContext2D', '!doc': '临时画布' } }, saves: { '!doc': '当前存档信息' }, dymCanvas: { '!doc': '各个自定义画布' }, statusBar: { '!doc': '状态栏信息' }, canvas: { '!doc': '系统画布' }, flags: { '!doc': '系统开关' }, values: { '!doc': '全局数值,如毒衰效果' }, firstData: { '!doc': '初始属性,如出生点' }, status: { '!doc': '状态信息', hero: { '!type': 'hero', '!doc': '勇士信息' }, automaticRoute: { '!doc': '自动寻路信息' }, bgmaps: { '!doc': '各地图背景层' }, fgmaps: { '!doc': '各地图前景层' }, mapBlockObjs: { '!doc': '以<位置,block>存放的各地图图块信息' }, boxAnimateObjs: { '!doc': '(手册和剧情文本的)帧动画对象' }, checkBlock: { '!doc': '阻激夹域捕捉信息', damage: { '!doc': '每个点的伤害信息' }, type: { '!doc': '每个点的伤害类型' }, repluse: { '!doc': '每个点的阻击信息' }, ambush: { '!doc': '每个点的捕捉信息' }, needCache: { '!type': 'bool', '!doc': '该楼层是否需要计算缓存' }, cache: { '!doc': '每个点的光环缓存' } }, damage: { '!doc': '每个点的显伤信息' }, ctrlDown: { '!type': 'bool', '!doc': 'Ctrl键是否被按下' }, curtainColor: { '!doc': '当前画面色调' }, event: { '!doc': '当前事件', data: { '!doc': '事件信息,如坐标等' }, id: { '!type': 'string', '!doc': '事件类型,如选择项/确认框' }, interval: { '!type': 'number', '!doc': '打字机效果的定时器' }, selection: { '!type': 'number', '!doc': '选择项和确认框的当前选中项' }, ui: { '!doc': '当前事件的界面信息,如楼传/手册/SL' } }, floorAnimateObjs: { '!doc': '楼层贴图的帧动画' }, floorId: { '!type': 'string', '!doc': '当前楼层ID' }, gameOver: { '!type': 'bool', '!doc': '游戏是否已结束' }, globalAnimateObjs: { '!doc': '各全局动画' }, globalAnimateStatus: { '!type': 'number', '!doc': '全局动画的帧状态' }, globalAttribute: { '!doc': '全局css属性' }, hard: { '!type': 'string', '!doc': '状态栏一角的难度名' }, downTime: { '!type': 'number', '!doc': '方向键已按下的时间' }, heroCenter: { '!doc': '勇士中心像素坐标', px: { '!type': 'number', '!doc': '勇士中心的横坐标' }, py: { '!type': 'number', '!doc': '勇士中心的纵坐标' } }, heroMoving: { '!type': 'number', '!doc': '勇士行走的状态值' }, heroStop: { '!type': 'bool', '!doc': '勇士是否已停下' }, holdingKeys: { '!type': '[number]', '!doc': '当前按下的键' }, id2number: { '!doc': '图块ID到数字的对应关系' }, lockControl: { '!type': 'bool', '!doc': '当前是否是锁定操作状态' }, maps: { '!doc': '当前各地图信息' }, number2Block: { '!doc': '数字到图块对象的对应关系' }, played: { '!type': 'bool', '!doc': '当前是否游戏中(不包括标题画面和录像回放)' }, replay: { '!doc': '当前录像回放信息', animate: { '!type': 'bool', '!doc': '回放是否正处于动画中' }, pausing: { '!type': 'bool', '!doc': '回放是否暂停中' }, replaying: { '!type': 'bool', '!doc': '当前是否回放中' }, save: { '!type': '[]', '!doc': '录像中的存档' }, speed: { '!type': 'number', '!doc': '回放速度' }, steps: { '!type': 'number', '!doc': '回放步数' }, toReplay: { '!type': '[string]', '!doc': '待回放的列表' }, totalList: { '!type': '[string]', '!doc': '回放总列表' } }, route: { '!type': '[string]', '!doc': '当前录像内容' }, shops: { '!doc': '全局商店列表' }, textAttribute: { '!doc': '当前剧情文本属性' }, thisMap: { '!type': 'floor', '!doc': '当前地图信息' } }, init: { '!doc': '初始化core', '!type': 'fn(coreData: ?, callback: fn())' }, doFunc: { '!doc': '执行一个函数;如果函数名是字符串则转发到插件中', '!type': 'fn(func: name|fn(), _this?: ?)' }, control: { '!doc': '负责整个游戏的核心控制系统,分为如下几个部分:
- requestAnimationFrame相关
- 标题界面,开始和重新开始游戏
- 自动寻路和人物行走相关
- 画布、位置、阻激夹域、显伤等相关
- 录像的回放相关
- 存读档,自动存档,同步存档等相关
- 人物属性和状态、位置、变量等相关
- 天气、色调、音乐和音效的播放
- 状态栏和工具栏相关
- 界面resize相关', showStatusBar: { '!doc': '显示状态栏', '!type': 'fn()' }, startReplay: { '!doc': '开始播放录像', '!type': 'fn(list: [string])' }, triggerReplay: { '!doc': '播放或暂停录像回放', '!type': 'fn()' }, screenFlash: { '!doc': '画面闪烁
例如:core.screenFlash([255, 0, 0, 1], 3); // 红屏一闪而过
color: 一行三列(第四列视为1)或一行四列(第四列若大于1则会被视为1,第四列若填负数则会被视为0)的颜色数组,必填
time: 单次闪烁时长,实际闪烁效果为先花其三分之一的时间渐变到目标色调,再花剩余三分之二的时间渐变回去
times: 闪烁的总次数,不填或填0都视为1
moveMode: 渐变方式
callback: 闪烁全部完毕后的回调函数,可选', '!type': 'fn(color: [number], time: number, times?: number, moveMode?: string, callback?: fn())' }, setCurtain: { '!doc': '更改画面色调,不计入存档。如需长期生效请使用core.events._action_setCurtain()函数
例如:core.setCurtain(); // 恢复画面色调,用时四分之三秒
color: 一行三列(第四列视为1)或一行四列(第四列若大于1则会被视为1,第四列若为负数则会被视为0)的颜色数组,不填视为[0, 0, 0, 0]
time: 渐变时间,单位为毫秒。不填视为750ms,负数视为0(无渐变,立即更改)
moveMode: 渐变方式
callback: 更改完毕后的回调函数,可选。事件流中常取core.doAction', '!type': 'fn(color?: [number], time?: number, moveMode?: string, callback?: fn())' }, updateDamage: { '!doc': '注意!请勿使用该函数!请使用core.updateStatusBar()代替!!重算并绘制地图显伤
例如:core.updateDamage(); // 更新当前地图的显伤,绘制在显伤层(废话)
floorId: 地图id,不填视为当前地图。预览地图时填写
ctx: 绘制到的画布,如果填写了就会画在该画布而不是显伤层', '!type': 'fn(floorId?: string, ctx?: string|CanvasRenderingContext2D)' }, drawDamage: { '!doc': '仅绘制地图显伤', '!type': 'fn(string|CanvasRenderingContext2D)' }, nextX: { '!doc': "获取主角面前第n格的横坐标
例如:core.closeDoor(core.nextX(), core.nextY(), 'yellowDoor', core.turnHero); // 在主角面前关上一扇黄门,然后主角顺时针旋转90°
n: 目标格与主角的距离,面前为正数,背后为负数,脚下为0,不填视为1", '!type': 'fn(n?: number) -> number' }, nextY: { '!doc': '获取主角面前第n格的纵坐标
例如:core.jumpHero(core.nextX(2), core.nextY(2)); // 主角向前跃过一格,即跳跃靴道具的使用效果
n: 目标格与主角的距离,面前为正数,背后为负数,脚下为0,不填视为1', '!type': 'fn(n?: number) -> number' }, clearContinueAutomaticRoute: { '!doc': '清空剩下的自动寻路列表', '!type': 'fn(callback?: fn())' }, updateViewport: { '!doc': '更新大地图的可见区域', '!type': 'fn()' }, getMappedName: { '!doc': '获得映射文件名', '!type': 'fn(name: string) -> string' }, addFlag: { '!doc': "增减一个flag变量,等价于 core.setFlag(name, core.getFlag(name, 0) + value)
例如:core.addFlag('hatred', 1); // 增加1点仇恨值
name: 变量名,支持中文
value: 变量的增量", '!type': 'fn(name: string, value: number)' }, setFlag: { '!doc': "设置一个flag变量
例如:core.setFlag('poison', true); // 令主角中毒
name: 变量名,支持中文
value: 变量的新值,不填或填null视为删除", '!type': 'fn(name: string, value: ?)' }, playSound: { '!doc': '播放一个音效
sound: 音效名;可以使用文件别名。
pitch: 播放的音调;可选,如果设置则为30-300之间的数值。
callback: 可选,播放完毕后执行的回调函数。
返回:一个数字,可用于core.stopSound的参数来只停止该音效。', '!type': 'fn(sound: string, pitch?: number, callback?: fn()) -> number' }, stopSound: { '!doc': '停止播放音效。如果未指定id则停止所有音效,否则只停止指定的音效。', '!type': 'fn(id?: number)' }, getPlayingSounds: { '!doc': '获得当前正在播放的所有(指定)音效的id列表
name: 音效名,可用别名;不填代表返回正在播放的全部音效
返回值: 一个列表,每一项为一个正在播放的音效id;可用core.stopSound立刻停止播放', '!type': 'fn(name?: string) -> [number]' }, addGameCanvasTranslate: { '!doc': '加减画布偏移', '!type': 'fn(x?: number, y?: number)' }, addBuff: { '!doc': "增减主角某个属性的百分比修正倍率,加减法叠加和抵消。等价于 core.setBuff(name, core.getBuff(name) + value)
例如:core.addBuff('atk', -0.1); // 主角获得一层“攻击力减一成”的负面效果
name: 属性的英文名,请注意只能用于数值类属性哦,否则随后的乘法会得到NaN
value: 倍率的增量", '!type': 'fn(name: string, value: number)' }, drawHero: { '!doc': '绘制主角和跟随者并重置视野到以主角为中心
例如:core.drawHero(); // 原地绘制主角的静止帧并重置视野野
status: 只能为 stop, leftFoot 和 rightFoot,不填用stop。
offset: 相对主角逻辑位置的偏移量,不填视为无偏移。
frame: 绘制的第几帧', '!type': 'fn(status?: string, offset?: number, frame?: number)' }, pauseBgm: { '!doc': '暂停背景音乐的播放', '!type': 'fn()' }, setBgmSpeed: { '!doc': '设置背景音乐的播放速度和音调
speed: 播放速度,必须为30-300中间的值。100为正常速度。
usePitch: 是否同时改变音调(部分设备可能不支持)', '!type': 'fn(speed: number, usePitch?: bool)' }, setReplaySpeed: { '!doc': '设置播放速度', '!type': 'fn(speed: number)' }, pauseReplay: { '!doc': '暂停播放', '!type': 'fn()' }, doSL: { '!doc': '实际进行存读档事件', '!type': 'fn(id?: string, type?: string)' }, setStatus: { '!doc': "设置主角的某个属性
例如:core.setStatus('atk', 100); // 设置攻击力为100
name: 属性的英文名,其中'x'、'y'和'direction'会被特殊处理为 core.setHeroLoc(name, value),其他的会直接对 core.status.hero[name] 赋值
value: 属性的新值", '!type': 'fn(name: string, value: number)' }, setAutomaticRoute: { '!doc': '半自动寻路,用于鼠标或手指拖动
例如:core.setAutomaticRoute(0, 0, [{direction: "right", x: 4, y: 9}, {direction: "right", x: 5, y: 9}]);
destX: 鼠标或手指的起拖点横坐标
destY: 鼠标或手指的起拖点纵坐标
stepPostfix: 拖动轨迹的数组表示,每项为一步的方向和目标点。', '!type': 'fn(destX: number, destY: number, stepPostfix: [{x: number, y: number, direction: string}])' }, setHeroOpacity: { '!doc': '改变勇士的不透明度', '!type': 'fn(opacity?: number, moveMode?: string, time?: number, callback?: fn())' }, gatherFollowers: { '!doc': '立刻聚集所有的跟随者', '!type': 'fn()' }, getStatus: { '!doc': "读取主角的某个属性,不包括百分比修正
例如:core.getStatus('atk'); // 读取主角的攻击力
name: 属性的英文名,其中'x'、'y'和'direction'会被特殊处理为 core.getHeroLoc(name),其他的会直接读取 core.status.hero[name]", '!type': 'fn(name: string) -> number' }, setHeroLoc: { '!doc': "设置勇士位置
值得注意的是,这句话虽然会使勇士改变位置,但并不会使界面重新绘制;
如需立刻重新绘制地图还需调用:core.clearMap('hero'); core.drawHero(); 来对界面进行更新。
例如:core.setHeroLoc('x', 5) // 将勇士当前位置的横坐标设置为5。
name: 要设置的坐标属性
value: 新值
noGather: 是否聚集跟随者", '!type': 'fn(name: string, value: string|number, noGather?: bool)' }, getLvName: { '!doc': '根据级别的数字获取对应的名称,后者定义在全塔属性
例如:core.getLvName(); // 获取主角当前级别的名称,如“下级佣兵”
lv: 级别的数字,不填则视为主角当前的级别
返回值:级别的名称,如果不存在就还是返回数字', '!type': 'fn(lv?: number) -> string|number' }, getNextLvUpNeed: { '!doc': '获得下次升级需要的经验值。
升级扣除模式下会返回经验差值;非扣除模式下会返回总共需要的经验值。
如果无法进行下次升级,返回null。', '!type': 'fn() -> number' }, addStatus: { '!doc': "增减主角的某个属性,等价于core.setStatus(name, core.getStatus(name) + value)
例如:core.addStatus('atk', 100'); // 给主角攻击力加100
name: 属性的英文名
value: 属性的增量", '!type': 'fn(name: string, value: number)' }, speedUpReplay: { '!doc': '加速播放', '!type': 'fn()' }, loadData: { '!doc': '从本地读档', '!type': 'fn(data?: ?, callback?: fn())' }, debug: { '!doc': '开启调试模式, 此模式下可以按Ctrl键进行穿墙, 并忽略一切事件。
此模式下不可回放录像和上传成绩。', '!type': 'fn()' }, moveOneStep: { '!doc': '每移动一格后执行的事件
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】', '!type': 'fn(callback?: fn())' }, clearStatus: { '!doc': '清除游戏状态和数据', '!type': 'fn()' }, updateFollowers: { '!doc': '更新跟随者坐标', '!type': 'fn()' }, waitHeroToStop: { '!doc': '等待主角停下
例如:core.waitHeroToStop(core.vibrate); // 等待主角停下,然后视野左右抖动1秒
callback: 主角停止后的回调函数', '!type': 'fn(callback?: fn())' }, hideStatusBar: { '!doc': '隐藏状态栏
showToolbox: 是否不隐藏竖屏工具栏', '!type': 'fn(showToolbox?: bool)' }, getBuff: { '!doc': "读取主角某个属性的百分比修正倍率,初始值为1
例如:core.getBuff('atk'); // 主角当前能发挥出多大比例的攻击力
name: 属性的英文名", '!type': 'fn(name: string) -> number' }, triggerDebuff: { '!doc': "获得或移除毒衰咒效果
action: 要获得还是移除,'get'为获得,'remove'为移除
type: 获得或移除的内容(poison/weak/curse),可以为字符串或数组", '!type': 'fn(action: string, type: string|[string])' }, setToolbarButton: { '!doc': '改变工具栏为按钮1-8', '!type': 'fn(useButton?: bool)' }, getSaves: { '!doc': '获得某些存档内容', '!type': 'fn(ids?: ?, callback?: fn())' }, replay: { '!doc': '回放下一个操作', '!type': 'fn()' }, getStatusOrDefault: { '!doc': '从status中获得属性,如果不存在则从勇士属性中获取', '!type': 'fn(status?: ?, name?: string)' }, unregisterReplayAction: { '!doc': '注销一个录像行为', '!type': 'fn(name: string)' }, unregisterWeather: { '!doc': '注销一个天气', '!type': 'fn(name: string)' }, setBuff: { '!doc': "设置主角某个属性的百分比修正倍率,初始值为1,
倍率存放在flag: '__'+name+'_buff__' 中
例如:core.setBuff('atk', 0.5); // 主角能发挥出的攻击力减半
name: 属性的英文名,请注意只能用于数值类属性哦,否则随后的乘法会得到NaN
value: 新的百分比修正倍率,不填(效果上)视为1", '!type': 'fn(name: string, value: number)' }, continueAutomaticRoute: { '!doc': '继续剩下的自动寻路操作', '!type': 'fn()' }, setAutoHeroMove: { '!doc': '连续行走
例如:core.setAutoHeroMove([{direction: "up", step: 1}, {direction: "left", step: 3}]); // 上左左左
steps: 压缩的步伐数组,每项表示朝某方向走多少步', '!type': 'fn(steps: [?])' }, unregisterResize: { '!doc': '注销一个resize函数', '!type': 'fn(name: string)' }, saveAndStopAutomaticRoute: { '!doc': '保存剩下的寻路,并停止', '!type': 'fn()' }, hideStartAnimate: { '!doc': '淡出标题画面
例如:core.hideStartAnimate(core.startGame); // 淡出标题画面并开始新游戏,跳过难度选择
callback: 标题画面完全淡出后的回调函数', '!type': 'fn(callback?: fn())' }, getAllSaves: { '!doc': '获得所有存档内容', '!type': 'fn(callback?: fn())' }, updateHeroIcon: { '!doc': '更新状态栏的勇士图标', '!type': 'fn(name: string)' }, setMusicBtn: { '!doc': '设置音乐图标的显隐状态', '!type': 'fn()' }, isPlaying: { '!doc': '游戏是否已经开始', '!type': 'fn() -> bool' }, triggerBgm: { '!doc': '开启或关闭背景音乐的播放', '!type': 'fn()' }, moveHero: { '!doc': '连续前进,不撞南墙不回头
例如:core.moveHero(); // 连续前进
direction: 可选,如果设置了就会先转身到该方向
callback: 可选,如果设置了就只走一步
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】', '!type': 'fn(direction?: string, callback?: fn())' }, getRealStatusOrDefault: { '!doc': '从status中获得实际属性(增幅后的),如果不存在则从勇士属性中获取', '!type': 'fn(status?: ?, name?: string)' }, getStatusLabel: { '!doc': '获得某个状态的名字,如atk->攻击,def->防御等', '!type': 'fn(name: string) -> string' }, removeSave: { '!doc': '删除某个存档', '!type': 'fn(index?: number, callback?: fn())' }, registerAnimationFrame: { '!doc': '注册一个 animationFrame
name: 名称,可用来作为注销使用
needPlaying: 是否只在游戏运行时才执行(在标题界面不执行)
func: 要执行的函数,或插件中的函数名;可接受timestamp(从页面加载完毕到当前所经过的时间)作为参数', '!type': 'fn(name: string, needPlaying: bool, func?: fn(timestamp: number))' }, getHeroLoc: { '!doc': '读取主角的位置和/或朝向
例如:core.getHeroLoc(); // 读取主角的位置和朝向
name: 要读取横坐标还是纵坐标还是朝向还是都读取
返回值:name ? core.status.hero.loc[name] : core.status.hero.loc', '!type': 'fn(name: string) -> string|number' }, stopAutomaticRoute: { '!doc': '停止自动寻路操作', '!type': 'fn()' }, setWeather: { '!doc': "设置天气,不计入存档。如需长期生效请使用core.events._action_setWeather()函数
例如:core.setWeather('fog', 10); // 设置十级大雾天
type: 新天气的类型,不填视为晴天
level: 新天气(晴天除外)的级别,必须为不大于10的正整数,不填视为5", '!type': 'fn(type?: string, level?: number)' }, updateStatusBar: { '!doc': '刷新状态栏和地图显伤
doNotCheckAutoEvents: 是否不检查自动事件', '!type': 'fn(doNotCheckAutoEvents?: bool, immediate?: bool)' }, autosave: { '!doc': '自动存档', '!type': 'fn(removeLast?: bool)' }, clearStatusBar: { '!doc': '清空状态栏', '!type': 'fn()' }, moveAction: { '!doc': '尝试前进一步,如果面前不可被踏入就会直接触发该点事件
请勿直接使用此函数,如有需要请使用「勇士前进一步或撞击」事件
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】', '!type': 'fn(callback?: fn())' }, hasFlag: { '!doc': "判定一个flag变量是否存在且不为false、0、''、null、undefined和NaN
例如:core.hasFlag('poison'); // 判断主角当前是否中毒
name: 变量名,支持中文
此函数等价于 !!core.getFlag(name)", '!type': 'fn(name: string) -> bool' }, rewindReplay: { '!doc': '回退到上一个录像节点', '!type': 'fn()' }, playBgm: { '!doc': "播放背景音乐,中途开播但不计入存档且只会持续到下次场景切换。如需长期生效请将背景音乐的文件名赋值给flags.__bgm__
例如:core.playBgm('bgm.mp3', 30); // 播放bgm.mp3,并跳过前半分钟
bgm: 背景音乐的文件名,支持全塔属性中映射前的中文名
startTime: 跳过前多少秒,不填则不跳过", '!type': 'fn(bgm: string, startTime?: number)' }, isReplaying: { '!doc': '是否正在播放录像', '!type': 'fn() -> bool' }, isMoving: { '!doc': '当前是否正在移动', '!type': 'fn() -> bool' }, getSaveIndexes: { '!doc': '获得所有存在存档的存档位', '!type': 'fn(callback?: fn())' }, unlockControl: { '!doc': '解锁用户控制行为', '!type': 'fn()' }, syncSave: { '!doc': '同步存档到服务器', '!type': 'fn(type?: string)' }, removeFlag: { '!doc': '删除某个flag/变量', '!type': 'fn(name: string)' }, registerResize: { '!doc': '注册一个resize函数
name: 名称,可供注销使用
func: 可以是一个函数,或者是插件中的函数名;可以接受obj参数,详见resize函数。', '!type': 'fn(name: string, func: fn(obj: ?))' }, registerWeather: { '!doc': '注册一个天气
name: 要注册的天气名
initFunc: 当切换到此天气时的初始化;接受level(天气等级)为参数;可用于创建多个节点(如初始化雪花)
frameFunc: 每帧的天气效果变化;可接受timestamp(从页面加载完毕到当前所经过的时间)和level(天气等级)作为参数
天气应当仅在weather层进行绘制,推荐使用core.animateFrame.weather.nodes用于节点信息。', '!type': 'fn(name: string, initFunc: fn(level: number), frameFunc?: fn(timestamp: number, level: number))' }, stopReplay: { '!doc': '停止播放', '!type': 'fn(force?: bool)' }, turnHero: { '!doc': '主角转向并计入录像,不会导致跟随者聚集,会导致视野重置到以主角为中心
例如:core.turnHero(); // 主角顺时针旋转90°,即单击主角或按下Z键的效果
direction: 主角的新朝向,可为 up, down, left, right, :left, :right, :back 七种之一', '!type': 'fn(direction?: string)' }, resumeReplay: { '!doc': '恢复播放', '!type': 'fn()' }, resize: { '!doc': '屏幕分辨率改变后重新自适应', '!type': 'fn()' }, getSave: { '!doc': '获得某个存档内容', '!type': 'fn(index?: number, callback?: fn(data: ?))' }, setViewport: { '!doc': '设置视野范围
px,py: 左上角相对大地图的像素坐标,不需要为32倍数', '!type': 'fn(px?: number, py?: number)' }, chooseReplayFile: { '!doc': '选择录像文件', '!type': 'fn()' }, lockControl: { '!doc': '锁定用户控制,常常用于事件处理', '!type': 'fn()' }, updateCheckBlock: { '!doc': '更新领域、夹击、阻击的伤害地图', '!type': 'fn(floorId?: string)' }, checkBlock: { '!doc': '检查并执行领域、夹击、阻击事件', '!type': 'fn()' }, clearAutomaticRouteNode: { '!doc': '清除自动寻路路线', '!type': 'fn(x?: number, y?: number)' }, getFlag: { '!doc': '读取一个flag变量
name: 变量名,支持中文
defaultValue: 当变量不存在时的返回值,可选(事件流中默认填0)。', '!type': 'fn(name: string, defaultValue?: ?)' }, getNakedStatus: { '!doc': '获得勇士原始属性(无装备和衰弱影响)', '!type': 'fn(name: string)' }, nearHero: { '!doc': '判定主角是否身处某个点的锯齿领域(取曼哈顿距离)
例如:core.nearHero(6, 6, 6); // 判定主角是否身处点(6,6)的半径为6的锯齿领域
x: 领域的中心横坐标
y: 领域的中心纵坐标
n: 领域的半径,不填视为1', '!type': 'fn(x: number, y: number, n?: number) -> bool' }, stepReplay: { '!doc': '单步播放', '!type': 'fn()' }, hasSave: { '!doc': '判断某个存档位是否存在存档', '!type': 'fn(index?: number) -> bool' }, showStartAnimate: { '!doc': '进入标题画面
例如:core.showStartAnimate(); // 重启游戏但不重置bgm
noAnimate: 可选,true表示不由黑屏淡入而是立即亮屏
callback: 可选,完全亮屏后的回调函数', '!type': 'fn(noAnimate?: bool, callback?: fn())' }, moveViewport: { '!doc': '移动视野范围', '!type': 'fn(x: number, y: number, moveMode?: string, time?: number, callback?: fn())' }, syncLoad: { '!doc': '从服务器加载存档', '!type': 'fn()' }, setHeroMoveInterval: { '!doc': '设置行走的效果动画', '!type': 'fn(callback?: fn())' }, registerReplayAction: { '!doc': '注册一个录像行为
name: 自定义名称,可用于注销使用
func: 具体执行录像的函数,可为一个函数或插件中的函数名;
需要接受一个action参数,代表录像回放时的下一个操作
func返回true代表成功处理了此录像行为,false代表没有处理此录像行为。', '!type': 'fn(name: string, func: fn(action?: string) -> bool)' }, checkAutosave: { '!doc': '实际将自动存档写入存储', '!type': 'fn()' }, resumeBgm: { '!doc': '恢复背景音乐的播放
resumeTime: 从哪一秒开始恢复播放', '!type': 'fn(resumeTime?: number)' }, setGameCanvasTranslate: { '!doc': '设置大地图的偏移量', '!type': 'fn(ctx: string|CanvasRenderingContext2D, x: number, y: number)' }, checkBgm: { '!doc': '检查bgm状态', '!type': 'fn()' }, setDisplayScale: { '!doc': '设置屏幕放缩', '!type': 'fn(delta: number)' }, speedDownReplay: { '!doc': '减速播放', '!type': 'fn()' }, getRealStatus: { '!doc': "计算主角的某个属性,包括百分比修正
例如:core.getRealStatus('atk'); // 计算主角的攻击力,包括百分比修正。战斗使用的就是这个值
name: 属性的英文名,请注意只能用于数值类属性哦,否则乘法会得到NaN", '!type': 'fn(name: string)' }, saveData: { '!doc': '存档到本地', '!type': 'fn()' }, unregisterAnimationFrame: { '!doc': '注销一个animationFrame', '!type': 'fn(name: string)' }, tryMoveDirectly: { '!doc': '尝试瞬移,如果该点有图块/事件/阻激夹域捕则会瞬移到它旁边再走一步(不可踏入的话当然还是触发该点事件),这一步的方向优先和瞬移前主角的朝向一致
例如:core.tryMoveDirectly(6, 0); // 尝试瞬移到地图顶部的正中央,以样板0层为例,实际效果是瞬移到了上楼梯下面一格然后向上走一步并触发上楼事件
destX: 目标点的横坐标
destY: 目标点的纵坐标', '!type': 'fn(destX: number, destY: number)' }, moveDirectly: { '!doc': '瞬间移动', '!type': 'fn(destX?: number, destY?: number, ignoreSteps?: number)' }, clearRouteFolding: { '!doc': '清空录像折叠信息', '!type': 'fn()' }, checkRouteFolding: { '!doc': '检查录像折叠信息', '!type': 'fn()' }, setSwitch: { '!doc': '设置某个独立开关', '!type': 'fn(x: number, y: number, floorId: string, name: string, value: ?)' }, getSwitch: { '!doc': '获得某个独立开关', '!type': 'fn(x: number, y: number, floorId: string, name: string, defaultValue?: ?)' }, addSwitch: { '!doc': '增加某个独立开关', '!type': 'fn(x: number, y: number, floorId: string, name: string, value: number)' }, removeSwitch: { '!doc': '删除某个独立开关', '!type': 'fn(x: number, y: number, floorId: string, name: string)' }, removeSwitch: { '!doc': '判定某个独立开关', '!type': 'fn(x: number, y: number, floorId: string, name: string) -> bool' } }, icons: { '!doc': '图标信息', getTilesetOffset: { '!doc': '根据图块数字或ID获得所在的tileset和坐标信息', '!type': 'fn(id?: string) -> {image: ?, x: number, y: number}' }, getClsFromId: { '!doc': '根据ID获得其图标类型', '!type': 'fn(id?: string) -> string' }, getAllIconIds: { '!doc': '获得所有图标的ID', '!type': 'fn() -> [string]' }, getIcons: { '!doc': '获得所有图标类型', '!type': 'fn()' } }, items: { '!doc': '道具相关的函数', getEquip: { '!doc': '检查主角某种类型的装备目前是什么
例如:core.getEquip(1) // 主角目前装备了什么盾牌
equipType: 装备类型,自然数
返回值:装备id,null表示未穿戴', '!type': 'fn(equipType: number) -> string' }, loadEquip: { '!doc': "尝试穿上某件背包里面的装备并提示
例如:core.loadEquip('sword5') // 尝试装备上背包里面的神圣剑,无回调
equipId: 装备id
callback: 穿戴成功或失败后的回调函数", '!type': 'fn(equipId: string, callback?: fn())' }, itemCount: { '!doc': "统计某种道具的持有量
例如:core.itemCount('yellowKey') // 持有多少把黄钥匙
itemId: 道具id
返回值:该种道具的持有量,不包括已穿戴的装备", '!type': 'fn(itemId: string) -> number' }, getItems: { '!doc': '获得所有道具', '!type': 'fn()' }, canUseItem: { '!doc': "检查能否使用某种道具
例如:core.canUseItem('pickaxe') // 能否使用破墙镐
itemId: 道具id
返回值:true表示可以使用", '!type': 'fn(itemId: string) -> bool' }, hasItem: { '!doc': "检查主角是否持有某种道具(不包括已穿戴的装备)
例如:core.hasItem('yellowKey') // 主角是否持有黄钥匙
itemId: 道具id
返回值:true表示持有", '!type': 'fn(itemId: string) -> bool' }, addItem: { '!doc': "静默增减某种道具的持有量 不会更新游戏画面或是显示提示
例如:core.addItem('yellowKey', -2) // 没收两把黄钥匙
itemId: 道具id
itemNum: 增加量,负数表示没收", '!type': 'fn(itemId: string, itemNum?: number)' }, unloadEquip: { '!doc': '脱下某个类型的装备
例如:core.unloadEquip(1) // 卸下盾牌,无回调
equipType: 装备类型编号,自然数
callback: 卸下装备后的回调函数', '!type': 'fn(equipType: number, callback?: fn())' }, quickLoadEquip: { '!doc': '快速换装
例如:core.quickLoadEquip(1) // 快速换上1号套装
index: 套装编号,自然数', '!type': 'fn(index: number)' }, getItemEffect: { '!doc': "即捡即用类的道具获得时的效果
例如:core.getItemEffect('redPotion', 10) // 执行获得10瓶红血的效果
itemId: 道具id
itemNum: 道具数量,可选,默认为1", '!type': 'fn(itemId: string, itemNum?: number)' }, quickSaveEquip: { '!doc': '保存当前套装
例如:core.quickSaveEquip(1) // 将当前套装保存为1号套装
index: 套装编号,自然数', '!type': 'fn(index: number)' }, setItem: { '!doc': "设置某种道具的持有量
例如:core.setItem('yellowKey', 3) // 设置黄钥匙为3把
itemId: 道具id
itemNum: 新的持有量,可选,自然数,默认为0", '!type': 'fn(itemId: string, itemNum?: number)' }, compareEquipment: { '!doc': "比较两件(类型可不同)装备的优劣
例如:core.compareEquipment('sword5', 'shield5') // 比较神圣剑和神圣盾的优劣
compareEquipId: 装备甲的id
beComparedEquipId: 装备乙的id
返回值:两装备的各属性差,甲减乙,0省略", '!type': 'fn(compareEquipId: string, beComparedEquipId: string) -> {value: ?, percentage: ?}' }, removeItem: { '!doc': '删除某个物品', '!type': 'fn(itemId?: string, itemNum?: number)' }, getEquipTypeById: { '!doc': "判定某件装备的类型
例如:core.getEquipTypeById('shield5') // 1(盾牌)
equipId: 装备id
返回值:类型编号,自然数", '!type': 'fn(equipId: string) -> number' }, getEquipTypeByName: { '!doc': '根据类型获得一个可用的装备孔', '!type': 'fn(name?: string)' }, useItem: { '!doc': "使用一个道具
例如:core.useItem('pickaxe', true) // 使用破墙镐,不计入录像,无回调
itemId: 道具id
noRoute: 是否不计入录像,快捷键使用的请填true,否则可省略
callback: 道具使用完毕或使用失败后的回调函数", '!type': 'fn(itemId: string, noRoute?: bool, callback?: fn())' }, hasEquip: { '!doc': "检查主角是否穿戴着某件装备
例如:core.hasEquip('sword5') // 主角是否装备了神圣剑
itemId: 装备id
返回值:true表示已装备", '!type': 'fn(itemId: string) -> bool' }, getItemEffectTip: { '!doc': "即捡即用类的道具获得时的额外提示
例如:core.getItemEffectTip(redPotion) // (获得 红血瓶)',生命+100'
itemId: 道具id
返回值:图块属性itemEffectTip的内容", '!type': 'fn(itemId: string) -> string' }, canEquip: { '!doc': "检查能否穿上某件装备
例如:core.canEquip('sword5', true) // 主角可以装备神圣剑吗,如果不能会有提示
equipId: 装备id
hint: 无法穿上时是否提示(比如是因为未持有还是别的什么原因)
返回值:true表示可以穿上,false表示无法穿上", '!type': 'fn(equipId: string, hint?: bool) -> bool' }, setEquip: { '!doc': "设置某个装备的属性并计入存档
例如:core.setEquip('sword1', 'value', 'atk', 300, '+='); // 设置铁剑的攻击力数值再加300
equipId: 装备id
valueType: 增幅类型,只能是value(数值)或percentage(百分比)
name: 要修改的属性名称,如atk
value: 要修改到的属性数值
operator: 操作符,可选,如+=表示在原始值上增加
prefix: 独立开关前缀,一般不需要", '!type': 'fn(equipId: string, valueType: string, name: string, value: ?, operator?: string, prefix?: string)' } }, utils: { '!doc': '工具函数库,里面有各个样板中使用到的工具函数。', scan: { '!doc': '朝向到x,y映射', up: { x: 'number', y: 'number' }, down: { x: 'number', y: 'number' }, left: { x: 'number', y: 'number' }, right: { x: 'number', y: 'number' } }, applyEasing: { '!doc': '获得变速移动曲线', '!type': 'fn(mode?: string) -> fn(t: number) -> number' }, clamp: { '!doc': '将x限定在[a,b]区间内,注意a和b可交换
例如:core.clamp(1200, 1, 1000); // 1000
x: 原始值,!x为true时x一律视为0
a: 下限值,大于b将导致与b交换
b: 上限值,小于a将导致与a交换', '!type': 'fn(x: number, a: number, b: number) -> number' }, rand: { '!doc': '不支持SL的随机数
例如:1 + core.rand(6); // 随机生成一个小于7的正整数,模拟骰子的效果
num: 填正数表示生成小于num的随机自然数,否则生成小于1的随机正数
返回值:随机数,即使读档也不会改变结果', '!type': 'fn(num?: number) -> number' }, clone: { '!doc': "深拷贝一个对象(函数将原样返回)
例如:core.clone(core.status.hero, (name, value) => (name == 'items' || typeof value == 'number'), false); // 深拷贝主角的属性和道具
data: 待拷贝对象
filter: 过滤器,可选,表示data为数组或对象时拷贝哪些项或属性,true表示拷贝
recursion: 过滤器是否递归,可选。true表示过滤器也被递归
返回值:拷贝的结果,注意函数将原样返回", '!type': 'fn(data?: ?, filter?: fn(name: string, value: ?) -> bool, recursion?: bool)' }, cloneArray: { '!doc': '深拷贝一个1D或2D数组对象
例如:core.cloneArray(core.status.thisMap.map)', '!type': 'fn(data?: [number]|[[number]]) -> [number]|[[number]]' }, setLocalForage: { '!doc': '往数据库写入一段数据', '!type': 'fn(key: string, value?: ?, successCallback?: fn(), errorCallback?: fn())' }, getGlobal: { '!doc': "读取一个全局存储,适用于global:xxx,支持录像。
例如:if (core.getGlobal('一周目已通关', false) === true) core.getItem('dagger'); // 二周目游戏进行到此处时会获得一把屠龙匕首
key: 全局变量名称,支持中文
defaultValue: 可选,当此全局变量不存在或值为null、undefined时,用此值代替
返回值:全局变量的值", '!type': 'fn(key: string, defaultValue?: ?)' }, replaceText: { '!doc': "将一段文字中的${}(表达式)进行替换。
例如:core.replaceText('衬衫的价格是${status:hp}镑${item:yellowKey}便士。'); // 把主角的生命值和持有的黄钥匙数量代入这句话
text: 模板字符串,可以使用${}计算js表达式,支持“状态、物品、变量、独立开关、全局存储、图块id、图块类型、敌人数据、装备id”等量参与运算
返回值:替换完毕后的字符串", '!type': 'fn(text: string, prefix?: string) -> string' }, removeLocalStorage: { '!doc': '移除本地存储', '!type': 'fn(key: string)' }, unzip: { '!doc': '解压一段内容', '!type': 'fn(blobOrUrl?: ?, success?: fn(data: ?), error?: fn(error: string), convertToText?: bool, onprogress?: fn(loaded: number, total: number))' }, formatTime: { '!doc': '格式化时间', '!type': 'fn(time: number) -> string' }, readFile: { '!doc': '尝试请求读取一个本地文件内容 [异步]
success: 成功后的回调
error: 失败后的回调
readType: 不设置则以文本读取,否则以DataUrl形式读取', '!type': 'fn(success?: fn(data: string), error?: fn(message: string), readType?: bool)' }, readFileContent: { '!doc': '文件读取完毕后的内容处理 [异步]', '!type': 'fn(content: string)' }, formatDate: { '!doc': '格式化日期为字符串', '!type': 'fn(date: ?) -> string' }, download: { '!doc': "弹窗请求下载一个文本文件
例如:core.download('route.txt', JSON.stringify(core.status.route)); // 弹窗请求下载录像
filename: 文件名
content: 文件内容", '!type': 'fn(filename: string, content: string)' }, encodeBase64: { '!doc': "base64加密
例如:core.encodeBase64('abcd'); // 'YWJjZA=='
str: 明文
返回值:密文", '!type': 'fn(str: string) -> string' }, strlen: { '!doc': "求字符串的国标码字节数,也可用于等宽字体下文本的宽度测算。请注意样板的默认字体Verdana不是等宽字体
例如:core.strlen('无敌ad'); // 6
str: 待测字符串
返回值:字符串的国标码字节数,每个汉字为2,每个ASCII字符为1", '!type': 'fn(str: string) -> number' }, myprompt: { '!doc': '让用户输入一段文字', '!type': 'fn(hint: string, value: string, callback?: fn(data?: string))' }, getCookie: { '!doc': '访问浏览器cookie', '!type': 'fn(name: string) -> string' }, decodeRoute: { '!doc': '录像解压的最后一步,即一压的逆过程
例如:core.decodeRoute(core.encodeRoute(core.status.route)); // 一压当前录像再解压-_-|
route: 录像解压倒数第二步的结果,即一压的结果
返回值:原始录像', '!type': 'fn(route: string) -> [string]' }, formatDate2: { '!doc': '格式化日期为最简字符串', '!type': 'fn(date: ?) -> string' }, unshift: { '!doc': "将b(可以是另一个数组)插入数组a的开头,此函数用于弥补a.unshift(b)中b只能是单项的不足。
例如:core.unshift(todo, {type: 'unfollow'}); // 在事件指令数组todo的开头插入“取消所有跟随者”指令
a: 原数组
b: 待插入的新首项或前缀数组
返回值:插入完毕后的新数组,它是改变原数组a本身得到的", '!type': 'fn(a: [?], b: ?) -> [?]' }, same: { '!doc': "判定深层相等, 会逐层比较每个元素
例如:core.same(['1', 2], ['1', 2]); // true", '!type': 'fn(a?: ?, b?: ?) -> bool' }, setTwoDigits: { '!doc': '两位数显示', '!type': 'fn(x: number) -> string' }, splitImage: { '!doc': "等比例切分一张图片
例如:core.splitImage(core.material.images.images['npc48.png'], 32, 48); // 把npc48.png切分成若干32×48px的小人
image: 图片名(支持映射前的中文名)或图片对象(参见上面的例子),获取不到时返回[]
width: 子图的宽度,单位为像素。原图总宽度必须是其倍数,不填视为32
height: 子图的高度,单位为像素。原图总高度必须是其倍数,不填视为正方形
返回值:子图组成的数组,在原图中呈先行后列,从左到右、从上到下排列。", '!type': 'fn(image?: string|image, width?: number, height?: number) -> [image]' }, decompress: { '!doc': '解压缩一个数据', '!type': 'fn(value: ?)' }, showWithAnimate: { '!doc': '动画显示某对象', '!type': 'fn(obj?: ?, speed?: number, callback?: fn())' }, subarray: { '!doc': "判定一个数组是否为另一个数组的前缀,用于录像接续播放。请注意函数名没有大写字母
例如:core.subarray(['ad', '米库', '小精灵', '小破草', '小艾'], ['ad', '米库', '小精灵']); // ['小破草', '小艾']
a: 可能的母数组,不填或比b短将返回null
b: 可能的前缀,不填或比a长将返回null
返回值:如果b不是a的前缀将返回null,否则将返回a去掉此前缀后的剩余数组", '!type': 'fn(a?: [?], b?: [?]) -> [?]|null' }, turnDirection: { '!doc': '计算应当转向某个方向
turn: 转向的方向,可为 up,down,left,right,:left,:right,:back 七种
direction: 当前方向', '!type': 'fn(turn: string, direction?: string) -> string' }, myconfirm: { '!doc': "显示确认框,类似core.drawConfirmBox(),但不打断事件流
例如:core.myconfirm('重启游戏?', core.restart); // 弹窗询问玩家是否重启游戏
hint: 弹窗的内容,支持 ${} 语法
yesCallback: 确定后的回调函数
noCallback: 取消后的回调函数,可选", '!type': 'fn(hint: string, yesCallback?: fn(), noCallback?: fn())' }, calValue: { '!doc': "计算一个表达式的值,支持status:xxx等的计算。
例如:core.calValue('status:hp + status:def'); // 计算主角的生命值加防御力
value: 待求值的表达式
prefix: 独立开关前缀,一般可省略
返回值:求出的值", '!type': 'fn(value: string, prefix?: string)' }, encodeRoute: { '!doc': '录像压缩缩
例如:core.encodeRoute(core.status.route); // 压缩当前录像
route: 原始录像,自定义内容(不予压缩,原样写入)必须由0-9A-Za-z和下划线、冒号组成,所以中文和数组需要用JSON.stringify预处理再base64压缩才能交由一压
返回值:一压的结果', '!type': 'fn(route: [string]) -> string' }, decodeBase64: { '!doc': 'base64解密
例如:core.decodeBase64(\'YWJjZA==\'); // "abcd"
str: 密文
返回值:明文', '!type': 'fn(str: string) -> string' }, http: { '!doc': '发送一个HTTP请求 [异步]
type: 请求类型,只能为GET或POST
url: 目标地址
formData: 如果是POST请求则为表单数据
success: 成功后的回调
error: 失败后的回调', '!type': 'fn(type: string, url: string, formData: ?, success?: fn(data: string), error?: fn(message: string), mimeType?: string, responseType?: string, onprogress?: fn(loaded: number, total: number))' }, getGuid: { '!doc': '获得或生成浏览器唯一的guid', '!type': 'fn() -> string' }, getLocalStorage: { '!doc': '获得本地存储', '!type': 'fn(key: string, defaultValue?: ?)' }, arrayToRGB: { '!doc': '颜色数组转字符串
例如:core.arrayToRGB([102, 204, 255]); // "#66ccff"
color: 一行三列的数组,必须为不大于255的自然数
返回值:该颜色的#xxxxxx字符串表示', '!type': 'fn(color: [number]) -> string' }, arrayToRGBA: { '!doc': '颜色数组转字符串
例如:core.arrayToRGBA([102, 204, 255, 0.3]); // "rgba(102,204,255,0.3)"
color: 一行三列或一行四列的数组,前三个元素必须为不大于255的自然数。第四个元素(如果有)必须为0或不大于1的数字,第四个元素不填视为1
返回值:该颜色的rgba(...)字符串表示', '!type': 'fn(color: [number]) -> string' }, formatBigNumber: { '!doc': '大数字格式化,单位为10000的倍数(w,e,z,j,g),末尾四舍五入
例如:core.formatBigNumber(123456789, false); // "12346w"
x: 原数字
onMap: 可选,true表示用于地图显伤,结果总字符数最多为5,否则最多为6
返回值:格式化结果', '!type': 'fn(x: number, onMap?: bool) -> string' }, removeLocalForage: { '!doc': '移除本地数据库的数据', '!type': 'fn(key: string, successCallback?: fn(), errorCallback?: fn())' }, matchWildcard: { '!doc': "通配符匹配,用于搜索图块等批量处理。
例如:core.playSound(core.matchWildcard('*Key', itemId) ? 'item.mp3' : 'door.mp3'); // 判断捡到的是钥匙还是别的道具,从而播放不同的音效
pattern: 模式串,每个星号表示任意多个(0个起)字符
string: 待测串
返回值:true表示匹配成功,false表示匹配失败", '!type': 'fn(pattern: string, string: string) -> bool' }, setLocalStorage: { '!doc': '设置本地存储', '!type': 'fn(key: string, value?: ?)' }, hideWithAnimate: { '!doc': '动画使某对象消失', '!type': 'fn(obj?: ?, speed?: number, callback?: fn())' }, copy: { '!doc': '尝试复制一段文本到剪切板。', '!type': 'fn(data: string) -> bool' }, isset: { '!doc': '判断一个值是否不为null,undefined和NaN
例如:core.isset(0/0); // false,因为0/0等于NaN
v: 待测值,可选
返回值:false表示待测值为null、undefined、NaN或未填写,true表示为其他值。', '!type': 'fn(v?: ?) -> bool' }, replaceValue: { '!doc': "对一个表达式中的特殊规则进行替换,如status:xxx等。
例如:core.replaceValue('status:atk+item:yellowKey'); // 把这两个冒号表达式替换为core.getStatus('hp')和core.itemCount('yellowKey')这样的函数调用
value: 模板字符串,注意独立开关不会被替换
返回值:替换完毕后的字符串", '!type': 'fn(value: string) -> string' }, getLocalForage: { '!doc': '从本地数据库读出一段数据', '!type': 'fn(key: string, defaultValue?: ?, successCallback?: fn(data: ?), errorCallback?: fn())' }, inArray: { '!doc': '判定array是不是一个数组,以及element是否在该数组中。
array: 可能的数组,不为数组或不填将导致返回值为false
element: 待查找的元素
返回值:如果array为数组且具有element这项,就返回true,否则返回false', '!type': 'fn(array?: ?, element?: ?) -> bool' }, setGlobal: { '!doc': "设置一个全局存储,适用于global:xxx,录像播放时将忽略此函数。
例如:core.setBlobal('一周目已通关', true); // 设置全局存储“一周目已通关”为true,方便二周目游戏中的新要素。
key: 全局变量名称,支持中文
value: 全局变量的新值,不填或null表示清除此全局存储", '!type': 'fn(key: string, value?: ?)' }, rand2: { '!doc': '支持SL的随机数,并计入录像
例如:1 + core.rand2(6); // 随机生成一个小于7的正整数,模拟骰子的效果
num: 正整数,0或不填会被视为2147483648
返回值:属于 [0, num) 的随机数', '!type': 'fn(num?: number) -> number' }, setStatusBarInnerHTML: { '!doc': "填写非自绘状态栏
例如:core.setStatusBarInnerHTML('hp', core.status.hero.hp, 'color: #66CCFF'); // 更新状态栏中的主角生命,使用加载画面的宣传色
name: 状态栏项的名称,如'hp', 'atk', 'def'等。必须是core.statusBar中的一个合法项
value: 要填写的内容,大数字会被格式化为至多6个字符,无中文的内容会被自动设为斜体
css: 额外的css样式,可选。如更改颜色等", '!type': 'fn(name: string, value: ?, css?: string)' }, matchRegex: { '!doc': '是否满足正则表达式', '!type': 'fn(pattern: string, string: string) -> string' }, push: { '!doc': "将b(可以是另一个数组)插入数组a的末尾,此函数用于弥补a.push(b)中b只能是单项的不足。
例如:core.push(todo, {type: 'unfollow'}); // 在事件指令数组todo的末尾插入“取消所有跟随者”指令
a: 原数组
b: 待插入的新末项或后缀数组
返回值:插入完毕后的新数组,它是改变原数组a本身得到的", '!type': 'fn(a: [?], b: ?) -> [?]' }, formatSize: { '!doc': '格式化文件大小', '!type': 'fn(size: number) -> string' } }, actions: { '!doc': '主要是处理一些和用户交互相关的内容。', onup: { '!doc': '当点击(触摸)事件放开时', '!type': 'fn(loc: {x: number, y: number, size: number})' }, pressKey: { '!doc': '按住某个键时', '!type': 'fn(keyCode: number)' }, keyUp: { '!doc': '根据放开键的code来执行一系列操作', '!type': 'fn(keyCode: number, altKey?: bool, fromReplay?: bool)' }, ondown: { '!doc': '点击(触摸)事件按下时', '!type': 'fn(loc: {x: number, y: number, size: number})' }, registerAction: { '!doc': '此函数将注册一个用户交互行为。
action: 要注册的交互类型,如 ondown, onclick, keyDown 等等。
name: 你的自定义名称,可被注销使用;同名重复注册将后者覆盖前者。
func: 执行函数。
如果func返回true,则不会再继续执行其他的交互函数;否则会继续执行其他的交互函数。
priority: 优先级;优先级高的将会被执行。此项可不填,默认为0', '!type': 'fn(action: string, name: string, func: string|fn(params: ?), priority?: number)' }, onkeyDown: { '!doc': '按下某个键时', '!type': 'fn(e: Event)' }, keyDown: { '!doc': '根据按下键的code来执行一系列操作', '!type': 'fn(keyCode: number)' }, onStatusBarClick: { '!doc': '点击自绘状态栏时', '!type': 'fn(e?: Event)' }, longClick: { '!doc': '长按', '!type': 'fn(x: number, y: number, px: number, py: number, fromEvent?: bool)' }, unregisterAction: { '!doc': '注销一个用户交互行为', '!type': 'fn(action: string, name: string)' }, keyDownCtrl: { '!doc': '长按Ctrl键时', '!type': 'fn() -> bool' }, onclick: { '!doc': '具体点击屏幕上(x,y)点时,执行的操作', '!type': 'fn(x: number, y: number, px: number, py: number, stepPostfix?: [?])' }, doRegisteredAction: { '!doc': '执行一个用户交互行为', '!type': 'fn(action: string, params: ?)' }, onkeyUp: { '!doc': '放开某个键时', '!type': 'fn(e: Event)' }, onmousewheel: { '!doc': '滑动鼠标滚轮时的操作', '!type': 'fn(direct: number)' }, onmove: { '!doc': '当在触摸屏上滑动时', '!type': 'fn(loc: {x: number, y: number, size: number})' } }, loader: { '!doc': '资源加载相关的函数', loadImages: { '!doc': '加载一系列图片', '!type': 'fn(dir: string, names: [string], toSave: ?, callback?: fn()) ' }, loadImagesFromZip: { '!doc': '从zip中加载一系列图片', '!type': 'fn(url: string, names: [string], toSave?: ?, onprogress?: ?, onfinished?: ?)' }, loadBgm: { '!doc': '加载一个bgm', '!type': 'fn(name: string)' }, loadOneMusic: { '!doc': '加载一个音乐或音效', '!type': 'fn(name: string)' }, freeBgm: { '!doc': '释放一个bgm的缓存', '!type': 'fn(name: string)' }, loadOneSound: { '!doc': '加载一个音效', '!type': 'fn(name: string)' }, loadImage: { '!doc': '加载某一张图片', '!type': 'fn(dir: name, imgName: name, callback?: fn())' } }, maps: { '!doc': '负责一切和地图相关的处理内容,包括如下几个方面:
- 地图的初始化,保存和读取,地图数组的生成
- 是否可移动或瞬间移动的判定
- 地图的绘制
- 获得某个点的图块信息
- 启用和禁用图块,改变图块
- 移动/跳跃图块,淡入淡出图块
- 全局动画控制,动画的绘制', noPass: { '!doc': '判定某个点是否不可被踏入(不基于主角生命值和图块cannotIn属性)
例如:core.noPass(0, 0); // 判断地图左上角能否被踏入
x: 目标点的横坐标
y: 目标点的纵坐标
floorId: 目标点所在的地图id,不填视为当前地图
返回值:true表示可踏入', '!type': 'fn(x: number, y: number, floorId?: string) -> bool' }, drawAnimate: { '!doc': "播放动画,注意即使指定了主角的坐标也不会跟随主角移动,如有需要请使用core.drawHeroAnimate(name, callback)函数
例如:core.drawAnimate('attack', core.nextX(), core.nextY(), false, core.vibrate); // 在主角面前一格播放普攻动画,动画停止后视野左右抖动1秒
name: 动画文件名,不含后缀
x: 横坐标
y: 纵坐标
alignWindow: 是否是相对窗口的坐标
callback: 动画停止后的回调函数,可选
返回值:一个数字,可作为core.stopAnimate()的参数来立即停止播放(届时还可选择是否执行此次播放的回调函数)", '!type': 'fn(name: string, x: number, y: number, alignWindow: bool, callback?: fn()) -> number' }, drawHeroAnimate: { '!doc': '播放跟随勇士的动画
name: 动画名
callback: 动画停止后的回调函数,可选
返回值:一个数字,可作为core.stopAnimate()的参数来立即停止播放(届时还可选择是否执行此次播放的回调函数)', '!type': 'fn(name: string, callback?: fn()) -> number' }, stopAnimate: { '!doc': '立刻停止一个动画播放
id: 播放动画的编号,即drawAnimate或drawHeroAnimate的返回值;不填视为所有动画br/>doCallback: 是否执行该动画的回调函数', '!type': 'fn(id?: number, doCallback?: bool)' }, getPlayingAnimates: { '!doc': '获得当前正在播放的所有(指定)动画的id列表
name: 动画名;不填代表返回全部正在播放的动画
返回值: 一个数组,每一项为一个正在播放的动画;可用core.stopAnimate停止播放。', '!type': 'fn(name?: string) -> [number]' }, getBlockCls: { '!doc': "判定某个点的图块类型
例如:if(core.getBlockCls(x1, y1) != 'enemys' && core.getBlockCls(x2, y2) != 'enemy48') core.openDoor(x3, y3); // 另一个简单的机关门事件,打败或炸掉这一对不同身高的敌人就开门
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图
showDisable: 隐藏点是否不返回null,true表示不返回null
返回值:图块类型,即“地形、四帧动画、矮敌人、高敌人、道具、矮npc、高npc、自动元件、额外地形”之一", '!type': 'fn(x: number, y: number, floorId?: string, showDisable?: bool) -> string' }, drawMap: { '!doc': '地图重绘
例如:core.drawMap(); // 重绘当前地图,常用于更改贴图或改变自动元件后的刷新
floorId: 地图id,可省略表示当前楼层
callback: 重绘完毕后的回调函数,可选', '!type': 'fn(floorId?: string)' }, nearStair: { '!doc': '当前位置是否在楼梯边;在楼传平面塔模式下对箭头也有效', '!type': 'fn() -> bool' }, turnBlock: { '!doc': '事件转向', '!type': 'fn(direction?: string, x?: number, y?: number, floorId?: string)' }, getMapArray: { '!doc': "生成事件层矩阵
例如:core.getMapArray('MT0'); // 生成主塔0层的事件层矩阵,隐藏的图块视为0
floorId: 地图id,不填视为当前地图
showDisable: 可选,true表示隐藏的图块也会被表示出来
返回值:事件层矩阵,注意对其阵元的访问是[y][x]", '!type': 'fn(floorId?: string, noCache?: bool) -> [[number]]' }, getMapNumber: { '!doc': '获得事件层某个点的数字', '!type': 'fn(x: number, y: number, floorId?: string, noCache?: bool) -> number' }, jumpBlock: { '!doc': '跳跃图块;从V2.7开始不再有音效
例如:core.jumpBlock(0, 0, 0, 0); // 令地图左上角的图块原地跳跃半秒,再花半秒淡出
sx: 起点的横坐标
sy: 起点的纵坐标
ex: 终点的横坐标
ey: 终点的纵坐标
time: 单步和淡出用时,单位为毫秒。不填视为半秒
keep: 是否不淡出,true表示不淡出
callback: 落地或淡出后的回调函数,可选', '!type': 'fn(sx: number, sy: number, ex: number, ey: number, time?: number, keep?: bool, callback?: fn())' }, replaceBlock: { '!doc': '批量替换图块
例如:core.replaceBlock(21, 22, core.floorIds); // 把游戏中地上当前所有的黄钥匙都变成蓝钥匙
fromNumber: 旧图块的数字
toNumber: 新图块的数字
floorId: 地图id或其数组,不填视为当前地图', '!type': 'fn(fromNumber: number, toNumber: number, floorId?: string|[string])' }, drawBlock: { '!doc': '绘制一个图块', '!type': 'fn(block?: block, animate?: number)' }, resetMap: { '!doc': '重置地图', '!type': 'fn(floorId?: string|[string])' }, animateSetBlock: { '!doc': '动画形式转变某点图块', '!type': 'fn(number: number|string, x: number, y: number, floorId?: string, time?: number, callback?: fn())' }, animateSetBlocks: { '!doc': '动画形式同时转变若干点图块', '!type': 'fn(number: number|string, locs: [?], floorId?: string, time?: number, callback?: fn())' }, compressMap: { '!doc': '压缩地图', '!type': 'fn(mapArr: [[number]], floorId?: string) -> [[number]]' }, enemyExists: { '!doc': '某个点是否存在(指定的)怪物', '!type': 'fn(x: number, y: number, id?: string, floorId?: string) -> bool' }, npcExists: { '!doc': '某个点是否存在NPC', '!type': 'fn(x: number, y: number, floorId?: string) -> bool' }, getBlockByNumber: { '!doc': '根据数字获得图块', '!type': 'fn(number: number) -> block' }, removeBlock: { '!doc': '删除一个图块,对应于「隐藏事件」并同时删除
例如:core.removeBlock(0, 0); // 尝试删除地图左上角的图块
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图', '!type': 'fn(x: number, y: number, floorId?: string)' }, hideBlock: { '!doc': '隐藏一个图块,对应于「隐藏事件」且不删除
例如:core.hideBlock(0, 0); // 隐藏地图左上角的图块
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图', '!type': 'fn(x: number, y: number, floorId?: string)' }, removeBlockByIndex: { '!doc': '根据block的索引删除该块', '!type': 'fn(index: number, floorId?: string)' }, stairExists: { '!doc': '某个点是否存在楼梯', '!type': 'fn(x: number, y: number, floorId?: string) -> bool' }, isMapBlockDisabled: { '!doc': '某个点图块是否被强制启用或禁用', '!type': 'fn(floorId?: string, x?: number, y?: number, flags?: ?) -> bool' }, setMapBlockDisabled: { '!doc': '设置某个点图块的强制启用或禁用状态', '!type': 'fn(floorId?: string, x?: number, y?: number, disabled?: bool)' }, setBlockOpacity: { '!doc': '设置某个点图块的不透明度', '!type': 'fn(opacity?: number, x?: number, y?: number, floorId?: string)' }, setBlockFilter: { '!doc': '设置某个点图块的特效', '!type': 'fn(filter?: ?, x?: number, y?: number, floorId?: string)' }, decompressMap: { '!doc': '解压缩地图', '!type': 'fn(mapArr: [[number]], floorId?: string) -> [[number]]' }, automaticRoute: { '!doc': '自动寻路
例如:core.automaticRoute(0, 0); // 自动寻路到地图左上角
destX: 目标点的横坐标
destY: 目标点的纵坐标
返回值:每步走完后主角的loc属性组成的一维数组', '!type': 'fn(destX: number, destY: number) -> [{x: number, y: number, direction: string}]' }, resizeMap: { '!doc': '更改地图画布的尺寸', '!type': 'fn(floorId?: string)' }, getFgNumber: { '!doc': '判定某点的前景层的数字
例如:core.getFgNumber(); // 判断主角脚下的前景层图块的数字
x: 横坐标,不填为勇士坐标
y: 纵坐标,不填为勇士坐标floorId: 地图id,不填视为当前地图
noCache: 可选,true表示不使用缓存而强制重算', '!type': 'fn(x: number, y: number, floorId?: string, noCache?: bool) -> number' }, moveBlock: { '!doc': "移动图块
例如:core.moveBlock(0, 0, ['down']); // 令地图左上角的图块下移一格
x: 起点的横坐标
y: 起点的纵坐标
steps: 步伐数组
time: 单步和淡出用时,单位为毫秒。不填视为半秒
keep: 是否不淡出,true表示不淡出
callback: 移动或淡出后的回调函数,可选", '!type': 'fn(x: number, y: number, steps: [string], time?: number, keep?: bool, callback?: fn())' }, getBgNumber: { '!doc': '判定某点的背景层的数字
例如:core.getBgNumber(); // 判断主角脚下的背景层图块的数字
x: 横坐标,不填为勇士坐标
y: 纵坐标,不填为勇士坐标
floorId: 地图id,不填视为当前地图
noCache: 可选,true表示不使用缓存而强制重算', '!type': 'fn(x?: number, y?: number, floorId?: string, noCache?: bool) -> number' }, getIdOfThis: { '!doc': '获得当前事件点的ID', '!type': 'fn(id?: string) -> string' }, searchBlock: { '!doc': "搜索图块, 支持通配符和正则表达式
例如:core.searchBlock('*Door'); // 搜索当前地图的所有门
id: 图块id,支持星号表示任意多个(0个起)字符
floorId: 地图id或数组,不填视为当前地图
showDisable: 隐藏点是否计入,true表示计入
返回值:一个详尽的数组,一般只用到其长度", '!type': 'fn(id: string, floorId?: string|[string], showDisable?: bool) -> [{floorId: string, index: number, x: number, y: number, block: block}]' }, searchBlockWithFilter: { '!doc': "根据给定的筛选函数搜索全部满足条件的图块
例如:core.searchBlockWithFilter(function (block) { return block.event.id.endsWith('Door'); }); // 搜索当前地图的所有门
blockFilter: 筛选函数,可接受block输入,应当返回一个boolean值
floorId: 地图id或数组,不填视为当前地图
showDisable: 隐藏点是否计入,true表示计入
返回值:一个详尽的数组", '!type': 'fn(blockFilter: fn(block: block) -> bool, floorId?: string|[string], showDisable?: bool): [{floorId: string, index: number, x: number, y: number, block: block}]' }, hideBgFgMap: { '!doc': '隐藏前景/背景地图', '!type': 'fn(name?: string, loc?: [number]|[[number]], floorId?: string, callback?: fn())' }, getBlockInfo: { '!doc': '获得某个图块或素材的信息,包括ID,cls,图片,坐标,faceIds等等', '!type': 'fn(block?: number|string|block) -> blockInfo' }, getFaceDownId: { '!doc': '获得某个图块对应行走图朝向向下的那一项的id;如果不存在行走图绑定则返回自身id。', '!type': 'fn(block?: string|number|block) -> string' }, canMoveDirectlyArray: { '!doc': '获得某些点可否通行的信息', '!type': 'fn(locs?: [[number]])' }, hideFloorImage: { '!doc': '隐藏一个楼层贴图', '!type': 'fn(loc?: [number]|[[number]], floorId?: string, callback?: fn())' }, extractBlocks: { '!doc': '根据需求解析出blocks', '!type': 'fn(map?: ?)' }, extractBlocksForUI: { '!doc': '根据需求为UI解析出blocks', '!type': 'fn(map?: ?, flags?: ?)' }, getBlockId: { '!doc': "判定某个点的图块id
例如:if(core.getBlockId(x1, y1) != 'greenSlime' && core.getBlockId(x2, y2) != 'redSlime') core.openDoor(x3, y3); // 一个简单的机关门事件,打败或炸掉这一对绿头怪和红头怪就开门
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图
showDisable: 隐藏点是否不返回null,true表示不返回null
返回值:图块id,该点无图块则返回null", '!type': 'fn(x: number, y: number, floorId?: string, showDisable?: bool) -> string' }, getBlockNumber: { '!doc': '判定某个点的图块数字
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图
showDisable: 隐藏点是否不返回null,true表示不返回null
返回值:图块数字,该点无图块则返回null', '!type': 'fn(x: number, y: number, floorId?: string, showDisable?: bool) -> number' }, getBlockOpacity: { '!doc': '获得某个点图块的不透明度', '!type': 'fn(x?: number, y?: number, floorId?: string, showDisable?: bool) -> number' }, getBlockFilter: { '!doc': '获得某个点图块的特效', '!type': 'fn(x?: number, y?: number, floorId?: string, showDisable?: bool) -> ?' }, loadFloor: { '!doc': '从文件或存档中加载某个楼层', '!type': 'fn(floorId?: string, map?: ?)' }, generateMovableArray: { '!doc': '可通行性判定
例如:core.generateMovableArray(); // 判断当前地图主角从各点能向何方向移动
floorId: 地图id,不填视为当前地图
返回值:从各点可移动方向的三维数组', '!type': 'fn(floorId?: string) -> [[[string]]]' }, terrainExists: { '!doc': '某个点是否存在(指定的)地形', '!type': 'fn(x: number, y: number, id?: string, floorId?: string) -> bool' }, getBlockById: { '!doc': '根据ID获得图块', '!type': 'fn(id: string) -> block' }, drawBg: { '!doc': '绘制背景层(含贴图,其与背景层矩阵的绘制顺序可通过复写此函数来改变)
例如:core.drawBg(); // 绘制当前地图的背景层
floorId: 地图id,不填视为当前地图
ctx: 某画布的ctx,用于绘制缩略图,一般不需要', '!type': 'fn(floorId?: string, ctx?: CanvasRenderingContext2D)' }, showBlock: { '!doc': '显示(隐藏或显示的)图块,此函数将被“显示事件”指令和勾选了“不消失”的“移动/跳跃事件”指令(如阻击怪)的终点调用
例如:core.showBlock(0, 0); // 显示地图左上角的图块
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图', '!type': 'fn(x: number, y: number, floorId?: string)' }, getMapBlocksObj: { '!doc': '以x,y的形式返回每个点的事件', '!type': 'fn(floorId?: string, noCache?: bool)' }, removeGlobalAnimate: { '!doc': '删除一个或所有全局动画', '!type': 'fn(x?: number, y?: number, name?: string)' }, drawEvents: { '!doc': '绘制事件层
例如:core.drawEvents(); // 绘制当前地图的事件层
floorId: 地图id,不填视为当前地图
blocks: 一般不需要
ctx: 某画布的ctx,用于绘制缩略图,一般不需要', '!type': 'fn(floorId?: string, blocks?: [block], ctx?: CanvasRenderingContext2D)' }, canMoveDirectly: { '!doc': '能否瞬移到某点,并求出节约的步数。
例如:core.canMoveDirectly(0, 0); // 能否瞬移到地图左上角
destX: 目标点的横坐标
destY: 目标点的纵坐标
返回值:正数表示节约的步数,-1表示不可瞬移', '!type': 'fn(destX: number, destY: number) -> number' }, saveMap: { '!doc': '将当前地图重新变成数字,以便于存档', '!type': 'fn(floorId?: string)' }, drawBoxAnimate: { '!doc': '绘制UI层的box动画', '!type': 'fn()' }, setBgFgBlock: { '!doc': "转变图层块
例如:core.setBgFgBlock('bg', 167, 6, 6); // 把当前地图背景层的中心块改为滑冰
name: 背景还是前景
number: 新图层块的数字(也支持纯数字字符串如'1')或id
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图", '!type': 'fn(name: string, number: number|string, x: number, y: number, floorId?: string)' }, drawFg: { '!doc': '绘制前景层(含贴图,其与前景层矩阵的绘制顺序可通过复写此函数来改变)
例如:core.drawFg(); // 绘制当前地图的前景层
floorId: 地图id,不填视为当前地图
ctx: 某画布的ctx,用于绘制缩略图,一般不需要', '!type': 'fn(floorId?: string, ctx?: CanvasRenderingContext2D)' }, getBlock: { '!doc': '获得某个点的block', '!type': 'fn(x: number, y: number, floorId?: string, showDisable?: bool) -> block' }, initBlock: { '!doc': '初始化一个图块', '!type': 'fn(x: number, y: number, id: string|number, addInfo?: bool, eventFloor?: ?) -> block' }, addGlobalAnimate: { '!doc': '添加一个全局动画', '!type': 'fn(block?: block)' }, animateBlock: { '!doc': '显示/隐藏某个块时的动画效果', '!type': 'fn(loc?: [number]|[[number]], type?: string|number, time?: number, callback?: fn())' }, loadMap: { '!doc': '将存档中的地图信息重新读取出来', '!type': 'fn(data?: ?, floorId?: string, flags?: ?)' }, setBlock: { '!doc': "转变图块
例如:core.setBlock(1, 0, 0); // 把地图左上角变成黄墙
number: 新图块的数字(也支持纯数字字符串如'1')或id
x: 横坐标
y: 纵坐标
floorId: 地图id,不填视为当前地图", '!type': 'fn(number: number|string, x: number, y: number, floorId?: string)' }, getFgMapArray: { '!doc': "生成前景层矩阵
例如:core.getFgMapArray('MT0'); // 生成主塔0层的前景层矩阵,使用缓存
floorId: 地图id,不填视为当前地图
noCache: 可选,true表示不使用缓存
返回值:前景层矩阵,注意对其阵元的访问是[y][x]", '!type': 'fn(floorId?: string, noCache?: bool) -> [[number]]' }, getBgMapArray: { '!doc': "生成背景层矩阵
例如:core.getBgMapArray('MT0'); // 生成主塔0层的背景层矩阵,使用缓存
floorId: 地图id,不填视为当前地图
noCache: 可选,true表示不使用缓存
返回值:背景层矩阵,注意对其阵元的访问是[y][x]", '!type': 'fn(floorId?: string, noCache?: bool) -> [[number]]' }, canMoveHero: { '!doc': '单点单朝向的可通行性判定;受各图层cannotInOut、起点cannotMove和canGoDeadZone影响,不受canPass和noPass影响
x: 起点横坐标,不填视为主角当前的
y: 起点纵坐标,不填视为主角当前的
direction: 移动的方向,不填视为主角面对的方向
floorId: 地图id,不填视为当前地图', '!type': 'fn(x?: number, y?: number, direction?: string, floorId?: string) -> bool' }, drawThumbnail: { '!doc': '绘制缩略图
例如:core.drawThumbnail(); // 绘制当前地图的缩略图
floorId: 地图id,不填视为当前地图
blocks: 一般不需要
options: 绘制信息,可选。可以增绘主角位置和朝向、采用不同于游戏中的主角行走图、增绘显伤、提供flags用于存读档,同时包含要绘制到的画布名或画布的ctx或还有其他信息,如起绘坐标、绘制大小、是否绘制全图、截取中心', '!type': 'fn(floorId?: string, blocks?: [block], options?: ?)' }, hideBlockByIndex: { '!doc': '根据图块的索引来隐藏图块', '!type': 'fn(index?: number, floorId?: string)' }, getNumberById: { '!doc': "根据图块id得到数字(地图矩阵中的值)
例如:core.getNumberById('yellowWall'); // 1
id: 图块id
返回值:图块的数字,定义在project\\maps.js(请注意和project\\icons.js中的“图块索引”相区分!)", '!type': 'fn(id: string) -> number' }, removeBlockByIndexes: { '!doc': '一次性删除多个block', '!type': 'fn(indexes?: [number], floorId?: string)' }, hideBlockByIndexes: { '!doc': '一次性隐藏多个block', '!type': 'fn(indexes?: [number], floorId?: string)' }, generateGroundPattern: { '!doc': '生成groundPattern', '!type': 'fn(floorId?: string)' }, showBgFgMap: { '!doc': '显示前景/背景地图', '!type': 'fn(name?: string, loc?: [number]|[[number]], floorId?: string, callback?: fn())' }, showFloorImage: { '!doc': '显示一个楼层贴图', '!type': 'fn(loc?: [number]|[[number]], floorId?: string, callback?: fn())' } }, ui: { '!doc': '负责一切UI界面的绘制。主要包括三个部分:
- 设置某个画布的属性与在某个画布上绘制的相关API
- 具体的某个UI界面的绘制
- 动态创建画布相关的API', resizeCanvas: { '!doc': '重新设置一个自定义画布的大小', '!type': 'fn(name: string, x?: number, y?: number, styleOnly?: bool, isTempCanvas?: bool)' }, deleteCanvas: { '!doc': '删除一个自定义画布
name: 画布名,也可以传入一个函数对所有画布进行筛选', '!type': 'fn(name: string|fn(name: string) -> bool)' }, deleteAllCanvas: { '!doc': '清空所有的自定义画布', '!type': 'fn()' }, drawIcon: { '!doc': '在某个canvas上绘制一个图标', '!type': 'fn(name: string|CanvasRenderingContext2D, id: string, x: number, y: number, w?: number, h?: number, frame?: number)' }, drawFly: { '!doc': '绘制楼层传送器', '!type': 'fn(page?: ?)' }, setOpacity: { '!doc': '设置某个canvas整体的透明度;此函数直接改变画布本身,对已经绘制的内容也生效
如果仅想对接下来的绘制生效请使用setAlpha', '!type': 'fn(name: string|CanvasRenderingContext2D, opacity: number)' }, getTextContentHeight: { '!doc': '获得某段文字的预计绘制高度;参数说明详见 drawTextContent', '!type': 'fn(content: string, config?: ?)' }, drawArrow: { '!doc': '在某个canvas上绘制一个箭头', '!type': 'fn(name: string|CanvasRenderingContext2D, x1: number, y1: number, x2: number, y2: number, style?: string, lineWidth?: number)' }, strokeEllipse: { '!doc': '在某个canvas上绘制一个椭圆的边框', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, a: number, b: number, angle?: number, style?: string, lineWidth?: number)' }, fillCircle: { '!doc': '在某个canvas上绘制一个圆', '!url': 'https://www.w3school.com.cn/tags/canvas_arc.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, r: number, style?: string)' }, strokeRoundRect: { '!doc': '在某个canvas上绘制一个圆角矩形的边框', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number, style?: string, lineWidth?: number, angle?: number)' }, getContextByName: { '!doc': '根据画布名找到一个画布的context;支持系统画布和自定义画布。如果不存在画布返回null。
也可以传画布的context自身,则返回自己。', '!type': 'fn(canvas: string|CanvasRenderingContext2D) -> CanvasRenderingContext2D' }, drawImage: { '!doc': "在一个画布上绘制图片
后面的8个坐标参数与canvas的drawImage的八个参数完全相同。
name: 可以是系统画布之一,也可以是任意自定义动态创建的画布名 画布名称或者画布的context
image: 要绘制的图片,可以是一个全塔属性中定义的图片名(会从images中去获取;支持加':x',':y',':o'翻转),图片本身,或者一个画布。
angle:旋转角度", '!url': 'http://www.w3school.com.cn/html5/canvas_drawimage.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, image: string|image, x: number, y: number, w?: number, h?: number, x1?: number, y1?: number, w1?: number, h1?: number, angle?: number)' }, drawTip: { '!doc': '左上角绘制一段提示
text: 要提示的字符串,支持${}语法
id: 要绘制的图标ID
frame: 要绘制该图标的第几帧', '!type': 'fn(text: string, id?: string, frame?: number)' }, drawBackground: { '!doc': '绘制一个背景图,可绘制winskin或纯色背景;支持小箭头绘制', '!type': 'fn(left: string, top: string, right: string, bottom: string, posInfo?: {px: number, py: number, direction: string})' }, fillEllipse: { '!doc': '在某个canvas上绘制一个椭圆', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, a: number, b: number, angle?: number, style?: string)' }, setFillStyle: { '!doc': '设置某个canvas的绘制属性(如颜色等)', '!url': 'https://www.w3school.com.cn/tags/canvas_fillstyle.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, style: string)' }, drawText: { '!doc': '地图中间绘制一段文字', '!type': 'fn(contents: string, callback?: fn())' }, drawConfirmBox: { '!doc': '绘制一个确认框
此项会打断事件流,如需不打断版本的请使用core.myconfirm()
text: 要绘制的内容,支持 ${} 语法
yesCallback: 点击确认后的回调
noCallback: 点击取消后的回调', '!type': 'fn(text: string, yesCallback?: fn(), noCallback?: fn())' }, drawUIEventSelector: { '!doc': '自绘一个闪烁的选择光标
code: 选择光标的编号,必填
background: 要绘制的光标背景,必须是一个合法的WindowSkin
x, y, w, h: 绘制的坐标和长宽
z: 可选,光标的的z值', '!type': 'fn(code: number, background: string, x: number, y: number, w: number, h: number, z?: number)' }, clearUIEventSelector: { '!doc': '清除若干个自绘的选择光标
codes: 清除的光标编号;可以是单个编号或编号数组;不填则清除所有光标', '!type': 'fn(codes?: number|[number])' }, fillPolygon: { '!doc': '在某个canvas上绘制一个多边形', '!type': 'fn(name: string|CanvasRenderingContext2D, nodes?: [[number]], style?: string)' }, fillText: { '!doc': '在某个画布上绘制一段文字
text: 要绘制的文本
style: 绘制的样式
font: 绘制的字体
最大宽度,超过此宽度会自动放缩', '!url': 'https://www.w3school.com.cn/tags/canvas_filltext.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, text: string, x: number, y: number, style?: string, font?: string, maxWidth?: number)' }, setTextBaseline: { '!doc': '设置某个canvas的基准线
baseline: 可为alphabetic, top, hanging, middle, ideographic, bottom', '!url': 'https://www.w3school.com.cn/tags/canvas_textbaseline.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, baseline: string)' }, loadCanvas: { '!doc': '加载某个canvas状态', '!type': 'fn(name: string|CanvasRenderingContext2D)' }, splitLines: { '!doc': '字符串自动换行的分割', '!type': 'fn(name: string|CanvasRenderingContext2D, text: string, maxWidth?: number, font?: string)' }, setAlpha: { '!doc': '设置某个canvas接下来绘制的不透明度;不会影响已经绘制的内容
返回设置之前画布的不透明度
如果需要修改画布本身的不透明度请使用setOpacity', '!url': 'https://www.w3school.com.cn/tags/canvas_globalalpha.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, alpha: number) -> number' }, setFilter: { '!doc': '设置某个canvas接下来绘制的filter', '!type': 'fn(name: string|CanvasRenderingContext2D, style: string)' }, setLineWidth: { '!doc': '设置某个canvas的线宽度', '!url': 'https://www.w3school.com.cn/tags/canvas_linewidth.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, lineWidth: number)' }, drawTextBox: { '!doc': '绘制一个对话框', '!type': 'fn(content: string, showAll?: bool)' }, relocateCanvas: { '!doc': '重新定位一个自定义画布', '!type': 'fn(name: string, x: number, y: number, useDelta: bool)' }, rotateCanvas: { '!doc': '设置一个自定义画布的旋转角度
centerX, centerY: 旋转中心(以屏幕像素为基准);不填视为图片正中心。', '!type': 'fn(name: string, angle: number, centerX?: number, centerY?: number)' }, closePanel: { '!doc': '结束一切事件和绘制,关闭UI窗口,返回游戏进程', '!type': 'fn()' }, textImage: { '!doc': '文本图片化', '!type': 'fn(content: string, lineHeight?: number) -> image' }, drawStatusBar: { '!doc': '绘制状态栏', '!type': 'fn()' }, setStrokeStyle: { '!doc': '设置某个canvas边框属性', '!url': 'https://www.w3school.com.cn/tags/canvas_strokestyle.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, style: string)' }, clearUI: { '!doc': '清空UI层内容', '!type': 'fn()' }, drawWindowSkin: { '!doc': '绘制WindowSkin', '!type': 'fn(background: string, ctx: string|CanvasRenderingContext2D, x: number, y: number, w: string, h: string, direction?: string, px?: number, py?: number)' }, fillRect: { '!doc': '绘制一个矩形。
x,y: 绘制的坐标
width,height: 绘制的长宽
style: 绘制的样式
angle: 旋转的角度,弧度制,如Math.PI/2代表90度', '!url': 'https://www.w3school.com.cn/tags/canvas_fillrect.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, width: number, height: number, style?: string, angle?: number)' }, drawScrollText: { '!doc': '绘制滚动字幕', '!type': 'fn(content: string, time: number, lineHeight?: number, callback?: fn())' }, strokePolygon: { '!doc': '在某个canvas上绘制一个多边形的边框', '!type': 'fn(name: string|CanvasRenderingContext2D, nodes?: [[number]], style?: string, lineWidth?: number)' }, strokeCircle: { '!doc': '在某个canvas上绘制一个圆的边框', '!url': 'https://www.w3school.com.cn/tags/canvas_arc.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, r: ?, style?: string, lineWidth?: number)' }, drawWaiting: { '!doc': '绘制等待界面', '!type': 'fn(text: string)' }, setFont: { '!doc': '设置某个canvas的文字字体', '!url': 'https://www.w3school.com.cn/tags/canvas_font.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, font: string)' }, drawChoices: { '!doc': '绘制一个选项界面', '!type': 'fn(content?: string, choices?: [?], width?: number, ctx?: string|CanvasRenderingContext2D)' }, setFontForMaxWidth: { '!doc': '根据最大宽度自动缩小字体', '!type': 'fn(name: string|CanvasRenderingContext2D, text: string, maxWidth: number, font?: ?) -> string' }, clearMap: { '!doc': "清空某个画布图层
name为画布名,可以是系统画布之一,也可以是任意自定义动态创建的画布名;还可以直接传画布的context本身。
如果name也可以是'all',若为all则为清空所有系统画布。", '!url': 'https://www.w3school.com.cn/tags/canvas_clearrect.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x?: number, y?: number, width?: number, height?: number)' }, drawTextContent: { '!doc': '绘制一段文字到某个画布上面
ctx: 要绘制到的画布
content: 要绘制的内容;转义字符不允许保留 \\t, \\b 和 \\f
config: 绘制配置项,目前暂时包含如下内容(均为可选)
left, top:起始点位置;maxWidth:单行最大宽度;color:默认颜色;align:左中右
fontSize:字体大小;lineHeight:行高;time:打字机间隔;font:字体名
返回值:绘制信息', '!type': 'fn(ctx: string|CanvasRenderingContext2D, content: string, config: ?)' }, calWidth: { '!doc': '计算某段文字的宽度', '!url': 'https://www.w3school.com.cn/tags/canvas_measuretext.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, text: string, font?: string) -> number' }, fillArc: { '!doc': '在某个canvas上绘制一个扇形', '!url': 'https://www.w3school.com.cn/tags/canvas_arc.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, r: number, start: number, end: number, style?: string)' }, strokeArc: { '!doc': '在某个canvas上绘制一段弧', '!url': 'https://www.w3school.com.cn/tags/canvas_arc.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, r: number, start: number, end: number, style?: string, lineWidth?: number)' }, drawLine: { '!doc': '在某个canvas上绘制一条线', '!url': 'https://www.w3school.com.cn/tags/canvas_lineto.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x1: number, y1: number, x2: number, y2: number, style?: string, lineWidth?: number)' }, drawPagination: { '!doc': '绘制分页', '!type': 'fn(page?: ?, totalPage?: ?, y?: number)' }, getToolboxItems: { '!doc': '获得所有应该在道具栏显示的某个类型道具', '!type': 'fn(cls: string) -> [string]' }, strokeRect: { '!doc': '绘制一个矩形的边框
style: 绘制的样式
lineWidth: 线宽
angle: 旋转角度,弧度制,如Math.PI/2为90度', '!url': 'https://www.w3school.com.cn/tags/canvas_strokerect.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, width: number, height: number, style?: string, lineWidth?: number, angle?: number)' }, drawBook: { '!doc': '绘制怪物手册', '!type': 'fn(index?: ?)' }, fillRoundRect: { '!doc': '在某个canvas上绘制一个圆角矩形', '!type': 'fn(name: string|CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number, style?: string, angle?: number)' }, fillBoldText: { '!doc': '在某个画布上绘制一个描边文字
text: 要绘制的文本
style: 绘制的样式
strokeStyle: 要绘制的描边颜色
font: 绘制的字体
maxWidth: 最大宽度,超过此宽度会自动放缩', '!type': 'fn(name: string|CanvasRenderingContext2D, text: string, x: number, y: number, style?: string, strokeStyle?: string, font?: string, maxWidth?: number)' }, saveCanvas: { '!doc': '保存某个canvas状态', '!type': 'fn(name: string|CanvasRenderingContext2D)' }, createCanvas: { '!doc': '动态创建一个画布。
name: 要创建的画布名,如果已存在则会直接取用当前存在的。
x,y: 创建的画布相对窗口左上角的像素坐标
width,height: 创建的长宽。
zIndex: 创建的纵向高度(关系到画布之间的覆盖),z值高的将覆盖z值低的;系统画布的z值可在个性化中查看。
返回创建的画布的context,也可以通过core.dymCanvas[name]调用。', '!type': 'fn(name: string, x: number, y: number, width: number, height: number, zIndex: number) -> CanvasRenderingContext2D' }, setTextAlign: { '!doc': '设置某个canvas的对齐', '!url': 'https://www.w3school.com.cn/tags/canvas_textalign.asp', '!type': 'fn(name: string|CanvasRenderingContext2D, align: string)' } }, enemys: { '!doc': '定义了一系列和怪物相关的API函数。', getEnemys: { '!doc': '获得所有怪物原始数据的一个副本。
请使用core.material.enemys获得当前各项怪物属性。', '!type': 'fn()' }, getEnemyValue: { '!doc': '获得某个点上怪物的某个属性值', '!type': 'fn(enemy?: string|enemy, name: string, x?: number, y?: number, floorId?: string)' }, getSpecials: { '!doc': '获得所有特殊属性的定义', '!type': 'fn() -> [[?]]' }, getSpecialColor: { '!doc': '获得某个怪物所有特殊属性的颜色', '!type': 'fn(enemy: string|enemy) -> [string]' }, getSpecialFlag: { '!doc': '获得某个怪物所有特殊属性的额外标记。

例如,1为全图性技能,需要进行遍历全图(光环/支援等)', '!type': 'fn(enemy: string|enemy) -> number' }, getSpecialHint: { '!doc': "获得某种敌人的某种特殊属性的介绍
例如:core.getSpecialHint('bat', 1) // '先攻:怪物首先攻击'
enemy: 敌人id或敌人对象,用于确定属性的具体数值,否则可选
special: 属性编号,可以是该敌人没有的属性
返回值:属性的介绍,以属性名加中文冒号开头", '!type': 'fn(enemy: string|enemy, special: number) -> string' }, getSpecialText: { '!doc': "获得某种敌人的全部特殊属性名称
例如:core.getSpecialText('greenSlime') // ['先攻', '3连击', '破甲', '反击']
enemy: 敌人id或敌人对象,如core.material.enemys.greenSlime
返回值:字符串数组", '!type': 'fn(enemy: string|enemy) -> [string]' }, hasSpecial: { '!doc': "判定某种特殊属性的有无
例如:core.hasSpecial('greenSlime', 1) // 判定绿头怪有无先攻属性
special: 敌人id或敌人对象或正整数数组或自然数
test: 待检查的属性编号
", '!type': 'fn(special: number|[number]|string|number, test: number) -> bool' }, nextCriticals: { '!doc': "获得某只敌人接下来的若干个临界及其减伤,算法基于useLoop开关选择回合法或二分法
例如:core.nextCriticals('greenSlime', 9, 0, 0, 'MT0') // 绿头怪接下来的9个临界
enemy: 敌人id或敌人对象
number: 要计算的临界数量,可选,默认为1
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
floorId: 敌人所在的地图,可选
返回:两列的二维数组,每行表示一个临界及其减伤", '!type': 'fn(enemy: string|enemy, number?: number, x?: number, y?: number, floorId?: string) -> [[number]]' }, getDefDamage: { '!doc': "计算再加若干点防御能使某只敌人对主角的总伤害降低多少
例如:core.getDefDamage('greenSlime', 10, 0, 0, 'MT0') // 再加10点防御能使绿头怪的伤害降低多少
enemy: 敌人id或敌人对象
k: 假设主角增加的防御力,可选,默认为1
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
floorId: 敌人所在的地图,可选", '!type': 'fn(enemy: string|enemy, k?: number, x?: number, y?: number, floorId?: string) -> number' }, canBattle: { '!doc': "判定主角当前能否打败某只敌人
例如:core.canBattle('greenSlime',0,0,'MT0') // 能否打败主塔0层左上角的绿头怪(假设有)
enemy: 敌人id或敌人对象
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
floorId: 敌人所在的地图,可选
返回值:true表示可以打败,false表示无法打败", '!type': 'fn(enemy: string|enemy, x?: number, y?: number, floorId?: string) -> bool' }, getEnemyInfo: { '!doc': '获得怪物真实属性
hero: 可选,此时的勇士属性
此函数将会计算包括坚固、模仿、光环等若干效果,将同时被怪物手册和伤害计算调用', '!type': 'fn(enemy: string|enemy, hero?: ?, x?: number, y?: number, floorId?: string) -> {hp: number, atk: number, def: number, money: number, exp: number, special: [number], point: number, guards: [?]}' }, getDamageInfo: { '!doc': "获得战斗伤害信息
例如:core.getDamage('greenSlime',0,0,'MT0') // 绿头怪的总伤害
enemy: 敌人id或敌人对象
hero: 可选,此时的勇士属性
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
floorId: 敌人所在的地图,可选
返回值:伤害计算信息,如果因为没有破防或无敌怪等其他原因无法战斗,则返回null", '!type': 'fn(enemy: string|enemy, hero?: ?, x?: number, y?: number, floorId?: string) -> {damage: number, per_damage: number, hero_per_damage: number, init_damage: number, mon_hp: number, mon_atk: number, mon_def: number, turn: number}' }, getDamage: { '!doc': "获得某只敌人对主角的总伤害
例如:core.getDamage('greenSlime',0,0,'MT0') // 绿头怪的总伤害
enemy: 敌人id或敌人对象
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
floorId: 敌人所在的地图,可选
返回值:总伤害,如果因为没有破防或无敌怪等其他原因无法战斗,则返回null", '!type': 'fn(enemy: string|enemy, x?: number, y?: number, floorId?: string) -> number' }, getDamageString: { '!doc': "获得某只敌人的地图显伤,包括颜色
例如:core.getDamageString('greenSlime', 0, 0, 'MT0') // 绿头怪的地图显伤
enemy: 敌人id或敌人对象
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
floorId: 敌人所在的地图,可选
返回值:damage: 表示伤害值或为'???',color: 形如'#RrGgBb'", '!type': 'fn(enemy: string|enemy, x?: number, y?: number, floorId?: string) -> {color: string, damage: string}' }, getCurrentEnemys: { '!doc': "获得某张地图的敌人集合,用于手册绘制
例如:core.getCurrentEnemys('MT0') // 主塔0层的敌人集合
floorId: 地图id,可选
返回值:敌人集合,按伤害升序排列,支持多朝向怪合并", '!type': 'fn(floorId?: string) -> [enemy]' }, hasEnemyLeft: { '!doc': "检查某些楼层是否还有漏打的(某种)敌人
例如:core.hasEnemyLeft('greenSlime', ['sample0', 'sample1']) // 样板0层和1层是否有漏打的绿头怪
enemyId: 敌人id,可选,null表示任意敌人
floorId: 地图id或其数组,可选,不填为当前地图
返回值:地图中是否还存在该种敌人", '!type': 'fn(enemyId?: string, floorId?: string|[string]) -> bool' } }, events: { '!doc': 'events.js将处理所有和事件相关的操作,主要分为五个部分:
- 游戏的开始和结束
- 系统事件的处理
- 自定义事件的处理
- 点击状态栏图标所进行的操作
- 一些具体事件的执行内容', afterChangeFloor: { '!doc': '转换楼层结束的事件', '!type': 'fn(floorId?: string)' }, popEventLoc: { '!doc': '将当前点坐标入栈', '!type': 'fn()' }, afterOpenDoor: { '!doc': '开一个门后触发的事件', '!type': 'fn(doorId?: string, x?: number, y?: number)' }, checkLvUp: { '!doc': '检查升级事件', '!type': 'fn()' }, insertAction: { '!doc': "插入一段事件;此项不可插入公共事件,请用 core.insertCommonEvent
例如:core.insertAction('一段文字'); // 插入一个显示文章
action: 单个事件指令,或事件指令数组
x: 新的当前点横坐标,可选
y: 新的当前点纵坐标,可选
callback: 新的回调函数,可选
addToLast: 插入的位置,true表示插入到末尾,否则插入到开头", '!type': 'fn(action: string|?|[?], x?: number, y?: number, callback?: fn(), addToLast?: bool)' }, unfollow: { '!doc': '取消跟随
name: 取消跟随的行走图,不填则取消全部跟随者', '!type': 'fn(name?: string)' }, hasVisitedFloor: { '!doc': '是否到达过某个楼层', '!type': 'fn(floorId?: string) -> bool' }, startEvents: { '!doc': '开始执行一系列自定义事件', '!type': 'fn(list?: [?], x?: number, y?: number, callback?: fn())' }, setHeroIcon: { '!doc': "更改主角行走图
例如:core.setHeroIcon('npc48.png', true); // 把主角从阳光变成样板0层左下角的小姐姐,但不立即刷新
name: 新的行走图文件名,可以是全塔属性中映射前的中文名。映射后会被存入core.status.hero.image
noDraw: true表示不立即刷新(刷新会导致大地图下视野重置到以主角为中心)", '!type': 'fn(name: string, noDraw?: bool)' }, changingFloor: { '!doc': '楼层转换中', '!type': 'fn(floorId?: string, heroLoc?: {x: number, y: number, direction: string})' }, setEvents: { '!doc': '直接设置事件列表', '!type': 'fn(list?: [?], x?: number, y?: number, callback?: fn())' }, setValue: { '!doc': '数值操作', '!type': 'fn(name: string, operator: string, value: ?, prefix?: string)' }, precompile: { '!doc': '预编辑事件', '!type': 'fn(data?: ?)' }, vibrate: { '!doc': '视野抖动
例如:core.vibrate(); // 视野抖动1秒
direction: 抖动方向;可填 horizontal(左右),vertical(上下),diagonal1(左上右下),diagonal2(左下右上)
time: 抖动时长
speed: 抖动速度
power: 抖动幅度
callback: 抖动平息后的回调函数,可选', '!type': 'fn(direction?: string, time?: number, speed?: number, power?: number, callback?: fn())' }, confirmRestart: { '!doc': '询问是否需要重新开始', '!type': 'fn()' }, battle: { '!doc': "战斗,如果填写了坐标就会删除该点的敌人并触发战后事件
例如:core.battle('greenSlime'); // 和从天而降的绿头怪战斗(如果打得过)
id: 敌人id,必填
x: 敌人的横坐标,可选
y: 敌人的纵坐标,可选
force: true表示强制战斗,可选
callback: 回调函数,可选", '!type': 'fn(id: string, x?: number, y?: number, force?: bool, callback?: fn())' }, follow: { '!doc': '跟随
name: 要跟随的一个合法的4x4的行走图名称,需要在全塔属性注册', '!type': 'fn(name: string)' }, beforeBattle: { '!doc': '战斗前触发的事件;返回false代表不进行战斗', '!type': 'fn(enemyId?: string, x?: number, y?: number) -> bool' }, registerEvent: { '!doc': '注册一个自定义事件
type: 事件类型
func: 事件的处理函数,可接受(data, x, y, prefix)参数
data为事件内容,x和y为当前点坐标(可为null),prefix为当前点前缀', '!type': 'fn(type: string, func: fn(data: ?, x?: number, y?: number, prefix?: string))' }, flyTo: { '!doc': '飞往某一层', '!type': 'fn(toId?: string, callback?: fn()) -> bool' }, afterGetItem: { '!doc': '获得一个道具后的事件', '!type': 'fn(id?: string, x?: number, y?: number, isGentleClick?: bool)' }, doAction: { '!doc': '执行下一个事件指令,常作为回调
例如:core.setCurtain([0,0,0,1], null, null, core.doAction); // 事件中的原生脚本,配合勾选“不自动执行下一个事件”来达到此改变色调只持续到下次场景切换的效果', '!type': 'fn()' }, openBook: { '!doc': '点击怪物手册时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, save: { '!doc': '点击存档按钮时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, load: { '!doc': '点击读档按钮时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, getNextItem: { '!doc': '轻按获得面前的物品或周围唯一物品
noRoute: 若为true则不计入录像', '!type': 'fn(noRoute?: bool)' }, hasAsync: { '!doc': '当前是否有未处理完毕的异步事件(不包含动画和音效)', '!type': 'fn() -> bool' }, stopAsync: { '!doc': '立刻停止所有正在进行的异步事件', '!type': 'fn()' }, openEquipbox: { '!doc': '点击装备栏时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, recoverEvents: { '!doc': '恢复一个事件', '!type': 'fn(data?: ?)' }, setGlobalFlag: { '!doc': "设置一个系统开关
例如:core.setGlobalFlag('steelDoorWithoutKey', true); // 使全塔的所有铁门都不再需要钥匙就能打开
name: 系统开关的英文名
value: 开关的新值,您可以用!core.flags[name]简单地表示将此开关反转", '!type': 'fn(name: string, value: bool)' }, moveImage: { '!doc': '移动一张图片并/或改变其透明度
例如:core.moveImage(1, null, 0.5); // 1秒内把1号图片变为50%透明
code: 图片编号
to: 新的左上角坐标,省略表示原地改变透明度
opacityVal: 新的透明度,省略表示不变
time: 移动用时,单位为毫秒。不填视为1秒
callback: 图片移动完毕后的回调函数,可选', '!type': 'fn(code: number, to?: [number], opacityVal?: number, moveMode?: string, time?: number, callback?: fn())' }, rotateImage: { '!doc': '旋转一张图片
code: 图片编号
center: 旋转中心像素坐标(以屏幕为基准);不填视为图片本身中心
angle: 旋转角度;正数为顺时针,负数为逆时针
moveMode: 旋转模式
time: 旋转用时,单位为毫秒。不填视为1秒
callback: 图片旋转完毕后的回调函数,可选', '!type': 'fn(code: number, center?: [number], angle?: number, moveMode?: string, time?: number, callback?: fn())' }, scaleImage: { '!doc': '放缩一张图片', '!type': 'fn(code: number, center?: [number], scale?: number, moveMode?: string, time?: number, callback?: fn())' }, moveTextBox: { '!doc': '移动对话框', '!type': 'fn(code: number, loc: [number], relative?: bool, moveMode?: string, time?: number, callback?: fn())' }, clearTextBox: { '!doc': '清除对话框', '!type': 'fn(code: number)' }, openSettings: { '!doc': '点击设置按钮时的操作', '!type': 'fn(fromUserAction?: bool)' }, afterPushBox: { '!doc': '推箱子后的事件', '!type': 'fn()' }, unregisterSystemEvent: { '!doc': '注销一个系统事件', '!type': 'fn(type: string)' }, trigger: { '!doc': '触发(x,y)点的系统事件;会执行该点图块的script属性,同时支持战斗(会触发战后)、道具(会触发道具后)、楼层切换等等
callback: 执行完毕的回调函数
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】', '!type': 'fn(x?: number, y?: number, callback?: fn())' }, restart: { '!doc': '重新开始游戏;此函数将回到标题页面', '!type': 'fn()' }, doEvent: { '!doc': '执行一个自定义事件', '!type': 'fn(data?: ?, x?: number, y?: number, prefix?: string)' }, win: { '!doc': '游戏获胜事件', '!type': 'fn(reason?: string, norank?: bool, noexit?: bool)' }, setGlobalAttribute: { '!doc': '设置全塔属性', '!type': 'fn(name: string, value: string)' }, setNameMap: { '!doc': '设置文件别名', '!type': 'fn(name: string, value?: string)' }, setTextAttribute: { '!doc': '设置剧情文本的属性', '!type': 'fn(data: ?)' }, openToolbox: { '!doc': '点击工具栏时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, setVolume: { '!doc': '调节bgm的音量
例如:core.setVolume(0, 100, core.jumpHero); // 0.1秒内淡出bgm,然后主角原地跳跃半秒
value: 新的音量,为0或不大于1的正数。注意系统设置中是这个值的平方根的十倍
time: 渐变用时,单位为毫秒。不填或小于100毫秒都视为0
callback: 渐变完成后的回调函数,可选', '!type': 'fn(value: number, time?: number, callback?: fn())' }, pushEventLoc: { '!doc': '将当前点坐标入栈', '!type': 'fn(x?: number, y?: number, floorId?: string) -> bool' }, openKeyBoard: { '!doc': '点击虚拟键盘时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, insertCommonEvent: { '!doc': "插入一个公共事件
例如:core.insertCommonEvent('加点事件', [3]);
name: 公共事件名;如果公共事件不存在则直接忽略
args: 参数列表,为一个数组,将依次赋值给 flag:arg1, flag:arg2, ...
x: 新的当前点横坐标,可选
y: 新的当前点纵坐标,可选
callback: 新的回调函数,可选
addToLast: 插入的位置,true表示插入到末尾,否则插入到开头", '!type': 'fn(name?: string, args?: [?], x?: number, y?: number, callback?: fn(), addToLast?: bool)' }, hideImage: { '!doc': '隐藏一张图片
例如:core.hideImage(1, 1000, core.jumpHero); // 1秒内淡出1号图片,然后主角原地跳跃半秒
code: 图片编号
time: 淡出时间,单位为毫秒
callback: 图片完全消失后的回调函数,可选', '!type': 'fn(code: number, time?: number, callback?: fn())' }, visitFloor: { '!doc': '到达某楼层', '!type': 'fn(floorId?: string)' }, openQuickShop: { '!doc': '点击快捷商店按钮时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, afterBattle: { '!doc': '战斗结束后触发的事件', '!type': 'fn(enemyId?: string, x?: number, y?: number)' }, pushBox: { '!doc': '推箱子', '!type': 'fn(data?: ?)' }, autoEventExecuted: { '!doc': '当前是否执行过某个自动事件', '!type': 'fn(symbol?: string, value?: ?) -> bool' }, onSki: { '!doc': '当前是否在冰上', '!type': 'fn(number?: number) -> bool' }, showImage: { '!doc': "显示一张图片
例如:core.showImage(1, core.material.images.images['winskin.png'], [0,0,128,128], [0,0,416,416], 0.5, 1000); // 裁剪winskin.png的最左边128×128px,放大到铺满整个视野,1秒内淡入到50%透明,编号为1
code: 图片编号,为不大于50的正整数,加上100后就是对应画布层的z值,较大的会遮罩较小的,注意色调层的z值为125,UI层为140
image: 图片文件名(可以是全塔属性中映射前的中文名)或图片对象(见上面的例子)
sloc: 一行且至多四列的数组,表示从原图裁剪的左上角坐标和宽高,可选
loc: 一行且至多四列的数组,表示图片在视野中的左上角坐标和宽高,可选
opacityVal: 不透明度,为小于1的正数。不填视为1
time: 淡入时间,单位为毫秒。不填视为0
callback: 图片完全显示出来后的回调函数,可选", '!type': 'fn(code: number, image: string|image, sloc?: [number], loc?: [number], opacityVal?: number, time?: number, callback?: fn())' }, getItem: { '!doc': "获得道具并提示,如果填写了坐标就会删除该点的该道具
例如:core.getItem('book'); // 获得敌人手册并提示
id: 道具id,必填
num: 获得的数量,不填视为1,填了就别填坐标了
x: 道具的横坐标,可选
y: 道具的纵坐标,可选
callback: 回调函数,可选", '!type': 'fn(id: string, num?: number, x?: number, y?: number, callback?: fn())' }, registerSystemEvent: { '!doc': '注册一个系统事件
type: 事件名
func: 为事件的处理函数,可接受(data,callback)参数', '!type': 'fn(type: string, func: fn(data?: ?, callback?: fn()))' }, startGame: { '!doc': "开始新游戏
例如:core.startGame('咸鱼乱撞', 0, ''); // 开始一局咸鱼乱撞难度的新游戏,随机种子为0
hard: 难度名,会显示在左下角(横屏)或右下角(竖屏)
seed: 随机种子,相同的种子保证了录像的可重复性
route: 经由base64压缩后的录像,用于从头开始的录像回放
callback: 回调函数,可选", '!type': 'fn(hard: string, seed: number, route: string, callback?: fn())' }, doSystemEvent: { '!doc': '执行一个系统事件', '!type': 'fn(type: string, data?: ?, callback?: fn())' }, resetGame: { '!doc': '初始化游戏', '!type': 'fn(hero?: ?, hard?: ?, floorId?: string, maps?: ?, values?: ?)' }, setFloorInfo: { '!doc': "设置一项楼层属性并刷新状态栏
例如:core.setFloorInfo('ratio', 2, 'MT0'); // 把主塔0层的血瓶和宝石变为双倍效果
name: 要修改的属性名
values: 属性的新值。
floorId: 楼层id,不填视为当前层
prefix: 独立开关前缀,一般不需要", '!type': 'fn(name: string, values: ?, floorId?: string, prefix?: string)' }, openDoor: { '!doc': '开门(包括三种基础墙)
例如:core.openDoor(0, 0, true, core.jumpHero); // 打开左上角的门,需要钥匙,然后主角原地跳跃半秒
x: 门的横坐标
y: 门的纵坐标
needKey: true表示需要钥匙,会导致机关门打不开
callback: 门完全打开后或打不开时的回调函数,可选
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】', '!type': 'fn(x: number, y: number, needKey?: bool, callback?: fn())' }, setEnemy: { '!doc': "设置一项敌人属性并计入存档
例如:core.setEnemy('greenSlime', 'def', 0); // 把绿头怪的防御设为0
id: 敌人id
name: 属性的英文缩写
value: 属性的新值,可选
operator: 运算操作符如+=,可选
prefix: 独立开关前缀,一般不需要,下同", '!type': 'fn(id: string, name: string, value: ?, operator?: string, prefix?: string)' }, setEnemyOnPoint: { '!doc': "设置某个点的敌人属性。如果该点不是怪物,则忽略此函数。
例如:core.setEnemyOnPoint(3, 5, null, 'atk', 100, '+='); // 仅将(3,5)点怪物的攻击力加100。", '!type': 'fn(x: number, y: number, floorId?: string, name: string, value: ?, operator?: string, prefix?: string)' }, resetEnemyOnPoint: { '!doc': '重置某个点的怪物属性', '!type': 'fn(x: number, y: number, floorId?: string)' }, moveEnemyOnPoint: { '!doc': '将某个点已经设置的敌人属性移动到其他点', '!type': 'fn(fromX: number, fromY: number, toX: number, toY: number, floorId?: string)' }, autoEventExecuting: { '!doc': '当前是否在执行某个自动事件', '!type': 'fn(symbol?: string, value?: ?) -> bool' }, checkAutoEvents: { '!doc': '检测自动事件', '!type': 'fn()' }, showGif: { '!doc': '绘制一张动图或擦除所有动图
例如:core.showGif(); // 擦除所有动图
name: 动图文件名,可以是全塔属性中映射前的中文名
x: 动图在视野中的左上角横坐标
y: 动图在视野中的左上角纵坐标', '!type': 'fn(name?: string, x?: number, y?: number)' }, unregisterEvent: { '!doc': '注销一个自定义事件', '!type': 'fn(type: string)' }, jumpHero: { '!doc': '主角跳跃,跳跃勇士。ex和ey为目标点的坐标,可以为null表示原地跳跃。time为总跳跃时间。
例如:core.jumpHero(); // 主角原地跳跃半秒
ex: 跳跃后的横坐标
ey: 跳跃后的纵坐标
time: 跳跃时长,单位为毫秒。不填视为半秒
callback: 跳跃完毕后的回调函数,可选
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】', '!type': 'fn(ex?: number, ey?: number, time?: number, callback?: fn())' }, closeDoor: { '!doc': "关门,目标点必须为空地
例如:core.closeDoor(0, 0, 'yellowWall', core.jumpHero); // 在左上角关掉一堵黄墙,然后主角原地跳跃半秒
x: 横坐标
y: 纵坐标
id: 门的id,也可以用三种基础墙
callback: 门完全关上后的回调函数,可选
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】", '!type': 'fn(x: number, y: number, id: string, callback?: fn())' }, eventMoveHero: { '!doc': "强制移动主角(包括后退),这个函数的作者已经看不懂这个函数了
例如:core.eventMoveHero(['forward'], 125, core.jumpHero); // 主角强制前进一步,用时1/8秒,然后主角原地跳跃半秒
steps: 步伐数组,注意后退时跟随者的行为会很难看
time: 每步的用时,单位为毫秒。0或不填则取主角的移速,如果后者也不存在就取0.1秒
callback: 移动完毕后的回调函数,可选
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】", '!type': 'fn(steps: [step], time?: number, callback?: fn())' }, changeFloor: { '!doc': "场景切换
例如:core.changeFloor('MT0'); // 传送到主塔0层,主角坐标和朝向不变,黑屏时间取用户定义的值
floorId: 传送的目标地图id,可以填':before'和':next'分别表示楼下或楼上
stair: 传送的位置
heroLoc: 传送的坐标;会覆盖stair
time: 传送的黑屏时间,单位为毫秒;不填为用户设置值
callback: 传送的回调函数
【异步脚本,请勿在脚本中直接调用(而是使用对应的事件),否则可能导致录像出错】", '!type': 'fn(floorId: string, stair?: string, heroLoc?: {x?: number, y?: number, direction?: string}, time?: number, callback?: fn())' }, getCommonEvent: { '!doc': '获得一个公共事件', '!type': 'fn(name: string) -> [?]' }, lose: { '!doc': '游戏失败事件', '!type': 'fn(reason?: string)' }, gameOver: { '!doc': '游戏结束
例如:core.gameOver(); // 游戏失败
ending: 结局名,省略表示失败
fromReplay: true表示在播放录像,可选
norank: true表示不计入榜单,可选', '!type': 'fn(ending?: string, fromReplay?: bool, norank?: bool)' }, useFly: { '!doc': '点击楼层传送器时的打开操作', '!type': 'fn(fromUserAction?: bool)' }, tryUseItem: { '!doc': "尝试使用一个道具
例如:core.tryUseItem('pickaxe'); // 尝试使用破墙镐
itemId: 道具id,其中敌人手册、传送器和飞行器会被特殊处理", '!type': 'fn(itemId: string)' } }, plugin: { '!doc': '插件编写中内置了一些常用的插件。', drawLight: { '!doc': "绘制一段灯光效果
name:必填,要绘制到的画布名;可以是一个系统画布,或者是个自定义画布;如果不存在则创建
color:可选,只能是一个0~1之间的数,为不透明度的值。不填则默认为0.9。
lights:可选,一个数组,定义了每个独立的灯光。其中每一项是三元组 [x,y,r] x和y分别为该灯光的横纵坐标,r为该灯光的半径。
lightDec:可选,0到1之间,光从多少百分比才开始衰减(在此范围内保持全亮),不设置默认为0。比如lightDec为0.5代表,每个灯光部分内圈50%的范围全亮,50%以后才开始快速衰减。
例如:core.plugin.drawLight('test', 0.2, [[25,11,46,0.1]]); // 创建一个test图层,不透明度0.2,其中在(25,11)点存在一个半径为46的灯光效果,灯光中心不透明度0.1。
core.plugin.drawLight('test2', 0.9, [[25,11,46],[105,121,88],[301,221,106]]); // 创建test2图层,且存在三个灯光效果,分别是中心(25,11)半径46,中心(105,121)半径88,中心(301,221)半径106。", '!type': 'fn(name: string|CanvasRenderingContext2D, color?: number, lights?: [[number]], lightDec?: number)' }, openShop: { '!doc': '打开一个全局商店
shopId: 要开启的商店ID
noRoute: 打开行为是否不计入录像', '!type': 'fn(shopId: string, noRoute?: bool)' }, isShopVisited: { '!doc': '某个全局商店是否被访问过', '!type': 'fn(id: string) -> bool' }, listShopIds: { '!doc': '列出所有应当显示的快捷商店列表', '!type': 'fn() -> [string]' }, canOpenShop: { '!doc': '当前能否打开某个商店', '!type': 'fn(id: string) -> bool' }, setShopVisited: { '!doc': '设置某个商店的访问状态', '!type': 'fn(id: string, visited?: bool)' }, canUseQuickShop: { '!doc': '当前能否使用某个快捷商店
如果返回一个字符串,则代表不能,返回的字符串作为不能的提示;返回null表示可以使用', '!type': 'fn(id: string) -> string' }, removeMaps: { '!doc': '删除某一些楼层;删除后不会存入存档,不可浏览地图也不可飞到。
fromId: 开始删除的楼层ID
toId: 删除到的楼层编号;可选,不填则视为fromId
例如:core.plugin.removeMap.removeMaps("MT1", "MT300") 删除MT1~MT300之间的全部层
core.plugin.removeMap.removeMaps("MT10") 只删除MT10层', '!type': 'fn(fromId: string, toId?: string)' }, resumeMaps: { '!doc': '恢复某一些被删除楼层。
fromId: 开始恢复的楼层ID
toId: 恢复到的楼层编号;可选,不填则视为fromId
例如:core.plugin.removeMap.resumeMaps("MT1", "MT300") 恢复MT1~MT300之间的全部层
core.plugin.removeMap.resumeMaps("MT10") 只删恢复MT10层', '!type': 'fn(fromId: string, toId?: string)' }, autoRemoveMaps: { '!doc': '根据楼层分区信息自动砍层与恢复', '!type': 'fn(floorId: string)' }, openItemShop: { '!doc': '打开一个道具商店', '!type': 'fn(itemShopId: string)' } } }, lzw_encode: { '!doc': 'LZW压缩算法', '!url': 'https://gist.github.com/revolunet/843889', '!type': 'fn(s: string) -> string' }, lzw_decode: { '!doc': 'LZW解压缩算法', '!url': 'https://gist.github.com/revolunet/843889', '!type': 'fn(s: string) -> string' }, hero: { '!type': 'heroStatus', '!doc': '勇士信息,为 core.status.hero 的简写' }, flags: { '!type': 'flag', '!doc': '游戏中用到的变量,为 core.status.hero.flags 的简写' } } ];