SDE Patched

A patched EVE Online SDE to work better with EVEShipFit's dogma-engine.

The main goal is to produce a small data-file, with everything included for dogma-engine to calculate fit statistics.

Prerequisite

• Go 1.27 or later
• flatc

Usage

go run ./cmd/sde-patched download        # fetch the latest SDE into sde/
go run ./cmd/sde-patched build           # write dist/sde.dat, dist/names.dat and dist/texts.dat
go run ./cmd/sde-patched compare old/    # tell whether dist/ differs from old/, ignoring the SDE build
go run ./cmd/sde-patched patches         # list all patches
go run ./cmd/sde-patched ids             # give an ID to anything added without one
go run ./cmd/sde-patched explain alignTime
go run ./cmd/sde-patched explain --type "Rifter"
go run ./cmd/sde-patched serve           # edit the patches in a browser

build downloads the SDE when there is none yet, and uses the one on disk otherwise. Use --build <number> to pin a version, --server singularity to use the SDE of the test server, and --major <number> to stamp the major version of the release into sde.dat.

Editing

The patches are best edited via the web-editor (via serve). It allows for full customization of all existing and new attributes.

This editor is fully vibe-coded, and it is very likely no human actually understands how it works. It is also not meant as "production-ready" software, but much more as "an easier way to digest patches".

Output

build writes three flatbuffers, described in specs/:

• dist/sde.dat holds the types, dogma, groups, categories, buffs and mutaplasmids, with English names only. It is all a dogma-engine needs.
• dist/names.dat maps a name in any of the eight languages EVE supports back to a type ID. Only an EFT-fit importer needs it, and only ever to search.
• dist/texts.dat holds text only a user interface shows, like the tooltips of attributes and the bonuses of ships, in English. A dogma-engine never needs it.

npm

npm install @eveshipfit/sde

@eveshipfit/sde ships all three files and the schemas, under dist/ and specs/.

Python

pip install eveshipfit-sde

eveshipfit-sde ships all three files and the schemas, and the paths to them.

from eveshipfit_sde import build_number, names_path, sde_path, specs_path, texts_path

dogma.load_sde_from_file(sde_path())

build_number() reads the SDE build straight off the version.

Releasing

Every day at 12:00 UTC, main is built against the latest SDE. When the result differs from the latest release, the SDE build number and release date aside, a new release is made and published on npm and PyPI. A change to the patches is released this way too.

To preview the SDE of Singularity, run the Release workflow by hand with server set to singularity. It is published on npm only, under the singularity tag.

Patches

The SDE describes what the EVE client needs, not what a fitting tool needs. Align time, for example, is not an attribute; the client works it out. Patches add the missing attributes and effects, so a dogma-engine can work them out instead.

License

All EVE Online data belongs to CCP, and is subject to their license agreement. Everything EVEShip.fit-specific is MIT.