Project1

标题: 地图自动播放BGM/BGS控制器 [打印本页]

作者: Shirakawa_Yuui 时间: 2025-8-13 18:23
标题: 地图自动播放BGM/BGS控制器
本帖最后由 Shirakawa_Yuui 于 2025-8-14 04:24 编辑

本插件旨在拓展原地图属性 - 自动切换BGM/BGS 的功能。

可以为地图添加多首自动播放的BGM/BGS，通过不同的标签来决定播放那一首。

能够实现某些只有在固定时点才自动播放特定BGM/BGS，地图时间系统一类的。

例如：

时间为"早上"自动播放早上的BGM，

时间为"下午"时，自动播放下午的BGM 等等

如何使用？
在地图属性的注释栏中添加上添加对应的注释，并且使用事件 - 脚本来设置相应的自动播放Tag即可。

帖子最下面/插件帮助内有设置教程，可以参考那个来设置。

更新 v1.1，添加了自动播放模式的选择，具体看插件内的帮助。

地图注释填写格式：

1.自动播放bgm:

<Yuui_AutoPlayController_BGM>{
"tag": 自动播放标签,
"name": Bgm名称,
"volume": 音量,
"pitch" : 音高,
"pan": 音像
}
</Yuui_AutoPlayController_BGM>

2.自动播放bgs:

<Yuui_AutoPlayController_BGS>{
"tag": 自动播放标签,
"name": Bgm名称,
"volume": 音量,
"pitch" : 音高,
"pan": 音像
}
</Yuui_AutoPlayController_BGS>

参数解析：

tag 对应的是标签名称
name 对应的是bgm名称（不需要填写后缀名）
volume 对应的是音量
pitch 对应的是音调
pan 对应的是音像

括号内需要严格符合json格式填写，每个地图添加的BGM/BGS无限制，想添加多少都行。

但是注意同类型的对象内，tag不能相同，否则播放的时候只会取最先填写的那个。

添加Tag的脚本：

Yuui_AutoPlayController.addTag("类型","标签")

类型有：BGM、BGS、ALL
分别代表：设置BGM、设置BGS、以及全部设置

标签内容可以自定义，什么字符都可以

删除Tag的脚本：

Yuui_AutoPlayController.resetTag("类型")

类型有：设置BGM、设置BGS、以及全部设置

开启/关闭自动播放的脚本：

Yuui_AutoPlayController.AutoPlaySwitch("类型",布尔值)

类型有：BGM、BGS、ALL
分别代表：设置BGM、设置BGS、以及全部设置
布尔值：true/false（开启/关闭）

注意：默认 BGM/BGS 的自动播放是打开的

(注意： !!!写的时候注意别漏了引号!!! ）

具体的使用方法/教程

1.设置地图注释：

首先在地图注释上设置

<Yuui_AutoPlayController_BGM>{
"tag": "早上",
"name": "Battle1",
"volume": 60,
"pitch" : 100,
"pan": 0
}
</Yuui_AutoPlayController_BGM>

（在这个位置里面添加）

2.添加自动播放标签

事件 - 脚本中设置

Yuui_AutoPlayController.addTag("BGM","早上")

注意：填写的时候注意不要漏了引号，也不要写成全角引号

（在这个位置里面添加）

这时候你再进入这张地图，就会自动播放你设置好的BGM了(Battle1)

BGS设置也大同小异

关于标签：

设置的BGM/BGS标签是持久的，除非被修改/清除（插件内有清除方法），否则本存档内都能生效。
尽量不要在同一张地图下，同类型的对象（例如同是BGM）设置同样的标签。

但是不同的对象类型下可以设置相同的标签，
例如：BGM、BGS内都有一个名为"早上"的标签，这样可以更好的管理BGM/BGS。

目前我这边运行没啥问题，若是插件有什么问题可以向我反馈，能修我尽量修。

Yuui_AutoPlayController v1.1.zip (4.25 KB, 下载次数: 9)

作者: 杰克哈尔 时间: 2025-8-16 02:55
非常感谢大大

欢迎光临 Project1 (https://rpg.blue/)