[MV/MZ]ULDS无限图层插件使用详解 (2023-08-04更新+范例v3)

Rose_shadows

taroxd大佬的ULDS无限图层插件具有非常强大的图层功能，允许开发者在地图上叠加无限的视差图层。但相信不少人在研究插件的时候都曾为插件帮助中不甚详尽的说明绞尽脑汁……
现在论坛上似乎还没有系统的ULDS教程，为了能让更多的新人小白感受到这个插件的魅力，我以我对ULDS浅薄的认识写了这样一篇教程。
与此同时，诚邀各路大神一起解决该教程中的问题，弥补该教程中的缺憾。

2023-08-04 ULDS简易范例更新至v3.00（蓝奏云）：
https://wwll.lanzout.com/iRUuY14d2yte
新增自由淡入淡出和遮罩房间范例，修复了Bug并进一步完善了内容，将无限图层插件帮助文档内容与本帖同步

旧版本范例

该教程将依次讲述以下5个模块，后续也许还会更新：

1. 地图注释（基础）
2. 地图注释（高级）
3. 地图注释例子
4. 设置碰撞体积
5. 技巧
     •关于相对地图远景
     •关于动态帧图层
     •关于简易光源 (2022-12-09更新)
        ├ 简易圆形光源
        └ 简易手电筒
     •关于淡入淡出 (2023-07-27更新)
        ├ 立即淡入淡出
        ├ 与开关相联的淡入/淡出(仅能同时实现一种)
        └ 与开关相联的自由淡入淡出(两种皆可实现)
     •关于遮罩房间 (2023-08-04更新)
     •（或许以后还会更新...）

* ---------------------------------------------------------------------
*  === ULDS插件使用说明 ===
*
* ULDS插件通过配置地图注释来实现图层功能。
*
*  == 1. 地图注释（基础） ==
*
* 在地图注释中按以下格式书写：
*
      <ulds> {
       参数1: 值1,
       参数2: 值2,
       ......
       参数n: 值n
    } </ulds>
*
*    <ulds>和</ulds>之间要以 JSON 格式书写。请自行学习JSON格式如何书写。
*   
*    其中，必须有的参数是：
*
*    "name": 图片名称。
*
*    "x": 图片的x坐标。x坐标越大，图片越靠右。
*         若为 纯数字 ，则表示以 屏幕左上角 为原点的图片x坐标。图片横向位置始终与屏幕保持一致。
*         若为 this.rx(n) ，则表示以 地图左上角 为原点的图片x坐标。
*         n 可以是以下2种情况：
*           - 若n为 数字，则表示以 地图左上角 为原点的图片x坐标，且x坐标为 n 。
*             例如 this.rx(48) 指的是图片会贴在地图x坐标为 48 像素的位置。
*           - 若n为 t ，则图片将会被从左向右滚动播放。
*             如果是 -t ，则图片会被从右向左滚动播放。
*
*    "y": 图片的y坐标。y坐标越大，图片越靠下。
*         若为 纯数字 ，则表示以 屏幕左上角 为原点的图片y坐标。图片纵向位置始终与屏幕保持一致。
*         若为 this.ry(n) ，则表示以 地图左上角 为原点的图片y坐标。
*         n 可以是以下2种情况：
*           - 若n为 数字，则表示以 地图左上角 为原点的图片y坐标，且y坐标为 n 。
*             例如 this.ry(48) 指的是图片会贴在地图y坐标为 48 像素的位置。
*           - 若n为 t ，则图片将会被从上到下滚动播放。
*             如果是 -t ，则图片会被从下向上滚动播放。
*
*    其他可供选择的基础参数有：
*
*    "z": 图片的z层级。默认是0.5（可在插件参数中设置）。小数点可精确至后两位。建议大于1，且为浮点数，这样设置可以最大程度地兼容其他涉及图层的插件（如灯光插件等）。
*         指定图片可以覆盖在z层级小于该图片z层级的所有图片之上。
*         例如，若指定A图片z层级为6，B图片z层级为10，则A图片会覆盖所有z层级低于6的贴图，但会被B图片覆盖。
*         RMMV中各贴图的原生层级：0 -> 远景/A区地面图块，3 -> 玩家/事件，4 -> 星标图块。
*
*    "path": 自定义图片所在的文件夹。文件夹必须在img文件夹里。默认是parallaxes（插件参数中可配置）
*
*    "loop": true/false
*            是否循环播放图片。
*
*    还有一些参数，需要开发人员对Sprite类, Bitmap类属性具有初步的认识：
*    （不过本人已将常用参数全部列在下方了，即便不懂脚本的小伙伴们应该也可以看懂）
*   
*    "smooth": true/false
*                   是否应用平滑缩放。
*
*    "blendMode": 图片的混合模式。默认是0（正常）。
*                        RMMV原生混合模式：0 -> 正常，1 -> 叠加，2 -> 正片叠底，3 -> 滤色
*
*    "opacity": 图片的不透明度。0-255间的一个数字。默认是255（完全不透明）。
*
*    "rotation": 图片的旋转角度（弧度）。数字 兀 在JS中是 Math.PI 。
*
*    "scale.x": 图片被横向缩放的倍数。默认是1（不放大）。可以是小数。
*                    如果是负数，图片就会被左右镜像翻转。
*
*    "scale.y": 图片被纵向缩放的倍数。默认是1（不放大）。可以是小数。
*                    如果是负数，图片就会被上下镜像翻转。
*
*    "visible": true/false
*                 图片是否可见。
*
*
*
*  == 2. 地图注释（高级） ==
*
* 上面模块讲的是地图注释的基本格式。这一模块将会讲到该插件的一些高级用法和提供的一些引用。
*
*
* 无限图层的设置在游玩时是即时动态更新的。
* 所以在地图注释中，可以调用$gameSwitches和$gameVariables等脚本的值来实时控制图片的状态。
*
* 例如：
*
* · 参数"visible"可以这样写：
*   "visible": "$gameSwitches.value(2)"
*   - 这表示由开关#2来实时控制图片的显示与隐藏。
*
* · 参数"rotation"可以这样写：
*   "rotation": "$gameVariables.value(1)*Math.PI"
*   - 这表示由变量#1来控制图片的旋转角度。变量#1最好是介于0到2的数字。
*
* 当然，以此类推，其他插件提供的脚本变量/开关也可以使用。
*
*
* 也许各位会觉得每次写$gameVariables, $gameSwitches什么的太麻烦了，还容易写错，
* 那么可以考虑使用插件作者提供的引用：s 和 v 来代替开关和变量。
*
* 仍以上面举过的两个例子为例：
*
* · 参数"visible"可以这样写：
*   "visible": "s.value(2)"
*   - 这表示由开关#2来实时控制图片的显示与隐藏。
*
* · 参数"rotation"可以这样写：
*   "rotation": "v.value(1)*Math.PI"
*   - 这表示由变量#1来控制图片的旋转角度。变量#1最好是介于0到2的数字。
*
* 除了 s, v 这两个引用之外，插件作者还提供了一个引用。
* 还记得前面提到的 this.rx(t) 吗？
* 其中的 t 也是一个引用。t 代表每帧都会自增（自己+1）的一个数字。初始值是0。
*
* 一个地图中可以添加多个注释。利用z层级来控制各图层的叠加情况，就可以非常灵活地制作视差地图了！
*
*
*
*   == 3. 例子 ==
*
   <ulds> {
     "name": "BlueSky",
     "x": "this.rx(t)",
     "y": 50,
     "z": 10.5,
     "loop": true,
     "scale.x": -1,
     "visible": "s.value(3)"
   } </ulds>
*   - 在地图中使用位于img/parallaxes/中的BlueSky.png图片。
*     该图片Z层级是10.5，在横向位置上以正常速度(1帧1像素)从左向右循环自滚动，在纵向位置上相对于屏幕的y坐标为50，图片被左右镜像反转，由开关#3控制显示和隐藏。
*
   <ulds> {
     "name": "Night",
     "path": "pictures",
     "x": "this.rx(48)",
     "y": "this.ry(48)",
     "z": 20,
     "visible": "s.value(5)",
     "scale.x": "v.value(2)",
     "scale.y": "v.value(2)",
     "blendMode": 2,
     "rotation": "Math.PI"
   } </ulds>
*   - 在地图中使用位于img/pictures/中的Night.png图片。
*     该图片Z层级是20，相对于地图的坐标为(48, 48)，由开关#5控制显示和隐藏，
*     横纵向缩放的倍数是变量#2的值，混合模式是正片叠底，以图片左上角为锚点，旋转180°。
*
*
*
*  == 4. 设置碰撞体积 ==
*
* ULDS插件本身不提供碰撞体积功能。
*
* 默认情况下，在地图的图块组 A组 中随意寻找 可通行图块 和 不可通行图块 各一种，
* 然后根据所使用的图层直接在RMMV地图编辑器中绘制相应可通行/不可通行区域即可。
*
* 似乎也可以使用与该插件同作者的RegionPassage.js，用区域来设置相应可通行/不可通行区域。
*
* 如果有更为细微的需求（例如半格或不规则碰撞体积），也可以找找别的插件。
* 例如QM+CollisionMap.js及其前置插件QMovement.js，允许你进行像素级移动，
* 并通过检查一张图片的颜色来设定通行设置。
* 图片白色和透明部分是可通行的地方，其他颜色不可通行。
*
*
*
*  == 5. 技巧 ==
*
* 可以先稍微熟悉一下以上四个模块的内容，再来看这一模块。
*
*
*  = 关于相对地图远景 =
*
* 设想情景：玩家正行走在一处山峰中。山峰会随着玩家的走动而移动。
* 表现形式：距离镜头近的山峰移动速度快。距离镜头远的山峰(背景)移动速度慢。
* 核心问题：解决不同山峰贴图的不同移动速度问题。
* 解决方法：在原来注释的基础上，只给各个贴图相应的注释参数"x"和"y"值乘一个PARAM即可：
*          (比如如果贴图原先位于相对于地图的(0, 0)处，就做出如下改动：)
*             "x": "this.rx(0)*PARAM",
*             "y": "this.ry(0)*PARAM",
*          其中，PARAM 是一个数字。
*        - 对于 距离镜头近 的贴图：PARAM 最好是一个1以上的数字。
*          数字越大，贴图随玩家移动的速度越快，所演绎的贴图与镜头的距离就越近。
*          记得将z层级设为4以上。
*        - 对于 距离镜头远 的贴图：PARAM 最好是一个0到1之间的小数。
*          小数越小，贴图随玩家移动的速度越慢，所演绎的贴图与镜头的距离就越远。
*          记得将z层级设为3以下。
*
*
*  = 关于动态帧图层 =
*
* 设想情景：玩家走到一处风景宜人的桃源乡暂且歇脚。湖泊中流水潺潺，好一幅生机勃勃之景。
* 表现形式：用多帧图层来表现动态的湖水。
* 核心问题：如何按照指定帧数依次显示湖水的各个图层。
* 解决方法：假设图层相对于地图位于(144, 144)，共有3帧(湖泊_1, 湖泊_2, 湖泊_3)，
*          则创建以以下格式书写的地图注释：
          <ulds> {
               "name": "湖泊_1",
               "x": "this.rx(144)",
               "y": "this.ry(144)",
               "z": 1.5,
               "visible": "v.value(10) === 0"
          } </ulds>
            <ulds> {
               "name": "湖泊_2",
               "x": "this.rx(144)",
               "y": "this.ry(144)",
               "z": 1.5,
               "visible": "v.value(10) === 1"
          } </ulds>
            <ulds> {
               "name": "湖泊_3",
               "x": "this.rx(144)",
               "y": "this.ry(144)",
               "z": 1.5,
               "visible": "v.value(10) === 2"
          } </ulds>
*        在这个例子中，属性"visible"中的条件占用了变量#10。
*        如果想替换为别的变量，直接将所有出现的"10"替换为所使用的变量ID即可。
*        随后，在地图上创建一个并行处理的事件，内容如下：
*            ◆等待：n 帧
*            ◆变量操作：#0010 = 1
*            ◆等待：n 帧
*            ◆变量操作：#0010 = 2
*            ◆等待：n 帧
*            ◆变量操作：#0010 = 0
*        n 是图层的帧间隔。
*        这样应该就没什么问题了。
*
*
*  = 关于简易光源 = 2022-12-09更新
*
* 设想情景：玩家/跟随者/事件在黑暗中行走，只有柔和的光源相伴左右，营造出一种静谧的氛围。
*
* 注意，这一例子主要是讲解将图片绑定在玩家/跟随者/事件上的方法和介绍图片锚点属性。
* 这一部分所制作的光源一个地图只能使用一张，局限性非常大，如果有需求的话还是要使用插件。
* 不过通过将图片绑定在玩家/跟随者/事件上与动态帧图层方法结合起来，可以制作类似角色行走图特效等的效果。
*
* 0.光源图片的配置
*
* 这一部分所要用到的光源图片并非一张简单的有色光源图片，而是背景为纯黑色，只有中心部分镂空作为光源的一张图片。
* 图片的尺寸下限以游戏分辨率为准。一格默认为48像素x48像素，如果分辨率为17格x13格（816像素x624像素），那么图片的大小至少应当是(17x2-1)格x(13x2-1)格，即1584像素x1200像素。
* 在这一情况下，考虑到图片文件的大小，可以适当缩小图片，使用时设置"scale.x"和"scale.y"属性调整缩放值即可。
*
* 在此提供两张用于816x624分辨率下游戏的光源图片。使用时需要将"scale.x"和"scale.y"属性均设为2。建议将"opacity"设为225。
light_816x624.zip (13.19 KB, 下载次数: 75)

2022-12-9 17:41 上传

点击文件名下载附件
圆形光源+手电筒光源

*
* 1.简易圆形光源 (烛光)
*
* 表现形式：以玩家/跟随者/事件为中心，周身环绕着圆形的光源。
* 核心问题：如何将圆形光源图片绑定在玩家/跟随者/事件身上。
* 解决方法：假设圆形光源图片名为 light.png ，为了将图片绑定到*玩家*身上，
*          则创建以以下格式书写的地图注释：
          <ulds> {
               "name": "light",
               "x": "this.rx(($gamePlayer._realX+1/2)*$gameMap.tileWidth())",
               "y": "this.ry(($gamePlayer._realY+1/2)*$gameMap.tileHeight())",
               "z": 5,
               "anchor.x": 0.5,
               "anchor.y": 0.5,
               "visible": "v.value(11) == 1"
          } </ulds>
*        将变量#11的值设为1时图片就会显现出来。
*
*        其中，"anchor.x"和"anchor.y"属性是指图片的锚点。锚点的位置将会影响图片的旋转和缩放效果。
*        锚点在左上角时"anchor.x"和"anchor.y"分别为0, 0，在中央时分别为0.5, 0.5，在右下角时分别为1, 1，以此类推。
*
*        ※如果想将光源图片绑定到*跟随者*上的话，就将"x""y"属性中的$gamePlayer替换成$gamePlayer.followers().visibleFollowers()[INDEX]。INDEX从零开始计数，第一个跟随者（地图上玩家身后的角色）索引是0。
*        ※如果想将光源图片绑定到*事件*上的话，就将"x""y"属性中的$gamePlayer替换成$gameMap.event(EVENT_ID)。EVENT_ID是事件ID。
*
* 2.简易手电筒
*
* 表现形式：手电筒的光源将会永远朝向玩家/跟随者/事件的正前方。
* 核心问题：如何让手电筒光源图片的旋转角度与玩家的朝向相关联。
* 解决方法：假设手电筒光源图片名为flashlight.png，图片中手电筒光源朝下，为了将图片绑定到*玩家*身上，
*          则创建以以下格式书写的地图注释：
          <ulds> {
               "name": "flashlight",
               "x": "this.rx(($gamePlayer._realX+1/2)*$gameMap.tileWidth())",
               "y": "this.ry(($gamePlayer._realY+1/2)*$gameMap.tileHeight())",
               "z": 5,
               "anchor.x": 0.5,
               "anchor.y": 0.5,
               "visible": "v.value(11) == 2",
               "rotation": "(function(){var obj = $gamePlayer;if(obj.direction()==2) return 0;if(obj.direction()==4) return 1/2*Math.PI;if(obj.direction()==8) return Math.PI;if(obj.direction()==6) return -1/2*Math.PI;})()"
          } </ulds>
*        将变量#11的值设为2时图片就会显现出来。
*
* 对于将手电筒光源图片绑定到跟随者/事件上的方法，参见 1.简易圆形光源 (烛光) 部分。记得将"rotation"属性值中的$gamePlayer也替换掉。
*
*
* = 关于淡入淡出 = 2023-07-27更新
*
* 1. 立即淡入淡出
*
* 设想情景：玩家甫一进入洋馆客房，房间墙壁和地毯上竟慢慢浮现出大块大块狰狞的暗褐色污渍。
* 表现形式：玩家进入地图时，血迹贴图渐渐由透明变为不透明（淡入）。
* 核心问题：如何使血迹贴图的不透明度随时间推移而增大。
* 解决方法：假设血液贴图的名称为 blood.png ，以图片左上角为锚点，贴图位于 (123, 456)，需要在 1.5s 内显现，
*          则创建以以下格式书写的地图注释：
          <ulds> {
               "name": "blood",
               "x": "this.rx(123)",
               "y": "this.ry(456)",
               "z": 3.5,
               "opacity": "(function(){var duration=1.5;var f=duration*60;var val=255/f;if(t<f){return t*val;}else{return 255;}})()"
          } </ulds>
*        如果想自定义时长，可以将参数 opacity 中的变量 duration 的值从 1.5 改成别的数。
*
*        ※ 如果要表现玩家一进入洋馆客房，墙壁上狰狞的暗褐色污渍渐渐淡去（淡出），则创建以以下格式书写的地图注释：
          <ulds> {
               "name": "blood",
               "x": "this.rx(123)",
               "y": "this.ry(456)",
               "z": 3.5,
               "opacity": "(function(){var duration=1.5;var f=duration*60;var val=255/f;if(t<f){return 255-t*val;}else{return 0;}})()"
          } </ulds>
*        如果想自定义时长，可以将参数 opacity 中的变量 duration 的值从 1.5 改成别的数。
*
* 2. 与开关相联的淡入/淡出(仅能同时实现一种)
*
* 设想情景：玩家最终找到了真相，在幻象消失之际，怨魂渐渐现身。
* 表现形式：打开指定开关后，怨魂贴图渐渐由透明变为不透明（淡入）。
* 核心问题：如何在等到指定开关打开后，相关贴图的不透明度随时间推移而增大。
* 解决方法：假设怨魂贴图的名称为 phantom.png ，以图片左上角为锚点，贴图位于 (123, 456)，需要在 1.5s 内消失，
*          则创建以以下格式书写的地图注释：
         <ulds> {
               "name": "phantom",
               "x": "this.rx(123)",
               "y": "this.ry(456)",
               "z": 3.5,
               "opacity": "(function(){var duration=1.5;var sId_show=20;var sId_prevent=21;var vId=13;var f=duration*60;var val=255/f;if(s.value(sId_show)){if(!v.value(vId)){v.setValue(vId, t);};var rt=t-v.value(vId);if(!s.value(sId_prevent)&&(rt<f)){return rt*val;}else{return 225;};}else{return 0;};})()"
          } </ulds>
*       ！注意！这个注释占用了两个开关(#20, #21)和一个变量(#13)。
*       开关#20打开时，贴图就会慢慢显现。变量#13存储开关#20打开时 t 的值，用以与之后的 t 进行比较。开关#21是为了防止每次进入地图时贴图都会显现一次。
*       所以在执行淡入时，可以设置事件：
*         ◆开关操作：#0020 = ON
*         ◆等待：90帧
*         ◆开关操作：#0021 = ON
*         90帧 = 1.5s，即所设置的淡入时长。必须先打开用于显现图片的开关(#20)，等待所设置的淡入时长后，再打开防止贴图重新显现的开关(#21)。
*       如果想再次执行淡入，在进入地图之前将两个开关关掉，再在进入地图后将两个开关按如上设置打开即可。
*       如果想自定义开关ID和变量ID，可以将参数 opacity 中的 sId_show 的值从 20 改成别的开关ID用以显示贴图，sId_prevent 用于防止贴图重新显现，vId 的值从 13 改为别的变量ID。
*       如果想自定义时长，可以将参数 opacity 中的变量 duration 的值从 1.5 改成别的数，单位秒。在事件中，记得打开两个开关之间等待的时长要和这里的值换算成帧数的最终结果相同。
*
*       ※ 如果要表现幻象渐渐消失，整个洋馆终于露出了它真实的样子（淡出），则创建以以下格式书写的地图注释：
          <ulds> {
               "name": "phantom",
               "x": "this.rx(123)",
               "y": "this.ry(456)",
               "z": 3.5,
               "opacity": "(function(){var duration=1.5;var sId_show=20;var sId_prevent=21;var vId=13;var f=duration*60;var val=255/f;if(s.value(sId_show)){if(!v.value(vId)){v.setValue(vId, t);};var rt=t-v.value(vId);if(!s.value(sId_prevent)&&(rt<f)){return 255-rt*val;}else{return 0;};}else{return 255;};})()"
          } </ulds>
*       ！注意！这个注释占用了两个开关(#20, #21)和一个变量(#13)。
*       开关#20打开时，贴图就会慢慢消失。变量#13存储开关#20打开时 t 的值，用以与之后的 t 进行比较。开关#21是为了防止每次进入地图时贴图都会消失一次。
*       所以在执行淡出时，可以设置事件：
*         ◆开关操作：#0020 = ON
*         ◆等待：90帧
*         ◆开关操作：#0021 = ON
*         90帧 = 1.5s，即所设置的淡出时长。必须先打开用于淡出图片的开关(#20)，等待所设置的淡出时长后，再打开防止贴图重新消失的开关(#21)。
*       如果想再次执行淡出，在进入地图之前将两个开关关掉，再在进入地图后将两个开关按如上设置打开即可。
*       如果想自定义开关ID和变量ID，可以将参数 opacity 中的 sId_show 的值从 20 改成别的开关ID用以淡出贴图，sId_prevent 用于防止贴图重新消失，vId 的值从 13 改为别的变量ID。
*       如果想自定义时长，可以将参数 opacity 中的变量 duration 的值从 1.5 改成别的数，单位秒。在事件中，记得打开两个开关之间等待的时长要和这里的值换算成帧数的最终结果相同。
*
* 3. 与开关相关联的自由淡入淡出(两种皆可实现)
*
* 设想情景：临近傍晚时分，街上的路灯一盏盏亮起；而至次日黎明，又会一盏盏暗去。
* 表现形式：打开用于淡入的开关后，路灯灯光贴图渐渐由透明变为不透明；打开用于淡出的开关后，路灯灯光贴图渐渐由不透明变为透明。
* 核心问题：如何将用于淡入的开关和用于淡出的开关同时绑定到灯光贴图上。
* 解决方法：假设路灯灯光贴图的名称为 streetlight.png，以图片左上角为锚点，贴图位于 (123, 456)，淡入淡出时长为 1.5s，
* 则创建以以下格式书写的地图注释：
         <ulds> {
               "name": "streetlight",
               "x": "this.rx(123)",
               "y": "this.ry(456)",
               "z": 3.5,
               "opacity": "(function(){var duration=1.5;var init_opacity=0;var sId_show=4;var sId_hide=5;var sId_prevent=20;var vId_target=15;var vId_opacity=16;var f=duration*60;var val=255/f;if(!v.value(vId_opacity)){v.setValue(vId_opacity,0);}if(s.value(sId_show)){v.setValue(vId_target,255);}else if(s.value(sId_hide)){v.setValue(vId_target,0);}var result=v.value(vId_target)==255?Math.min(v.value(vId_target),v.value(vId_opacity)+val):Math.max(v.value(vId_target),v.value(vId_opacity)-val);if((s.value(sId_show)||s.value(sId_hide))&&s.value(sId_prevent)){result=v.value(vId_target);}v.setValue(vId_opacity,result);return result||init_opacity;})()"
          } </ulds>
*       ！注意！这个注释占用了三个开关(#4, #5, #20)和两个变量(#15, #16)。
*       变量#15存储贴图的目标不透明度(0或255)，变量#16存储贴图的当前不透明度，是动态变化的。这两个变量均只读。
*       开关#4是淡入贴图的开关，开关#5是淡出贴图的开关，开关#20是为了防止每次进入地图时贴图都会消失一次的开关。
*       在执行淡入时，可以设置事件：
*         ◆开关操作：#0020 防止每次淡入淡出 = OFF
*         ◆开关操作：#0005 开始淡出 = OFF
*         ◆开关操作：#0004 开始淡入 = ON
*         ◆等待：90帧
*         ◆开关操作：#0020 防止每次淡入淡出 = ON
*       在执行淡出时，可以设置事件：
*         ◆开关操作：#0020 防止每次淡入淡出 = OFF
*         ◆开关操作：#0004 开始淡入 = OFF
*         ◆开关操作：#0005 开始淡出 = ON
*         ◆等待：90帧
*         ◆开关操作：#0020 防止每次淡入淡出 = ON
*       90帧 = 1.5s，即所设置的淡入淡出时长。
*       注意，如果淡入淡出前没有关掉防止每次淡入淡出的开关#20，那么就无法淡入淡出。
*       在参数opacity的参数值中，sId_show 是淡入贴图的开关ID，sId_hide 是淡出贴图的开关ID，sId_prevent 是防止再次淡入淡出的开关ID，
*       vId_target 是存储贴图的目标不透明度的变量ID，vId_opacity 是存储贴图的当前不透明度的变量ID，
*       最开始的 duration 是淡入淡出时长，单位秒；init_opacity 是贴图的初始不透明度。
*
*
* = 关于遮罩房间 = 2023-08-04更新
*
* 设想情景：玩家只能看到自己当前所在的房间，其他房间在玩家看来一片漆黑。
* 表现形式：只有踩在特定ID的区域内，相应的房间贴图才会显示。
* 核心问题：如何将特定ID的区域与房间贴图的显隐相关联。
* 解决方法：创建以以下格式书写的地图注释：
         <ulds> {
                "name": "streetlight",
               "x": "this.rx(123)",
               "y": "this.ry(456)",
               "z": 3.5,
               "opacity": "(function(){var regionId=200;if($gamePlayer.regionId()==regionId){return true;}else{return false};})()"
          } </ulds>
        ！注意！这个注释占用了区域#200。
        当玩家踩在区域#200上时，房间贴图才会显现，否则会消失。
        若想自定义区域ID，请设置 regionId 的值。
*
*       ※如果想在某个*跟随者*踩到特定ID的区域时显示房间贴图，就将"visible"属性中的$gamePlayer替换成$gamePlayer.followers().visibleFollowers()[INDEX]。INDEX从零开始计数，第一个跟随者（地图上玩家身后的角色）索引是0。
*       ※如果想在某个*事件*踩到特定ID的区域时显示房间贴图，就将"visible"属性中的$gamePlayer替换成$gameMap.event(EVENT_ID)。EVENT_ID是事件ID。
*
*
*
*/

如果想实现某种功能又不知从何下手的话可以回帖求助，我能帮得上忙的话，就会在主楼（这一层帖子）补充相关知识（技巧模块可能会持续更新）。大家的每一个问题、每一分解答都有助于完善该教程。

RPG的小新人

感谢大佬！

Rose_shadows

人偶师与机器人 发表于 2024-4-15 00:54
麻烦问一下，想做成进入遮罩房间后显示npc， 并且npc可以在遮罩房间和走廊之间来回移动，应该怎么做呢？ ...

可以转换一下思路，底下铺上一整块房间+走廊的地图，然后用黑色遮罩图片遮住各个房间就行。玩家踩到哪个区域就隐藏哪个区域的黑色遮罩。遮罩的visible可以这样写：

"visible": "(function(){var regionId = 200; if($gamePlayer.regionId()===regionId){return false;}else{return true;}})()"

表示当玩家踩到区域#200时遮罩隐藏。

人偶师与机器人

麻烦问一下，想做成进入遮罩房间后显示npc， 并且npc可以在遮罩房间和走廊之间来回移动，应该怎么做呢？

带火星的木条

带火星的木条 发表于 2023-12-19 00:10
打扰了，使用这个插件制作了树木图层，在同一套参数的情况下，816×624分辨率的地图没问题，换成1200×912 ...

非常感谢！！终于解决了！

带火星的木条

打扰了，使用这个插件制作了树木图层，在同一套参数的情况下，816×624分辨率的地图没问题，换成1200×912分辨率的地图后，树木图层就变成跟着玩家走了。树木图层的分辨率和对应地图的分辨率检查过了都是匹配的，想问一下这种情况是怎么造成的啊

1. <ulds> {
   
2. "name": "05 cunzhong tree",
   
3. "x": "this.rx(1)",
   
4. "y": "this.rx(1)",
   
5. "z": 15,
   
6. "loop": false
   
7. } </ulds>

复制代码

飞天老兲

冒昧问一下，这个插件可以叠加角色行走图吗？
我做的RPG游戏里面，使用同一种武器（《鬼灭之刃》的日轮刀）的角色/NPC很多，我希望不用每一个行走图都做一个手持武器差分，
而是通过图层叠加的方式完成武器装备

Rose_shadows

li19910808 发表于 2023-10-5 22:03
大佬，有个关于循环图片的开关的问题，不知道是不是插件冲突，还是指令问题，
"visible": "s.val ...

我这边试了一下，是可以运行的。
是不是loop属性后面少了英文逗号？

我是这样写的：
<ulds>{
  "name":"01_Mist",
  "x":"t*0.5",
  "y":0,
  "z":5,
  "loop":true,
  "visible":"s.value(13)"
}</ulds>

li19910808

大佬，有个关于循环图片的开关的问题，不知道是不是插件冲突，还是指令问题，
"visible": "s.value( )"指令跟循环图片"loop": true, 指令不能一起用，一起用，图片就不显示了。

我自己的指令如下，

<ulds> {
"name": "瘴气",
"x": "this.rx(0.25*t)",
"y": "this.ry(1)",
"z": "4.1",
"loop": true
} </ulds>

这个指令的图层可以正常循环，如果不用负责控制显示的"visible": "s.value( )指令的话，如果用"visible": "s.value( )指令，只能控制没有 "loop": true, 指令的静态图片的显示与否，是什么问题呢？

~谓伊~

感谢分享