Connecter Browser

Library
tristan updated 4mo ago 0 MB engine 25
Connecter Browser
Connecter Browser for s&box

Editor-only s&box library for browsing a local Connecter workspace and importing assets into the active project on demand.

What It Does

- Adds `View > Connecter Browser` to the s&box editor.
- Auto-discovers a Connecter workspace from saved settings and common local locations.
- Lets you manually set the Connecter workspace path in the dock.
- Does not bake in a single Connecter path; the saved workspace path can be changed or cleared any time.
- Reads Connecter repository roots from `<workspace>/default.dcdb`.
- Falls back to `<workspace>/settings.xml` if the database does not expose roots.
- Provides two browsing modes:
  - `Files`: folder-first navigation through Connecter roots.
  - `Assets`: flat recursive grid of importable assets across all Connecter roots.
- Imports into the active project under `Assets/ConnecterImports/<ConnecterRootName>/...`.
- Keeps source assets untouched.

 Setup

1. Put this library in your s&box libraries/addons location or reference it from a project.
2. Open s&box.
3. Open the dock from:

   Editor > View > Connecter Browser

4. If the workspace is not found automatically, paste the Connecter workspace folder into the `Workspace` field and press the checkmark button.

The browser remembers the chosen workspace path in `%LOCALAPPDATA%/sbox/ConnecterBrowser/workspace.txt`. The workspace should be the folder containing `default.dcdb` or `settings.xml`, not one of the asset repository folders. Use the auto-detect button to clear the manual value and scan common locations again.

Files Mode

`Files` mode is for browsing the actual Connecter folder structure.

- The left tree shows Connecter repository roots and folders.
- The right list/grid shows the current folder.
- Search recursively scans the selected folder.
- Folders can be imported recursively after confirmation.

Assets Mode

`Assets` mode behaves more like a content browser.

- It hides the folder tree.
- It recursively scans all Connecter repositories.
- It shows a flat grid of matching assets.
- Images show source thumbnails before import.
- Models, materials, audio, and unsupported files show type tiles.
- Dragging an item imports it first, then starts a normal s&box asset drag.

Use the filter menu to show:

- `All`
- `Models`
- `Materials`
- `Images`
- `Audio`
- `Sbox`
- `Unsupported`

## Import Behavior

Single-file imports copy the selected file into the active project. For model sources, the importer also copies likely same-folder dependencies such as `.mtl` files and texture siblings.

Supported model source files:

- `.fbx`
- `.obj`
- `.vox`

These are copied and wrapped in a generated `.vmdl` using a `RenderMeshFile` node plus `AnimBindPose`. The generated `.vmdl` becomes the primary asset for drag/drop.

Images, audio, `.vmat`, and existing `.vmdl` files are copied and registered with `AssetSystem.RegisterFile`.

Unsupported files such as `.blend`, `.glb`, and `.gltf` stay visible in the browser, but v1 does not attempt conversion. Export those to `.fbx`, `.obj`, or `.vox` first.

Safety

- Source files are never moved, deleted, or modified.
- Imports are constrained to the current project's `Assets/ConnecterImports` folder.
- Folder imports show a file-count and size confirmation first.
- The Connecter database is read-only.

Current Limitations

- Connecter tags, descriptions, custom previews, and metadata are not used yet.
- Pre-import model/material thumbnails are type tiles, not rendered previews.
- Blender and glTF conversion is not implemented.
- Auto-discovery checks common local locations, but unusual setups may still need the workspace path set manually.
1
Total Users
3
Total Sessions
7 min
Total Playtime
0 recorded entries
Rank Player Score Recorded
refresh
Discovering package leaderboards...
Package ID: tristan.connectorintegration
Created: 2026-05-09 16:53 UTC
Updated: 2026-05-09 16:56 UTC
Type: library
Public: Yes
Version: 234835
files: 26
Size: 0.1 MB
Engine Version: 25
Asset Version ID: 234835
Version Created: 2026-05-09 16:56 UTC
Hash: -843449615142380944
Manifest: Open manifest

more_horiz Additional Properties

Description: Editor-only Connecter browser for s&box. Browse indexed local Connecter folders, view a flat asset grid, and import selected assets into the active project on demand.
Project Template: {"Icon":"perm_media","Order":50,"Description":"Browse and import local Connecter asset libraries from inside the s&box editor."}
new_releases Latest Update May 9, 2026
Changes on 2026-05-09
234835 May 9, 2026
Changes on 2026-05-09
info Live API Passthrough & Removal Notice

This file manifest and asset metadata are retrieved live directly from the official Facepunch s&box public API. s&box Explorer does not host, store, or redistribute any package files. All download links route directly to Facepunch CDN servers.