Skip to main content
Your server setup is a build. It took weeks, it lives in one map on one server, and the only record of how it got there is your memory of doing it. Blueprints treats it as what it is: a project with a history.

Install Blueprints

Two folders into garrysmod/addons/, then restart. No key, no config file.

Learn the workflow

Capture a Version, change something, read the diff, put it back.

Build an adapter

Teach Blueprints to manage the objects your own addon owns.

What it does

Version

Capture the managed state of your server as an immutable, timestamped Version. Browse the history, inspect what any Version contained, compare any two.

Group

Treat a market stall or a checkpoint as the one thing you built rather than as forty props. Each group carries its own anchor.

Migrate

Rebuild a group captured on one map onto another, with a ghost preview in the world before anything is created.

Restore

Return the managed world toward an earlier Version. The full plan is shown before the first change, and a failed restore rolls back and verifies the rollback.

Deploy

Build on a development server, deploy to production. By exported package file, or through Vetra with Remote Deploy.

Extend

Props, NPCs, DarkRP job spawns and MalboroDEV PermaProps ship in 1.0. The Adapter SDK is public, so any addon can add its own.

Git for your server setup, up to a point

The analogy is useful and it has an edge. Blueprints gives you an immutable history, an object-by-object diff and a way to move a build between machines. It is not a distributed version control system: there is no merge, no branch and no rebase, and a Version is a full record of the managed world rather than a patch on the one before it. It is also authoritative only over the object types it has an adapter for. Everything else on your server is outside its authority, and it says so rather than guessing.

What Blueprints manages

The support matrix, per object type, per operation.

For developers

An adapter teaches Blueprints one domain. It lives in your own addon, it registers through one public hook, and it never touches Blueprints’ internals.

Adapter SDK

What an adapter is responsible for, and what Blueprints does with it.

Quickstart

A registered, capturable adapter in one file.

Worked example

The example adapter that ships with Blueprints, section by section.

API reference

Every public function, with its exact signature and realm.