# Palpedia Palworld 1.0 catalog

Palpedia ships a **complete, version-pinned local Paldeck**: 287 unique player-facing records for Palworld 1.0.0 build 1.100.427, retrieved and generated on 2026-07-13. This is a local browser dataset; it does not download data, portraits, icons, models, maps, or runtime code from third parties.

## Provenance and canonical rule

- Official release context: [Pocketpair's Palworld 1.0 announcement](https://www.pocketpair.jp/game-news/%E3%80%8E%E3%83%91%E3%83%AB%E3%83%AF%E3%83%BC%E3%83%AB%E3%83%89%EF%BC%9A1-0%E3%80%8F%E6%AD%A3%E5%BC%8F%E7%89%88%E3%80%81%E6%9C%AC%E6%97%A5%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%EF%BC%81/), released 2026-07-10.
- Primary factual source: [PalCalc](https://github.com/tylercamp/palcalc), MIT repository, commit `a6dc6665c66ce65d38dcf727e4be8136d11721c5`, database `v26`.
  - Input URL: `https://raw.githubusercontent.com/tylercamp/palcalc/a6dc6665c66ce65d38dcf727e4be8136d11721c5/PalCalc.Model/db.json`
  - Retrieved input SHA-256: `803d891afdb18bd00e24332844a7276bbe5c0855170ef90ef142f2f4d7698ed1`
- Element cross-check: [Palworld.gg Pals](https://palworld.gg/pals), retrieved 2026-07-13, SHA-256 `67e54a5fb4046dd0f798344186f4702fedc2ca344a34166f98be70f76248f3e1`.
  - Only Paldeck IDs and nine element labels were used. No page text, images, icons, models, map data, or other assets are copied.

The deterministic rule is `Id.PalDexNo < 10000`, excluding only `InternalName === "PlantSlime_Flower"`. That source row is a duplicate displayed **Gumoss** record with no distinct Paldeck name/card in the element cross-check roster. The result is 287 unique display IDs and names. Terraria crossover entities use `PalDexNo >= 10000` and are excluded by the same rule.

## Files and update workflow

- `core/palworld-1.0-catalog.json` — generated factual core: ID, name, elements, base stats, movement, and Work Suitability.
- `manifests/` — source manifests, asset inventories, and companion locks used to pin generated and local inputs.
- `snapshots/` — versioned factual/detail snapshots used as stable build inputs.
- `registries/` — browser registries for optional profile models and derived Structure metadata.
- `capture/` — local Capture Lab datasets and formula configuration.
- `core/` — canonical Palpedia factual catalog used by builders and validators.
- `catalogs/` — generated browser/runtime catalogs. Do not hand-edit these files.
- `snapshots/palpedia-legacy-details.json` — pre-import local descriptions, drops, partner skills, and active skills preserved only where the factual source does not provide them.
- `catalogs/palpedia-catalog.js` — browser-compatible generated presentation catalog. Do not hand-edit it.
- `../scripts/import/import-palworld-1.0.js` — deterministic importer/integrity checker.

To recreate a reviewed update from downloaded source files:

```powershell
node scripts/import/import-palworld-1.0.js --bootstrap --palcalc <palcalc-db.json> --elements-page <palworldgg-pals.html> --write
node scripts/import/import-palworld-1.0.js --verify
node scripts/validate/validate-data.js
```

Run the complete local validation suite, including structure and companion-source checks, with:

```powershell
node scripts/validate/validate-all.mjs
```

The bootstrap refuses any count other than 287 after the documented predicate. It also records the input hashes in `core/palworld-1.0-catalog.json`. `--verify` proves that `catalogs/palpedia-catalog.js` exactly matches the versioned factual catalog plus the preserved local detail snapshot.

## Portrait boundary

Only pre-existing local files under `Pal/` may be rendered as portraits. Every imported record records `portraitAvailable`; absent files render an explicit **No portrait** fallback, never a third-party image URL or a broken image request.

## Work Suitability

The UI supports levels **1–10**. The pinned v1.0 source records currently observe levels 1–8; levels 9–10 remain available in the control so a subsequent verified update does not require a UI schema change.

## Palworld Official Card Game snapshot

The TCG Explorer uses a local English snapshot retrieved from the official
[Palworld Official Card Game card list](https://en.palworld-official-cardgame.com/cardlist/).
The snapshot contains 242 card records across `EBP01`, `ETD01`, `ETD02`, and
`PR2026`, plus the official search masters, product metadata, card artwork,
element symbols, and card-text icons.

- `catalogs/palworld-tcg-catalog.json` — normalized list and detail API responses, official filter masters, source URLs, local asset paths, byte counts, and SHA-256 hashes.
- `palworld-tcg/` — local card images, product thumbnails, element symbols, and card-text icons.
- `../scripts/import/import-palworld-tcg.mjs` — refreshes the snapshot from the official public card-list endpoints and verifies every local asset.

Refresh and verify the snapshot with:

```powershell
node scripts/import/import-palworld-tcg.mjs --write
node scripts/import/import-palworld-tcg.mjs --verify
```

Card numbers are unique only within an expansion. Runtime identity and validation
therefore use the official numeric ID and the `expansion + card_number` pair.
Palworld and all related card artwork remain the property of their respective
owners.