Basic Game Setup

Set up Network Storage in your s&box game from scratch. Install the library, create a project, configure collections, and implement basic data operations.

YAML Source is the Network Storage authoring standard.
Use the s&box Library Manager install for auto-updates. GitHub is best for agents, source review, contributions, and manual installs.
1

Install Network Storage Library

The Network Storage library handles API calls, authentication, response parsing, and error handling. It also includes a Setup panel and Sync Tool for managing your project without writing any configuration code.

## Open the Library Manager

In the s&box editor, go to **Editor > Library Manager** (or press the Library button in the toolbar).

## Find Network Storage

Search for **Network Storage** in the library search bar, or go directly to:

**[sbox.game/sboxcool/network-storage](https://sbox.game/sboxcool/network-storage)**

Source: [github.com/sbox-cool/sbox-network-storage](https://github.com/sbox-cool/sbox-network-storage)

## Install It

Click **Add to Project** to install the library into your current s&box project. This gives you:

- **`NetworkStorage`** -- the API client class (auto-configures, no setup code needed)
- **Setup** -- enter your credentials in a UI panel
- **Sync Tool** -- push and pull collections, endpoints, and game values

## Restart the Editor

After installing, **close and restart the s&box editor**. The library registers a new top-level **Network Storage** menu in the editor menu bar (next to **Help**). You will not see this menu until you restart.

Once restarted, you should see the **Network Storage** menu with two options:

- **Network Storage > Setup** -- configure your project credentials
- **Network Storage > Sync Tool** -- push/pull data to the server

![Setup Window](https://cdn.sboxcool.com/uploads/wiki/setup-window.webp)

This is the Setup panel where you will enter your API keys in the next step.
Tips & Troubleshooting

> **Tip:** The library updates automatically when new versions are published. You do not need to manually update it. If the **Network Storage** menu does not appear after restarting, try reopening the project.