Node.js CLI for fetching, browsing, diffing, and exporting Minecraft Marketplace creators from the PlayFab / Store config endpoint. Includes an interactive arrow-key UI, fuzzy search, favorites, cache + diff workflow, and export tools (JSON/CSV/IDs). Built for quick inspection and repeatable exports.
Important
Project Disclaimer
"CreatorGET-Service" by SpindexGFX is an independent project. It is not affiliated with, endorsed by, sponsored by, or otherwise connected to Mojang AB, Microsoft Corporation, or any of their subsidiaries or affiliates. No partnership, approval, or official relationship with Mojang AB or Microsoft is implied.
All names, logos, brands, trademarks, service marks, and registered trademarks are the property of their respective owners and are used strictly for identification and reference purposes only. This project does not claim ownership of third-party intellectual property and does not grant any license to use it.
- Overview
- Key Features
- Quickstart
- Configuration (Environment)
- Data Files & Local Storage
- Runtime & Architecture
- Security Model
- CLI
- Output Formats
- Caching & Diff Workflow
- Diagnostics (Health)
- Error Model
- Rate Limiting
- Directory Layout
- Development & Utilities
- Testing
- Performance Tuning
- Deployment
- Troubleshooting
- FAQ
- Contributing
- License
CreatorGET-Service is a focused CLI that extracts the creator registry used by the Minecraft Marketplace store UI.
It fetches Store Session Config from:
https://store.mktpl.minecraft-services.net/api/v1.0/session/config
From that payload, it resolves the creator filter and exports each toggle as a normalized creator entry:
displayName→ human readable creator label (as exposed by the store config)id→ creator identifier (typically an entity reference likemaster_player_account!<hex>)creatorName→ a deterministic normalized name derived fromdisplayName(configurable)
This project is intentionally scoped: creators only. No catalog browsing, no store items, no prices.
Repository: Daniel-Ric/CreatorGET-Service
- 🎛️ Interactive arrow-key CLI (prompts) with minimal, readable colors.
- 🔐 Token-based access: reads
MC_TOKEN(MCToken …) from environment or prompts. - ⚡ Fast & resilient fetch using Axios with keep-alive agents and timeout controls.
- 💾 Cache fetched creators on disk and load instantly on next run.
- 🧭 Browse creators in pages with details view and clipboard actions.
- 🔎 Fuzzy search (Fuse.js) across
displayName,creatorName, andid. - ⭐ Favorites: star creators and persist them for quick access.
- 🔁 Diff vs API: compare cache against a fresh API fetch (added/removed/changed).
- 🧾 Exports:
creators.jsonin the required array formatcreators.csv- selection-only exports
ids.txt/ids.json
- 🧪 Diagnostics: duplicates,
creatorNamecollisions, empty normalization results.
git clone https://github.com/Daniel-Ric/CreatorGET-Service
cd CreatorGET-Service
npm i
cp .env.example .env
npm startIf you prefer a global CLI command, link the package once:
npm link
creatorservice
creatorgetserviceis still available as a backwards-compatible alias.
This CLI is configured via .env (loaded via dotenv) and validated with joi.
| Variable | Default | Description |
|---|---|---|
NODE_ENV | development | development | production | test |
LOG_PRETTY | true | Pretty console output toggle |
HTTP_TIMEOUT_MS | 25000 | HTTP timeout in ms |
CACHE_DIR | .cache | Cache directory |
CACHE_TTL_MS | 21600000 | Cache freshness threshold in ms (0 disables) |
PAGE_SIZE | 20 | Page size for browsing |
CREATORNAME_MODE | nospace | How creatorName is derived from displayName |
MC_TOKEN | empty | Store auth token (MCToken …). If empty, CLI will prompt. |
| Mode | Behavior |
|---|---|
nospace | Removes whitespace from displayName |
alnum | Keeps only 0-9 A-Z a-z _ - |
Example:
| displayName | nospace | alnum |
|---|---|---|
4J Studios | 4JStudios | 4JStudios |
2-Tail Productions | 2-TailProductions | 2-TailProductions |
Cool ✨ Studio | Cool✨Studio | CoolStudio |
This CLI persists a few small files under CACHE_DIR (default .cache/). You can safely delete them at any time.
creators.cache.json— cached creators list +fetchedAtfavorites.json— your starred creator IDs
Example cache structure:
{
"fetchedAt": "2025-12-29T12:00:00.000Z",
"creators": [
{
"creatorName": "4JStudios",
"id": "master_player_account!28D0EC53875E6219",
"displayName": "4J Studios"
}
]
}Favorites structure:
{ "ids": ["master_player_account!28D0EC53875E6219"] }User ──► Interactive CLI (prompts)
│
▼
Marketplace Service
(fetch session/config + transform)
│
▼
Cache + Favorites Store (JSON files)
│
▼
Exporters (JSON/CSV/IDs)
Highlights
services/marketplace.service.jsis the single source of truth for:- fetching store session config
- extracting creators
- normalization
- diff + diagnostics helpers
ui/menu.jscontains all prompt-based UI flows.cache/andfavorites/isolate disk storage.
- MC_TOKEN is treated as sensitive.
- It is read from
.envor entered via a password prompt (not echoed). - It is sent as the
authorizationheader.
- It is read from
- Cached creators and favorites do not store the token.
- If you share logs/screenshots, ensure the token is not visible in your shell history.
- Use Arrow keys to navigate.
- Press Enter to select.
- In multi-select menus:
- press Space to toggle selection
- press Enter to confirm
The UI uses subtle colors (chalk) and includes a header showing:
- number of loaded creators
- cache timestamp (
fetchedAt) CREATORNAME_MODE
| Action | What it does |
|---|---|
| Refresh from API | Fetches latest creators and updates cache |
| Diff vs API | Fetches latest creators and compares with current cache |
| Browse creators | Paged list with details + clipboard + favorite toggle |
| Browse favorites | Same browser but only starred creators |
| Search (fuzzy) | Fuzzy search across name/id |
| Export creators.json | Writes full list as JSON |
| Export creators.csv | Writes full list as CSV |
| Export selection | Pick subset and export JSON/CSV |
| Export IDs | Writes ids.txt or ids.json |
| Health / diagnostics | Finds duplicates/collisions/odd normalization |
| Cache info | Shows cache file size + fetchedAt |
Inside a creator entry you can:
- toggle favorite
- copy ID / displayName / creatorName
- copy JSON snippet for paste/use elsewhere
This is the primary output format used by this project:
[
{
"creatorName": "100Media",
"id": "master_player_account!C815378092EF16AB",
"displayName": "100Media"
},
{
"creatorName": "2-TailProductions",
"id": "master_player_account!FAAF566E8298B9CB",
"displayName": "2-Tail Productions"
}
]Headers:
creatorName,id,displayName
Values are quoted as needed and use standard CSV escaping.
ids.txt— one ID per lineids.json— JSON array of IDs
The cache allows you to:
- start instantly without an API call
- compare your last known registry with the current one
Cache freshness
If CACHE_TTL_MS > 0, the CLI will warn when cached data is older than the TTL and offer to refresh.
Diff vs API
Diff results are categorized as:
- Added: IDs present in fresh fetch but not in cache
- Removed: IDs present in cache but not in fresh fetch
- Changed: same ID exists in both but
displayName/creatorNamediffers
After viewing the diff, you can optionally apply the latest data and update the cache.
The health menu is designed to catch issues that matter when you consume exports downstream:
- Duplicate IDs: indicates upstream duplication or transformation issues
- creatorName collisions: multiple creators normalize to the same
creatorName - empty creatorName: normalization produced an empty string (usually due to strict modes)
If collisions exist, the CLI can print a condensed list (limited to keep output readable).
Errors are surfaced as short console messages.
Typical causes:
- Missing token:
MC_TOKENnot set and prompt canceled - 401/403: token invalid/expired or insufficient access
- Timeouts:
HTTP_TIMEOUT_MStoo low, network issues - Unexpected upstream shape: store config changed and creator filter isn’t present
This CLI does not enforce client-side rate limiting. If upstream responds with throttling or transient errors, reduce the frequency of refresh/diff calls and avoid rapid repeated fetches.
bin/
creatorservice.js # entrypoint
src/
app.js # main runtime loop
state.js # in-memory state
config/
env.js # env loading + validation
services/
marketplace.service.js # fetch/transform/diff/diagnostics
cache/
creators.cache.js # disk cache
favorites/
favorites.store.js # favorites persistence
export/
json.export.js # JSON writer
csv.export.js # CSV writer
ids.export.js # ids.txt / ids.json writers
ui/
theme.js # color helpers
menu.js # interactive CLI flows
utils/
fs.js # file helpers
http.js # axios instance with keep-alive
httpError.js # lightweight error helpers
npm inpm startEquivalent direct command:
node bin/creatorservice.jsdotenv -e .env.local -- node bin/creatorservice.jsSuggested test targets:
Unit tests:
- creator extraction + normalization
- diff function correctness
- collision detection
- CSV writer escaping
Integration tests:
- cache read/write
- favorites toggle + persistence
This repository is intentionally lightweight and does not include a test runner by default.
- Increase
HTTP_TIMEOUT_MSif you see timeouts on slower connections. - Increase
PAGE_SIZEif you prefer fewer pages (at the cost of larger UI lists). - Prefer the cache when repeatedly exporting; only refresh when needed.
The CLI is designed to run anywhere Node.js 18+ is available.
npm link
creatorserviceTo remove the link later:
npm unlinkToken prompt shows, but fetch fails
EnsureMC_TOKENstarts withMCTokenand is still valid.No creators loaded / empty list
The upstream response may have changed, or your token lacks access to the store config endpoint.Fuzzy search returns unexpected matches
Adjust the search term; Fuse will prioritize close matches. If you need stricter matching, use longer terms or include part of the ID.creatorName collisions
SwitchCREATORNAME_MODEtoalnumor consumeidas the unique key downstream.Cache not used
EnsureCACHE_DIRis writable and not blocked by permissions.
Where do creators come from?
From the store session config payload under the creator store filter toggles.
Is creatorName official?
No. It is a derived convenience field. The stable identifier is id.
Can I export only a subset?
Yes. Use Export selection.
Does this support multiple titles?
This project intentionally focuses on a single upstream endpoint that provides the creator toggles. Title/alias management is out of scope here.
- Fork the repo and create a feature branch.
- Keep changes focused on creators workflow and CLI UX.
- Update the README when behavior changes.
- Open a PR with a clear description and screenshots for UI changes.
This project integrates third-party services (Minecraft / PlayFab). Ensure compliance with the provider’s terms of use and your internal policies.