{"id":21812796,"url":"https://github.com/forestoflight/understudy","last_synced_at":"2026-04-02T15:40:20.219Z","repository":{"id":253930744,"uuid":"842790008","full_name":"ForestOfLight/Understudy","owner":"ForestOfLight","description":"A simulated player Canopy extension for Minecraft Bedrock Edition.","archived":false,"fork":false,"pushed_at":"2025-04-06T01:37:53.000Z","size":488,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-13T23:15:42.032Z","etag":null,"topics":["mcpack","minecraft","minecraft-bedrock","minecraft-bedrock-addon","minecraft-bedrock-edition","multiplayer"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/ForestOfLight.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"ForestOfLight","patreon":"ForestOfLight","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-08-15T04:54:23.000Z","updated_at":"2025-04-01T07:21:41.000Z","dependencies_parsed_at":"2024-08-28T01:29:02.673Z","dependency_job_id":"6e6c97a0-8194-482a-829d-a16e680ecfb7","html_url":"https://github.com/ForestOfLight/Understudy","commit_stats":null,"previous_names":["forestoflight/understudy"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForestOfLight%2FUnderstudy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForestOfLight%2FUnderstudy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForestOfLight%2FUnderstudy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ForestOfLight%2FUnderstudy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ForestOfLight","download_url":"https://codeload.github.com/ForestOfLight/Understudy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248794568,"owners_count":21162615,"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":["mcpack","minecraft","minecraft-bedrock","minecraft-bedrock-addon","minecraft-bedrock-edition","multiplayer"],"created_at":"2024-11-27T14:20:06.520Z","updated_at":"2026-04-02T15:40:20.205Z","avatar_url":"https://github.com/ForestOfLight.png","language":"JavaScript","funding_links":["https://github.com/sponsors/ForestOfLight","https://patreon.com/ForestOfLight"],"categories":[],"sub_categories":[],"readme":"![Understudy Logo](./understudy_logo_banner.png)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\u003cb\u003ePrecise Control for Simulated Players\u003c/b\u003e\u003c/p\u003e\n\n[![GitHub Downloads](https://img.shields.io/github/downloads/ForestOfLight/Understudy/total?label=Github%20downloads\u0026logo=github)](https://github.com/ForestOfLight/Understudy/releases/latest)\n[![Curseforge Downloads](https://cf.way2muchnoise.eu/full_1093805_downloads.svg)](https://www.curseforge.com/minecraft-bedrock/addons/understudy)\n[![Minecraft - Version](https://img.shields.io/badge/Minecraft-v26.0_(Bedrock)-brightgreen)](https://feedback.minecraft.net/hc/en-us/sections/360001186971-Release-Changelogs)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/bee7bd9061ab4085b1a26624c1f97e2c)](https://app.codacy.com/gh/ForestOfLight/Understudy/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![Discord](https://badgen.net/discord/members/9KGche8fxm?icon=discord\u0026label=Discord\u0026list=what)](https://discord.gg/9KGche8fxm)\n\u003c/div\u003e\n\nUnderstudy gives you complete control over simulated players in your Minecraft Bedrock world. Afk your farms, load areas, and more -- all through a set of powerful, intuitive commands!\n\n\u003e [!IMPORTANT]\n\u003e This addon is a **Canopy Extension**, which means **Canopy** must be installed in your world for it to work.\n\u003e [Download **Canopy** here!](https://github.com/ForestOfLight/Canopy)\n\n## Usage\n\n### Commands\n\n**Usage: `/simplayer:join \u003cplayername: string\u003e`**  \nSpawn a simulated player with the given name at your current location in your current game mode.\n\n**Usage: `/simplayer:leave \u003cplayername: string\u003e`**  \nRemove the simulated player with the given name. \n\n**Usage: `/simplayer:rejoin \u003cplayername: string\u003e`**  \nSpawn a simulated player with the given name at its last location, if it has one.\n\n**Usage: `/simplayer:tp \u003cplayername: string\u003e`**  \nTeleport the simulated player with the given name to your current location.\n\n**Usage: `/simplayer:look \u003cplayername: string\u003e [lookOption: up/down/noth/south/east/west/block/entity/me/at] [x y z: location]`**  \nMake the simulated player with the given name look at the specified target.\n- `up`, `down`, `north`, `south`, `east`, `west` will make the simulated player look in different cardinal directions.\n- `block` and `entity` will make the simulated player look at the block or entity you are looking at.\n- `me` will make the simulated player look at you.\n- `at \\\u003cx y z\\\u003e` will make the simulated player look at the specified coordinates.\n\n**Usage: `/simplayer:move \u003cplayername: string\u003e [moveOption: forward/backward/left/right/block/entity/me/to] [location: x y z]`**  \nMake the simulated player with the given name move in the specified direction or (navigate) to the specified location. This command uses Minecraft's normal pathfinding system, so the simulated player won't be able to navigate very far very far at once.\n- `forward`, `backward`, `left`, `right` will make the simulated player move continuously relative to the direction they are facing.\n- `block` and `entity` will make the simulated player move towards the block or entity you are looking at.\n- `me` will make the simulated player move towards you.\n- `to \\\u003clocation: x y z\\\u003e` will make the simulated player move towards the specified coordinates. \n\n**Usage: `/simplayer:action \u003cname: string\u003e \u003caction: attack/interact/use/build/break/drop/dropstack/dropall/jump\u003e [timingOption: once/after/continuous/interval/stop] [ticks: int]`**  \nMake the simulated player with the given name perform the specified action. \n\n**Actions:**  \n- `attack` will make the simulated player attack the block or entity they are looking at.\n- `interact` will make the simulated player interact with the block or entity they are looking at.\n- `use` will make the simulated player use the item they are holding.\n- `build` will make the simulated player place a block from their inventory at the location they are looking at.\n- `break` will make the simulated player break the block they are looking at.\n- `drop` will make the simulated player drop one item from their hand.\n- `dropstack` will make the simulated player drop the entire stack of items from their hand.\n- `dropall` will make the simulated player drop their entire inventory.\n- `jump` will make the simulated player jump.\n\n**Timing options:**  \nIf no timing option is specified, the simulated player will perform the action once. \n- `once` will make the simulated player perform the action once.\n- `after` will make the simulated player perform the action after a delay specified by the last argument.\n- `continuous` will make the simulated player perform the action continuously.\n- `interval` will make the simulated player perform the action at regular intervals specified by the last argument.\n- `stop` will make the simulated player stop performing the action.\n\n**Usage: `/simplayer:select \u003cplayername: string\u003e \u003cslotNumber: int\u003e`**  \nMake the simulated player with the given name select the item in the specified hotbar slot.\n\n**Usage: `/simplayer:sprint \u003cplayername: string\u003e \u003cshouldSprint: boolean\u003e`**  \nMake the simulated player with the given name sprint or stop sprinting.\n\n**Usage: `/simplayer:sneak \u003cplayername: string\u003e \u003cshouldSneak: boolean\u003e`**  \nMake the simulated player with the given name sneak or stop sneaking.\n\n**Usage: `/simplayer:claimprojectiles \u003cplayername: string\u003e [radius: int]`**  \nMake the simulated player with the given name become the owner of all projectiles within a block radius. If no radius is specified, it defaults to 25 blocks.\n\n**Usage: `/simplayer:stop \u003cplayername: string\u003e`**  \nStop all actions the simulated player with the given name is doing.\n\n**Usage: `/simplayer:swapheld \u003cplayername: string\u003e`**  \nSwaps the held item of the simulated player with the given name with the item you are holding.\n\n**Usage: `/simplayer:inventory \u003cplayername: string\u003e`**  \nShows the inventory of the simulated player with the given name in chat.\n\n**Usage: `/simplayer:prefix \u003cprefix: string\u003e`**  \nSet a nametag prefix for all simulated players. Use `-none` to remove the prefix.\n\n### Rules\n\nThese rules can be toggled in **Canopy**.\n\n- **`simplayerRejoining`**: Makes online simulated players rejoin when the world reloads.\n- **`noSimplayerSaving`**: Disables saving playerdata for simulated players. Improves performance but causes simulated players to lose their inventory and location when they leave and rejoin.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforestoflight%2Funderstudy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforestoflight%2Funderstudy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforestoflight%2Funderstudy/lists"}