Skip to content

chummer5a/chummer5a

Repository files navigation

Chummer 5

Github Latest Release Date GitHub Issues Build status Discord License Donations

Basic Overview

Chummer is a character creation and management application for the tabletop RPG Shadowrun, Fifth Edition running on Windows. Not only can you create your character quickly and easily, but you can also use Chummer during your character's shadowrunning career, to accurately track your Karma, Nuyen, ammo, and everything else all in one place. Chummer also includes support for a number of optional rules and house rules and even includes support for critters and is useful for players and Game Masters alike! It also supports a number of languages: supports multiple languages: English (US), French, German, Japanese, Portuguese (Brazil) and Chinese (Simplified) files are pre-installed, while additional languages can be added and shared through use of our in-house translator tool.

Requirements

Operating System .NET Framework
Windows 7 SP1 or 8.1+ 4.8+

Installation - Windows

Chummer uses a single tree release strategy with two release channels; Milestone and Nightly.

  • Milestone releases are a fixed-point for use by living communities and people that prefer not to update their application regularly. These releases are considered to be stable and are recommended for general use.
  • Nightly releases are an automated build created with Appveyor at 0000 UTC daily. These releases are more likely to be unstable, but also receive new features and bugfixes faster than the Milestone releases. These are recommended for users that have a specific issue from Milestone that was resolved in Nightly, or are comfortable with testing features.
  1. Download the archive for your preferred update channel Milestone or Nightly (Select the latest Nightly tag)
  2. Extract to preferred folder location. If upgrading, you can extract over the top of an existing folder path.
  3. Run Chummer5.exe.

Installation - Linux and OSX

As Chummer is a WinForms application, support for other operating systems is limited. For Linux, macOS, and Chrome OS, Chummer can be run through one of three possible ways:

  1. Set up and run Wine, an open-source Windows compatibility layer. This is usually not for the faint-of-heart, especially on Chrome OS, but it is completely free. Some details about the steps necessary to run Chummer5a under Wine can be found on the wiki. Note that even after you set up Chummer5a to run on Wine, Wine is not perfect and you will encounter some additional bugs while using Chummer5a that you wouldn't run into under Windows.
  2. Set up and run CrossOver, a hassle-free version of Wine with commercial support. It costs money (though it has a limited free trial), but what you are effectively purchasing is for someone else to do all the hard work setting up Wine for you, no matter what you want to run on it. If you do not want to mess around with technical stuff, we highly recommend using CrossOver.
  3. Set up and run a Windows virtual machine through programs like VirtualBox, VMWare Fusion, or Parallels. You will need a valid copy of Windows and lots of disk space, but Chummer5a will run on a Windows virtual machine exactly how it would run under full Windows. Virtual machine hosts are generally not available for Chrome OS, though with some behind-the-scenes tinkering, it can still be possible to run a Windows virtual machine on Chrome OS.

Contributing

Please take a look at our contributing guidelines if you're interested in helping!

History

This project is a continuation of work on the original Chummer projects for Shadowrun 4th and 5th editions, developed by Keith Rudolph and Adam Schmidt. Due to the closure of code.google.com, github repositories of their code have been created as a marker of their work. Please note, Chummer 4 is considered abandonware and is not maintained by the chummer5a team, and exists solely for historical purposes.

Sponsors

  • JetBrains have been kind enough to provide our development team with licences for their excellent tools: