Skip to content

Quartermaster v1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 27 Aug 11:58
· 9 commits to main since this release
v1.0.0
0e717e1

You search your library for a "dam" and get 0 results — even though you own concrete barriers, industrial floodgates, and river water shaders.

Store listings are full of generic marketing copy, packages are opaque archives, and finding what you already own takes longer than building from scratch.

Quartermaster Demo

Quartermaster indexes your Unity Asset Store and Fab entitlements alongside local .unitypackage archives and Epic's VaultCache into a local-first vault. It fuses keyword matching with offline text and visual neural embeddings, lints dependencies for pipeline conflicts, and exposes a native MCP interface so AI coding agents understand your actual asset library.

⚡ What’s in 1.0.0

🔍 3-Way Hybrid Search (FTS5 + BGE Text + CLIP Vision)

  • Keyword Match: BM25 token retrieval across titles, publishers, and descriptions.
  • Text Semantic Search: Offline BGE bi-encoder running on CPU to match natural language intent ("concrete structures for holding back water" → bridges, retaining walls, water packs).
  • Cross-Modal CLIP Visual Search: Encodes gallery screenshots into CLIP ViT vectors to match visual aesthetics and rendering styles directly.
  • LRU Cached Embeddings: Memoized query vectors cut warm end-to-end search latency from ~110 ms down to ~54 ms (~2× speedup).

🧠 Stack Intelligence & Dependency Linter

  • Exclusivity Audits: Flags conflicting systems before import (e.g., competing terrain mesh blending shaders, duplicate sky/weather controllers, or conflicting vegetation renderers).
  • Product-Family Grouping: Recognizes modular add-on ecosystems (MicroVerse, MicroSplat, Enviro, Gaia) so companion packs group cleanly rather than triggering false-positive conflict warnings.
  • Prerequisite Tracking: Warns if an asset requires an uninstalled parent framework.

🤖 Complete Model Context Protocol (MCP) Suite

Exposes 9 tools to local AI agents (Claude Desktop, Cursor, Windsurf, Antigravity):

Tool Purpose
search_owned_assets 3-way hybrid search across owned vault assets with engine and pipeline filters.
get_asset_details Full listing metadata, package version, publisher links, and local on-disk paths.
list_asset_categories Returns the 13 normalized library categories with asset counts.
audit_project Inspects target Unity project manifests to detect active Render Pipeline (HDRP/URP/Built-in) and installed packages.
validate_stack Lints a list of candidate asset IDs for exclusivity conflicts and missing prerequisites.
get_stack_recommendations Maps a natural-language scene brief ("foggy pine valley with river") to compatible owned packs.
list_stack_recipes Curated production stacks from data/recipes.json, resolved against the assets you actually own.
import_asset_to_project Extracts .unitypackage archives directly into project folders with path-traversal sandboxing.
get_vault_stats Totals by engine and category, plus counts of downloaded local assets vs cloud-only entitlements.

🖥️ Native Multi-Surface Interfaces

  • Desktop GUI (Quartermaster): Responsive dark-mode desktop app with non-blocking async search threads, instant debounced queries, and global tray hotkey (Win+Alt+V on Windows).
  • Console MCP Binary (Quartermaster-mcp): Dedicated stdio JSON-RPC binary with clean stderr stream handling. Run --register for instant one-command client discovery.
  • Unity Editor Bridge (Quartermaster-Bridge.unitypackage): Search, browse, and import directly inside the Unity Editor.
  • Localhost Web Dashboard (http://localhost:7890): Fast web UI hardened with SameSite cookies, CSRF defense, and subresource origin verification.

📦 Release Assets

Asset Platform Description
Quartermaster-windows-x64.zip Windows x64 Standalone Windows distribution with Quartermaster.exe and Quartermaster-mcp.exe. Zero Python environment required.
Quartermaster-linux-x64.tar.gz Linux x64 Standalone Linux distribution with Quartermaster and Quartermaster-mcp. Zero Python environment required.
Quartermaster-Bridge.unitypackage Cross-Platform Unity Editor window bridge for in-engine asset browsing and direct importing.

🚀 Quick Start (Standalone Binary)

Windows

  1. Extract Quartermaster-windows-x64.zip.
  2. Register the MCP server: .\Quartermaster-mcp.exe --register
  3. Launch Quartermaster.exe.

Linux

  1. Extract Quartermaster-linux-x64.tar.gz: 
    tar -xzvf Quartermaster-linux-x64.tar.gz
cd Quartermaster
  2. Register the MCP server: ./Quartermaster-mcp --register
  3. Launch ./Quartermaster.

🔒 Security & Local Data Model

  • Local Data Storage: Database, auth tokens, logs, browser profiles, and image cache live in %LOCALAPPDATA%\Quartermaster (Windows) or ~/.local/share/quartermaster (Linux).
  • Neural Model Weights: ONNX models are cached in standard user directories (~/.cache).
  • Interactive Store Auth: Store logins execute in a standard browser window with your own MFA — zero automated credential scraping.
  • Extraction Sandbox: import_asset_to_project enforces strict path traversal protection (../ stripping, absolute path normalization, control character rejection).
Assets 6
Loading