如何建立一个组件库插件
当我们建立好一个完整组件库时(包含各级文件夹分级、Py文件和BFA文件),我们就可以将其通过插件形式,将其变为一个组件库插件
如何打包bfa(无图版)
如何打包bfa(有图版)
如何配置组件库插件
1. 首先,我们要按照组件模型分类,分好文件夹层级,例如施工场布组件库
插件名称为施工场布,下面分设1-7共七个文件夹,每个文件夹下又细分为多个文件夹

如1-建构筑物下又设置了5个文件夹

2. 我们需要配置施工场布组件库的Plugin文件
注意,Pyplugin文件需要和插件最外层文件夹处于同级目录下,插件plugin文件名称应当和插件文件夹名称一致

编辑plugin文件
需要注意,第一行的xml verion和encoding不需要修改。需要我们修改的是从第三行开始
首先,因为这是一个组件库插件,所以需要填写BfaLibName,填写时注意格式以及“/”的所在位置。
组件库名称是施工场布,所以我们在这里写施工场布即可。
PluginVersion,目前是1.0.6(截止2025年8月更新为止)
LoadStatus这里使用true即可
接下来,就是配置Ribbion菜单了。需要配置Categroy,Panel和Button
他们在建模软件中所对应的位置如下图所示
所以,我们需要配置一个Category,多个Panel,每个Panel下会有一个或多个Button,我们需要实现的是点击Button就会跳转至对应的组件库位置,而不是启动某个Py文件
我们的插件是施工场布插件,所以我们就给Category起名为“施工场布”,前面提到过,施工场布文件夹下有7个细分文件夹,那么就对应着7个Panel。这7个细分文件夹下还有各自的细分文件夹,这就对应着每个Panel下的button
因此,我们的第一个panel的名字就起名为“建/构筑物”。注意,Plugin文件中的Category、Panel和Button的名字(字符串)不需要和文件夹名称一致
【1-建构筑物】文件夹下有五个细分文件夹,那么我们就需要创建5个对应的button。这5个button的名字就根据其文件夹名字命名即可。
Commond一行中,填写的是Button所在的相对位置。
如果填写到Py文件,会变成运行该文件,但如果使用插件的电脑没有配置过环境,则会出现各种问题,所以组件库插件不允许将py文件写在commond命令中。
注意,Plugin文件会寻找和他同名的文件夹,Commond命令中的路径是在同名文件夹下的路径。
所以在这里填写的路径是【施工场布//1-建构筑物//1-墙、板】,而不是【1-施工场布//施工场布//1-建构筑物//1-墙、板】,文件夹【1-墙、板】下不再有细分文件夹,存放的都是bfa文件和Py文件(如需交付给其他用户,可不上传py文件,如比赛有要求,则需要提供py文件)
iconpath,填写ico文件名称(含文件后缀名)
helpweburl,可以使用默认链接,也可以不写
如下图所示
icopath也需要注意,直接填写ico文件名即可,软件会自动寻找Plugin文件同名文件夹下的Picture文件夹中对应的ico文件

重复以上步骤,编写设置好剩下的6个Panel和其下的button。最后Name一行,同BfaLibName即可

检查PluginModule路径。其路径为默认即可(因为使用BIMBase新建插件时就自动确定了),大多数情况下无需修改。(当前版本为V1.6,但如此处显示为V1.4或V1.5,那请将此处改为V1.6即可。注意,如果修改了此处版本号,需将Plugin文件和组件库插件文件夹一并移入修改后的文件目录下。)

- PluginSDKVersion设置为1.6.1即可
