# SimSync Workshop

Desktop 0.10.0 · Android 0.6.0 beta

## Gallery, household profiles and import improvements

The shared Gallery companion is under **Tools → Gallery companion** (Hub: **Workshop**). Save official EA Gallery links and creator IDs as household or lot planning profiles, search your saved collection, and open a source in EA Gallery. Downloads happen through EA into My Library. Choose **Import downloaded Library files** to open the Tray reader. EA sign-in/search/downloads are outside SimSync; no EA account connection, live listing feed or automatic missing-CC download is included. Gallery bookmarks and Tray profiles are separate unless you deliberately record their connection. Names alone are not identity proof.

These 15 improvements are included in this release:

1. A shared detailed Sim/household dossier on the site and in the Android/desktop Workshop.
2. Household member cards with initials or available portraits and direct profile navigation.
3. Member search and life-stage filters, including recorded species, roles and careers.
4. Household funds, linked home/world, member counts and imported-fact summaries together.
5. Known trait/career names in profile summaries; original IDs remain available in reports. Tray display strings can provide actual saved trait and aspiration names.
6. Search across imported detail sections, resolving names in both headings and values.
7. An original-ID toggle and expand/collapse controls for detailed reports.
8. Full profile JSON and readable detail CSV exports, using Android's native share sheet.
9. Navigable links for supported imported Sim/lot/household references that match existing profiles.
10. Tray age, gender, species, primary trait IDs/names, aspiration names and likes/dislikes references retained. Hidden binary traits stay separate.
11. Tray household funds and documented lot/room values, dimensions, bedrooms/bathrooms and lot traits retained when present.
12. Structured Tray Sim reports preserve supported careers, skills, family, outfits, life-state and other available sections instead of relying on clipped notes.
13. Unambiguous individual .sgi portraits can be exported and attached to their Sim profiles. Ambiguous or unsupported portraits remain unavailable; no appearance-based matching.
14. Newborn life stages are preserved, and household name/funds/home information now stays in imported household reports. Oversized statistics/needs/inventory sections have their own budget so they do not consume every later section.
15. Save import supports whole-household selection and all matching Sims without the old 500-Sim selector cap, paginated selection, coverage previews, explicit excluded counts, and picture assignment to every included household. Reimported Tray data can refresh matching reports and fill blank fields without replacing notes, placements or statuses.

**Import limits remain explicit.** Raw saves: 128 MB. Save reader: up to 5,000 Sims; imported collection: 2,000 linked records; extracted request: 7 MB in the UI (8 MB server ceiling). Select fewer linked records if needed and retain the full supported snapshot export. This is not unlimited or lossless save import. The reader understands supported fields only, not every game subsystem. Reports are bounded to 400 rows per section, 30,000 characters of retained rows and 40,000 characters per report; warnings identify shortening. Statistics, needs and inventory each have a 3,500-character row budget. Exported reports cannot recover fields already skipped or shortened. Keep original files.

Tray imports retain the existing 1 GB / 3,000-file limit. Portrait batches are limited to 32 MB; ambiguous image matches are skipped. Metadata display names are not positionally matched to resource IDs, because the source does not prove that mapping. Known community labels can differ from current/localized game text; unknown and modded resources remain unresolved unless a trustworthy name is present or you supply a label. Finished Sim ZIPs, meshes, textures and installed CC remain separate files.

In the Tray reader, **Refresh retained Tray reports** updates only matching deterministic import IDs. It keeps notes, status, links and placements, fills empty details, and can replace an exactly matching raw trait/aspiration ID string with its recorded display name. Existing portraits remain. A Gallery bookmark is not automatically merged with a Tray profile.


## Where to open it

- Sims Hub: choose **SimSync Workshop** in the sidebar, or **More → SimSync Workshop** on mobile.
- Desktop: choose **SimSync Workshop** in the left menu. **Outfit CC finder** is a separate desktop tool.
- Android 0.5: the bundled Workshop Home opens first. **Connected Sims Hub** opens your complete existing Hub in its verified full-screen activity. It needs internet and your existing account. Android Back returns to the Workshop.

## Your app workspace

Android and the desktop Workshop now have five main screens:

- **Home:** collection progress, records that need attention, quick tools and a connection guide. Progress uses your planning statuses, not verified game completion.
- **Library:** create and edit Sims, households, worlds, lots, CC/mod records and tasks. Search titles, details and notes; filter by type/status, sort by name/priority/recent edits, and browse all records in pages of 24. Open a profile to edit its details, status, priority and assignments.
- **Planner:** tasks for build sessions, story work, makeovers and testing. Set a target date, priority and completion status.
- **Tools:** Tray library, Offline notebook, 3D Sim viewer, Local casting assistant, Troubleshoot, Career builder and Tools & mod reviews.
- **More:** plan import/export, connected Hub, Android pictures and reminders, release information and credits. An **Earlier notebook** button appears if notes remain in the original default workspace.

Create a separate collection for each save project. The last collection is remembered. Existing collections and pictures are retained. New pictures are stored per collection. Local record edits are saved in a transaction and reject stale versions from another window. Archive records instead of deleting them; use the Archived filter and clear the checkbox in the editor to restore one.

Local plan JSON import/export allows up to 32 MB and 10,000 records. Import first previews record counts and whether a collection will be added or replaced. Export the existing local copy before replacing if needed. Duplicate IDs and mixed-save records are rejected. These local edits do not automatically sync to the Hub. Notes and pictures have separate exports; a plan JSON is not a full backup.

## Tray households, lots and pictures

Choose a complete Tray ZIP or select its `.trayitem` and supporting files together. Files are inspected on the device, up to 3,000 Tray files and 1 GB (1,024 MB). ZIPs are indexed without loading the full archive into memory. Metadata and household outfits are read as needed; cover pictures load when selected. Expanded Tray content is also limited to 1 GB, each Tray file to 16 MB, and decoded pictures to 8 MB / one megapixel. Normal stored/deflated ZIPs are supported; encrypted, split and ZIP64 archives require re-exporting as a standard ZIP. Unrelated files such as CC packages are skipped. Search by creation, creator, Sim name or story; filter by type or review warnings, and browse 24 results per page. Choose a creation to review names, creator, story, pictures, missing files and outfit references.

**Add to this save plan** creates a household and its Sims, or a lot planning record. The connected Hub attaches the supported cover picture. Existing imports use stable IDs and are skipped, so their status, placement and edits remain yours. Imported records start as plans; their presence in Tray does not verify placement or installed CC. Rooms remain clearly labeled room exports. A partial network failure can be retried without duplicating records.

The desktop/Android Workshop keeps imported records in a separate local collection. Import a Hub plan JSON to bring a copy of your character profiles into its local assistant. Local plan JSON exports contain records, not pictures, game files or CC. Keep the original Tray ZIP and save pictures separately. Device storage can be cleared by uninstalling the app or clearing browser data.

**Export this Tray group** includes only the selected Library files. It does not collect or redistribute custom content. Selected-group exports are limited to 128 MB in the browser/desktop. Android exports up to 32 MB use the system Save/Share sheet; use desktop for larger exports.

## Outfit CC finder on desktop

1. Open a save and run **Package inspector** against its Mods folder.
2. Open a household in **Workshop → Tray library** and inspect an outfit or export its report.
3. Paste up to 100 decimal CAS part IDs into **Outfit CC finder**.
4. Review matching packages, structured CASP/GEOM references and unresolved items. Export the report if useful.

The finder rechecks file hashes, rejects changed packages and follows supported, bounded references. “Not found” means absent from scanned Mods packages. Base-game and pack resources are not indexed. Script requirements, tuning dependencies and other resource types are unverified. No packages are copied, moved or deleted.

## Error reports and guided mod tests

Open **Troubleshoot** in the Workshop (Android/desktop: **Tools → Troubleshoot**). Choose up to 10 `.txt`, `.log`, `.html` or `.xml` reports, limited to 2 MB each and 8 MB total. Supported tags from lastException and lastUIException, mod-report text and native crash reports are recognized. HTML is displayed as text; scripts, embedded images and external resources do not run or load. Reports remain in memory while this tool is open and are never sent to AI or uploaded.

The reader groups repeated entries, shows reported game builds and extracts supported archive/module clues. Optionally enter the current four-part build from GameVersion.txt, then select reports. An older report does not prove the problem is fixed; a filename mention does not prove a mod caused an error or is installed. Native crash reports cannot reliably identify a mod. Up to 100 entries per file are read, with visible truncation notices. Local detail previews show at most 12,000 characters per group.

**Export summary** omits raw report text and source filenames and reduces paths, links, emails and common secret labels. It can still contain personal report messages or mod names; review it before sharing. **Clear reports** discards the loaded results.

The **50/50 test planner** remembers 2–512 named mod groups per collection. Before starting, back up saves and Mods, use a disposable save, and verify the problem appears with all candidate groups and disappears without them. Keep a mod and its exclusive requirements together. Keep shared requirements in a fixed baseline. Close the game and manually enable only the groups listed for each round, leaving all other candidate groups outside Mods. Repeat the same action, record the result and add notes. Undo an uncertain round instead of guessing. Multiple causes, dependencies and interactions can invalidate binary search; the last candidate needs a separate confirmation test.

Test history persists on this device. Export it and use **Import test history** in the same collection on another device to continue. Imports up to 512 KB are validated and previewed before replacing the local test. There is no automatic sync or game-file modification. Plan JSON and notebooks do not include troubleshooting history.

## Mod reviews and tool research

**Tools & mod reviews** lists active CC/mod profiles needing attention: missing creator links, no recorded review, differing installed/creator versions, a different game build, pending tests or a manually marked broken status. Search by name, creator or version; browse 24 results per page. Open a profile to edit its installed version, **Creator version you checked**, **Last checked**, **Game build you tested** and existing compatibility notes/status. The game-build filter is temporary. These observations are yours; no remote version checker, automatic updater or compatibility certification is implied.

The searchable directory distinguishes code already included, separate tools, possible integrations and unresolved licensing. Source and license links were reviewed November 5, 2026. Selected MIT code from `sims4modorganizer`, `HistorianCareer` and `SyncCrate` is now adapted. Desktop Organizer includes metadata/baselines and verified portable transfer review copies. The shared Workshop includes an experimental career source builder. These are bounded adaptations, not the complete upstream applications. Projects without a verified reuse license remain research links and contribute no copied source.

## Career builder

Open **Tools → Career builder**, or **Sims Hub → Workshop → Career builder**. Start the Cozy Bell Innkeeper example or import a career-plan.json file up to 256 KB. Edit a unique ID, name, description and 1–20 ordered ranks. Each rank has a title, role description, hourly pay, start hour, shift duration and workdays, with a weekly pay estimate. Save draft stores one career per collection on this device. Export other careers before replacing the draft. Changes from another window are rejected instead of overwritten.

Export plan JSON to edit on another device. Export source ZIP produces CareerTrack and CareerLevel XML, localization JSON, deterministic instance IDs, the plan, license and validation checklist. Keep the career ID stable when updating the same project; give each distinct career its own ID. Drafts are not part of ordinary Hub plan or notebook exports.

This is experimental development source, not an installable mod. SimData, compiled strings, career registration, performance statistics, aspirations, icons and game testing are still required. Read validation.json in the ZIP. Do not put this source ZIP in Mods. No game tuning, icons or game assets are bundled. Android uses the native Save/Share sheet.

Desktop-only **Organizer** includes creator metadata, baseline changes and portable file transfers. The phone cannot scan a computer's folders. Follow the desktop guide for the full verified backup → copy folder → preview → separate review copy workflow. This is not automatic LAN sync, and never overwrites installed Mods.

## Offline notebook and merges

Notebook search covers title, text and linked Sims, with planned/completed filters and pages of 24. Start from a makeover, build, play-session or MySims business brief. Switching notes/tools or leaving a page warns about unfinished edits; drafts are not automatically saved.

Write story notes, makeover briefs and session goals in **Offline notebook**. Export `.simsync-notes` copies for backup or another device. Import the same Hub collection on both devices, edit notebook copies, then use **Merge notebook**. Separate notes merge; conflicting versions of a field are shown for your choice. The merge is file-based, not automatic network synchronization. It does not alter Hub profiles or game saves.

## Family trees and maps in the connected Hub

Family and relationship graphs support drag, pan, zoom and profile selection. Their text lists remain available. On the world map, choose **Touch map** for Leaflet pan/pinch controls and lot selection. **Detailed map** keeps boundary editing, household placement and the other existing planning controls. Map images are references, not renders of your current game.

Desktop 0.7 includes compact offline world images to keep the portable ZIP small. Full-size maps remain available in the connected Hub.

## Local casting assistant

Enable the optional model in **Local casting assistant**, then describe a role. The MiniLM model ranks up to 100 active Sim profiles from their text. The first search downloads a model and a pinned ONNX runtime from Hugging Face/CDN. Profile text and queries are processed locally. Results are suggestions, not verified Sims traits. No characters are edited automatically.

Model downloads, inference speed and memory use still need testing on your phone. This feature is separate from the existing Hub assistant and the desktop Ollama character chat. It does not add voice transcription, screen control or game commands.

## SimRipper model viewer

Use the separate TS4 SimRipper desktop program to export an OBJ and diffuse texture. Select the OBJ, optionally together with one PNG/JPEG, in **3D Sim viewer**. Rotate and zoom locally. Multiple materials and game lighting are not reproduced. SimRipper's extraction engine and game assets are not bundled.

## Android features and testing

Android includes local Workshop screens, a native reference-picture chooser/camera action, file sharing, and a local play-session reminder. Notification permission is requested when setting a reminder. Android battery settings can delay reminders. The full connected Hub still uses its existing authenticated online activity.

This release is built and signed as an update to `com.anubismods.simsync`. Actual installation, permissions, file pickers, shared exports, notifications, full-screen Hub handoff and Android Back need a physical-device test. Current game-patch compatibility of Bridge and Live also remains unverified; this release retains the 0.2.0 game mods.

## Credits

See `OPEN-SOURCE-NOTICES.md` and the packaged `licenses/` directory. The native Android runtime uses Capacitor and AndroidX. All game artwork remains © EA / Maxis. SimSync is an independent fan project.
