源码编译MuJoCo后加载含plugin模型报错：unknown plugin

问题情况 #

通过源码编译安装MuJoCo，执行了以下步骤：

mkdir build & cd build
cmake ..
make .

并在.bashrc中配置了环境变量：

export LD_LIBRARY_PATH=/home/xxx/Downloads/mujoco-main/build/bin
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/nvidia
export PATH="$LD_LIBRARY_PATH:$PATH"

普通模型（如humanoid_model.xml）可正常运行，但加载含插件的模型（如bowl.xml、cable.xml）时，报错：

XML Error: unknown plugin 'mujoco.elasticity.cable' Element 'plugin', line 20

解决步骤 #

1. 重新编译并启用插件支持

默认CMake配置未开启插件编译，需添加编译选项重新构建：

# 进入编译目录并清空原有文件
cd /home/xxx/Downloads/mujoco-main/build
rm -rf *

# 启用插件编译并生成Makefile
cmake .. -DMUJOCO_BUILD_PLUGINS=ON

# 多线程编译（提升速度）
make -j$(nproc)

2. 让MuJoCo识别插件库

编译完成后，插件库会生成在build/plugins目录下，需确保MuJoCo能找到它们，二选一即可：

方式一：设置插件路径环境变量

编辑.bashrc添加：

export MUJOCO_PLUGIN_PATH=/home/xxx/Downloads/mujoco-main/build/plugins

执行以下命令使配置生效：

source ~/.bashrc

方式二：复制插件到默认路径

若不想新增环境变量，可将插件库复制到MuJoCo默认读取的插件目录：

mkdir -p ~/.mujoco/plugins
cp /home/xxx/Downloads/mujoco-main/build/plugins/*.so ~/.mujoco/plugins/

3. 验证修复

重新运行simulate加载带插件的模型：

cd /home/xxx/Downloads/mujoco-main/build/bin
./simulate ../model/cable.xml

内容的提问来源于stack exchange，提问作者Yuxuan Wang