Home

Welcome to the chummer5a wiki! Anyone can edit this!

Installation

Head over to the releases page and download the latest release. Unzip to a folder and run Chummer5.exe. If Windows complains that you do not have the proper version of .NET Framework installed, download and install the .NET Framework 4.8 Redistributable; this will come pre-installed on most modern versions of Windows, so you usually will not need to worry about this step.

Windows' SmartScreen and/or your anti-virus software might warn you that running the program is unsafe and is a generic virus of some kind. This is mainly because the auto-updater part of Chummer5's code does the sort of things that a virus could do: it can silently download files from the internet in the background (new versions of Chummer), silently replace and delete files in the background (replacing older versions of Chummer's files with newer versions), and run executables that were downloaded from the Internet this way (restart Chummer when prompted in order to run the newly downloaded version). As far as we can tell, the program itself is completely safe, and we have even taken extra precautions to prevent the program from unintentionally deleting files that it shouldn't delete. If you wish to audit the auto-updater yourself, you can find almost all of its code here.

Additional Steps under Linux

Using Wine

1. Install wine and all the wine tools. As of July 11th 2018 these are the latest stable versions. Note that Fedora is used in this example if using a Debian based distro such as Ubuntu you'll need to use apt instead of dnf and the package names will be different just make sure that the x86 version of wine-devel is installed and not the default x64.

$ sudo dnf install wine-devel-3.5-1.fc28.i686

$ sudo dnf install wine-common-3.5-1.fc28.noarch

$ sudo dnf install wine-mono-4.7.1-2.fc28.noarch

$ sudo dnf install winetricks-20180603-1.fc28.noarch

2. Create the wine prefix. If you want a custom wine prefix also add WINEPREFIX="/dir/to/prefix", which is generally good practice. You'll also need to add it to all the other commands being run. If this is the first time using wine there will be a handful of popups that show, click install on them. Once winecfg shows up go to 'Libraries', and add override for the mshtml (native) library.

$ WINEARCH=win32 winecfg

3. Install all the dependencies for Chummer. There might be a specific font that's needed instead of allfonts, allfonts is provided in case a change happens resulting in different fonts being loaded that currently aren't used. Due to a recent update in WINE the original implementation of gecko and internet explorer 11 does not seem to work to preview the character sheet, because of this it is recommended to install internet explorer 8 as a workaround.

$ winetricks -q dotnet48 allfonts msls31 ie8

4. Run Chummer. Note that Chummer is significantly slower through wine than it is running natively on Windows.

$ wine Chummer.exe

5. Go to global settings and toggle 'Apply Linux printing fix', as well as change 'Preview uses Internet Explorer version' to 8.

Using Mono

Note: Mono support in Chummer5a has been mostly abandoned. Do not expect Chummer5a to function properly under Mono.

1. You will need to download & install Mono, an open-source implementation of .NET, on which Chummer5a relies.
2. At the commandline, type mono Chummer5.exe
3. Not all elements of Chummer are supported on non-windows platforms. Good luck!
4. Translator doesn't seem to currently run.

macOS support

Using Wine

1. Install Homebrew

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2. Install xquartz using homebrew

$ brew cask install xquartz

3. Check that XCode is up to date. If necessary update it to the latest version through appstore and accept license

$ sudo xcodebuild -license

4. Install wine using homebrew

$ brew install wine

5. Create the wine prefix. If you want a custom wine prefix also add WINEPREFIX="/dir/to/prefix". You'll also need to add it to all the other commands being run. If this is the first time using wine there will be a handful of popups that show, click install on them. Once winecfg shows up close it.

$ WINEARCH=win32 winecfg

6. Install Winetricks

$ brew install Winetricks

7. Install all the dependencies for Chummer. There might be a specific font that's needed instead of allfonts, allfonts is provided in case a change happens resulting in different fonts being loaded that currently aren't used.

$ winetricks -q dotnet48 allfonts

8. Run Chummer. Note that Chummer is significantly slower through wine than it is running natively on Windows.

$ wine Chummer.exe

Known issue : Infotips don't work with wine on macOS and will make the app crash.