{"id":23439836,"url":"https://github.com/jacob-walton/rpg","last_synced_at":"2025-08-26T03:30:35.451Z","repository":{"id":267375007,"uuid":"900993558","full_name":"Jacob-Walton/rpg","owner":"Jacob-Walton","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-12T02:16:51.000Z","size":11530,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-12T03:20:05.751Z","etag":null,"topics":["csharp-app","csharp-game","text-based","text-based-game","text-based-rpg"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jacob-Walton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2024-12-09T21:06:04.000Z","updated_at":"2024-12-10T18:17:21.000Z","dependencies_parsed_at":"2024-12-10T01:26:32.768Z","dependency_job_id":"70b0fe0b-aca8-4bb7-be7c-641b2321341d","html_url":"https://github.com/Jacob-Walton/rpg","commit_stats":null,"previous_names":["beans69584/rpg","jacob-walton/rpg"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jacob-Walton%2Frpg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jacob-Walton%2Frpg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jacob-Walton%2Frpg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jacob-Walton%2Frpg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jacob-Walton","download_url":"https://codeload.github.com/Jacob-Walton/rpg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230983961,"owners_count":18310762,"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":["csharp-app","csharp-game","text-based","text-based-game","text-based-rpg"],"created_at":"2024-12-23T15:37:08.353Z","updated_at":"2024-12-23T15:37:09.116Z","avatar_url":"https://github.com/Jacob-Walton.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Text RPG\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![.NET](https://img.shields.io/badge/.NET-9.0-512BD4)](https://dotnet.microsoft.com/download)\n[![Status](https://img.shields.io/badge/Status-Proof%20of%20Concept-orange)]()\n[![Development](https://img.shields.io/badge/Development-Halted-red)]()\n\n---\n\u003e **Note:** This project was developed for my college assignment. It is not intended for production use. The project is currently on hold and may not be actively maintained. Feel free to use the code for educational purposes or as a starting point for your own projects.\n\nA command-line RPG game written in C# featuring character creation, turn-based combat, and a dialogue system. Currently in early development.\n\n## Implemented Features\n\n- **Character System**\n  - Choice of classes: Warrior, Barbarian, Paladin, Sorcerer, Conjurer\n  - Customisable attributes (Strength, Dexterity, Constitution, Intelligence, Wisdom, Charisma)\n  - Basic class-specific abilities\n  - Currently limited progression system\n\n- **World Navigation**\n  - Travel between regions and locations\n  - Basic building exploration\n  - NPC interactions\n  - Currently lacking environmental descriptions and detailed world-building\n\n- **Combat System**\n  - Turn-based combat with basic actions (Attack, Defend, Use Items, Flee)\n  - Simple enemy AI\n  - Limited item system\n  - Combat balancing needs work\n\n- **Save System**\n  - Manual saves with multiple slots\n  - Autosave functionality\n  - Save file backups\n  - Currently missing save file compression\n\n## Known Limitations\n\n- Limited content (NPCs, quests, items)\n- Basic dialogue system lacking branching conversations\n- Minimal character progression\n- Simple combat mechanics\n- Limited world interaction options\n- Needs more extensive error handling\n\n## Requirements\n\n- .NET 9.0\n- Windows/Linux/macOS compatible\n- Terminal with UTF-8 support recommended\n\n## Building\n\nTo build the project:\n\n1. Clone the repository\n2. Ensure you have .NET 9.0 SDK installed\n3. Run `dotnet build` in the project directory\n\n## Running\n\n```bash\ndotnet run\n```\n\n## Project Structure\n\n### RPG/src/ (Main Project)\n\n- `Combat/` - Combat system implementation\n- `Commands/` - Game command handlers\n- `Core/` - Core game systems and state management\n- `Player/` - Player character classes and attributes\n- `Save/` - Save system implementation\n- `UI/` - Console interface and window management\n- `Utils/` - Utility classes and helpers\n- `World/` - World data structures and loading\n- `Resources/` - Game resources and localisation\n\n### RPG.WorldBuilder/ (World Building Tool)\n\n- `Data/` - World definition data\n  - `worlds/` - World template files\n  - `npcs/` - NPC definitions\n  - `items/` - Item definitions\n  - `regions/` - Region definitions\n  - `dialogues/` - Dialogue tree definitions\n  - `quests/` - Quest definitions\n\n## Contributing\n\nThis is a learning project but contributions are welcome. The project currently needs:\n\n### Priority Areas\n\n- More comprehensive documentation\n- Additional unit tests\n- Code cleanup and optimisation\n- Content creation tools\n- Better error handling\n- Expanded world content\n\n### Getting Started\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n### Coding Standards\n\n- Follow existing C# code style and conventions\n- Include XML documentation comments for public members\n- Add unit tests for new functionality\n- Update relevant documentation\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Disclaimer\n\nThis is an early development project created primarily for learning purposes. Many features are incomplete or in a proof-of-concept state. The code may contain bugs and security issues. Use at your own risk.\n\nThe focus is currently on establishing core systems rather than content. Breaking changes may occur frequently as the project evolves.\n\nWhile effort has been made to handle errors gracefully, data loss could occur. Regular backups of save files are recommended if you choose to use this software.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacob-walton%2Frpg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjacob-walton%2Frpg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacob-walton%2Frpg/lists"}