How to Contribute

Lineage 2 API is an open-source fan project, and contributions are welcome.

Good things to contribute

• Data correctness fixes — wrong stats, names, drops, etc.
• Parser fixes — improvements to how the datapack is read
• DTO improvements that don’t break existing responses
• Documentation improvements
• Bug reports with real Lineage 2 examples (an item id, an NPC, a drop)

The generated JSON under data/generated/interlude is built from the datapack — don’t edit it by hand. Fix the parser or source instead, then regenerate.

Local setup

pnpm install
pnpm dev

The API runs at http://localhost:3000:

curl http://localhost:3000/api/interlude/items/57

Regenerate the data

pnpm build:data

This reads a local aCis Interlude datapack (configured in scripts/chronicle-sources.ts) and optional client DAT files. Neither is redistributed; after regenerating, the JSON diff is reviewed in the PR alongside any parser changes.

Checks

Before opening a PR:

pnpm lint
pnpm typecheck
pnpm test

PRs welcome on GitHub.