Codex is a minimalistic, cross-platform item tracker for randomized games. Built on React and Electron, it allows gamers on any operating system the ability to enjoy their favorite randomized games with ease.
Check the releases tab and download Codex for your operating system.
- Windows: The
exefile will automatically install and launch Codex upon running it. - macOS: Open the
dmgfile and drag Codex to your Applications folder. - Linux: Make the
AppImagefile executable and run it.
There's a couple ways you can get a new game into Codex.
- Open an issue requesting a game you'd like to see added.
- Develop it yourself and open a PR.
To start developing, yarn install and then yarn develop.
Game tracker components are written in React, so an understanding of the React ecosystem is required to create new trackers. Game tracker components are located in the src/renderer/components/Games directory.
- Create a new directory for a specific game (if one does not currently exist).
- Develop your new item tracker component(s) for the game.
- Any assets, such as custom
SCSSfiles orSVGgraphics specific to the game should be nested in the game directory.
- Any assets, such as custom
- Add a new entry in
src/renderer/components/Games/games.jsto register your item tracker(s).
There is a common <Item/> component that can be used that should fit most use cases. Game-specific components should remain scoped to the game.
MIT
Game trademarks and copyrights are properties of their respective owners.