Prefab encapsulation has been one of the top feature requests from Unity users ever since nested Prefabs were introduced in 2018. BlackBox enables just that, with a single component!

With all the options that Unity's Prefab system offers, even for an expert user it can be easy to make modifications by mistake on a Prefab instance and leave them as overrides in the scene, something that can become a source of bugs that are pretty hard to track down. With BlackBox it's possible to prevent overrides to any Prefab... but not just that!

BlackBox offers three main features:

📦 Locking a Prefab

📦 Revealing properties, methods, references, or entire components

📦 Preventing Apply

And the beauty is that these three can be used together or individually, to create just the Prefab workflow you need!

In detail:

📦 LOCKING

Once you add the BlackBox component, any Prefab with a number of children GameObjects and components appears as a single object in the hierarchy in the Scene. The user can only change the Transform properties, and enable/disable it. To modify other properties, simply open it in Prefab mode and make changes as usual.

Temp Unlocking (NEW!)

You can temporarily unlock a Prefab on-the-fly, by just clicking an icon or hitting the U key. This allows you to add overrides to an otherwise locked Prefab.

📦 REVEAL PROPERTIES, METHODS, OBJECT REFS, COMPONENTS

If you have an important aspects of your Prefab that still need to be visible, you can add them to a list of revealed items. These special properties are going to show up on the root even when the Prefab is locked! (see images)

• All property types are supported out of the box, including the ones decorated with Odin Inspector! ✨
• You can reveal entire component Inspectors in one click! ✨✨
• You can reveal methods, and they will show up as buttons, so you can invoke them directly from the BlackBox (in Play or Edit mode). ✨✨✨
• If you need to reference a child Component in another script (a typical Unity pattern!), you can reveal an object reference to it! ✨✨✨✨

In essence, you can expose any internal aspect of your locked Prefabs, and use that to guide the team on what they can actually modify.

📦 PREVENTING APPLY

You can take revealed properties one step further and prevent users from applying Scene overrides to them. They can still be Reverted, but with no Apply the user gets the extra safety of being unable to mess with the original Prefab asset.

➡️ AND MORE!

Auto-add

You can configure BlackBox to be auto-added to all your Prefabs on creation, to achieve the ultimate safe workflow... or just add it manually to the ones you want!

No impact on the game

The BlackBox component is an editor-only component, so it won't end up in your builds, meaning it has no impact on the game.

You can easily add, remove or readd the BlackBox component, with no consequence or changes to how your Prefabs behave at runtime.

Compatible with all Prefab types and workflows

The BlackBox workflow is compatible with Prefab Variants and nesting, so you can have a locked Prefab within an unlocked Prefab, or viceversa.

Compatible with Odin Inspector

By simply using an [RevealWithOdin] attribute, properties decorated with Odin attributes will show in the BlackBox component just like they do in their original components.

Please note that the vast majority of Odin attributes are supported, but not all. Attributes that modify the layout (like [TabsGroup] or [FoldoutGroup]) are unlikely to work.

🎩 Integration with Hats - Workspaces and Teams (NEW!)

BlackBox integrates with Hats - Workspaces and Teams. Upon configuring a Prefab, you can now choose which Teams are allowed to edit it. (Read Hats documentation for more on Teams)

🈶️ CJK languages support

BlackBox supports CJK languages for revealed property names.

该工具支持中文。

このツールは日本語をサポートしています。

이 도구는 한국어를 지원합니다.

📘 Documentation

You can preview the documentation and learn all about the functionality before you get the asset.

Save some money

BlackBox is part of our All Editor Tools bundle. By getting that, you effectively get this package at 25% off. If instead you already purchased this package, you will get a discount on the bundle.

💬 Feedback

If there is a workflow BlackBox doesn't cover, I'd like to hear from you how I can make BlackBox better. You can write to buoybase@gmail.com and we can assess if it can be added to the asset. Or hop on my Discord to have a chat.