Skip to content

peterdn/heartcraft

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Heartcraft

Heartcraft is a cross-platform Daggerheart-compatible character creator and manager. Designed for use on mobile, tablet, and desktop devices, it runs entirely locally: no internet or network access required. It is highly extensible, supporting homebrew content as a first-class feature through importable "compendiums" containing user-provided game data.

⚠️ Content Disclaimer

The Darrington Press Community Gaming License (DPCGL) currently explicitly prohibits non-print digital distribution of SRD game content. Therefore, Heartcraft does not include any Daggerheart SRD or official game data. Users must supply their own content or homebrew compendiums. Distribution of ANY copyrighted material through this app, whether under the DPCGL or otherwise, is strictly prohibited without the express permission of the copyright owner.

Features

Currently in early alpha, Heartcraft supports the following high-level features:

  • Create characters with a step-by-step wizard
  • Import and export characters to/from local files
  • Track character stats, abilities, resources, equipment, inventory, and gold
  • Level-up characters (ℹ️ currently capped to tier 2 / level 4)
  • Import and manage compendiums of user-provided game data
  • Cross-platform - so far tested on:
    • Windows 11
    • Android 7 (Samsung Galaxy Tab S2)
    • Android 15 (Samsung Galaxy S21)
    • Linux (Ubuntu 24.04 LTS)

ℹ️ A sample homebrew compendium is included to showcase these features. Note that this compendium is not balanced nor playtested for actual gameplay, but feel free to use or extend it as you like.

Screenshot Gallery

Home screen showing Create New Character and an existing character, Cecil Pobblepot Resources tab showing evasion, damage thresholds, armor, HP, stress, and hope trackers Manage compendium screen showing homebrew compendiums

Download

Binary releases for Android and Windows x64 can be found under GitHub Releases.

⚠️⚠️⚠️ Please note that these binaries are unsigned and may require bypassing security settings to install (particularly on Android). This is generally NOT a good idea so proceed at your own risk.


Design Philosophy

Aspirational (it's nowhere near there yet!) app tenets include:

  • Powerful and customisable, with sensible defaults: Heartcraft should give power to players who want it, while keeping things simple for those who don't. For example, if a player equips new armour, damage thresholds should automatically update accordingly. If they want to manually adjust them back, they should be able to.
  • Explainable: Heartcraft should provide an explanation for why something is the way it is. For example, a player should be able to see how their damage thresholds were calculated, i.e. how armour and manual adjustments both contributed.
  • Extensible, homebrew-first: every game table has some homebrew. Heartcraft should be able to represent and allow players to use it.
  • Multi-platform support: Heartcraft should be usable and beautiful on any display size, on any device, across all supported operating systems.
  • Free and private: Heartcraft is licensed under the copyleft GNU AGPL, so improvements and contributions can always be shared with the community. The app is designed to run entirely locally on your personal devices and will not include ads.

Roadmap

It's early days for Heartcraft and, as a hobby project, features are prioritised based on what I need at my own game table. These currently include:

  • Finish level-up, i.e. support tier 3 and 4 advancements, including multiclassing
  • Domain card vault
  • Inventory and custom weapons
  • Support for large, tier-depedendent features (e.g. like Druid Beastform)
  • Ability resource/token management (e.g. Prayer dice tracker)
  • Combat wheelchair support
  • iOS & MacOS support (may already work, but I currently do not have the tools nor hardware to build or test for these platforms)
  • ... general UI and UX improvements across the board (currently prioritises "function over form")!
    • Inventory and gold management, and level-up specifically need LOTS of love
    • App icons
  • Character syncing between devices?
    • Would break the "no network access" policy...

Contributing

See CONTRIBUTING.md for project contribution guidelines (under construction).

Specific help would be very much appreciated in the following areas:

  1. Artwork (e.g. app icon, splash screen)
  2. UI / UX design
  3. An "official" Heartcraft homebrew compendium that is balanced and playtested would be cool! To give a more complete "batteries-included" experience.
  4. General feedback!

Getting Started

Heartcraft is built using Flutter and Dart.

Prerequisites

  • Flutter SDK
  • Android SDK (for Android builds)
  • Windows development environment (for Windows builds)

Building and Running

  1. Clone this repository
  2. cd app
  3. Run flutter pub get to install dependencies
  4. Run flutter run to start the app in debug mode

Compendium Data Format

An example compendium is included in the app/assets/data directory: app.heartcraft.homebrew.demo.xml

TODO: Compendium XML specification and documentation.

License

Heartcraft is licensed under the GNU AGPL. See LICENSE for full details.