查看“MAplus/zh”的源代码

{{NeedContent/zh}}
MAplus全称Mapping-Actions-Pack-plus,是[[Ghomist]]利用[[Virtools]]内建的[[Action]]开发的一套工具，其运行方式与Virtools原版的Actions相同。这套工具对Virtools内许多繁琐操作进行了简化，以vsl脚本的方式进行半自动化批量操作。

此工具包使用了[[VSL]]进行编写，完全开源。（事实上vsl文件可直接以文本文档的方式打开，并且可以直接看到源代码，故无需另行开放出源码）

此工具包目前涵盖了物件操作，[[网格]]操作，归[[组]]辅助，灯光辅助，命名辅助共5个方面。大多数情况下能为vt内操作节省大量繁琐操作，减少出错率；在使用熟练之后可以使vt内操作效率大幅提高。

不过，vt内使用Action进行的操作是'''''无法撤销的'''''。尽管大部分时候不会造成过于严重的损失，还是建议养成随手保存的习惯。

==安装与使用==

MAplus内包含了5个文件夹，名称如下: ''（括号内为注释而非文件名）''
* B_3DEntity（物件操纵）
* B_Group（归组辅助）
* B_Light（vt内灯光辅助）
* B_Mesh（网格工具）
* B_Name（命名工具）
'''安装时'''，直接将上述5个文件夹复制到Virtools根目录下的Actions文件夹内，随后重启vt即可使用。

'''使用时'''，在vt内3d layout或level manager界面右键Actions选项内选择需要调用的Action即可。

'''''值得一提的是'''''，vt内可以设置Action的快捷键以实现更高效地调用常用的Action。关于快捷键的介绍[[MAplus#快捷操作|详见后文]]。

==基本功能==
下面列出了MAplus所有功能的简介。

借助这些简介可以更好地了解MAplus的功能细节。

类似于索引，绝大部分时间建议使用检索功能直接查看具体的Action，而非一个个阅读。
=== B_3DEntity ===
* Align2
对齐

对vt原版align进行了优化，使得其可以将物件作为一个整体进行对齐。为了防止与原版Align重名遂加上了数字2作为后缀。

选中第一个基准物件，将第二个物件对齐至轴的指定方向使其顶端齐平(最大对最大/最小对最小)。

若选中As Whole则第三个物件及之后所有物件将与第二个物件作为一个整体，保持相对位置不变。不选中则所有物件按第二个物件的方式单独处理。

* CenterDistribute
使物件在指定轴居于两物件正中。

选中前两个基准物件，之后所有物件的选定轴调整至初始两物件选定轴的中心坐标。

选择少于三个物件时不运作。

* FastSplice
快速贴附。

选中第一个基准物件，第二个物件将贴附至指定轴指定方向的表面（如果指定方向选中Center则会使第二个物件贴附到基准物件的正中心）。

第三个物件及之后所有物件将与第二个物件作为一个整体，保持相对位置不变。

* SetPosition
设置坐标。

选中一个基准物件，并设置其坐标。

第二个物件及之后所有物件将与第一个物件作为一个整体，保持相对位置不变。
=== B_Group ===

* AsFloor
将选中物件按“[[路面]]”[[归组]]。若选中AsWoodenFloor则按“木制路面”归组。

将物件归入路面组，声音1组（包括滚动与撞击，若为木制路面则归入声音2组）。可自选是否归入[[影子]]组。

* AsModul
将选中物件按“[[机关]]”归组。

输入[[小节]]代码（1到8的整数）和[[机关]]代码即可自动归入。

[[箱子]]、[[道具球]]、[[变球器]]和[[Dome]]等不属于此处所说机关，对于这些道具请手动归组。

* AsRail
将选中物件按“[[钢轨]]”归组。

即将物件归入钢轨组，声音3组（包括滚动与撞击）。

* RemoveFromGroup
将选定物件从指定组移出。

若当前物件不存在于指定组内，则不执行。

*SCREGrouper
将[[存档点]]、[[重生点]]、[[飞船]]自动归组。

若名称不正确或不存在组，则不执行。具体详见[[归组#特殊物件组]]。

* SectorChanger
改变选中物件所在的小节组。

输入需要转入的小节数（1到8的整数），将会使物件从当前小节组移出并归入新的指定小节组。

若当前物件不存在于任何小节组则不执行。若指定小节组不存在（无法获取）也不执行。

=== B_Light ===
* LightOff
删除由“LightUp”产生的[[光源#平行光源|平行光灯]]。

若不存在则不执行。

* LightUp
生成一个位于世界原点处的平行光灯。

生成的灯角度已调整，可快速照亮路面上表面及一部分侧面。效果类似于游戏中的光照效果。

若需删除，可使用“LightOff”快速删除，亦可手动删除。若已存在，则不执行。

=== B_Mesh ===
=== B_Name ===

==快捷操作==

==下载==
[http://ghostmisser.ys168.com Ghomist的ys网盘]