Repository files navigation

Copyright (c) 2003-2025 by Kronosaur Productions, LLC.

https://transcendence.kronosaur.com

transcendence@kronosaur.com

This repo contains the source code for building the Transcendence.exe client,which is used to run any Transcendence adventure, includingStars of the Pilgrimfrom theDomina & Oracus saga.

Note that there are several other repositories that are relevant to thisproject but are not necessary for building it from scratch.

Art Assets:TransArt

Official community content and tools:Registered Developer Github Organization

You can choose to clone this repo with git and built from source, or downloada prebuilt binary.

Prebuilt binaries can be obtained from Kronosaur Productions for free. Theseversions are able to access the Kronosaur Multiverse, and download expansionsand mods from the Multiverse.

Kronosaur Multiverse

This is the latest stable version of the game.

Latest Stable Release

These are alpha/beta/release candidate releases. If none is available, the downloadwill simply provide the latest stable version of the game.

Latest Alpha/Beta Release

Transdata is a tool for performing various functionality such as decompiling.tdb files, running diagnostics, running stats/balance tools, and runningtlisp scripts

Latest Transdata Release

Summarized changelogs are available in the appropriate version's announcementthread on the Kronosaur Productions forums.

Announcement Forum

You may build your own copies of the game from source. These versions will nothave the code to access the Kronosaur Multiverse however, but you can stilluse one of the Kronosaur-provided binaries in order to

If you are downloading the repos in order to submit future pull requests, it isworthwhile to keep repositories synced with kronosaur:

How to sync a fork on github

General help on using git is available through official sources:

Github

You will need to install the February 2010 DirectX SDK release, as later versionsdo not include necessary libraries. The correct DirectX SDK can be downloadedhere:

Archive.org - 2010 DirectX SDK

Note the DirectX SDK's install location on your computer.

It may be necessary to uninstall certain Microsoft Visual C++ Redistributableswhen installing DirectX SDKs:

MSVC++ Redistributable Requirements

Use Microsoft Visual Studio 2019 or later. OpenFile > Open > Project/Solution<Repo Root>/Transcendence/Transcendence.sln, which is the Transcendencesolution file. The following warnings, if shown underOutput from Solution,may be safely ignored:

    <Repo Root>\Alchemy\zlib-1.2.7\contrib\vstudio\vc10\zlibstat.vcxproj :     warning  : Platform 'Itanium' referenced in the project file 'zlibstat'     cannot be found.    <Repo Root>\TransCore\TransCore.vcxproj : error  : Project     "...\TransCore\TransCore.vcxproj" could not be found.

Then go toView>Solution Explorer and check the pane opened to the right side.Right clickTranscendence and selectSet as Startup Project.Transcendenceshould now be bolded in the Solution Explorer.

Ensure that the correct locations of the DirectX SDK Include and Lib foldersare specified for the Transcendence project (under the Transcendence solution)by right clickingTranscendence and selectingProperties to open theproject's Properties page, and checking the following property sets:

Configuration Properties > VC++ Directories > General > Include DirectoriesConfiguration Properties > VC++ Directories > General > Library Directories

Always point the Library Directories variable to the \Lib\x86 folder of the SDK.

In the second from the top ribbon, there is aDebug dropdown. SelectDebug for Contributors and change the dropdown next to it fromAny CPU toWin32.Build the solution. Executables will be placed in the Transcendence/Gamedirectory. These can be viewed from the file system.

Now the game can optionally be launched from Visual Studio with theLocal Windows Debugger in the second from the top ribbon.

For security reasons the source code does not include certain files tocommunicate with the Hexarc arcology (the cloud service). The code will compilewithout it, however, as long as you add CHexarcServiceStub.cpp to the build.

In Visual Studio, selecting the "Debug For Contributors" configuration willbuild the game with CHexarcServiceStub.cpp.

Please see the contribution guidelines for information about best practices andstyle guides.

General Contribution Guidelines

Style & Contribution Guidelines:

• C++ Style Guide
• TLisp Style Guide
• XML Style Guide
• Markdown (Documentation) Style Guide
• In-game Text Style Guide
• Asset Style Guide

Please submit pull requests against the appropriate branch - if you have made anAPI change, ensure that your pull request is against the appropriate API branch.For example, if you add a new tlisp function or a new XML attribute field, thiswould be considered a new API version, and you should use the appropriateintegration/API## branch as the merge target, whereAPI## is the next highestAPI number after the current API version in the alpha/beta branches.

If your Pull Request is not ready for merge, please mark it as a draft, this willreduce unnecessary confusion when reviewing pull requests.

It is recommended to split up multiple unrelated (or extremely large)changes into multiple PRs to make it easier to review. We have a limited amountof time each week to review PRs, so oversized PRs may take multiple weeks toreview or outright rejected as too big to review.

To enable whitesmith indentation style in Visual Studio, openTools > Options:

Then selectText Editor > C/C++ > Tabs and ensure that:

Tab size = 4Indent size = 4Keep Tabs = True

Then selectText Editor > C/C++ > Code Style > Formatting > Indentation andensure that:

Indent braces = TrueIndent each line relatively to = `Innermost paranthesis`Within parenthesis, align new lines when I type them = `Indent new lines`Indent case contents = TrueIndent braces following a case statement = TrueIndent braces of lambdas = True

Then selectText Editor > C/C++ > Code Style > Formatting > Spacing and ensurethat:

`Spacing for operators > Pointer/reference Alignment > Leave unchanged` = True

If you find additional settings that should be changed to provide for an easierediting experience, please update this readme with them.

Official Website

Forums

Discord

Kronosaur Productions License