Proof Suite 1.2.0 — Documentation

1. What this is

Twelve separate Blender add-ons, sold together. They are separate on purpose:each installs, updates and works on its own, and removing one does not affectthe others. What the suite adds is what happens when several of them areinstalled at the same time — one run, one report, one verdict for a wholedelivery.

2. Installing

The download contains twelve add-on archives in one folder, plus a shortreadme. Install each the normal way: open Preferences, go to Add-ons, chooseInstall from Disk, pick an archive without unpacking it, and tick its checkboxto switch it on. Repeat for as many as you want, in any order. Nothing heredepends on anything else being present.

There is nothing else to install. No Python packages, no models, no accounts.Nothing is downloaded at any point and nothing leaves your machine.

3. The Whole Delivery panel

Once a tool is switched on, its sidebar tab gains a Whole Delivery panel withtwo buttons.

Check A Folder Of .blend Files runs that one tool over everyfile in a folder you pick.

Check A Folder With Every Check You Own runs all the toolsfrom this line that you have installed, over the same files, in one pass.

Both open every file in its own background Blender. The scene you have openis never touched: not opened over, not saved, not modified. This is also why afile that will not open costs you only that file — the rest of the delivery isstill checked, and the report names the one that failed.

Press Escape to stop. Nothing partial is written on purpose: a reportcovering half a delivery is a report nobody should trust.

4. The report

When the run finishes you get a single page next to the folder you checked.It opens in any browser and contains everything inside itself — no fonts,styles or scripts fetched from anywhere. It will still open years from now on amachine with no network.

It reads top down: the verdict for the whole delivery, then one file at atime. Each file shows which checks ran and what each said in a sentence, thenthe numbers, then every finding with its address and a line on what to do aboutit. Findings are ordered by severity, not by the order they were found, becausethe first three lines are the ones a lead actually reads.

5. Running it from a pipeline

Every tool has the same headless entry point: no interface, no person, onecommand that writes the report and finishes with a code your build system canread.

• 0 — clean.
• 1 — something blocking was found.
• 2 — a file could not be checked at all.
• 3 — the command itself was wrong, for example no files were named.

The second and third are separate from the first deliberately. A check thatdid not run has not passed, and a gate that treats silence as success will oneday let through the delivery it exists to stop.

The exact command line for your installation is shown on each add-on'spreferences page, so it can be copied without typing.

6. Comparing against last week

Any run can be saved as a baseline. A later run then reports what changed:which numbers moved and in which direction, which findings are new, and whichyou have fixed since.

Direction is not guessed. Each measurement carries its own sense of which wayis worse, decided by the tool that produced it — so rising coverage reads as animprovement and rising drift reads as a regression, without you having toremember which is which.

A baseline that cannot be read is reported as such rather than ignored. Therun still happens; it simply says it had nothing to compare against.

7. Sign-off inside the file

The Sign Off This File button runs every check you have on the file that isopen and writes the result into the file itself: the date, the tools and theirversions, the verdict and the counts.

Open that file next month and the panel says, before you press anything, whenit was last checked and how it came out. A pipeline can ask the same questionwithout running anything.

Two things are deliberate. First, checking a folder does notsign the files inside it: those are opened only to be read, and writing intothem silently would change files you asked us to check, not to touch. Signingoff is a separate, deliberate action on the file you have open. Second, if thefile is saved after the record was written, the panel says the record is out ofdate — a sign-off that stays quiet about later edits is worse than none,because people believe it.

The record is a log, not a seal. It says what was measured and by what. Itproves nothing about quality and can be edited by anyone with the file, and theadd-on does not pretend otherwise.

8. Taking you to a finding

Findings that have an address can be jumped to from the panel: the object isselected and brought into view, the frame is set, and the vertex or bone inquestion is made active. Only the selection, the mode and the current framechange, and the step can be undone like any other.

If the address no longer matches anything in the scene — the object wasrenamed or removed since the check — it says so plainly instead of selectingsomething at random.

9. One sidebar tab

Each tool has its own sidebar tab, which is right when you own one. Ownseveral and the sidebar fills up, so the panel offers to group them: one clickand all of them move into a single tab, collapsed, with one Whole Delivery panelinstead of one per tool. One click puts them back where they were.

The choice is remembered next to your Blender settings and applies to everytool from this line you have installed, so it only has to be made once. Thebutton appears only when more than one is installed.

10. Which tools repair, and which deliberately do not

Seven of the twelve can fix what they find, and each proves the fix bymeasuring again rather than by falling silent.

Five do not, and that is a decision rather than a gap:

• Rig Inspector never changes anything. Its whole promise is that it can be pointed at somebody else's rig safely.
• HandoffProof reports how your file opens elsewhere; it cannot reach into the other person's Blender.
• Modifier Profiler shows what a modifier costs. Whether to pay it is a modelling decision.
• AnimProof and OverrideProof tell you what moved and why. Rewriting animation or overrides automatically is a change we are not prepared to make on your behalf.

The same principle runs through the ones that do repair: an unbound vertex isnever assigned to the nearest bone, and a vertex further from the surface thanits own mesh spacing is left alone. Both are named in the report and left toyou.

11. Compatibility and limits

• Blender 4.2 LTS through 5.2, on Windows, macOS and Linux.
• Checking a folder starts one background Blender per file, one after another. A delivery of forty heavy scenes takes time; the panel shows which file it is on, and Escape stops it.
• The combined run needs the tools to be installed and switched on. Tools you do not own are listed in the report as not having taken part.
• Restoring or repairing works on the file you have open, never on files inside a checked folder.

12. How this was tested

8769 automated checks across Blender 4.2.9 LTS, 5.1 and 5.2, with zero problems. One change was made after that run — a false alarm fixed in DeformProof, which could report an untouched mesh as moved — and it was re-verified the same way: 133 checks on each of the three versions, plus the shared-module suites, again with zero problems. Among them:

• all twelve installed into one Blender at once — 432 operators, 193 panels and 96 scene properties, with nothing colliding; switching them all off leaves nothing behind, and switching them all back on works;
• the folder run measured against the open scene, to prove it is not touched;
• every repair measured before and after, and each test deliberately broken to confirm it can fail.

13. Support and licence

Through the marketplace messaging where you bought this. Licence: GPL-3.0.