{"id":47596178,"url":"https://github.com/3ndetz/unionclef","last_synced_at":"2026-04-01T18:06:10.055Z","repository":{"id":344873150,"uuid":"1183514602","full_name":"3ndetz/unionclef","owner":"3ndetz","description":"Lets your agent loose block game","archived":false,"fork":false,"pushed_at":"2026-03-24T09:33:07.000Z","size":4389,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-24T09:48:18.164Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","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/3ndetz.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-16T17:24:17.000Z","updated_at":"2026-03-24T09:33:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/3ndetz/unionclef","commit_stats":null,"previous_names":["3ndetz/unionclef"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/3ndetz/unionclef","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ndetz%2Funionclef","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ndetz%2Funionclef/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ndetz%2Funionclef/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ndetz%2Funionclef/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/3ndetz","download_url":"https://codeload.github.com/3ndetz/unionclef/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3ndetz%2Funionclef/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290749,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-04-01T18:06:09.749Z","updated_at":"2026-04-01T18:06:10.043Z","avatar_url":"https://github.com/3ndetz.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UnionClef\n\nLetting agents loose in block game.\n\n![Kill\u0026loot](https://github.com/3ndetz/autoclef/assets/30196290/7377ec79-1c3d-493b-9a1d-5d701f19d9c9)\n\n\nAn open platform for building AI agents that play Minecraft — pathfinding, combat, survival, multiplayer. The goal is to make it easy for researchers, developers, and tinkerers to plug their agents into the game and see what happens.\n\n![qwenie](https://github.com/user-attachments/assets/64b98492-ceca-410f-b3bc-efbd8ea09dcb)\n\nBuilt by merging **altoclef**, **shredder**, and **tungsten** into a single codebase. No submodules, no pre-built JARs, no tears.\n\n## What's inside\n\n| Module | What it does |\n|--------|-------------|\n| **altoclef** (root) | Autonomous bot — speedruns, PvP, SkyWars, Python scripting via Py4J |\n| **shredder/** | Pathfinder v2 — fork of baritone with WindMouse camera, tungsten integration, human-like movement |\n| **tungsten/** | A* pathfinder that doesn't break blocks — complex parkour, follows players, PvP movement |\n| ~~baritone/~~ | Legacy pathfinding code, kept as reference. Replaced by shredder |\n\n**Minecraft 1.21** / **Fabric** / **Java 21**\n\n\u003e **[How to build \u0026 run →](docs/DEVELOP.md)** | **[How to release →](docs/RELEASE.md)** | **[Multi-version →](docs/MULTIVERSIONING.md)** | **[Python scripting →](docs/SCRIPTS.md)**\n\n## Features\n\n\u003e (table is not ready yet, TODO. Functions more than this presented. TODO find more organic, suitable and sexy form for this features table)\n\n\n| Feature | Description | Ready |\n|---|---|---|\n| **MLG** |\n| Enderpearl clutch ![alt text](assets/README/EnderClutch.gif) | TP with enderpearl when pursue target. Save self with enderpearl when dropped from edge. | 3/3 ✅ |\n| Arrow dodger ![alt text](assets/README/AutoclefDodging.gif) | Epic incoming arrow dodging. If has shielf - uses it. | 1/1 ✅ |\n| `@test mace` ![alt text](assets/README/MaceClutch.gif) | 😎 | 1/1 ✅ |\n| `#bridgingMode jump` ![alt text](assets/README/ShredderBridging256.gif) | Super-fast bridging. (To cancel, you can change mode to `slow`, `standart` or `back-jump`) | 1/3 ❌ TODO |\n| **PvP** |\n| Attacking bot `@punk` | Handles close target battle. [Wind-mouse](https://github.com/arevi/wind-mouse) based rotations. Brokes shields (axe). Uses own shield. Combines ranging and melee attacks automatically, pursues targets. Using mace from the height | 3/3 ✅ |\n| Shooting bot `@shoot` | Handles ranged target battle with 2 types of angle (rapid-fire, sniper, artillery) | 3/3 ✅ |\n| Pursuing bot | Pursue parkouring targets. Slow for now. | 2/3 ⚠️ |\n| **Minigames** |\n| Skywars `@game sw` | SkyWars (fails exploration, buggy) | 3/5 ⚠️ |\n| Skywars `@game bw` | BedWars (only bed protect) | 3/5 ⚠️ |\n| Skywars `@game skypvp` | SkyPvP (on one server, but non-redactable spawn) | 4/5 ✅ |\n| Skywars `@game mm` | MurderMystery | 5/5 ✅ |\n| **Building** |\n| `@grave \u003ctext\u003e`, `@sign \u003ctext\u003e` | New structures to build | 2/2 ✅ |\n| Privated regions support | Temporal block placement and removal locks | 4/5 ✅ |\n| `@schematic \u003cschematic\u003e` | Schematic integration | 0/3 ❌ TODO |\n| **Multiplayer** |\n| Autologin (`@set multiplayer_password \u003cpassword\u003e`) | Autologin and autoregister | 3/3 ✅ |\n| **Agentic** |\n| Python integration | Py4J configurable two-way interface. Port configures via `@set pythonGatewayPort \u003cport\u003e`. Supports multi-instance launching. Rich contextual and method base (see `adris.altoclef.Py4JEntryPoint` class) for agents, including live-screenshot support. | 3/3 ✅ |\n| Agentic commands | `@check_block`, `@check_player` | 3/3 ✅ |\n| Agentic MCP server | MCP for AI agents endpoint on java-side | 0/3 ❌ TODO |\n| **Comfort** |\n| Command suggestions | Rich chat commands suggestions `@help` | 1/1 ✅ |\n| Monorepo structure | Multi-versioned structured mono-repo with easy-to-work with any of integrated mod | 1/1 ✅ |\n| Removed naughty prints from baritone | | 1/1 ✅ |\n\n\u003e Vote for the new features, report for bugs in the [issues](https://github.com/3ndetz/unionclef/issues).\n\n## Quick start\n\n1. Drop the latest JAR from [releases](https://github.com/3ndetz/unionclef/releases) into your Minecraft `mods/` folder and launch with Fabric\n\n    \u003e Ensure you have the correct Minecraft version for the release you download\n\n2. Type `@help` in chat for the list of commands\n\n## Development\n\nQuick start for development — clone the repo, build, and run:\n\n```bash\ngit clone https://github.com/3ndetz/unionclef\ncd unionclef\ngradlew compileJava     # compiles everything\ngradlew runClient       # launches Minecraft\n```\n\nSee **[docs/DEVELOP.md](docs/DEVELOP.md)** for debug setup, hot-swap, and troubleshooting.\n\n## Demo\n\n\u003cdetails\u003e\u003csummary\u003eSkyWars bot in action\u003c/summary\u003e\n\n### Looting chests\n![Looting chests](https://github.com/3ndetz/autoclef/assets/30196290/aa44993e-a7e8-4285-bba6-a690b0ac29a2)\n\n### Gapple \u0026 EnderPearl\n![Gapple \u0026 EnderPearl](https://github.com/3ndetz/autoclef/assets/30196290/0d3e73d2-2e1f-40e7-a53b-be43d3d9335d)\n\n### Kill \u0026 Loot\n![Kill \u0026 Loot](https://github.com/3ndetz/autoclef/assets/30196290/7377ec79-1c3d-493b-9a1d-5d701f19d9c9)\n\n### Bow\n![Bow](https://github.com/3ndetz/autoclef/assets/30196290/9bae7aee-f535-4704-83a3-3dd9ec885a80)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eTungsten pathfinding\u003c/summary\u003e\n\nPathfinder that can't build/break blocks and looks like a NASA computing program.\n\n![Tungsten pathfinding](https://raw.githubusercontent.com/3ndetz/Tungsten/altoclef-compat/assets/README/Tungsten2.gif)\n\n\u003c/details\u003e\n\n## Project structure\n\n```\nunionclef/\n├── src/main/java/          altoclef source (bot logic, commands, tasks)\n├── src/main/resources/     fabric.mod.json, mixins, assets\n├── shredder/               pathfinder v2 (fork of baritone + tungsten bridge)\n│   └── src/main/java/      shredder code (baritone.* packages)\n├── tungsten/               tungsten source (A* movement, player following)\n│   └── src/main/java/      tungsten code\n├── baritone/               legacy pathfinding (kept as reference, not used)\n│   └── src/main/java/      original baritone code (remapped to yarn)\n├── scripts/                python scripting via Py4J (uv project)\n├── root.gradle.kts         root build config\n├── gradle.properties       versions \u0026 settings\n└── docs/\n    ├── DEVELOP.md          build \u0026 run instructions\n    └── SCRIPTS.md          python scripting guide\n├── README.md               you are here\n└── TODOS.md                project TODOs and roadmap\n```\n\n## Fork History\n\n### altoclef\n\n1. Origin: **[gaucho-matrero/altoclef](https://github.com/gaucho-matrero/altoclef)** →\n2. Fork: **[MarvionKirito/altoclef](https://github.com/MarvionKirito/altoclef)** →\n3. Fork: **[MiranCZ/altoclef](https://github.com/MiranCZ/altoclef)** (multi-version support, bug fixes) →\n4. Fork: **[3ndetz/autoclef](https://github.com/3ndetz/autoclef)** (multiplayer, SkyWars, Python bridge) →\n5. Merged into: **unionclef**\n\n### shredder\n\nFork of baritone, rebuilt as the primary pathfinder. Keeps `baritone.*` packages for API compatibility but adds WindMouse camera smoothing, human-like movement entropy, and a tungsten bridge that delegates complex parkour segments (no block breaking/placing) to tungsten's A* executor.\n\n1. Origin: **[cabaletta/baritone](https://github.com/cabaletta/baritone)** (by leijurv \u0026 Brady) →\n2. Patched by altoclef maintainers (GauchoMatrero → MiranCZ → 3ndetz) →\n3. Remapped mojmap → yarn →\n4. Forked as **shredder** with WindMouse + tungsten integration →\n5. Merged into: **unionclef**\n\n### baritone (legacy)\n\nOriginal pathfinding engine. Kept in the repo as reference code — all active pathfinding now goes through shredder.\n\n1. Origin: **[cabaletta/baritone](https://github.com/cabaletta/baritone)** (by leijurv \u0026 Brady) →\n2. Remapped mojmap → yarn \u0026 merged into: **unionclef** →\n3. Superseded by **shredder**\n\n### tungsten\n\n1. Origin: **[CaptainWutax/Tungsten](https://github.com/CaptainWutax/Tungsten)** →\n2. Fork: **[Hackerokuz/Tungsten](https://github.com/Hackerokuz/Tungsten)** (crash fixes, followPlayer) →\n3. Fork: **[3ndetz/Tungsten](https://github.com/3ndetz/Tungsten)** (altoclef integration) →\n4. Merged into: **unionclef**\n\n## License\n\nGPL-3.0 — see [LICENSE](LICENSE).\n\nIncorporates code from: baritone/shredder (LGPL-3.0), altoclef (MIT), tungsten (CC0-1.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3ndetz%2Funionclef","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F3ndetz%2Funionclef","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3ndetz%2Funionclef/lists"}