wutw-public README

The project's README from github.com/max99x/wutw-public. As one markdown file: README.md.

Worlds Upon The Wind

Steam Page Discord License: CC0

This is the public domain release of Worlds Upon The Wind, a peaceful roguelite deckbuilder available on Steam.

Screenshot

Worlds Upon The Wind is a peaceful roguelite deckbuilder where you resettle the shards of a shattered world. Its art is based on public domain historical Japanese art, mainly ukiyo-e woodblock prints and e-maki (picture scrolls).

The game has a 20-30 hour long campaign, as well as hundreds of glyphs (cards), relics, events, and other content. It also includes an extensive art wiki of hundreds of public domain woodblock prints and scrolls, and integrated Japanese practice minigames with thousands of vocabulary entries and annotated example sentences. It is available on Windows, Linux, and MacOS. As of Sep 2026, it has a 99% positive rating on Steam.

The primary goal of this repository is to provide a complete, production-tested reference for other indie developers.

What's Included

IMPORTANT: AUDIO EXCLUDED

Due to third-party licensing restrictions, all music and sound effects are excluded. When running the game from this repository, it will play silently except for voiced cutscenes.

Running the Project

The project can be edited on Windows, Linux, or MacOS.

  1. Install Godot 4.7.
  2. Clone this repository:
    git clone https://github.com/max99x/wutw-public
    
  3. From the Godot Project Manager, click Import and select wutw-public/wutw/project.godot.
  4. If you see console errors, wait until all data is imported and reopen the project.
  5. Press F5 to run the project.

Project Architecture

The game is made in Godot 4 and uses GDScript for the majority of its logic. A few performance-critical parts, such as the map generator, are written in C++ as a GDExtension. Most of the visuals use Godot's standard GLSL shaders. Some automation code is in Bash and Python. The game makes heavy use of Resource subclasses for all game elements such as cards, relics, skills, characters, quests, linkable gameplay terms, and many more.

The code is intentionally kept as simple as possible while supporting efficient content creation and being robust enough for a commercial release. Here's an overview of what's included:

Contributing

This is a read-only mirror, so I am unable to merge pull requests. However, I am open to manually accepting significant contributions.

Additionally, while the game is set up for localization, it is not currently localized due to the sheer amount of text (230k+ words, 800+ pages, though about a third is Japanese learning materials). If you are interested in contributing to translation, let me know.

Maintenance

This mirror is updated along with the official Steam release.

License

Except for the third-party libraries and data mentioned below and the excluded audio, the entire game is released into the public domain. Feel free to reuse any art or code, including within commercial projects, without attribution.

You are even welcome to translate and sell the game without any royalties, though attribution is appreciated.

Third Party Licenses

wutw-public (max99x/wutw-public)

glsl
Searching Database…

What is this?The complete public domain release of Worlds Upon The Wind, a peaceful roguelite deckbuilder sold on Steam, where you resettle the shards of a shattered world. The repo contains the full Godot project, source code, and art assets.
Is this repository meant for players or for developers?For developers: players can simply buy the game on Steam, while this repo is a production-tested reference project — GDScript game logic, a C++ map-generation extension, source art, and the scripts that build and publish to Steam.
How do I get it running?Install Godot 4.7, clone the repo, then click Import in the Godot Project Manager and select wutw-public/wutw/project.godot. If the console shows errors, wait for the import to finish and reopen the project, then press F5 to play.
Do I need to install anything besides Godot?No. The C++ GDExtension ships as prebuilt Windows, Linux, and MacOS binaries inside the project, so cloning and importing is enough — build scripts are only needed if you want to recompile the extension yourself.
Does the game play the same when run from this repo?Almost. Music and sound effects are excluded due to third-party licensing, so the game plays silently except for voiced cutscenes; the audio-system code itself is still included.
Which systems can run and edit it?Windows, Linux, and MacOS — both the released game and the editor project work on all three, with matching GDExtension binaries bundled in res://bin.
Can I reuse the code or art in my own projects?Yes — except for third-party libraries and the excluded audio, everything is public domain (CC0). You can reuse art or code in commercial projects without attribution, and even translate and sell the game royalty-free.
What does the gameplay actually look like?You build decks of Glyphs and go on expeditions across a shard map, with the Essences and Slots system as the core mechanic. Between runs there is a hub (Haven) with a museum, skills, crafting, and story characters.
How long is the game and how much content is in it?A 20-30 hour campaign with hundreds of glyphs (cards), relics, events, and other content. As of September 2026 it holds a 99% positive rating on Steam.
Where does the game's art come from?Public domain historical Japanese art, mainly ukiyo-e woodblock prints and e-maki picture scrolls. The game includes an art wiki covering hundreds of these prints, and the repo ships the full PSD and SVG source files.
What are the Japanese practice minigames?Built-in Japanese study tools: practice minigames with thousands of vocabulary entries and annotated example sentences, backed by JMdict, KANJIDIC2, tatoeba sentences, and KanjiVG stroke data.
Creator
max99x
Size
3.1 GB
Stars
241
Updated
CommitOct 17
Age
1mo
Commits · 90 Days