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)

Searching Database…

241 ·GitHub
Wutw-public
Что это такое?Полный публичный релиз игры Worlds Upon The Wind — спокойного роглайт-декбилдера, продающегося в Steam, где вы заново заселяете осколки разрушенного мира. В репозитории лежит весь проект Godot, исходный код и арт-ресурсы.
Этот репозиторий для игроков или для разработчиков?Для разработчиков: игрокам достаточно просто купить игру в Steam, а этот репозиторий — проверенный в реальной разработке образцовый проект: игровая логика на GDScript, расширение для генерации карты на C++, исходники арта и скрипты для сборки и публикации в Steam.
Как его запустить?Установите Godot 4.7, склонируйте репозиторий, затем нажмите Import в Godot Project Manager и выберите wutw-public/wutw/project.godot. Если в консоли видны ошибки, дождитесь окончания импорта и снова откройте проект, после чего нажмите F5, чтобы играть.
Нужно ли ставить что-то ещё, кроме Godot?Нет. C++ GDExtension поставляется в виде готовых сборок для Windows, Linux и MacOS прямо внутри проекта, поэтому достаточно склонировать и импортировать — скрипты сборки нужны, только если вы захотите пересобрать расширение сами.
Игра, запущенная из этого репозитория, играется так же?Почти. Музыка и звуковые эффекты исключены из-за лицензий третьих сторон, поэтому игра идёт без звука, кроме озвученных катсцен; сам код аудиосистемы при этом включён.
На каких системах можно играть и редактировать проект?Windows, Linux и MacOS — и выпущенная игра, и проект для редактора работают на всех трёх, нужные сборки GDExtension лежат в res://bin.
Можно ли использовать код или арт в своих проектах?Да — всё, кроме сторонних библиотек и исключённого аудио, находится в общественном достоянии (CC0). Арт и код можно использовать в коммерческих проектах без указания авторства и даже перевести и продавать игру без отчислений.
Как вообще выглядит игровой процесс?Вы собираете колоды Глифов и отправляетесь в экспедиции по карте осколков; ядро механики — система Эссенций и Слотов. Между забегами есть хаб (Haven) с музеем, навыками, крафтом и сюжетными персонажами.
Насколько длинная игра и сколько в ней контента?Кампания на 20–30 часов, сотни глифов (карт), реликвий, событий и прочего контента. По состоянию на сентябрь 2026 года у игры 99% положительных отзывов в Steam.
Откуда взялся арт в игре?Из исторического японского искусства в общественном достоянии — в основном гравюры укиё-э и живописные свитки э-маки. В игре есть вики по искусству, охватывающая сотни этих гравюр, а в репозитории лежат все исходные файлы PSD и SVG.
Что такое мини-игры для практики японского?Встроенные инструменты для изучения японского: мини-игры для тренировки с тысячами словарных статей и примерами предложений с пояснениями, на основе JMdict, KANJIDIC2, предложений из tatoeba и данных начертаний иероглифов из KanjiVG.
What are similar projects?Pixelorama, 3d-game-shaders-for-beginners, GATE, godogen, awesome-godot, nobodywho, GDevelop, nakama
Which topics is it in?godot-engine, indiedev, glsl, godot, language-learning, japanese, steam, art, localization, gamedev, game-development, game
Creator
max99x
Size
3.1 GB
Stars
241
Updated
CommitOct 17
Age
1mo
Commits · 90 Days