Ecryme (FoundryVTT) — agent notes

This is a FoundryVTT Game System (not a module), id fvtt-ecryme. Compatible with Foundry v13–v14. Requires babele and lib-wrapper.

Quick commands

Command	What
`npm run build`	Compile `styles/ecryme.less` → `css/ecryme.css` via Gulp
`npm run watch`	Watch `styles/*/.less` and rebuild

No other npm scripts exist. No tests, no linter, no typechecker, no TypeScript. Pure JS ES modules, no bundling.

Project structure

modules/          # JS source (loaded directly by Foundry, no build step)
  ecryme-main.js  # Entry point — registers documents, sheets, hooks, templates
  actors/         # Actor document + sheet classes (pc, npc, annency)
  items/          # Item document + sheet classes (equipment, weapon, trait, spec, maneuver)
  models/         # Foundry DataModels (extends TypeDataModel) — schema definitions
  dialogs/        # Roll/confrontation dialog classes
  app/            # Combat, commands, hotbar, summary app
  common/         # Config constants + utility helpers (798-line utility)
templates/        # Handlebars sheets (actors/, items/, chat/, dialogs/)
styles/           # LESS source files (ecryme.less imports all partials)
lang/             # fr.json, en.json localization
packs/            # LevelDB compendium packs (specialisation, equipment, traits, scenes, maneuvers, help)
translated/fr/    # Babele translation JSON files for compendium content
images/           # Assets, icons, UI
css/              # Compiled CSS output (committed despite being in .gitignore)

Architecture

App v1 sheets (foundry.appv1.sheets.ActorSheet/ItemSheet), not ApplicationV2
DataModels replace the deprecated template.json (kept as template.json.SAVED)
- Actor types: pc, npc, annency
- Item types: equipment, weapon, trait, specialization, maneuver
ES module imports use relative paths with .js extension
Custom combat class extends Combat with its own initiative formula
Socket enabled ("socket": true in system.json)

Conventions (verified from codebase)

JS files: kebab-case (ecryme-actor.js)
Classes: PascalCase (EcrymeActor)
Templates: kebab-case .hbs (actor-sheet.hbs)
Barrel files: _module.js
Hooks: init → register classes/sheets/templates; ready → welcome msg/scene import; babele.init → register translation dir

Release

Gitea CI (.gitea/workflows/release.yaml) triggers on published release. Zips the source tree directly — JS is used as-is, no build step for JS. CSS must be pre-compiled before release.

2.6 KiB Raw Blame History Unescape Escape