Home - mchorse/bbs-mod-wiki GitHub Wiki

Welcome to BBS mod Wiki! Here you can find additional technical information that isn't present in video tutorials or on Discord.

What is BBS mod?

BBS mod is a Minecraft mod for Fabric 1.20.4 and 1.20.1 which aims to assist content creators in creating cinematic (machinimas) or roleplay videos. If you know about Blockbuster mod, think of BBS mod as Blockbuster mod's spiritual successor.

I don't have any plans to have compatibilities with other mods. If other mod crashes with BBS mod, or causes issues with other mod, or other mod causes issues with BBS mod, then it is what it is. The only mods that BBS mod is aimed to be compatible with are Sodium and Iris.

Incompatible mods

Majority of these were reported by users. I haven't personally checked these, so keep that in mind.

  • OptiFabric. Bone picker mechanism gets sabotaged for some reason when OptiFabric is installed.
  • Blur+. Messes up preview in the film editor.
  • Dynamic FPS. Flickers screen when Minecraft is out of focus.
  • TaCZ. Interferes with actor control in the film editor, rendering WASD control useless. It also messes up with Record Current Replay keybind.
  • ResolutionControl+. When resolution is changed, mobs will be shifted in a weird way in film editor's preview.
  • Legacy4J. Messes up with form preview picker scrolling and GUI scale.
  • Effective. Breaks film editor's preview in newer versions.
  • Immersive Engineering. Breaks film editor's preview.
  • Stellarity. Turns film editor's preview black.
  • Simple Animated Guns. Breaks film editor's preview resolution.

Quirks with other mods

There are some quirks you might encounter when using BBS mod with other mods. Here are some known quirks:

  • Whenever you use mob forms with Entity Model Features mod and resource packs, mob animations can appear as capped by frame rate, but they won't lag. This happens because player is far away from the mob. Move your character closer to the scene, or enable Teleport player to camera by right clicking Teleport icon and left clicking the top option.
  • Distant Horizons has a visual glitch when entering the dashboard. Check this video out for more information. Distant Horizons used to be broken in film editor preview prior to 1.2.1.

Incompatibility with Forge and Sinytra Connector

IMPORTANT: these bugs were resolved in BBS mod 1.2.

Prior to version 1.2, due to the way Sinytra Connector works, or possible skill issue on my part, BBS mod 1.20.1 build has following issues when used on Forge:

  1. Actor control movement doesn't work in film editor.
  2. Factory models like player models, MichaelCreeper_'s bendable models and eyes rigs don't work out of the box. BBS mod circumvents that by copying the files manually to config/bbs/assets/models/player/..., but if there will be any changes to those models, you'll have to remove those folders to update the files. Or manually grab the files from BBS mod's jar in assets/bbs/assets/models/player/ and replace accordingly.

Blockbuster mod vs BBS mod

A lot of people in the past asked me what is the difference between Blockbuster mod and BBS mod, and whether BBS mod can do exactly same things that Blockbuster (and its complementary mods) can do. Let's start with the basic difference.

Property Blockbuster mod BBS mod
Minecraft version 1.12.2 (and previously 1.10.2 and 1.11.2) 1.20.4 and 1.20.1
Mod loader Forge Fabric (works on Forge 1.20.1 via Sinytra Connector mods)
Additional mods Requires a lot of mods Requires just Fabric API

What Blockbuster mod can do that BBS mod can't?

Blockbuster mod was developed for a longer time, and therefore has more features. Its advantage over BBS mod:

  • CGI features (mostly developed by Chryfi) — Blockbuster mod (and its complementary) has extra features to help applying additional VFX in After Effects or Blender, like 32-bit depth, keying, etc.
  • Sequencer morph — one of the factory features of Blockbuster mod is sequencer morph, which allows to animate morphs without player recording editor. This feature was added in 1.6!
  • Structure morph — structure morph allows animating and using structures saved with structure block as morphs. However, there is a fork called BBS CML EDITION that features a simple variant of this feature.
  • Shader curves — in Aperture mod, with shader packs, you can animate shader pack's parameters. This feature was added in 1.5!
  • First-person playback — this feature makes it easier to record 1st person POVs, simulating roleplays. This feature was partially implemented in 1.4.2!

What BBS mod can do that Blockbuster mod can't?

Even though Blockbuster mod has more features, and BBS mod wasn't out for a long time, there are still unique features present in BBS mod that aren't in Blockbuster mod:

  • anchor keyframe property — this feature allows smoothly attach replays between different replays.
  • Model block transformations — this feature is useful for roleplays, you can change how model block and BBS gun look like in first person, third person, on the ground, and inventory. You can also have separate forms for different perspectives.
  • Trail form — this form allows creating trailing effects, looks impressive for swords or any fast moving actions.
  • Converting media files / drag-and-dropping files — one of the most convenient features of BBS mod is an ability to convert (through ffmpeg) different media file formats (like .mp3, .flac, etc.) to native formats that BBS mod works best with.
  • Hermite interpolation for poses — one feature that makes BBS mod way better for animation is the presence of hermite interpolation, not only for camera, but also for other aspects, like poses, shape keys, etc.