Athena Crisis is an Open Core video game developed by Nakazawa Tech and published by Null. The source code in this repository is licensed under the MIT License and can be used to improve Athena Crisis, build additional tools, study game development with JavaScript or create entirely new turn-based strategy games.
The single-player campaign, multiplayer, art, music, and content are not open source. You can try a demo at athenacrisis.com and you can wishlist or purchase Athena Crisis on Steam Early Access or buy Athena Crisis directly to experience the full game.
If you like Athena Crisis, please consider a sponsorship to support its development.
![Athena Crisis Gameplay](https://private-user-images.githubusercontent.com/13352/328364786-800717e7-fda9-4265-9e0f-25c6c99326ce.gif?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM5MjY3NDQsIm5iZiI6MTcyMzkyNjQ0NCwicGF0aCI6Ii8xMzM1Mi8zMjgzNjQ3ODYtODAwNzE3ZTctZmRhOS00MjY1LTllMGYtMjVjNmM5OTMyNmNlLmdpZj9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE3VDIwMjcyNFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPThhOTBkMjA4NDU3ZDBjYzIxZTYzODMwY2U4YzQwZDlkMWEzYjRiOGQwMmYyYmNkNTg0M2RjZGUyNDMwYjEzZDImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.mmwLSweXyRnOH-xjmVirCKa0OlZe0SrpdsQP3omuKxI)
Athena Crisis requires Node.js and the latest major version of pnpm
.
Note
Windows Specific Config
Developers on Windows will want to ensure that they are using `bash` to run `package.json` scripts. You can configure npm to use git bash by default with the following:npm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"
pnpm install && pnpm dev:setup
pnpm dev
Visit localhost:3003 to see the docs page.
Check out our Athena Crisis Open Source Docs & Playground site.
The codebase is split into multiple packages to enforce the separation of concerns. We suggest starting with these packages to get an end-to-end overview:
athena
→ Data structures and algorithms for manipulating map state (client/server).apollo
→ Data structures and algorithms for manipulating game state (client/server).hera
→ Game engine and rendering (client).ui
→ Design system (client).docs
→ Docs & Playground (client).
These are secondary packages focused on specific domains:
art
→ Handling of assets (client/build).codegen
→ Runpnpm codegen
when changing gameAction
s orActionResponse
s to generate encoded actions and formatters (build).dionysus
→ AI code (client/server).hephaestus
→ Iterator and Immutable data structures (client/server).hermes
→ Campaign related data structures and algorithms (client/server).i18n
→ Internationalization (client/build).offline
→ Offline splash screen for app (client).tests
→ e2e tests.
We welcome contributions to Athena Crisis. Some feature development is funded via Polar: nkzw-tech/athena-crisis
on Polar. Here are some guidelines to get you started:
- The style guide is enforced through tests and linting. Please run
pnpm test
to run all checks. If they pass, you are good to send a Pull Request. - We suggest adding tests to Pull Requests. You can find many examples in the
tests
folder. - Check out The Perfect Development Environment and Fastest Frontend Tooling for tips on how to optimize your environment setup.
- Join the #tech channel on Discord if you run into issues.
We greatly appreciate contributions in the following areas:
- Bug fixes.
- AI improvements.
- New game features.
- Balancing improvements.
- Experimental technical explorations.
- Tests to cover untested functionality.
- Performance Improvements to core data structures.
- Separation of concerns into smaller libraries that can be published on npm and consumed by other projects.
About 75% of all non-content related Athena Crisis code – almost 100,000 lines – is open source, including the core data structures, algorithms, game engine, rendering, AI, and the map editor. Backend implementations such as user management, databases, APIs, realtime spectating, server configuration, and app wrappers for Steam or app stores are not open source. We aim to open source more of the game over time, but the content will remain the intellectual property of Nakazawa Tech KK and therefore not be open source. You can buy and experience Athena Crisis on Steam Early Access or buy it on athenacrisis.com.
Nakazawa Tech is an Open Core company. See the "Athena Crisis is now Open Source" blog post for more information.
We use a monorepo for Athena Crisis at Nakazawa Tech and are syncing a portion of the codebase to this repository. Code merged into this open-source repository is automatically synced to the internal monorepo, and vice versa. Athena Crisis always runs the latest version of code from this repository in production.
To simplify dependency management with pnpm
, most of the internal package.json
files and the pnpm-lock.yaml
are public. This makes it easier to share code between the internal monorepo and this repository but leaves some placeholders in this repository, most notably the ares
and artemis
packages, which can be ignored.
Why not!? At some point it became necessary to split the codebase into multiple packages to share code between the client and server. The first package was named athena
, and it was hard to come up with meaningful names for the other packages. We decided to name them after Greek gods because it seemed cute.
Over time, many pieces will be extracted into separate packages and published on npm under the @nkzw
organization. Please move it to a packages
folder and send a Pull Request if you find code that should be extracted into a separate package.
Assets are not part of this codebase and are not open source. Art and other assets are loaded remotely from the Athena Crisis servers for testing and development. If you want to build your own game based on Athena Crisis, you can use the code as a starting point and replace the assets with your own.
Yes, you can. However, any content such as art, music, story, characters and their descriptions are not open source and are the intellectual property of Nakazawa Tech KK. You can use the codebase to build your own game, but you must replace all content with your own. For example, you have to replace all references to assets in Images.tsx
or change character descriptions in Unit.tsx
if you want to publish your own game.
If you'd like to use content from Athena Crisis for commercial or non-commercial purposes, you must obtain a license from Nakazawa Tech KK by emailing [email protected].
Check out these links to learn more about the tech behind Athena Crisis:
- Join us on Discord
- How NOT to Build a Video Game
- Follow Athena Crisis on Twitter
- Building the AI for Athena Crisis
- Athena Crisis Open Source Docs & Playground
![Athena Crisis Keyart](./offline/keyart.jpg)