PolyDroben käyttöohjeet.
Perusta työtila, mallinna varasi ja muunnelmasi, kutsu tiimi mukaan ja korjaa useimmin toistuvat virheet.
Käyttövalmis neljässä vaiheessa
Projekti, taksonomia, varat, tiimi. Tässä järjestyksessä.
Luo projekti
Luo ensimmäinen projekti ja määritä selkeä projektin slug.
Määritä taksonomia
Määritä kategoriat, harvinaisuudet, tunnisteet, valuutat, tilat ja julkaisut.
Lisää assetteja ja variantteja
Lisää varat ja luo muunnelmat kuvilla, hinnoilla ja valinnaisella metadatalla.
Kutsu tiimisi
Kutsu tiimikaverit ja anna Omistaja-, Toimittaja- tai Katsoja-roolit.
Kaikki mitä voit tehdä
Avaa työnkulku nähdäksesi tiedot.
Projektin käyttöönottoRakenne ensin, sisältö sen jälkeen.
- Täytä projektin tiedot ja ikoni.
- Määritä uudelleenkäytettävä taksonomia projektiasetuksissa.
Varojen ja muunnelmien hallintaVara on peruskohde, muunnelma on versio.
- Lisää varan metadata ja valitse kategoria/harvinaisuus.
- Liitä muunnelmiin tekstuurit, kuvat ja hinnat.
Tarkistus ja hakuPidä katalogi selkeänä ja ylläpidettävänä.
- Käytä suodatusta, tilaa ja tunnisteita löytääksesi edessäsi olevan työn.
- Tarkista muutokset aktiviteettilokista.
Tuonti ja vientiVaihda dataa turvallisesti pipelineen kanssa.
- Vie projektidata JSON- tai Excel-muodossa tai rastita Sisällytä mediatiedostot, niin saat ZIP-paketin, jossa ovat mukana kuvat, tekstuurit ja mesh-tiedostot.
- Tuo JSON- ja Excel-tiedostoja sekä ZIP-paketteja. Jokainen tuonti ajetaan ensin esikatseluna, joten näet rivikohtaiset muutokset ja virheet ennen kuin mitään tallennetaan.
Google Sheets -tuontiTuo varat, muunnelmat ja projektin asetukset natiivista Google-taulukosta.
- Luo natiivi Google-taulukko (ei ladattua .xlsx-tiedostoa), jossa on oma välilehti kullekin kohdetyypille: Currencies, Rarities, Releases, Tags, Categories, Assets ja Variants.
- Lisää tarkat sarakeotsikot jokaisen välilehden ensimmäiselle riville (isoilla ja pienillä kirjaimilla on merkitystä). Esimerkiksi Variants-välilehti tarvitsee sarakkeet: slug, name, asset_slug, rarity, release, currency, price, description, tags.
- Kohteet tuodaan riippuvuusjärjestyksessä: Currencies, Rarities, Releases, Tags, Categories, Assets ja lopuksi Variants. Kaiken, mihin rivi viittaa, on oltava projektissa jo olemassa tai tultava vastaan aiemmin samassa ajossa.
- Avaa projektissasi Tiedonvaihto-sivu (projektin valikossa Tuonti / Vienti), valitse tuontilähteeksi Google-taulukko ja yhdistä Google-tilisi. PolyDrobe pyytää Googlen drive.file-käyttöoikeutta, joten se pystyy lukemaan vain ne tiedostot, jotka annat sille.
- Anna profiilille nimi Luo profiili -kohdassa, valitse taulukkosi Google Pickerissä Selaa-painikkeella, muuta välilehtien nimet, jos omasi on nimetty toisin, ja valitse Tallenna profiili.
- Aja tallennetulle profiilille ensin Esikatselu. Se on testiajo, joka raportoi validointivirheet kirjoittamatta mitään; Tuo-toiminto suorittaa saman ajon oikeasti.
- Varojen ja muunnelmien tunnisteet erotetaan puolipisteellä: starter;seasonal=winter;limited-edition.
- Hinnoissa desimaalierottimena käy sekä piste että pilkku (9.99 tai 9,99). Harvinaisuus tunnistetaan nimestä, valuutta koodista ja julkaisu versiomerkkijonosta.
Kehittäjäoppaat
Yhdistä työkalusi, agenttisi ja pipelinesi PolyDrobeen.
REST API:n käyttöönottoIntegroi PolyDrobeen vakiomuotoisella REST API:lla. Käytettävissä Pro-suunnitelmassa.
1. Luo käyttöoikeustunnus
Avaa Työtilan asetukset > API-tunnukset ja luo uusi henkilökohtainen käyttöoikeustunnus. Anna sille kuvaava nimi (esim. 'CI-pipeline' tai 'Paikallinen skripti'), valitse luku- ja kirjoitusoikeudet ja aseta vanhentumisaika. Kopioi tunnus heti, kun se ilmestyy näkyviin: se näytetään vain kerran.
# 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. Todenna pyynnöt
Liitä tunnus Bearer-tunnuksena Authorization-otsakkeeseen jokaisessa pyynnössä.
curl -H "Authorization: Bearer pdtk_abc123..." \
https://polydrobe.app/api/v1/projects/
3. Listaa projektisi
Palauttaa kaikki projektit, joissa olet jäsenenä. Vastaus käyttää vakiomuotoista kuorta, jossa on data- ja meta-avaimet.
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. Luo vara
Luo vara projektiin. Vaatii Toimittaja- tai Omistaja-roolin. Slug muodostetaan automaattisesti nimestä.
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. Luo muunnelma
Lisää varaan muunnelma, jolla on hinta, harvinaisuus ja tila. Kaikki viiteavaimet käyttävät slugeja.
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. Hae varoja
Kokotekstihaku varoista ja muunnelmista PostgreSQL-haulla. Tukee fraaseja, OR-hakua ja poissulkemista.
GET /api/v1/projects/cyber-skins/search/?q=gold+legendary&type=variant&limit=10
7. Massatoiminnot
Päivitä tai poista useita muunnelmia kerralla. Vaatii Massatoiminnot-ominaisuuden, joka kuuluu Pro-suunnitelmaan.
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/
Käytettävissä olevat päätepisteet
REST API yltää jokaiseen projektin resurssiin, jonka PolyDrobe tallentaa, itse katalogista mediaan, joukkomuokkauksiin, aktiviteettiin ja webhookeihin asti. Alla olevat ryhmät kattavat kokonaisuuden. Jokainen resurssi käyttää slug-pohjaisia URL-osoitteita.
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}/
MCP-palvelimen käyttöönottoYhdistä tekoälyavustajat (Claude, ChatGPT) PolyDrobeen Model Context Protocolin avulla. Käytettävissä Pro-suunnitelmassa.
1. Luo henkilökohtainen käyttöoikeustunnus
Avaa Työtilan asetukset > API-tunnukset ja luo uusi tunnus. Nimeä se tekoälyasiakkaasi mukaan (esim. 'Claude Desktop' tai 'Claude Code'). Valitse luku- ja kirjoitusoikeudet ja aseta pitkä vanhentumisaika (1 vuosi tai ei vanhentumista). Kopioi tunnus heti, kun se ilmestyy näkyviin: se näytetään vain kerran.
# 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. Yhdistä Claude Desktop
Lisää PolyDroben MCP-palvelin Claude Desktopin asetuksiin. Avaa claude_desktop_config.json ja lisää siihen tämä kohta.
{
"mcpServers": {
"polydrobe": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://polydrobe.app/mcp"],
"env": {
"MCP_HEADERS": "Authorization: Bearer pdtk_abc123..."
}
}
}
}
3. Yhdistä Claude Code
Lisää MCP-palvelin päätteestä Claude Code -komentorivityökalulla.
claude mcp add polydrobe \ --transport http \ --url https://polydrobe.app/mcp \ --header "Authorization: Bearer pdtk_abc123..."
4. Paikallinen kehitys (stdio-tila)
Paikallisessa kehityksessä voit ajaa MCP-palvelinta suoraan stdion kautta ilman HTTP:tä. Tämä todentaa istunnon valmiiksi annetulle käyttäjälle.
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. Kokeile
Kun yhteys on valmis, kysy tekoälyavustajaltasi projektidatastasi luonnollisella kielellä.
# 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"
Käytettävissä olevat MCP-työkalut
Jokainen PolyDroben luku-, kirjoitus-, haku- ja vientitoiminto on tarjolla työkaluna. Tekoälyavustaja löytää koko joukon yhteyden muodostuessa kategorioittain ryhmiteltynä, eikä mitään tarvitse määrittää.
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 tuotantokäyttöön (edistynyt)
CI/CD-pipelineissä ja palvelinten välisissä integraatioissa voit käyttää henkilökohtaisten tunnusten sijaan OAuth 2.1:n client credentials -todennusta. Ota yhteyttä tukeen, niin saat OAuth-sovelluksen käyttöön.
# 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.
Kuka voi tehdä mitäkin
Kolme roolia, rajattuna sen mukaan, mitä kunkin pitää päästä muuttamaan. Katsojat pysyvät maksuttomina.
Omistaja
Hallinnoi projektin asetuksia, suunnitelman rajoja ja tiimin käyttöoikeuksia.
- Projektin asetukset
- Laskutus
- Tiimin hallinta
- Luo tai muokkaa assetteja
- Tuonti ja vienti
- Vain luku -selaus
Toimittaja
Luo ja päivittää varoja, muunnelmia ja operatiivista dataa.
- Projektin asetukset
- Laskutus
- Tiimin hallinta
- Luo tai muokkaa assetteja
- Tuonti ja vienti
- Vain luku -selaus
Katsoja
Näkee projektidatan review-, QA- ja sidosryhmäkäyttöön.
- Projektin asetukset
- Laskutus
- Tiimin hallinta
- Luo tai muokkaa assetteja
- Tuonti ja vienti
- Vain luku -selaus
Usein kysytyt kysymykset
Mikä PolyDrobe on?
Millaisia varoja PolyDrobe hallinnoi?
Tukeeko PolyDrobe 3D-mallien esikatselua?
Miten PolyDrobe vertautuu Google Sheetsiin pelivarojen seurannassa?
Miten PolyDrobe eroaa Notionista tai Airtablesta?
Minkä pelimoottorien kanssa PolyDrobe toimii?
Voivatko tekoälyagentit käyttää PolyDrobea?
Mitä eroa on REST API:lla ja MCP-palvelimella?
Miten saan API-käyttöoikeustunnuksen?
Tukeeko PolyDrobe tiimityötä?
Pitääkö jokainen skin mallintaa varana vai muunnelmana?
Miten pidän nimeämisen yhtenäisenä?
Voinko jakaa projektidataa ulkoisesti?
Mitä Free-suunnitelma sisältää?
Lasketaanko Katsoja-roolit laskutettaviin paikkoihin?
Onko PolyDrobe SaaS-tuote?
Voinko tuoda olemassa olevaa varadataa PolyDrobeen?
Mitä sarakkeita Google Sheets -tuonnin mallipohja tarvitsee?
Miksi Google Sheets -tuonti ilmoittaa 'Taulukon metatietoja ei voitu ladata'?
Pitääkö Google yhdistää erikseen jokaiseen projektiin?
Yleiset ongelmat
Nopeat korjaukset yleisimpiin ongelmiin.
Puuttuvat oikeudet
Jos toiminto ei ole käytettävissä, tarkista roolisi ja pyydä Omistajaa päivittämään käyttöoikeudet.
Tuonnin validointivirheet
Tarkista pakolliset kentät, kategorioiden slugit ja enum-arvot ennen uutta tuontia.
Median latausongelmat
Tarkista tiedostotyyppi, koko ja tallennustilan käyttö suhteessa suunnitelman rajoihin.
Google Sheets: 'Taulukon metatietoja ei voitu ladata'
Tiedosto on todennäköisesti ladattu .xlsx eikä natiivi Google-taulukko. Avaa se, valitse File > Save as Google Sheets ja valitse sitten muunnettu tiedosto synkronointiprofiilisi Selaa-painikkeella. Tarkista myös, että yhdistetty Google-tili pystyy avaamaan taulukon.
Google Sheets: Assets- tai Variants-välilehti kaatuu virheeseen 'Tag not found' tai 'Category not found'
Viitattujen kohteiden on oltava olemassa ennen kuin mikään voi osoittaa niihin. Tuonti käy välilehdet läpi järjestyksessä (Currencies > Rarities > Releases > Tags > Categories > Assets > Variants), joten epäonnistunut kategoria kaataa mukanaan omat varansa. Lue testiajon esikatselu ylhäältä alas ja korjaa ensin varhaisin kohdetyyppi.
Google Sheets: muunnelman hinnasta tulee 'invalid price'
Tuonti hyväksyy desimaalierottimeksi sekä pisteen (9.99) että pilkun (9,99). Jos virhe jatkuu, etsi hintasolusta ylimääräisiä merkkejä, valuuttasymboleita tai välilyöntejä.