Ako používať PolyDrobe.

Nastavte pracovný priestor, namodelujte svoje assety a varianty, pozvite tím a opravte chyby, ktoré sa objavujú najčastejšie.

V prevádzke v štyroch krokoch

Projekt, taxonómia, assety, tím. V tomto poradí.

1

Vytvoriť projekt

Vytvorte prvý projekt a nastavte jasný slug projektu.

2

Nakonfigurovať taxonómiu

Nastavte základné položky: kategórie, rarity, značky, meny, stavy a vydania.

3

Pridať assety a varianty

Pridajte assety a potom varianty s obrázkami, cenami a voliteľnými metadátami.

4

Pozvite svoj tím

Pozvite členov tímu a priraďte roly Vlastník, Editor alebo Divák podľa zodpovednosti.

Všetko, čo môžete robiť

Otvorte pracovný postup a zobrazte podrobnosti.

Nastavenie projektuNajprv štruktúra, potom obsah.
  • Vyplňte detaily projektu a ikonu.
  • V Nastaveniach projektu definujte znovupoužiteľnú taxonómiu.
Správa assetov a variantovAsset používajte pre položku, variant pre jej verziu.
  • Doplňte metadata assetu a priraďte kategóriu/raritu.
  • K variantom pridajte textúry, obrázky a ceny.
Kontrola a vyhľadávanieUdržujte katalóg prehľadný a ľahko udržiavateľný.
  • Použite filtre, stav a značky, aby ste našli prácu, ktorá je pred vami.
  • Kontrolujte zmeny v denníku aktivít.
Import a exportBezpečne vymieňajte dáta s vaším pipeline.
  • Exportujte projektové dáta do JSON alebo Excelu, prípadne zaškrtnite Zahrnúť mediálne súbory a dostanete ZIP balík s obrázkami, textúrami a mesh súbormi.
  • Importujte JSON, Excel alebo ZIP balíky. Každý import najprv spustí náhľad, takže si zmeny po riadkoch aj chyby pozriete skôr, než sa čokoľvek zapíše.
Import z Google SheetsImportujte assety, varianty a nastavenia projektu z natívnej tabuľky Google.
  • Vytvorte natívnu tabuľku Google (nie nahraný súbor .xlsx) s jedným hárkom pre každý typ entity: Currencies, Rarities, Releases, Tags, Categories, Assets, Variants.
  • Do prvého riadka každého hárka pridajte presné názvy stĺpcov (záleží na veľkosti písmen). Hárok Variants napríklad potrebuje: slug, name, asset_slug, rarity, release, currency, price, description, tags.
  • Entity sa importujú v poradí závislostí: Currencies, Rarities, Releases, Tags, Categories, Assets a nakoniec Variants. Všetko, na čo sa riadok odkazuje, už musí v projekte existovať alebo sa musí objaviť skôr v tom istom behu.
  • V projekte otvorte stránku Výmena údajov (Import / Export v menu projektu), ako zdroj importu zvoľte Google tabuľka a pripojte svoj účet Google. PolyDrobe si od Googlu pýta rozsah drive.file, takže vie čítať iba súbory, ktoré mu sami odovzdáte.
  • V časti Vytvoriť profil zadajte názov profilu, kliknite na Prehľadávať a v Google Pickeri vyberte svoju tabuľku, upravte názvy hárkov, ak sa vaše záložky volajú inak, a kliknite na Uložiť profil.
  • Na uloženom profile najprv spustite Náhľad. Je to skúšobné spustenie, ktoré nahlási chyby validácie a nič nezapíše; Importovať potom ten istý beh vykoná naostro.
  • Značky na assetoch alebo variantoch zadávajte oddelené bodkočiarkou: starter;seasonal=winter;limited-edition.
  • Ceny prijímajú desatinnú bodku aj čiarku (9.99 alebo 9,99). Rarita sa páruje podľa názvu, mena podľa kódu a vydanie podľa reťazca verzie.

Príručky pre vývojárov

Prepojte svoje nástroje, agentov a pipeline s PolyDrobe.

Nastavenie REST APIIntegrujte sa s PolyDrobe cez štandardné REST API. Dostupné v pláne Pro.

1. Vygenerujte prístupový token

Prejdite do Nastavenia pracovného priestoru > API tokeny a vytvorte nový osobný prístupový token. Pomenujte ho výstižne (napr. „CI Pipeline“ alebo „Local Script“), vyberte oprávnenia na čítanie a zápis a zvoľte platnosť. Token si skopírujte hneď, ako sa zobrazí, pretože sa ukáže iba raz.

# 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. Autentifikujte požiadavky

Token posielajte v každej požiadavke ako Bearer token v hlavičke Authorization.

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

3. Vypíšte svoje projekty

Vráti všetky projekty, v ktorých ste členom. Odpoveď používa štandardný formát obálky s kľúčmi data a 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. Vytvorte asset

Vytvorí asset v projekte. Vyžaduje rolu Editor alebo Vlastník. Slug sa vygeneruje z názvu.

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. Vytvorte variant

Pridajte k assetu variant s cenou, raritou a stavom. Všetky odkazy na cudzie kľúče používajú slugy.

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. Vyhľadávajte assety

Fulltextové vyhľadávanie naprieč assetmi a variantmi cez PostgreSQL. Podporuje frázy, OR aj negáciu.

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

7. Hromadné operácie

Aktualizujte alebo zmažte viac variantov naraz. Vyžaduje funkciu Hromadné operácie v pláne Pro.

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/

Dostupné endpointy

REST API siaha na každý projektový zdroj, ktorý PolyDrobe ukladá, od samotného katalógu cez médiá až po hromadné úpravy, aktivitu a webhooky. Skupiny nižšie tvoria kompletnú sadu. Každý zdroj používa URL založené na slugoch.

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}/
Nastavenie MCP serveraPripojte k PolyDrobe AI asistentov (Claude, ChatGPT) cez Model Context Protocol. Dostupné v pláne Pro.

1. Vygenerujte osobný prístupový token

Prejdite do Nastavenia pracovného priestoru > API tokeny a vytvorte nový token. Pomenujte ho podľa svojho AI klienta (napr. „Claude Desktop“ alebo „Claude Code“). Vyberte oprávnenia na čítanie a zápis a zvoľte dlhú platnosť (1 rok alebo bez expirácie). Token si skopírujte hneď, ako sa zobrazí, pretože sa ukáže iba raz.

# 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. Pripojte Claude Desktop

Pridajte MCP server PolyDrobe do konfigurácie Claude Desktop. Otvorte súbor claude_desktop_config.json a doplňte tento záznam.

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

3. Pripojte Claude Code

Pridajte MCP server z terminálu pomocou CLI nástroja Claude Code.

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

4. Lokálny vývoj (režim stdio)

Pri lokálnom vývoji spustite MCP server priamo cez stdio, bez HTTP. Server vás vopred prihlási ako zadaného používateľa.

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. Vyskúšajte to

Po pripojení sa svojho AI asistenta pýtajte na dáta projektu bežným jazykom.

# 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"

Dostupné MCP nástroje

Každá operácia čítania, zápisu, vyhľadávania a exportu v PolyDrobe je dostupná ako nástroj. AI asistent objaví celú sadu pri pripojení, rozdelenú do kategórií a bez akéhokoľvek nastavovania.

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 pre produkciu (pokročilé)

Pre CI/CD pipeline a integrácie medzi servermi môžete namiesto osobných tokenov použiť OAuth 2.1 flow s client credentials. O nastavenie OAuth aplikácie požiadajte podporu.

# 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.

Kto čo môže robiť

Tri role vymedzené podľa toho, čo kto potrebuje meniť. Diváci zostávajú zadarmo.

Vlastník

Spravuje nastavenia projektu, limity plánu a prístup tímu.

  • Nastavenia projektu
  • Fakturácia
  • Správa tímu
  • Vytvoriť alebo upraviť assety
  • Import a export
  • Prehliadanie iba na čítanie
Platené miesto

Editor

Vytvára a upravuje assety, varianty a prevádzkové dáta.

  • Nastavenia projektu
  • Fakturácia
  • Správa tímu
  • Vytvoriť alebo upraviť assety
  • Import a export
  • Prehliadanie iba na čítanie
Platené miesto

Divák

Číta projektové dáta pre review, QA alebo stakeholderov.

  • Nastavenia projektu
  • Fakturácia
  • Správa tímu
  • Vytvoriť alebo upraviť assety
  • Import a export
  • Prehliadanie iba na čítanie
Bezplatné miesto

Často kladené otázky

Čo je PolyDrobe?
PolyDrobe je platforma na správu herných assetov: dokumentujete v nej odevné assety, teda skiny, kozmetiku a doplnky naprieč herným projektom, verzujete ich a spolupracujete na nich. Namiesto tabuliek, s ktorými väčšina tímov začína, dostanete štruktúrovanú databázu s vyhľadávaním.
Aké typy assetov PolyDrobe spravuje?
PolyDrobe je navrhnutý pre herné odevy a kozmetické predmety: skiny postáv, outfity, doplnky, zbrane a akýkoľvek predmet s viacerými vizuálnymi variantmi. Každý asset môže mať viac variantov, ktoré predstavujú rôzne farebné prevedenia, úrovne kvality alebo sezónne verzie.
Podporuje PolyDrobe náhľad 3D modelov?
Áno. PolyDrobe má vstavaný prehliadač 3D modelov, ktorý vykresľuje súbory .glb a .gltf priamo v prehliadači. K assetom pripojíte mesh súbory, k variantom textúry a obidve si pozriete bez toho, aby ste opustili aplikáciu.
Ako si PolyDrobe stojí oproti Google Sheets pri sledovaní herných assetov?
Google Sheets nemá štruktúrované dátové typy, sledovanie verzií, riadenie rolí ani prácu s médiami. PolyDrobe vám dáva samostatné polia pre raritu, stav, cenu, verziu vydania a značky, ukladá miniatúry a 3D modely priamo k záznamu a vynucuje prístup podľa rolí.
Čím sa PolyDrobe líši od Notion alebo Airtable?
Notion a Airtable sú všeobecné databázové nástroje a schému pre herné assety si v nich postavíte sami. PolyDrobe túto schému prináša hotovú: hierarchiu asset a variant, prehliadač 3D modelov, správu textúr, stavy pipeline, úrovne rarity a verzovanie vydaní.
S akými hernými enginmi je PolyDrobe kompatibilný?
PolyDrobe je nezávislý od enginu. Dokumentuje a koordinuje katalóg, kým hru poháňa váš engine, takže tímy na Unity, Unreal Engine, Godot aj na vlastnom engine ho používajú rovnako. Export do JSON a Excelu spolu s MCP serverom prenesú dáta do vášho pipeline.
Môžu s PolyDrobe pracovať AI agenti?
Áno. PolyDrobe má server Model Context Protocol (MCP) na adrese https://polydrobe.app/mcp. Každá operácia čítania, zápisu, vyhľadávania a exportu je dostupná ako nástroj. AI asistenti ako Claude a ChatGPT sa pripoja pomocou Bearer tokenu a potom vypíšu projekty, spravujú assety, varianty, balíčky a kolekcie, nastavujú klasifikácie, priraďujú značky, hromadne upravujú záznamy a prehľadávajú databázu bežným jazykom. Postup nastavenia nájdete v sekcii Príručky pre vývojárov.
Aký je rozdiel medzi REST API a MCP serverom?
Obidva siahajú na tie isté dáta cez rovnakú servisnú vrstvu. REST API používa štandardné HTTP metódy (GET, POST, PATCH, DELETE) s JSON obálkami, čo sa hodí pre skripty, CI/CD pipeline a vlastné integrácie. MCP server hovorí protokolom Model Context Protocol, takže AI asistenti ako Claude a ChatGPT vedia s vašimi dátami pracovať bežným jazykom. Obidva vyžadujú plán Pro a autentifikáciu cez OAuth2.
Ako získam prístupový token k API?
Prejdite do Nastavenia pracovného priestoru > API tokeny a kliknite na Vytvoriť token. Pomenujte ho, vyberte oprávnenia (čítanie, zápis) a zvoľte platnosť. Token si skopírujte hneď, ako sa zobrazí, pretože sa ukáže iba raz. Ten istý token funguje pre REST API aj MCP server a obidva vyžadujú plán Pro.
Podporuje PolyDrobe tímovú spoluprácu?
Áno. Projekty zvládnu viacerých členov tímu s tromi rolami: Vlastník (plná kontrola vrátane nastavení a fakturácie), Editor (vytvára a upravuje assety a varianty) a Divák (prístup len na čítanie pre QA alebo review od stakeholderov). Kolegov pozvete e-mailom v Nastaveniach projektu.
Mám každý skin modelovať ako asset alebo variant?
Použite jeden asset pre základnú položku a varianty pre každý skin/verziu.
Ako udržať konzistentné názvy?
Používajte jasné naming pravidlá a slug URL pre stabilné referencie.
Dajú sa projektové dáta zdieľať externe?
Áno, na plánoch, ktoré zahŕňajú Výmenu údajov. Na stránke Výmena údajov vyexportujete celý projekt do JSON alebo Excelu, prípadne do ZIP balíka, ktorý nesie aj mediálne súbory, a zdieľate ho s nadväznými nástrojmi, vydavateľmi alebo externými dodávateľmi.
Čo obsahuje plán Free?
Plán Free obsahuje 1 vlastnený projekt, až 3 členov, 1 GB úložiska pre pracovný priestor, neobmedzené assety, 100 variantov na projekt a 30 dní denníka aktivít.
Počítajú sa roly Divák do účtovaných miest?
Nie. Účtované miesta počítajú iba roly Vlastník a Editor. Diváci zostávajú zadarmo.
Je PolyDrobe SaaS produkt?
Áno. PolyDrobe je webová SaaS aplikácia bežiaca na polydrobe.app. Nič sa neinštaluje. Zaregistrujete sa, vytvoríte projekt a hneď začnete pridávať assety.
Môžem do PolyDrobe naimportovať existujúce dáta o assetoch?
Áno. PolyDrobe importuje JSON, Excel (.xlsx), ZIP balíky, ktoré popri dátovom súbore nesú aj médiá, a Google Sheets. Existujúcu tabuľku vyexportujte v očakávanom formáte a naimportujte ju na stránke Výmena údajov. Každý import má najprv náhľad: ešte pred zapísaním zmien vidíte počty vytvorení, aktualizácií a chýb po riadkoch.
Aké stĺpce potrebuje šablóna pre import z Google Sheets?
Každý hárok používa vlastné stĺpce. Categories potrebuje: slug, name, description, parent_slug. Tags potrebuje: slug, name, value. Rarities potrebuje: name, color (hex #RRGGBB), priority. Currencies potrebuje: code, name, symbol. Releases potrebuje: version, name, description, release_date (YYYY-MM-DD). Assets potrebuje: slug, name, description, category_slug, tags. Variants potrebuje: slug, name, asset_slug, rarity, release, currency, price, description, tags. Na veľkosti písmen v názvoch stĺpcov záleží a musia byť v prvom riadku. Synchronizácia s Google Sheets pokrýva týchto sedem typov entít; balíčky a kolekcie naimportujete nahraním Excelu alebo JSON.
Prečo import z Google Sheets hlási 'Metadáta tabuľky sa nepodarilo načítať'?
Súbor je pravdepodobne nahraný .xlsx otvorený v Google Sheets, nie natívna tabuľka Google. Nahraný súbor prezradí URL s parametrom 'rtpof=true'. Opravíte to tak, že súbor otvoríte v Google Sheets, zvolíte File > Save as Google Sheets a potom vo svojom profile synchronizácie kliknete na Prehľadávať a vyberiete prevedený súbor. Skontrolujte aj to, či pripojený účet Google vie tabuľku otvoriť.
Musím pripájať Google zvlášť pre každý projekt?
Áno. Každý projekt vyžaduje vlastné pripojenie ku Google kvôli izolácii medzi tenantmi. Rôzne projekty môžu mať rôznych vlastníkov a iné riadenie prístupu. Ten istý účet Google môžete použiť vo všetkých projektoch.

Bežné problémy

Rýchle riešenia najčastejších problémov.

Chýbajúce oprávnenia

Ak akcia nie je dostupná, skontrolujte rolu v projekte a požiadajte vlastníka o úpravu prístupu.

Chyby validácie pri importe

Pred opakovaním importu overte povinné polia, slugy kategórií a hodnoty enumov.

Problémy s nahrávaním médií

Skontrolujte typ súboru, veľkosť a využitie úložiska voči limitom plánu.

Google Sheets: 'Metadáta tabuľky sa nepodarilo načítať'

Súbor je pravdepodobne nahraný .xlsx, nie natívna tabuľka Google. Otvorte ho, zvoľte File > Save as Google Sheets a potom vo svojom profile synchronizácie kliknite na Prehľadávať a vyberte prevedený súbor. Skontrolujte aj to, či pripojený účet Google vie tabuľku otvoriť.

Google Sheets: assety alebo varianty zlyhajú s chybou 'Tag not found' alebo 'Category not found'

Odkazované entity musia existovať skôr, než na ne môže čokoľvek ukazovať. Importér prechádza hárky v poradí (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), takže kategória, ktorú sa nepodarilo naimportovať, stiahne so sebou aj svoje assety. Prečítajte si náhľad skúšobného behu zhora a opravte najprv najskorší typ entity.

Google Sheets: cena variantu hlási 'invalid price'

Import prijíma desatinný oddeľovač bodku (9.99) aj čiarku (9,99). Ak chyba pretrváva, hľadajte v bunke s cenou nadbytočné znaky, symboly meny alebo medzery.

Opýtajte sa nás priamo.

Napíšte nám e-mail a odpovie vám človek.

Kontaktujte nás