# SimSync Workshop integrations

This release includes these open-source components and bounded adaptations. Their licenses are included with the distribution.

- TS4MM (MIT, Maurice René Steenborg), commit 716a38e4e2abc3ee19deafdd7dc9f2e1195f6a0c: Tray filenames and metadata layout adapted to TypeScript with stricter bounds. `ErrorLogAnalyzer.cs` informed report-tag, traceback and grouping adaptations in `lib/sims/diagnostics.ts`. `BisectSession.cs` informed the original manual 50/50 planning workflow. SimSync uses cautious clue labels, bounded inputs and text-only reports; it does not port automatic file moves. https://github.com/TrollingDEAD/The-Sims-4-Mod-Manager-TS4MM
- Harbor (MIT), commit c363124fcf4f3c059a838a1d93da9374905944b1: Tray image wrapper decoding and unambiguous cover matching adapted to TypeScript. https://github.com/Harborofficial/Harbor
- TrayTrim (MIT), commit f4031ed6f8b5921fa5973d3e7d77a16f924b076e: household outfit schema and resource-reference parsing adapted to TypeScript/JavaScript. https://github.com/stixez/TrayTrim
- Dexie (Apache-2.0): local IndexedDB storage. https://github.com/dexie/Dexie.js
- Automerge (MIT): mergeable planning notebook. https://github.com/automerge/automerge
- Cytoscape.js (MIT): family and relationship graphs. https://github.com/cytoscape/cytoscape.js
- Leaflet (BSD-2-Clause): touch world maps. https://github.com/Leaflet/Leaflet
- tus-js-client (MIT): resumable upload transport, using SimSync's existing private multipart storage. https://github.com/tus/tus-js-client
- Transformers.js (Apache-2.0): optional device-local inference. Models are separately licensed and downloaded only after an explicit choice. https://github.com/huggingface/transformers.js
- Capacitor (MIT) and official plugins: Android app runtime and native capabilities. https://github.com/ionic-team/capacitor
- Three.js (MIT): local OBJ viewing. https://github.com/mrdoob/three.js

## SimRipper interoperability

TS4 SimRipper is a separate GPL-3.0 application. SimSync can view user-selected OBJ exports. SimRipper source, executable, .NET runtime, game meshes and game assets are not bundled. This does not reproduce the SimRipper extraction engine. Run SimRipper on your game computer and import its exported files. https://github.com/CmarNYC-Tools/TS4SimRipper

## Limits

Tray grouping follows exact creation and Sim IDs. Missing support files are reported. Outfit references are not a complete list of gameplay dependencies. Resources absent from a scanned Mods inventory are unresolved, because base-game and pack resources have not been indexed. No automatic deletion, game-file editing, or redistribution of creators' CC is performed. World art and user-provided game assets retain their own rights and are not covered by these software licenses.

## New bounded adaptations

- sims4modorganizer, MIT, Copyright (c) 2024 subtervisor, commit 6a09f630a5da9690cee88d3831924d91f2d29e38. Metadata fields and verify_files path-set comparison from src/commands/util.rs adapted in desktop organizer/ledger.mjs. SimSync retains full relative paths and SHA-256 instead of upstream xxh3_64. Baseline acceptance is explicit and separate from metadata edits. https://github.com/subtervisor/sims4modorganizer
- HistorianCareer, MIT, Copyright (c) 2026 HistorianCareer contributors, commit 0f7a35a355bd97e51262b0b790401684c1157182. CareerTrack/CareerLevel structure and Build/s4tk-builder/resolve-names.mjs adapted in lib/sims/career-builder.ts. Only source templates and reference resolution are included; no SimData generator, compiled mod, EA descriptors or art. Generated source ZIPs include the MIT license. https://github.com/derneuere/HistorianCareer
- SyncCrate, MIT, Copyright (c) 2026 stixe, commit b25de43be5564849b0203b7c7d86468352c776bd. sync/diff.rs comparison, case/disabled-name handling and reviewed-plan checks adapted in desktop organizer/transfer.mjs. SimSync uses its own verified backup format and separate-copy workflow. No LAN/network service, native SyncCrate archive importer or in-place replacement is included. https://github.com/stixez/SyncCrate

Full license texts are in licenses/ and the downloadable third-party license ZIP. These adaptations do not bundle the complete upstream applications. Metadata versions are manual; hash equality is not game compatibility. Career exports are experimental source only. Transfer copies never modify installed Mods.

## Research directory

Other listed projects can remain separate tools or candidates. TS4 VanillaLogs has differing source/package terms. Sims4 Save Manager and sims4-mod-detector remain license-review references only, with no source copied. Check each directory entry for the actual integration state.

## Expanded Tray schema references

LlamaLogic, MIT, commit 4a3d576f0afb776aba783db561760afb5b5de8b7: Exchange.cs, Sims.cs, FileSerialization.cs and SimObjectAttributes.cs establish the Tray metadata, saved display strings and householdbinary field layouts used in the expanded reader. No game assets or LlamaLogic executable is included. Full terms are in licenses/LlamaLogic.txt. TrayTrim's pinned MIT metadata parser also informed the lot/room field reads. https://github.com/Llama-Logic/LlamaLogic

EA Gallery actions open EA's official website. SimSync's Gallery companion stores user-entered source links and planning records, and imports user-selected Library files. It does not scrape listings, connect an EA account, or download Gallery items/CC automatically.
