Mneme Cepheus Engine Character Generator (CCG)

A browser-based PWA for generating Cepheus Engine / Mneme characters. Built with Vite, Tailwind CSS, and vanilla JavaScript.

Live demo: https://game-in-the-brain.github.io/ccg-mneme-ce/

---

What it does

CCG produces a complete, rules-faithful CE/Mneme character in seconds:

• Random name and linguistic culture (with optional phonological drift)
• Species selection (Human, Voidborn, Jovian)
• Homeworld and background skills
• Six characteristics (2d6 or custom NdK keep)
• Full career history across all 24 CE SRD / Mneme careers
• Skills, rank, mustering benefits, and final status
• Export as TXT, JSON, or CSV

It is especially useful for GMs who need to generate NPCs in bulk — contacts, allies, rivals, enemies, ship crews, starport crowds, or faction rosters.

---

Quick start

npm install
npm run dev      # http://localhost:8080
npm run build    # production build in dist/
npm test         # run Node test suite

---

Features

• 24 careers — Navy, Marine, Merchant, Drifter, and the full Mneme career set, each with qualification, survival, advancement, and mustering tables.
• Weighted pools — toggle careers and homeworlds off, or bias their selection weight.
• Flexible terms — fixed target, min-max range, or a dice formula (default Mneme: 4d6 keep 3 ÷ 2).
• Cultural names — names are generated from real linguistic profiles via the bundled @gi7b/namegen engine; cultures can drift into each other for hybrid results.
• Bulk generation — generate 1–999 characters at once, navigate the batch, and export everything.
• Presets — save generator settings, import/export them as JSON.
• Editable rules tables — tweak careers, skills, homeworlds, species, and names in-app; validate and export the rules package.
• Documentation view — browsable reference tables for careers, skills, and homeworlds.

---

Project structure

├── app.js                   # main UI controller
├── index.html               # application shell
├── src/
│   ├── engine/              # generator, careers, mustering, names, etc.
│   ├── lib/                 # presets, utilities
│   └── dice.js
├── scripts/
│   ├── build-rules.js       # build public/rules/default.json from jvdb/
│   ├── prepare-namegen.js   # copy namegen data into public/namegen/
│   ├── verify_character.js  # 1k-character verification gate
│   └── bulk_stats.js        # mass generation + statistical report
├── test/                    # Node test suite
├── docs/                    # write-ups and UI test scheme
├── vendor/                  # bundled @gi7b/namegen and @gi7b/shared
└── public/                  # static assets, generated rules, namegen data

---

Verification

# 1k character gate
npm run verify

# Mass bulk run with statistical report
npm run bulk -- --count 10000 --seed myseed

---

License

MIT — see LICENSE.