Netcade Documentation

Guides and references for players, creators, and developers building on Netcade.

Overview

Netcade is a creator first platform for games, videos, and music. This documentation explains every part of the product—from uploading and metadata to monetization and the API.

Tip: Use the left sidebar to jump to any section on this page.

Quickstart

1) Create your account

  1. Click Register in the site header and verify your email.
  2. Visit Channel > Settings to set a display name, avatar, and short bio.

2) Upload your first item

Go to Creator Dashboard > Upload and select Game, Video, or Music. Follow the wizard.

3) Publish & share

When the status changes to Released, your page is live. Share your URL or issue access keys for testers.

Core concepts

Users vs creators

  • User: plays games, watches videos, listens to music, leaves reviews.
  • Creator: uploads content, sets pricing, tracks analytics, gets paid.

Content types

  • Game: HTML5/WebGL (in-browser) or downloadable builds (Windows/Mac/Linux).
  • Video: MP4/HLS with adaptive streaming; posters and trailers supported.
  • Music: MP3/FLAC; waveform previews and track/album pages.

Statuses & visibility

StatusMeaning
DraftPrivate to you; incomplete metadata.
SubmittedQueued for review (automated + human checks).
ApprovedMeets policy; ready to release.
ReleasedPublicly visible and monetizable.
UnlistedAccessible via link or key; not visible in browse.
ArchivedNot available to new users; owners retain access.

Achievements & XP

Netcade tracks XP, levels, and tier badges (Bronze → Silver → Gold → Mithril → Adamant → Diamond → Grandmaster). XP comes from both creation (uploads, updates, milestones) and engagement (views, likes, reviews).

Level formula: XP_needed(level) = 250 * level1.35. Badges render on your channel and tooltips.

Uploads

Games

  1. Choose GameUpload.
  2. Select type:
    • Web build: ZIP with index.html (e.g., Unity WebGL, HTML5). Extracted and hosted for in-browser play.
    • Downloadable: ZIP or installer (Win/Mac/Linux). Offered via the Netcade Client download flow.
  3. Add required metadata (see Metadata & tags).
  4. Optionally add trailer (MP4/HLS), screenshots, and external links (Discord, site).
  5. Click Submit for review. Automated scans check for malware and prohibited content; human review verifies metadata.
Large files (> 2 GB): use the Netcade Client Uploader or the dedicated large-file endpoint at upload.netcade.com. Resumable/chunked uploads are supported.

Videos

  • Upload MP4 (H.264/AAC) or HLS. Recommended: 1080p @ 8–10 Mbps; 4K supported.
  • Set a poster image (16:9). Netcade generates responsive renditions automatically.
  • Optional trailer vs. full video are both supported via the media carousel.

Music

  • Upload MP3 (320kbps) or FLAC. Provide track title, artist/creator, album/collection, and artwork.
  • Waveforms are generated; listeners get inline previews. Albums can group multiple tracks.

Images & assets

AssetSpecNotes
Game coverVertical poster (2:3), PNG/JPGUsed in cards + storefront header
Screenshots16:9/4:3, up to 10Auto-optimized
Poster (video)16:9, 1920×1080 recommendedShown before playback
Artwork (music)Square (1:1)Album/track thumbnails
AvatarSquareChannel icon

Metadata & tags

Good metadata increases discovery and determines eligibility for features and age gating. These fields are supported across Games, Videos, and Music:

FieldTypeDescription / Values
titlestringPublic title displayed on cards and pages.
slugstringCustom URL slug (validated in real-time; must be unique).
short_descriptionstring~140 chars; used in list cards and social embeds.
descriptionHTML/markdownFull page description. Supports rich text and images.
visibilityenumpublic | unlisted | private
release_statusenumdraft | submitted | approved | released | archived
is_paidboolean (0/1)0 = free; 1 = paid (PWYW or fixed price).
pricenumberFixed price (if is_paid=1 and not PWYW).
pwyw_minnumberMinimum price for pay-what-you-want (0 allowed).
for_kidsbooleanDesigned for children (COPPA-aligned presentation).
age_ratingenume.g., E, 10+, 13+, 16+, 18+.
content_warningsarray<string>Violence, language, flashing lights, etc. Shown as badges.
genrestringPrimary genre (e.g., Action, Puzzle; for music: Electronic, Rock).
tagsarray<string>3–8 tags recommended; confirmed with comma/tab.
engineenumDetected for games (Unreal / Unity / Godot / HTML5).
platformenumFor games: web (in-browser) or downloadable.
allow_downloadsbooleanPermit local download for HTML/Web games (if enabled).
allow_embedsbooleanAllow embedding of the player on external sites.
cover_imagefilePrimary cover art (games: vertical poster; music: square; video: 16:9 poster).
screenshotsfile[]Up to 10 screenshots for the media carousel.
trailer_urlurlOptional video trailer shown in the carousel and on hover.
external_linksobjectDiscord, website, socials.

Review process

  1. Automated checks: malware scan (for executables/zips), file type validation, aspect ratio, policy keywords.
  2. Human pass: verify description, age rating, content warnings, and imagery.
  3. Result: approved → Released; needs changes → notes returned in Dashboard.

Commerce & payouts

Pricing models

  • Free: zero price; optional donations/tips.
  • Pay-what-you-want (PWYW): set a minimum (can be 0).
  • Fixed price: you set the price per item.
  • Keys: sell elsewhere; redeem on Netcade (see Access keys).

Earnings calculation

Netcade shares 95% of net revenue with creators (after processor fees). Here’s the formula used in the dashboard:


creator_payout = (gross_amount - payment_processor_fees) * 0.95
// Example: $10.00 sale, Stripe fee 2.9% + $0.30
// gross = 10.00; fees = 0.59; remainder = 9.41; payout = 8.9395 ⇒ $8.94

Payouts

  • How it works: Buyers pay via Stripe/PayPal on Netcade. Creator payouts are handled through Trolley (our disbursement/KYC/tax partner).
  • KYC / Tax: You’ll complete identity + tax onboarding securely in Trolley. Netcade does not store sensitive tax or banking data.
  • Threshold: $10 minimum balance.
  • Schedule: Weekly payout requests; typical arrival 2–7 business days depending on region and method.

API

Use the REST API to automate uploads, keys, and analytics pulls for games, videos, and music.

Authentication


Authorization: Bearer YOUR_API_TOKEN

Moderation & content policy

Safety

  • No hate speech, harassment, or sexual content involving minors.
  • Malware and crypto-mining binaries are strictly prohibited.
  • Age-gating required for mature content; follow regional laws.

Glossary

  • Release: A public version of your item.
  • Key: Single-use code that unlocks access.
  • PWYW: Pay-what-you-want pricing.
  • HLS: HTTP Live Streaming (adaptive video).

Support

Questions? Email [email protected] or join our Discord.

© 2026 Netcade. All rights reserved.