{"id":21706339,"url":"https://github.com/ethanmclark1/blocksworld3d","last_synced_at":"2025-04-12T16:14:07.148Z","repository":{"id":203211189,"uuid":"677535882","full_name":"ethanmclark1/blocksworld3d","owner":"ethanmclark1","description":"3D version of the classic Blocksworld environment for reinforcement learning","archived":false,"fork":false,"pushed_at":"2023-10-30T17:39:18.000Z","size":63436,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T10:36:32.831Z","etag":null,"topics":["3-dimensional","3d","blocksworld","gym","gymnasium","miniworld","multi-agent","openai-gym","pettingzoo"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ethanmclark1.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}},"created_at":"2023-08-11T20:43:37.000Z","updated_at":"2024-11-09T03:06:20.000Z","dependencies_parsed_at":"2023-10-30T18:39:20.827Z","dependency_job_id":null,"html_url":"https://github.com/ethanmclark1/blocksworld3d","commit_stats":null,"previous_names":["ethanmclark1/blocksworld3d"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethanmclark1%2Fblocksworld3d","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethanmclark1%2Fblocksworld3d/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethanmclark1%2Fblocksworld3d/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethanmclark1%2Fblocksworld3d/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ethanmclark1","download_url":"https://codeload.github.com/ethanmclark1/blocksworld3d/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248594133,"owners_count":21130314,"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":["3-dimensional","3d","blocksworld","gym","gymnasium","miniworld","multi-agent","openai-gym","pettingzoo"],"created_at":"2024-11-25T22:12:30.441Z","updated_at":"2025-04-12T16:14:07.120Z","avatar_url":"https://github.com/ethanmclark1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# An Extension of MiniWorld\n\nBlocksworld3D, building upon the MiniWorld environment, specifically targets the RoomObjects scenario. Designed for reinforcement learning and robotics research, this minimalistic environment aligns with the MiniWorld API.\n\n# Blocksworld3D\n\nBlocksworld3D extends the traditional BlocksWorld planning problem to a 3D domain, adding extra rows of blocks. It presents eight problems, each with unique constraints on initial block positioning and final objectives.\n\n## Installation\n\nInstall from ``PyPi`` using:\n\n``pip install blocksworld3d``\n\nOr install from the source using:\n\n```\ngit clone https://github.com/ethanmclark1/blocksworld3d.git\ncd blocksworld3d\npip install -r requirements.txt\npip install -e .\n```\n\n## Usage\n\n```\nimport blocksworld3d\n\nenv = blocksworld3d.env()\nenv.reset(options={'problem_instance': 'gap'}))\nobservation, _, terminations, truncations, _ = env.last()\nenv.step(action)\nenv.close()\n```\n\n## List of Problem Instances\n\n| Problem Instance |\n| ---------------- |\n| ``gap``          |\n| ``balance``      |\n| ``stairs``       |\n| ``pyramid``      |\n| ``bed``          |\n| ``towers``       |\n| ``wave-v0``      |\n| ``wave-v1``      |\n\n## Contributing\n\nWe welcome contributions to Blocksworld3d! Whether it's bug reports, feature requests, or pull requests, your collaboration helps make Blocksworld3d better.\n\n## Support\n\nIf you have questions or need support, please contact us at [eclark715@gmail.com](mailto:eclark715@gmail.com), or create an issue in the GitHub repository.\n\n## License\n\nBlocksworld3d is open-source software licensed under the [MIT license](https://chat.openai.com/LINK_TO_YOUR_LICENSE).\n\n## Paper Citation\n\nIf you found this environment helpful, consider citing relevant papers. Here's an example citation for the original MiniWorld environment:\n\n\u003cpre\u003e\n@article{MinigridMiniworld23,\n  author={Maxime Chevalier-Boisvert and Bolun Dai and Mark Towers and Rodrigo de Lazcano and Lucas Willems and Salem Lahlou and Suman Pal and Pablo Samuel Castro and Jordan Terry},\n  title={Minigrid \u0026 Miniworld: Modular \u0026 Customizable Reinforcement Learning Environments for Goal-Oriented Tasks},\n  journal={CoRR},\n  volume={abs/2306.13831}\n  year={2023}\n}\n\u003c/pre\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethanmclark1%2Fblocksworld3d","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethanmclark1%2Fblocksworld3d","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethanmclark1%2Fblocksworld3d/lists"}