--- url: https://docs.sunlicense.com/guide/thread-studio.md --- # Thread Studio Thread Studio designs the thread that sells your product on BuiltByBit (the description on your resource page) and its listing thumbnail, the way a designer would: it asks about your product, picks a look, and lays everything out. You answer a few questions, choose between a few looks and ask for changes in your own words. Then publish: SunLicense draws the images, hosts them, and gives you BBCode with every link filled in, ready to paste. Thread Studio is in the dashboard under **Tools**, marked **Experimental** while it settles. It is on every [plan](/guide/plans). Hosting the images counts toward your plan's thread limits: **Free** 1 product and 25 MB, **Lite** 5 products and 150 MB, **Standard** 25 products and 500 MB. On **Lite** and **Standard** each AI step (reading your product, the draft, each change you ask for) uses one SunLicense AI message. **Free** gets 30 AI tool calls a month, shared with Docs' **Write with AI**, enough for a few threads. With [your own AI key](/guide/sunlicense-ai#use-your-own-key) none of it is counted, on any plan. ## Brand kit **Tools › Thread Studio › Brand kit** holds what every thread of yours shares, set once: your name (shown as the creator), tagline, Discord invite, website, docs, store page, a one-line support promise ("Answers within 24 hours on Discord") and your studio colours. The logo is your organization's (Settings › Branding), and Discord starts from the invite there. Every thread's support block uses the kit unless you give that product its own links. ## Start a thread Open **Tools › Thread Studio** and choose **New thread**. One question at a time: 1. **Product**: the product the thread is for, and what it is: the game or platform and the kind (plugin, server setup, config, Skript, build, models, textures, graphics, bot, theme, script, map, mod). 2. **About it**: describe the product in as much detail as you like and add every picture that shows it: screenshots, menus, banners and your logo (up to 12). Your download page's screenshots are already there. A thread needs **at least 3 screenshots** of the product working, so the interview continues once there are three. 3. **Questions**: SunLicense AI reads everything and asks two to four questions that would make the thread sell better: a screenshot of a feature you mention but don't show, which server software it runs on, whether there's a test server. Answer or skip each. 4. **Look**: three colour sets that suit your product, each shown as your listing thumbnail on the template that fits it. Pick one, or switch the template (all templates are one click away). **Design my thread** writes the copy from your description and answers, places your screenshots, and opens the editor. If the AI isn't available, the editor opens with what you gave, to finish there. ### Templates Each template rebuilds what top-selling threads of a kind do (from a study of nearly 800 of them): | Template | For | |---|---| | **Product page** | Plugins, Hytale mods: a dark product page in one tall image | | **Setup showcase** | Server setups and configs: buttons and test server first, a "what's included" checklist | | **Asset pack** | Builds, maps, models, textures, graphics: a screenshot collage, spec tiles, a gallery | | **Bot showcase** | Discord bots and tools: your product inside chat-message frames | | **Storefront** | Webstore and panel themes: a live preview button under the banner, feature rows | | **Clean light** | Premium tools and UI kits: a light product page with stat cards | | **Pixel quest** | Hytale and game mods: a game-interface look with pixel labels | | **Spec sheet** | Modules, add-ons, Skripts: a spec table and numbered sections over real text | | **Lean text** | Scripts and anything that reads best as text: a small banner over real text | | **Aurora** | Premium plugins and tools: glass cards over soft colour light, your product in a glass frame | | **Bento** | Launches, bots and tools: the hero and features as a grid of rounded tiles (dark or light) | | **Brutal** | Bold indie products: flat colour, thick outlines, hard shadows and sticker tags (light sets) | | **Neon grid** | PvP, minigames, arcade: a synthwave sky, a glowing grid floor and neon capitals | | **Tale UI** | Hytale, RPG and fantasy: gold bevelled frames, carved capitals and ornaments | | **Stud pop** | Roblox and playful packs: a studded colour field, sticker screenshots and ribbons | | **Island kit** | Fortnite (UEFN) and Garry's Mod: condensed capitals and slanted bars over real text | | **Addon series** | A range of add-ons: one compact look with a series bar, so buyers recognise your products | | **Blocky poster**, **Midnight landing**, **Hybrid classic** | Playful gameplay plugins, large products, technical tools | Every card in the template library shows the top of your own thread in that template. Colours come only from curated sets that read well; there are no colour pickers. A template only offers the sets that suit it (some are dark only, Clean light is light only). ### Style The **Style** button in the editor's rail sets the rest of the look, always from choices that suit the template: * **Typeface**: 13 pairings of a title face and a text face (Modern, Tech, Wide, Expressive, Editorial, Tall, Esports, Sci-fi, Chunky, Cartoon, Friendly, Fantasy, Pixel), or the template's own. **Title size** (small, medium, large) and **capitals** (the template's, all caps, as typed) fine-tune it; titles always fit their space. * **3D elements**: one or two small 3D renders in your colours beside the title and on the thumbnail: blocky heroes, loot (sword, chest, gem), blocks, magic, bots, rewards, economy, gems, 3D shapes or tech. They're off unless you add them; most threads look best without. * **Pattern** behind the content (dots, grid, honeycomb, contours, circuit, studs…) and a faint **light and finish** effect (glow, aurora, light rays, bokeh, film grain, scanlines, vignette). A light effect and 3D elements don't go together: picking one sets the other aside. Switching template keeps what the new one takes and resets the rest. ## Change it The editor shows the thread as buyers see it. **Click any section** to select it: move it up or down, hide it, edit its words right under it, or ask the AI about just that section. The rail on the left opens the **template** library, the **colours**, the **style**, the list of **sections** (show, hide, reorder) and the **details** (what the product is, the listing title and tags, your description). The **design check** above the thread lists what a designer would point out: screenshots that will look soft, missing captions, a long name or tagline, too few features, no support link. Publishing waits until the thread has at least 3 screenshots. The **SunLicense AI** panel on the right takes changes in your own words: "warmer colours", "move the FAQ up", "make the features more specific", "try a lighter look", "add 3D characters", "a fantasy typeface". With a section selected, it works on that section. Each answer says what it changed, and **Undo** takes it back. The conversation stays with the design. The **Thumbnail** tab shows the listing thumbnail (2000 × 1000, BuiltByBit's card image). It's drawn in your template's look (its typeface, colours, pattern, effect and 3D elements), so the card in search matches the thread it opens. Each template offers a few alternative styles, among them **3D showcase** (your elements large beside the title); add a corner badge (NEW, a version) and download it. ## Marketing kit The **Marketing kit** tab draws the pictures around your thread from the same design (template, colours, typeface, 3D elements, screenshots and words), grouped by where they go: | Picture | Size | For | |---|---|---| | Listing thumbnail | 2000 × 1000 | The card buyers see in search and category lists (its style is set in the **Thumbnail** tab) | | Product icon | 512 × 512 | The resource icon, your Discord server, your store. Your logo on a tile, a line icon on a tile, a ring, or your main 3D element | | Gallery screenshots | 1920 × 1080 | One per screenshot, framed and captioned, for the listing's gallery | | Social card | 1200 × 630 | Announcements on Discord, X and forums | | Video thumbnail | 1280 × 720 | A showcase or update video on YouTube | | Feature cards | 1080 × 1080 | One per top feature (up to three), for a carousel post | | Discord server banner | 960 × 540 | Server Settings › Server banner | | Update banner | 1200 × 400 | Each update: its title and up to four lines on what changed | | Sale banner | 1200 × 400 | Sale events and discount codes: the deal and when it ends | | Thread banner | 1200 × 400 | A wide header for any post | The social card, update and sale banners have **Copy post text**: ready-to-paste words for the post that goes with the picture. Download each picture as a PNG, or **Download all** as a zip. These pictures aren't hosted: upload them where they go. The listing's title and tags are under **Details** in the editor's rail. ## Publish **Publish** draws the images, uploads them and checks each one, then shows the BBCode. Copy it into your resource's description on BuiltByBit, and download the thumbnail for the resource's card image. Each publish is a new version. Versions never change once published, so a thread you posted keeps working when you publish again. **Published versions** in the editor's **⋯** menu lists them, with **Copy BBCode** for each. Deleting a version deletes its images: any thread still using it shows broken images. Image-heavy templates also include the text of your description in a spoiler (**Read the description as text**), so marketplace search still finds it. ## API Under the product's permissions (`products.read` to read, `products.write` for the rest): * `GET /api/v1/distribution/threads`: every design with its latest published version, and usage. * `GET` and `PUT /api/v1/distribution/threads/brand` with `{"document": {…}}`: the brand kit. * `GET /api/v1/distribution/products/{productId}/thread`: the design, its screenshots, the published versions and usage. * `PUT …/thread` with `{"template": "landing", "document": {…}}` saves the design (a new one needs room in `thread_designs`); `DELETE …/thread` deletes it with every version. * `POST …/thread/uploads` with `{"kind": "screenshot", "size": 1234}` returns an upload URL; `PUT` the bytes, then `POST …/uploads/{fileId}/complete`. PNG, JPEG or WebP, up to 8 MB. * `POST …/thread/versions` with the template, the BBCode ({{IMG:\}} where each image goes) and the images' names, sizes and dimensions returns an upload URL per image; `POST …/versions/{number}/complete` checks them and publishes. `DELETE …/versions/{number}` deletes one. * Published images are public at `https://api.sunlicense.com/api/v1/downloads/thread-files/{id}.png`.