{"id":49868321,"url":"https://github.com/velzie/minecraft.sh","last_synced_at":"2026-05-15T04:05:42.730Z","repository":{"id":192915542,"uuid":"686136579","full_name":"velzie/minecraft.sh","owner":"velzie","description":"a minecraft client/bot library written entirely in pure bash + coreutils","archived":false,"fork":false,"pushed_at":"2023-09-06T17:07:39.000Z","size":47654,"stargazers_count":26,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-22T16:30:36.071Z","etag":null,"topics":["bash","minecraft"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/velzie.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-01T20:50:14.000Z","updated_at":"2024-05-22T16:30:37.553Z","dependencies_parsed_at":null,"dependency_job_id":"348f98bf-1d0f-4eff-abe3-86b7740cf3fa","html_url":"https://github.com/velzie/minecraft.sh","commit_stats":null,"previous_names":["coolelectronics/minecraft.sh","velzie/minecraft.sh"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/velzie/minecraft.sh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velzie%2Fminecraft.sh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velzie%2Fminecraft.sh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velzie%2Fminecraft.sh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velzie%2Fminecraft.sh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/velzie","download_url":"https://codeload.github.com/velzie/minecraft.sh/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/velzie%2Fminecraft.sh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33053162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-15T02:00:06.351Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bash","minecraft"],"created_at":"2026-05-15T04:05:41.938Z","updated_at":"2026-05-15T04:05:42.725Z","avatar_url":"https://github.com/velzie.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eminecraft.sh\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cimg src=\"./assets/logo.png\" alt=\"logo\" height=\"100\"\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003eA minecraft client/bot library written in pure bash + coreutils\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/CoolElectronics/minecraft.sh?style=for-the-badge\u0026color=purple\" height=\"25\"/\u003e\n  \u003ca href=\"https://github.com/CoolElectronics/minecraft.sh\"\u003e\u003cimg alt=\"github\" src=\"https://img.shields.io/badge/github-coolelectronics/minecraft.sh-default?style=for-the-badge\u0026logo=github\" height=\"25\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/CoolElectronics/minecraft.sh?style=for-the-badge\" height=\"25\"/\u003e\n\u003c/div\u003e\n\n## Why?\nI wanted to learn more about bash, maintaining libraries, and the minecraft protocol. This is mostly a learning excersize on my end.\nIf you were looking for an actual featured bot library, there are probably better options.\n\n## Features\n\n| Feature              | Supported?           |\n| -------------------- | -------------------- |\n| 1.20.1               | :white_check_mark:   |\n| Mining               | :white_check_mark:   |\n| Placing Blocks       | :white_check_mark:   |\n| Entities             | :white_check_mark:   |\n| Chat                 | :white_check_mark:   |\n| Metadata Retrival    | :white_check_mark:   |\n| Movement             | :heavy_minus_sign:   |\n| Inventory Management | :heavy_minus_sign:   |\n| Chunk/Biome data     | :x:                  |\n| Pathfinding          | :x:                  |\n| Vehicles             | :x:                  |\n| Chat encryption      | :x:                  |\n| Online-Mode support  | :x:                  |\n| Old protocol versions| :x:                  |\n\n## Cool demos\n\n### Chat client (see examples/chatclient.sh)\nhttps://github.com/CoolElectronics/minecraft.sh/assets/58010778/e1983ea0-3156-4ce5-83a1-6f085be2f1cf\n### Auto-stripminer (see examples/stripminer.sh)\nhttps://github.com/CoolElectronics/minecraft.sh/assets/58010778/29641d51-603f-4c0e-b031-7dbf324000e0\n## How to use\nminecraft.sh provides a simple high level library API for creating bots that can be easily used in any shell script. For example, here's a simple bot that will automatically \"strip mine\" in a straight line\n\n```bash\nsource src/minecraft.sh\nsource examples/demohooks.sh\nDELAY=0.25\nstart_login\n\nsleep 4\nwhile true; do\n  wait_on_login\n  m_get_player_pos\n  for i in {0..2}; do\n    for j in {0..1}; do\n      m_mine_relative \"$i\" \"$j\" 0 \"$DELAY\"\n      m_mine_relative \"$i\" \"$j\" 0 \"$DELAY\"\n    done\n  done\n  for i in {0..4}; do\n    m_move_relative 1 0 0\n    sleep 0.1\n  done\n  for i in {1..3}; do\n    m_mine_relative -1 1 \"$i\" \"$DELAY\"\n    m_mine_relative -1 1 \"$i\" \"$DELAY\"\n  done\n  for i in {1..3}; do\n    m_mine_relative -1 1 \"-$i\" \"$DELAY\"\n    m_mine_relative -1 1 \"-$i\" \"$DELAY\"\n  done\n  sleep 0.1\ndone\n```\n\nMore examples can be found [here](./examples), and make sure to check out the [documentation](./docs.md)\n\nNote: ksh is recommended for running any of the examples\n\n## Dependencies\nThe only non-coreutil dependencies are `zlib-flate` and `xxd`.\n`zlib-flate` is optional if compression is disabled in server.properties, and if you swap out `util.sh` with `util-pure.sh` xxd is optional too.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvelzie%2Fminecraft.sh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvelzie%2Fminecraft.sh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvelzie%2Fminecraft.sh/lists"}