Skip to main content

​
Blueprints did not load

vetra-blueprints needs vetra-framework. Both folders go in garrysmod/addons/, and both must keep their exact names.Check the folder names have not picked up a suffix from your extraction tool, such as vetra-framework-1 or vetra-framework (1).
More than one vetra-framework folder is in garrysmod/addons/, under any name. The console lists every copy and the version it declares, at boot and again once the map has loaded.Keep the one you mean to run, normally the newest, delete the others, and restart. Until then Blueprints does not open, and vetra_license_status and !vblueprints do nothing. Your data is untouched. See Updating.
Confirm the addons are actually mounted. vetra-framework/lua/autorun/vetra_framework.lua should exist relative to your garrysmod/addons/ folder.Errors and warnings from Vetra always print. There is no convar to turn them on, because a support ticket depends on them being visible.

​
Nothing happens when I type !vblueprints

The command is consumed for everybody who types it, authorised or not, so the line never reaches the room. If nothing opens, you are not an admin on this server as far as Garry’s Mod is concerned. If the line does appear in chat, Blueprints is not running on this server at all. Check the server console; a duplicate framework install is the usual cause (see above). Check with your admin mod that your rank actually grants admin. Then try the console command, which does the same thing:

​
The window opens but every section is empty

Read the notice at the top of Overview. The shell opens without a licence check on purpose, so an admin on a denied server can reach the screen that explains the denial. Then run, in the server console:
and match the state against Licensing and servers.

​
Licensing

Usually one of:
  • The addon was not your own download. A copy taken from a friend, a forum or another server carries their account. Download your own copy from your GmodStore purchases.
  • The server cannot reach the internet, or blocks outbound HTTPS. Check with your host. Blueprints only makes outbound requests; nothing needs opening inbound.
  • No free slots. See below.
Once the cause is fixed, restart. Automatic activation runs again on every start that has no credential yet.
Three servers per purchase. Open a ticket and tell us which server you no longer use, and we will free the slot. No charge, no waiting period.
The purchase behind this licence is not currently valid: refunded, revoked, or charged back on GmodStore. If you believe that is wrong, open a ticket with your purchase details.A denial never comes from a network failure and never decays back to allowed on its own.
We are unreachable and your server is running on its cached licence. Nothing is wrong on your side. It resolves itself. See Working offline.
The cached licence expired. Restore outbound HTTPS and it recovers on the next check. Nothing was deleted.
The old activation is still holding the slot. You need a recovery code. See Moving or replacing a server.

​
Adapters

Open the Adapters screen, or run vetra_blueprints_adapter show <id> in the server console. Every unavailable adapter carries a sentence written by that adapter explaining why. The common ones:An unavailable adapter’s domain is left out of every Version, rather than recorded as empty. That is the safe behaviour: a Version claiming a domain is empty would, restored, delete it.
It did not register. vetra_blueprints_adapter list shows every adapter that did. Registration happens through one hook, once, after the map has loaded, and registration outside that window is refused.If you wrote the adapter, see Registry. If somebody else did, tell them: the console names the refusal and the reason.

​
Versions, restore and migration

That adapter could not read its whole domain, so the capture refused rather than recording a partial world.This is recoverable and nothing was written. Fix whatever the adapter reported, and capture again. A capture that failed is far better than a capture that lied: a partial Version diffed against a healthy one reports every missing object as deleted.
Imported Versions cannot be restored. They can be inspected, compared and used as a migration source, and they are what a deployment applies.Use Deploy instead. The reason is in Export and import.
The objects were captured in a server session that has since ended, and their adapter only guarantees identity within a session. Props and NPCs are session-scoped, honestly.Blueprints will not match them by position or model, because matching by position is what destroys builds. Capture a fresh Version in this session, or use Migration, which creates new objects rather than reconciling old ones.
Changing a model in place rebuilds the physics mesh, loses the motion state and invalidates every constraint the entity is part of. The honest operation is a replace (remove plus rebuild), which version 1.0 does not implement.Exclude that object to leave it as it is, or remove and rebuild it yourself.
Check the group’s anchor. The anchor is what placement is measured from, and the default is computed from the members’ recorded bounds.Use Move Anchor to put it somewhere meaningful (a doorway, a corner, the base of a tower). Move Anchor changes nothing in the world; it changes where you hold the group.
An adapter that was authoritative when the Version was captured cannot be used here. The message says which of the three it is: the adapter is not installed, its dependency is missing, or it cannot read the data format that Version recorded.A blocked domain is left alone. Nothing is applied to it and nothing is deleted from it.

​
Remote Deploy

Vetra is holding the deployment until the target server next checks in. Confirm the target server is running, has Blueprints loaded, and has outbound HTTPS.
The target’s world changed after you approved, so nothing was applied. A new plan is being prepared and needs your approval again. This is the protection working.
The target server was interrupted while applying. Its own recovery has to be run on that server by an administrator before it will deploy again. Nothing is re-applied automatically. Open Deploy on the target.
Remote deployment is same-map. Change the target’s map, or deploy a Version captured on the map it is running.

​
Still stuck

Getting support

What to include so the first reply is an answer.