About this project

palschema-hub is a community-driven resource for Palworld modders using PalSchema to patch DataTables. It provides a comprehensive set of 31 JSON Schemas derived from game SDK headers and observed row data, filling a gap in the modding community for a browsable list of table fields. Key features include: - **Schema Registry & Browser**: A searchable, zero-build web interface (GitHub Pages) to browse schemas and current row values for 28 tables (over 41,000 rows). - **Validator CLI (`palschema-validate`)**: A tool that uses ajv to validate mod JSON/JSONC files against the registry. It supports raw table files, pal-loader, and item-loader formats, providing field-level errors and "did-you-mean" suggestions for unknown keys. - **Version Tracking & Migration**: Tracks row-struct changes across Palworld versions (from 0.3.1 to 1.0). The CLI can scan mods for fields removed or renamed between specific game versions to assist in migration. - **Data Provenance**: Schemas are cross-checked between public DataTable dumps and decompiled SDK headers to ensure accuracy in field names and C++ types. - **CI Integration**: Includes example GitHub Actions workflows for mod repositories to automate validation.