JZL - 🔗 MiniMax H3 ref2va参考总线（解包）

"JZL - 🔗 MiniMax H3 ref2va参考总线（解包）" (ref2va Reference Bus Unpack) is the receiving end of the pack's ref2va bus. It takes the single JZL_REF2VA_BUS wire created by the pack-side "ref2va参考总线（打包）" node and fans it back into the 18 fixed ports: ref_image_0–ref_image_8, ref_video_0–ref_video_2, ref_video_audio_0–ref_video_audio_2, and ref_audio_0–ref_audio_2.

The names are not an accident - they're an exact match for the input names on the "MiniMax H3 参考编码2" node (the fixed-port ref2va encoder), and the source says so explicitly: the unpack side connects straight to the encoder with zero renaming. This is the "keep the graph tidy without breaking the encoder" pattern, and it works because the port names were designed to line up.

How it works

The bus input is force-input of the custom JZL_REF2VA_BUS type, so ComfyUI only lets a genuine ref2va bus onto this port. unpack reads the 18 keys in the fixed order - images, videos, video soundtracks, standalone audios - and returns them typed by name: IMAGE for the image/video slots, AUDIO for the soundtrack and audio slots. It's pure transport: no resizing, no decoding, no scheduling. Whatever was None at pack time comes back None.

Outputs are the 18 fixed ports, ready to wire into the encoder's ref_image_N / ref_video_N / ref_video_audio_N / ref_audio_N inputs.

How to install it

Part of the JZL-MiniMax-H3 pack - ComfyUI Manager, search "ComfyUI-JZL-MiniMax-H3", or:

cd ComfyUI/custom_nodes
git clone https://github.com/wjluoxiao/ComfyUI-JZL-MiniMax-H3

Restart. No dependencies.

Common issues

The two bus types are intentionally incompatible - JZL_REF2VA_BUS (18 ports, this pair) won't connect to the 48-slot JZL_REF_BUS pair, and that's a feature, not a restriction. Watch the positional pairing of videos and their soundtracks: ref_video_audio_1 must belong to ref_video_1. And remember this node feeds the fixed-port encoder - the dynamic Autogrow version takes its own growing inputs, so there's no bus involved there. If a reference goes missing, trace back to the pack side: an unconnected slot rides through the bus as None and comes out None, silently.