Så använder du PolyDrobe.

Sätt upp en arbetsyta, modellera dina assets och varianter, bjud in teamet och åtgärda felen som dyker upp oftast.

Igång på fyra steg

Projekt, taxonomi, tillgångar, team. I den ordningen.

Skapa ett projekt

Skapa ditt första projekt och ange en tydlig project slug.

Konfigurera taxonomi

Konfigurera kategorier, rariteter, taggar, valutor, statusar och releaser.

Lägg till tillgångar och varianter

Lägg till assets och skapa varianter med bilder, priser och valfri metadata.

Bjud in ditt team

Bjud in teammedlemmar och tilldela rollerna Ägare, Redaktör eller Tittare.

Allt du kan göra

Öppna ett arbetsflöde för att se detaljerna.

ProjektuppsättningBörja med struktur innan innehåll.

Fyll i projektdetaljer och ikon.
Definiera återanvändbar taxonomi i Projektinställningar.

Asset- och varianthanteringAssets för objekt, varianter för versioner.

Lägg till asset-metadata och tilldela kategori/raritet.
Lägg till texturer, bilder och priser på varianter.

Granskning och sökHåll katalogen tydlig och lätt att underhålla.

Använd filtrering, status och taggar för att hitta jobbet du har framför dig.
Granska ändringar i aktivitetsloggen.

Import och exportByt data säkert med din pipeline.

Exportera projektdatan till JSON eller Excel, eller kryssa i Inkludera mediefiler för att få ett ZIP-paket med bilderna, texturerna och mesh-filerna.
Importera JSON, Excel eller ZIP-paket. Varje import börjar med en förhandsgranskning, så du ser ändringarna rad för rad och felen innan något genomförs.

Google Sheets-importImportera assets, varianter och projektinställningar från ett äkta Google-kalkylark.

Skapa ett äkta Google-kalkylark (inte en uppladdad .xlsx) med ett arbetsblad per entitetstyp: Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
Lägg in exakta kolumnrubriker på första raden i varje arbetsblad (versalkänsligt). Arbetsbladet Variants behöver till exempel: slug, name, asset_slug, rarity, release, currency, price, description, tags.
Entiteterna importeras i beroendeordning: Currencies, Rarities, Releases, Tags, Categories, Assets och sist Variants. Allt som en rad refererar till måste redan finnas i projektet eller komma tidigare i samma körning.
Öppna sidan Datautbyte i projektet (Import / Export i projektmenyn), välj Google-kalkylark som importkälla och anslut ditt Google-konto. PolyDrobe begär Googles omfång drive.file och kan därför bara läsa de filer du själv pekar ut.
Under Skapa en profil ger du profilen ett namn, klickar på Bläddra för att välja kalkylarket i Google Picker, justerar arbetsbladens namn om dina flikar heter något annat och klickar på Spara profil.
Kör Förhandsgranska på den sparade profilen först. Det är en testkörning som rapporterar valideringsfel utan att skriva något; Importera kör samma sak på riktigt.
För taggar på assets eller varianter använder du semikolonseparerade värden: starter;seasonal=winter;limited-edition.
Priser godtar både punkt och komma som decimaltecken (9.99 eller 9,99). Raritet matchas på namn, valuta på kod och release på versionssträng.

Utvecklarguider

Koppla dina verktyg, agenter och pipelines till PolyDrobe.

Konfigurera REST APIIntegrera med PolyDrobe via det vanliga REST API:et. Tillgängligt i Pro-planen.

1. Skapa en åtkomsttoken

Gå till Arbetsyteinställningar > API-tokens och skapa en ny personlig åtkomsttoken. Ge den ett beskrivande namn (t.ex. ”CI Pipeline” eller ”Lokalt skript”), välj omfången läsa och skriva och sätt ett utgångsdatum. Kopiera token när den visas, den visas bara en gång.

# Your token will look like this:
pdtk_a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5...

# Keep it safe. You cannot retrieve it later.
# If lost, revoke it and create a new one.

2. Autentisera anropen

Skicka med token som en Bearer-token i Authorization-huvudet i varje anrop.

curl -H "Authorization: Bearer pdtk_abc123..." \
     https://polydrobe.app/api/v1/projects/

3. Lista dina projekt

Returnerar alla projekt där du är medlem. Svaret använder standardformatet med nycklarna data och meta.

GET /api/v1/projects/

# Response:
{
  "data": [
    {
      "id": "...",
      "name": "Cyber Skins",
      "slug": "cyber-skins",
      "asset_count": 42,
      "my_role": "owner"
    }
  ],
  "meta": { "total": 1, "page": 1, "page_size": 25 }
}

4. Skapa en asset

Skapa en asset i ett projekt. Kräver rollen Redaktör eller Ägare. Slug genereras automatiskt från namnet.

curl -X POST \
  -H "Authorization: Bearer pdtk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Plasma Rifle", "description": "Sci-fi weapon", "category_slug": "weapons"}' \
  https://polydrobe.app/api/v1/projects/cyber-skins/assets/

5. Skapa en variant

Lägg till en variant på en asset med pris, raritet och status. Alla referenser till andra poster går via slugs.

curl -X POST \
  -H "Authorization: Bearer pdtk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Gold Edition", "rarity_slug": "legendary", "price": "29.99", "currency_code": "USD"}' \
  https://polydrobe.app/api/v1/projects/cyber-skins/assets/plasma-rifle/variants/

6. Sök bland assets

Fulltextsökning över assets och varianter med PostgreSQL-sökning. Stöder fraser, OR och negation.

GET /api/v1/projects/cyber-skins/search/?q=gold+legendary&type=variant&limit=10

7. Massåtgärder

Uppdatera eller ta bort flera varianter samtidigt. Kräver funktionen Massåtgärder, som ingår i Pro-planen.

curl -X POST \
  -H "Authorization: Bearer pdtk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"slugs": ["v1", "v2", "v3"], "updates": {"status_slug": "released"}}' \
  https://polydrobe.app/api/v1/projects/cyber-skins/bulk/variants/update/

Tillgängliga endpoints

REST API:et når varje projektresurs som PolyDrobe lagrar, från själva katalogen till media, massredigeringar, aktivitet och webhooks. Grupperna nedan är hela uppsättningen. Varje resurs har slug-baserade URL:er.

Projects:       GET|POST /v1/projects/
                GET|PATCH|DELETE /v1/projects/{slug}/

Assets:         GET|POST /v1/projects/{slug}/assets/
                GET|PATCH|DELETE /v1/projects/{slug}/assets/{slug}/

Variants:       GET|POST /v1/projects/{slug}/assets/{slug}/variants/
                GET|PATCH|DELETE .../assets/{slug}/variants/{slug}/
                GET /v1/projects/{slug}/variants/  (flat list)

Media:          GET .../variants/{slug}/images/
                PATCH|DELETE .../variants/{slug}/images/{uuid}/
                GET .../variants/{slug}/textures/
                DELETE .../variants/{slug}/textures/{uuid}/

Bundles:        GET|POST /v1/projects/{slug}/bundles/
                GET|PUT|PATCH|DELETE /v1/projects/{slug}/bundles/{slug}/
                GET|POST /v1/projects/{slug}/bundles/{slug}/items/
                DELETE .../bundles/{slug}/items/{variant_slug}/

Collections:    GET|POST /v1/projects/{slug}/collections/
                GET|PUT|PATCH|DELETE .../collections/{slug}/
                GET .../collections/{slug}/items/
                POST .../collections/{slug}/members/
                DELETE .../collections/{slug}/members/{variant_slug}/
                POST .../collections/{slug}/duplicate/

Classification: GET|POST /v1/projects/{slug}/{categories|tags|rarities|releases|currencies|statuses}/
                PATCH|DELETE /v1/projects/{slug}/{entity}/{slug}/

Favorites:      GET /v1/projects/{slug}/favorites/
                POST|PUT|DELETE /v1/projects/{slug}/favorites/{kind}/{uuid}/

Team:           GET|POST /v1/projects/{slug}/members/
                PATCH|DELETE /v1/projects/{slug}/members/{user_id}/

Bulk:           POST /v1/projects/{slug}/bulk/variants/update/
                POST /v1/projects/{slug}/bulk/variants/delete/

Search:         GET /v1/projects/{slug}/search/?q=term&type=all
Activity:       GET /v1/projects/{slug}/activity/
Export:         GET /v1/projects/{slug}/export/?format=json
Webhooks:       GET|POST /v1/projects/{slug}/webhooks/
                PATCH|DELETE /v1/projects/{slug}/webhooks/{uuid}/

Konfigurera MCP-servernKoppla AI-assistenter (Claude, ChatGPT) till PolyDrobe via Model Context Protocol. Tillgängligt i Pro-planen.

1. Skapa en personlig åtkomsttoken

Gå till Arbetsyteinställningar > API-tokens och skapa en ny token. Döp den efter din AI-klient (t.ex. ”Claude Desktop” eller ”Claude Code”). Välj omfången läsa och skriva och sätt ett långt utgångsdatum (1 år eller inget alls). Kopiera token när den visas, den visas bara en gång.

# Your token will look like this:
pdtk_a8f3b2c1d4e5f6a7b8c9d0e1f2a3b4c5...

# Use this token in the configuration steps below.
# The same token works for both REST API and MCP server.

2. Anslut Claude Desktop

Lägg till PolyDrobes MCP-server i konfigurationen för Claude Desktop. Öppna claude_desktop_config.json och lägg till den här posten.

{
  "mcpServers": {
    "polydrobe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://polydrobe.app/mcp"],
      "env": {
        "MCP_HEADERS": "Authorization: Bearer pdtk_abc123..."
      }
    }
  }
}

3. Anslut Claude Code

Lägg till MCP-servern från terminalen med Claude Code CLI.

claude mcp add polydrobe \
  --transport http \
  --url https://polydrobe.app/mcp \
  --header "Authorization: Bearer pdtk_abc123..."

4. Lokal utveckling (stdio-läge)

Vid lokal utveckling kör du MCP-servern direkt över stdio utan HTTP. Den autentiserar dig i förväg som den angivna användaren.

python manage.py mcp_stdio --user=your-username

# Claude Desktop config for local stdio:
{
  "mcpServers": {
    "polydrobe-local": {
      "command": "python",
      "args": ["manage.py", "mcp_stdio", "--user=your-username"],
      "cwd": "/path/to/polydrobe"
    }
  }
}

5. Prova

När anslutningen är klar ställer du frågor om dina projektdata till AI-assistenten på vanligt språk.

# Example prompts for your AI assistant:

"List all my projects"
"Show me the assets in project 'cyber-skins'"
"Create a new asset called 'Neon Jacket' in the 'outerwear' category"
"Search for legendary variants with price above 20"
"Set up categories: Headwear, Outerwear, Footwear, Accessories"
"Tag all sword assets with 'melee' and 'weapon'"
"Export the project data as JSON"
"Give me a project overview with sample thumbnails"

Tillgängliga MCP-verktyg

Varje läs-, skriv-, sök- och exportåtgärd i PolyDrobe finns som ett verktyg. AI-assistenten hittar hela uppsättningen vid anslutning, grupperad per kategori, utan att du konfigurerar något.

Projects:       list_projects, get_project, create_project,
                update_project, delete_project

Assets:         list_assets, get_asset, create_asset,
                update_asset, delete_asset

Variants:       list_variants, create_variant,
                update_variant, delete_variant

Bundles:        list_bundles, get_bundle, create_bundle,
                update_bundle, delete_bundle, list_bundle_items,
                add_bundle_item, remove_bundle_item,
                find_bundles_containing_variant

Collections:    collections_list, collections_get,
                collections_create, collections_update,
                collections_delete, collections_add_member,
                collections_remove_member, collections_duplicate

Classification: list_categories, create_category, update_category,
                delete_category, list_tags, create_tag, delete_tag,
                list_rarities, create_rarity, list_releases,
                create_release, list_currencies, create_currency,
                list_statuses, create_status

Tags:           add_asset_tags, remove_asset_tags,
                add_variant_tags, remove_variant_tags

Favorites:      list_favorites, add_favorite,
                remove_favorite, toggle_favorite

Team:           list_members, update_member_role, remove_member

Search:         search (full-text across assets & variants)
Activity:       get_activity_log

Images:         fetch_variant_thumbnail, fetch_variant_image,
                fetch_variant_texture, set_variant_thumbnail

Bulk:           bulk_create_variants, bulk_update_variants,
                bulk_delete_variants

Data:           export_project, import_project_data

OAuth 2.1 i produktion (avancerat)

För CI/CD-pipelines och integrationer mellan servrar kan du använda OAuth 2.1 med client credentials i stället för personliga tokens. Kontakta supporten för att sätta upp en OAuth-applikation.

# Exchange client credentials for an access token:
curl -X POST https://polydrobe.app/o/token/ \
  -d "grant_type=client_credentials" \
  -d "client_id=your-client-id" \
  -d "client_secret=your-client-secret" \
  -d "scope=read write"

# For most use cases, personal access tokens from
# Workspace Settings > API Tokens are simpler and sufficient.

Vem kan göra vad

Tre roller, dragna efter vad varje person behöver ändra. Tittare förblir gratis.

Ägare

Hantera projektinställningar, planbegränsningar och teamåtkomst.

Projektinställningar
Fakturering
Teamhantering
Skapa eller redigera tillgångar
Import och export
Skrivskyddad bläddring

Betald plats

Redaktör

Skapar och uppdaterar assets, varianter och operativ data.

Projektinställningar
Fakturering
Teamhantering
Skapa eller redigera tillgångar
Import och export
Skrivskyddad bläddring

Betald plats

Tittare

Läser projektdata för granskning, QA och intressentinsyn.

Projektinställningar
Fakturering
Teamhantering
Skapa eller redigera tillgångar
Import och export
Skrivskyddad bläddring

Gratis plats

Vanliga frågor

Vad är PolyDrobe?

PolyDrobe är en plattform för hantering av speltillgångar, där du dokumenterar, versionshanterar och samarbetar kring klädsel i spel: skins, kosmetika och accessoarer i ett helt spelprojekt. Du får en strukturerad och sökbar databas i stället för kalkylarken som de flesta team börjar med.

Vilka typer av assets hanterar PolyDrobe?

PolyDrobe är byggt för klädsel och kosmetiska föremål i spel: karaktärsskins, outfits, accessoarer, vapen och allt annat som finns i flera visuella varianter. Varje asset kan ha flera varianter för olika färgsättningar, kvalitetsnivåer eller säsongsversioner.

Har PolyDrobe förhandsgranskning av 3D-modeller?

Ja. PolyDrobe har en inbyggd 3D-modellvisare som renderar .glb- och .gltf-filer direkt i webbläsaren. Du kopplar mesh-filer till assets och texturfiler till varianter och förhandsgranskar dem utan att lämna appen.

Hur står sig PolyDrobe mot Google Sheets när du håller ordning på speltillgångar?

Google Sheets saknar strukturerade datatyper, versionshistorik, rollstyrning och mediahantering. PolyDrobe ger dig egna fält för raritet, status, pris, releaseversion och taggar, lagrar miniatyrbilder och 3D-modeller på posten och tillämpar rollbaserad åtkomst.

Hur skiljer sig PolyDrobe från Notion eller Airtable?

Notion och Airtable är generella databasverktyg, och schemat för speltillgångar bygger du själv. PolyDrobe levererar schemat färdigt: hierarkin med assets och varianter, 3D-modellvisare, texturhantering, pipeline-statusar, raritetsnivåer och releaseversionering.

Vilka spelmotorer fungerar PolyDrobe med?

PolyDrobe är motoroberoende. Det dokumenterar och samordnar katalogen medan din motor kör spelet, så team på Unity, Unreal Engine, Godot eller en egen motor använder det på samma sätt. Export till JSON och Excel samt MCP-servern tar datan vidare in i din pipeline.

Kan AI-agenter arbeta mot PolyDrobe?

Ja. PolyDrobe har en Model Context Protocol-server (MCP) på https://polydrobe.app/mcp. Varje läs-, skriv-, sök- och exportåtgärd finns som ett verktyg. AI-assistenter som Claude och ChatGPT ansluter med en Bearer-token och kan sedan lista projekt, hantera assets, varianter, paket och samlingar, konfigurera klassificeringar, sätta taggar, massuppdatera poster och söka i databasen på vanligt språk. Uppsättningen beskrivs i avsnittet Utvecklarguider.

Vad skiljer REST API:et från MCP-servern?

Båda når samma data genom samma tjänstelager. REST API:et använder vanliga HTTP-metoder (GET, POST, PATCH, DELETE) med JSON-envelopes, vilket passar skript, CI/CD-pipelines och egna integrationer. MCP-servern talar Model Context Protocol, så AI-assistenter som Claude och ChatGPT kan arbeta med dina data på vanligt språk. Båda kräver Pro-planen och OAuth2-autentisering.

Hur skaffar jag en API-token?

Gå till Arbetsyteinställningar > API-tokens och klicka på Skapa token. Ge den ett namn, välj omfång (läsa, skriva) och sätt ett utgångsdatum. Kopiera token när den visas, den visas bara en gång. Samma token fungerar för både REST API:et och MCP-servern, och båda kräver Pro-planen.

Stöder PolyDrobe samarbete i team?

Ja. Ett projekt kan ha flera teammedlemmar med tre roller: Ägare (full kontroll, inklusive inställningar och fakturering), Redaktör (skapar och uppdaterar assets och varianter) och Tittare (läsbehörighet för QA eller intressentgranskning). Bjud in kollegor via e-post från Projektinställningar.

Ska varje skin modelleras som asset eller variant?

Använd en asset för grundobjektet och varianter för varje skin/version.

Hur håller jag namngivning konsekvent?

Använd tydliga namngivningsregler och slug-baserade URL:er.

Kan jag dela projektdata externt?

Ja, på planer som inkluderar Datautbyte. Använd sidan Datautbyte för att exportera hela projektet till JSON eller Excel, eller till ett ZIP-paket som även bär med sig mediefilerna, och dela det med efterföljande verktyg, utgivare eller externa konsulter.

Vad ingår i Free-planen?

Free-planen innehåller 1 ägt projekt, upp till 3 medlemmar, 1 GB arbetsyte-lagring, obegränsade assets, 100 varianter per projekt och 30 dagars aktivitetshistorik.

Räknas tittarplatser som debiterbara?

Nej. Endast rollerna Ägare och Redaktör räknas som debiterbara platser. Tittare förblir gratis.

Är PolyDrobe en SaaS-produkt?

Ja. PolyDrobe är en webbaserad SaaS-applikation som körs på polydrobe.app. Det finns ingen programvara att installera. Registrera dig, skapa ett projekt och börja lägga till assets direkt.

Kan jag importera befintlig assetdata till PolyDrobe?

Ja. PolyDrobe importerar JSON, Excel (.xlsx), ZIP-paket som bär med sig media vid sidan av datafilen, och Google Sheets. Exportera ditt befintliga kalkylark i det förväntade formatet och importera det från sidan Datautbyte. Varje import förhandsgranskas först: du ser hur många rader som skapas, uppdateras och ger fel innan ändringarna genomförs.

Vilka kolumner behöver mallen för Google Sheets-import?

Varje arbetsblad har sina egna kolumner. Categories behöver: slug, name, description, parent_slug. Tags behöver: slug, name, value. Rarities behöver: name, color (hex som #RRGGBB), priority. Currencies behöver: code, name, symbol. Releases behöver: version, name, description, release_date (YYYY-MM-DD). Assets behöver: slug, name, description, category_slug, tags. Variants behöver: slug, name, asset_slug, rarity, release, currency, price, description, tags. Kolumnrubrikerna är versalkänsliga och måste stå på första raden. Google Sheets-synkroniseringen täcker de här sju entitetstyperna; paket och samlingar importerar du i stället via Excel- eller JSON-uppladdning.

Varför säger min Google Sheets-import ”Kalkylarkets metadata kunde inte läsas in”?

Filen är förmodligen en uppladdad .xlsx som öppnats i Google Sheets, inte ett äkta Google-kalkylark. En URL som innehåller ”rtpof=true” avslöjar en uppladdad fil. Öppna filen i Google Sheets, välj File > Save as Google Sheets, klicka sedan på Bläddra i din synkprofil och välj den konverterade filen. Kontrollera också att det anslutna Google-kontot kan öppna kalkylarket.

Måste jag ansluta Google separat för varje projekt?

Ja. Varje projekt behöver sin egen Google-anslutning för att projekten ska hållas isolerade från varandra. Olika projekt kan ha olika ägare och olika åtkomstregler. Samma Google-konto kan användas i alla projekt.

Vanliga problem

Snabba lösningar för de vanligaste problemen.

Saknade behörigheter

Om en åtgärd saknas, kontrollera din roll och be en Ägare uppdatera åtkomsten.

Importvalideringsfel

Kontrollera obligatoriska fält, category slugs och enum-värden före nytt försök.

Problem med mediauppladdning

Verifiera filtyp, filstorlek och lagringsanvändning mot planens gränser.

Google Sheets: ”Kalkylarkets metadata kunde inte läsas in”

Filen är förmodligen en uppladdad .xlsx snarare än ett äkta Google-kalkylark. Öppna den, välj File > Save as Google Sheets, klicka sedan på Bläddra i din synkprofil och välj den konverterade filen. Kontrollera också att det anslutna Google-kontot kan öppna kalkylarket.

Google Sheets: assets eller varianter faller på ”Tag not found” eller ”Category not found”

Refererade poster måste finnas innan något kan peka på dem. Importen går igenom arbetsbladen i ordning (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), så en kategori som inte importerades drar med sig sina assets. Läs förhandsgranskningen av testkörningen uppifrån och åtgärda den tidigaste posttypen först.

Google Sheets: variantens pris visar ”invalid price”

Importen godtar både punkt (9.99) och komma (9,99) som decimaltecken. Om felet kvarstår, leta efter lösa tecken, valutasymboler eller blanksteg i priscellen.

Fråga oss direkt.

Mejla oss, så svarar en människa.

Kontakta oss