tmt-prop-create

Create and validate bounded data-only TMT Office prop-pack JSON files.

11|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/wkh237/tmux-team --skill tmt-prop-create-wkh237
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmt-prop-create
Source: https://github.com/wkh237/tmux-team/tree/main/skills/tmt-prop-create
Command: npx skills add https://github.com/wkh237/tmux-team --skill tmt-prop-create-wkh237

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating custom furniture and prop artwork for a local TMT Office requires producing strictly bounded, data-only JSON files that pass validation, and hand-writing these files often leads to rejected packs, invalid palettes, or broken placements. ## Core Features & Use Cases - Prop-Pack Authoring: Produce UTF-8 .tmtprop.json documents in v1 (single rotated sprites) or v2 (four directional frames with optional tint and text customization) formats. - Validation and Preview: Validate packs with tmt office prop validate, inspect advisory warnings, and preview artwork against a running local Office service. - Catalog and Layout Management: Install packs with revision-checked authorization, place props into world layouts using immutable digest references, and handle revision conflicts safely. - Use Case: An artist authors a directional desk lamp prop with tintable accents, validates the pack, installs it into the local catalog, and places it on a floor tile in the office layout. ## Quick Start Create a v2 TMT Office prop pack for a small bookshelf with four directional views, validate it, and install it into my local Office catalog.

Frequently Asked Questions about tmt-prop-create

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom prop for TMT Office?

Author a UTF-8 .tmtprop.json file with a palette of lowercase #rrggbbaa colors and indexed-pixel rasters, choosing formatVersion 1 for simple sprites or 2 for directional furniture. Then validate it with tmt office prop validate --file <pack> --json before installing.

What is the difference between prop pack formatVersion 1 and 2?

Version 1 uses single-digit hex pixel rows for one rotated sprite with a 128 KiB limit. Version 2 replaces pixels with four directional frames in South, West, North, East order using two hex digits per pixel, allows 256 palette entries, and supports tint and text customization.

How do I add tint or text customization to a prop?

Declare a customization object with tint indices or text regions in the v2 pack, ensuring every tint index is used in every frame. At placement time, set customization with a lowercase #rrggbb tint or single-line text up to 24 Unicode scalars inside the placement object.

Why does prop pack validation reject my file?

Validation rejects files exceeding size or count limits, palettes missing the transparent first entry, duplicate or unknown fields, invalid keys, or pixel indices absent from the palette. Mixing pixels and frames in one pack also fails.

What happens when I remove an installed prop pack?

Removal is an authorized catalog mutation requiring the current catalog revision and never rewrites saved layouts. Existing placements render bounded unavailable placeholders, and reinstalling the exact original bytes restores them.