{"id":13436876,"url":"https://github.com/garkimasera/rusted-ruins","last_synced_at":"2025-09-07T15:00:31.308Z","repository":{"id":29794302,"uuid":"122794982","full_name":"garkimasera/rusted-ruins","owner":"garkimasera","description":"Extensible open world rogue like game with pixel art. Players can explore the wilderness and ruins.","archived":false,"fork":false,"pushed_at":"2023-04-03T23:40:12.000Z","size":17637,"stargazers_count":499,"open_issues_count":2,"forks_count":31,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-27T20:21:30.836Z","etag":null,"topics":["game","roguelike","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garkimasera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-25T01:19:29.000Z","updated_at":"2024-10-24T14:34:31.000Z","dependencies_parsed_at":"2024-06-19T02:55:21.840Z","dependency_job_id":"5efa21c0-cc3c-4c2d-a622-16bd89938d63","html_url":"https://github.com/garkimasera/rusted-ruins","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garkimasera%2Frusted-ruins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garkimasera%2Frusted-ruins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garkimasera%2Frusted-ruins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garkimasera%2Frusted-ruins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garkimasera","download_url":"https://codeload.github.com/garkimasera/rusted-ruins/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244310657,"owners_count":20432581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","roguelike","rust"],"created_at":"2024-07-31T03:00:52.730Z","updated_at":"2025-09-07T15:00:31.278Z","avatar_url":"https://github.com/garkimasera.png","language":"Rust","funding_links":[],"categories":["Applications","Rust","应用 Applications","应用","应用程序 Applications"],"sub_categories":["Games","游戏 Games","游戏"],"readme":"# Rusted Ruins [![Build Status](https://github.com/garkimasera/rusted-ruins/actions/workflows/ci.yml/badge.svg)](https://github.com/garkimasera/rusted-ruins/actions)\nExtensible open world rogue like game with pixel art. Players can explore the wilderness and ruins.\nThis game is written in Rust.\n\n## Screenshot\nRuin (Example of auto generated map)\n\n![exploring-ruin](https://raw.githubusercontent.com/wiki/garkimasera/rusted-ruins/images/screenshot-exploring-ruin.png)\n\nTown (Example of created map by map-editor)\n\n![town](https://raw.githubusercontent.com/wiki/garkimasera/rusted-ruins/images/screenshot-town.png)\n\n## Video\n\nhttps://youtu.be/t3Fo2ujrYIo\n\n## Manual\n\n[English](https://github.com/garkimasera/rusted-ruins/wiki/Manual),\n[日本語](https://github.com/garkimasera/rusted-ruins/wiki/Manual-Ja)\n\n## Game Objective\n\nThe player arrives at a recently discovered continent where a lot of ruins remain. The player will explore ruins and fight against monsters. By collecting relics in ruins, the player can earn money and fame, and solve the mystery of the ruined nation.\n\n## Status\nThis is a very early project. Many features for playing are not completed.\n\nBinary format of pak files and save files may be changed before version 1.0.\n\n## Changelog\n\n[See this wiki.](https://github.com/garkimasera/rusted-ruins/wiki/Changelog)\n\n## Features\n\n* 2D graphics.\n* Easy to extend by the pak file system. Most of the assets are packaged as pak file. Pak file can be created by makepak. Users can add new characters, items and dungeons easily by pak file system.\n* Map editor to create new map.\n* Script to describe talks and events in game.\n* Open world. Provide many playing style for players. The game objective will be different by players.\n\n### Implemented Features\n\n- Random dungeon generation\n- Item creation\n  - Crafting, Cooking\n- Agriculture\n- Mining\n- Town\n- Home building\n- Wilderness map\n\n### Planned Features\n\n- Allies\n  - Employ NPCs\n  - Livestock\n- Relationships with factions\n- Town economy\n  - Growable economic scale\n  - Effects the amount and quality of goods in shops\n- Various quests\n  - Main quest\n\n## Pak files\nIn this game, most of the image data and many assets are handled as *XXObject*.\nXXObject is packaged to pak files. Their file extension is \"pak\".\nPak files and the sources are under [rusted-ruins-pak](https://github.com/garkimasera/rusted-ruins-pak).\n\n## Precompiled packages\n\nFor Windows user, you can download from [Releases page](https://github.com/garkimasera/rusted-ruins/releases).\nDeb package is also available.\n\n## How to build and try\nPlease install SDL2 libraries at first.  \n\nUbuntu\n```shell\nsudo apt install libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev libsdl2-mixer-dev\n```\n\nFedora\n```shell\nsudo dnf install SDL2-devel.x86_64 SDL2_image-devel.x86_64 SDL2_ttf-devel.x86_64 SDL2_mixer-devel.x86_64\n```\n\nRusted Ruins is written in Rust, so please install Rust compilation tools. You can use [rustup](https://www.rustup.rs/) to install Rust.\n\nAfter that, clone this repository, download pak files, and run.\n\n```shell\ngit clone https://github.com/garkimasera/rusted-ruins.git\ncd rusted-ruins\n./build-pak.sh\nRUSTED_RUINS_ASSETS_DIR=./assets cargo run --release -p rusted-ruins\n```\n\n## How to operate\n\nOperate the player character with the keyboard and mouse.\n\n![how to operate](https://github.com/garkimasera/rusted-ruins/wiki/images/4a56abf8.png)\n\nLeft click on tiles - Move to the tile, melee attack, or start talking.\n\nLeft click + Ctrl - Shoot by the ranged weapon.\n\nLeft click + Shift - Use the equipped tool.\n\nRight click - Open action menu. Actions for specified tile are available through the menu. For example, you can use stairs and enter/exit the map by opening menu at the tile that player is on.\n\nWASD or Arrow key - Move\n\nEnter key - Enter towns or dungeons, walk up/down stairs, and select an answer when talking.\n\n### Sidebar\n\nThere are some icons on the sidebar. Click icons to open windows.\n\nIcon list\n\n* Inventory window\n* Status window\n* Active skill window\n* Creation window\n* Game information window\n* Save / Exit game\n\n### Shortcut keys\n\ne - Eat an item\n\ng - Pick up items\n\nh - Help\n\nq - Drink an item\n\nr - Release an magical device item\n\nv - Drop items\n\n0..9 - Call shortcut registered by player\n\nf1 - Open item window\n\nf2 - Open status window\n\nf3 - Open active skill window\n\nf4 - Open creation window\n\nf5 - Open game info window\n\nf6 / escape - Open exit window\n\nf12 - Debug command\n\n## License\nGPL v3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarkimasera%2Frusted-ruins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarkimasera%2Frusted-ruins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarkimasera%2Frusted-ruins/lists"}