{"id":27072721,"url":"https://github.com/ilukemagic/rustbound","last_synced_at":"2025-04-05T23:19:41.746Z","repository":{"id":282494631,"uuid":"948570247","full_name":"ilukemagic/Rustbound","owner":"ilukemagic","description":"A command-line text adventure game for learning Rust fundamentals.","archived":false,"fork":false,"pushed_at":"2025-03-15T01:09:09.000Z","size":2,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T01:26:26.565Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ilukemagic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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":"2025-03-14T15:10:32.000Z","updated_at":"2025-03-15T01:09:12.000Z","dependencies_parsed_at":"2025-03-15T01:26:31.375Z","dependency_job_id":"3fa49dc3-1347-45d1-b163-9377bfc456c2","html_url":"https://github.com/ilukemagic/Rustbound","commit_stats":null,"previous_names":["ilukemagic/rustbound"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilukemagic%2FRustbound","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilukemagic%2FRustbound/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilukemagic%2FRustbound/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilukemagic%2FRustbound/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ilukemagic","download_url":"https://codeload.github.com/ilukemagic/Rustbound/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247412072,"owners_count":20934797,"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":[],"created_at":"2025-04-05T23:19:41.198Z","updated_at":"2025-04-05T23:19:41.739Z","avatar_url":"https://github.com/ilukemagic.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rustbound\n\nA command-line text adventure game built in Rust where you explore a mysterious world filled with treasures and challenges. Perfect for both gaming enthusiasts and those learning Rust programming fundamentals.\n\n## Features\n\n### Core Gameplay 🎮\n\n- Explore diverse locations (mysterious forests, mountain peaks, treasure rooms)\n- Player management system (movement, inventory, name customization)\n- Interactive world with grid-based rooms containing items and NPCs\n- Item interaction system (take, drop, use)\n- NPC dialogue system\n- Command parsing with comprehensive help\n- Movement validation to prevent invalid actions\n\n### Technical Highlights 🦀\n\n- Robust error handling using Rust's Result and Option\n- Modular architecture for easy expansion\n- Clean code organization following Rust best practices\n- Efficient state management for game elements\n\n## Installation\n\n### Windows Users\n\n1. Download `Rustbound.exe` from the latest release\n2. Double-click the executable to start your adventure\n\n### Building from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/Rustbound.git\n\n# Navigate to project directory\ncd Rustbound\n\n# Build the release version\ncargo build --release\n\n# Run the game\ncargo run --release\n```\n\n## Available Commands\n\n```text\nMovement:\n\u003e north, south, east, west - Move in a direction\n\u003e look                     - Examine your surroundings\n\nInventory Management:\n\u003e take [item]             - Pick up an item\n\u003e drop [item]             - Drop an item\n\u003e use [item]              - Use an item\n\u003e inventory               - Check your inventory\n\nInteraction:\n\u003e talk to [npc]           - Interact with characters\n\u003e name [new name]         - Change your character's name\n\nSystem:\n\u003e help                    - Display help information\n\u003e quit                    - Exit the game\n```\n\n## Project Structure\n\n```text\nsrc/\n├── main.rs       # Game loop and entry point\n├── player.rs     # Player state management\n├── world.rs      # World generation and room data\n└── command.rs    # Command parsing system\n```\n\n## Game Tips 💡\n\n- Explore thoroughly - each room may contain valuable items or important NPCs\n- Talk to characters for valuable information and potential quests\n- Some items have special effects in certain locations\n- Use the 'look' command frequently to gather information about your surroundings\n\n## Future Development 🚀\n\n- Combat system implementation\n- Puzzle-based NPC interactions\n- Save/load game functionality\n- Enhanced UI using tui-rs\n- Additional locations and items\n\n## Version\n\nCurrent Version: 1.0.0\n\n## Contributing\n\nThis project welcomes contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.\n\n## Support\n\n- Report bugs or suggest features through GitHub Issues\n- Check the documentation for detailed information\n- Join our community discussions\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\nBuilt with 🦀 Rust and ❤️ for adventure gaming\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filukemagic%2Frustbound","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filukemagic%2Frustbound","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filukemagic%2Frustbound/lists"}