{"id":19952581,"url":"https://github.com/dosmike/helpmates-sponge-","last_synced_at":"2026-04-10T21:51:50.694Z","repository":{"id":133519987,"uuid":"118261834","full_name":"DosMike/HelpMates-Sponge-","owner":"DosMike","description":"Little Helper Robots","archived":false,"fork":false,"pushed_at":"2018-08-10T10:03:37.000Z","size":88,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-12T06:26:25.795Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/DosMike.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2018-01-20T16:50:05.000Z","updated_at":"2018-08-10T10:00:58.000Z","dependencies_parsed_at":"2023-07-09T23:16:26.810Z","dependency_job_id":null,"html_url":"https://github.com/DosMike/HelpMates-Sponge-","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DosMike%2FHelpMates-Sponge-","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DosMike%2FHelpMates-Sponge-/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DosMike%2FHelpMates-Sponge-/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DosMike%2FHelpMates-Sponge-/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DosMike","download_url":"https://codeload.github.com/DosMike/HelpMates-Sponge-/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241381645,"owners_count":19953751,"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":"2024-11-13T01:13:42.087Z","updated_at":"2026-04-10T21:51:45.662Z","avatar_url":"https://github.com/DosMike.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HelpMates-Sponge-\nLittle Helper Robots\n\nScriptable helpers for your Server - Who needs pipes anyways :)\n\n# This Plugin requires [MikesToolBox](https://github.com/DosMike/MikesToolBox-Sponge-)\n\n## Crafting\n\nCraft Robots with the following recipes:  \n![Fancy Image](https://raw.githubusercontent.com/DosMike/HelpMates-Sponge-/master/hm-crafting.png \"Fancy Crafting Image\")\n\nYou can convert the type of a helpmate by renaming 1 Lapiz into the entity type (e.g. rename it to `minecraft:villager`)   \nThen take the Lapiz and the HelpMate into both hands and use `/hm cast`   \nThe command requires the permission `helpmates.command.cast.base` and `helpmates.cast.entity.MODID.TYPE` (e.g. `helpmates.cast.entity.minecraft.villager`)\n\n*Be warned: Some mob types can and will cause harm - thus it is not recommended to permit entities with wildcards!*\n\n## HelpMates\n\nYou place HelpMates by holding them and right-clicking a block   \nOnce placed you can pick the HelpMate back up by sneaking and left-clicking   \nOpen the inventory of a HelpMate by right-clicking them\nA regular left-click will print the HelpMates current task into chat (Hover the name to see fuel and status)\n\nHelpmates consume about 16 Redstone per hour runtime, with a maximum fuel capacity of about 7h\n\nTo get a helpmate going write a script in a book and left-click the HelpMate with the book\n\n## Scripting\n\nThe Programming Language for HelpMates is made of a non-conditional sequence of commands.   \nHere are the available commands:\n\n| Command | Parameter | Description |\n| --- | --- | ---|\n| `charge` | max | Takes `max` amount of redstone from his Inventory and consumes it for fuel\n| `name is at location` | | Saves a `location` with the specified `name` |\n| `goto` | name or location | Let this HelpMate navigate to the location |\n| `use` | name or location | Open a container/block at this location (will goto if necessary), can also open doors and push buttons |\n| `put` | item name or `something` or `anything` or `everything` | Put stuff in the used block/container |\n| `fuel` | item name or `something` or `anything` or `everything` | Like put, but prefer fuel slots |\n| `take` | item name or `something` or `anything` or `everything` | Take stuff out of the used block/container |\n| `wait` | seconds | Wait the specified amount of seconds |\n| `try to` | another command | Don't wait until the command is done, just give it a quick try and move on |\n| `repeat` | - | Start the script again |\n| `idle within R for S` | R as radius, S a maximum idle time | Walk to a random location within R blocks at the same height and wait for up to S secons |\n| `tpto` | name or location | Teleport this HelpMate. Requires the owner to have permission `helpmates.script.teleport` |\n\nIn theory `use` would request permission, but at this point no permission plugin is checking fake interactions this way.\n\n`anything` means 'once, the first available, if possible'   \n`something` means 'the first available, required'   \n`everything` means 'until no more items are accepted'\n\nBooks containing scripts DO NOT have to be signed, they can still be editable\n\n## Permissions\n\n| Permission | Description |\n| --- | --- |\n| `helpmates.create.base` | Allow spawning helpmates with right-click (not related to crafting) |\n| `helpmate.skript.teleport` | Allow a players HelpMate to execute the script command `TpTo` |\n| `helpmates.cast.entity.MODID.TYPE` | Allow a HelpMate to be casted into the type MODID:TYPE |\n| `helpmates.command.give.base` | Allows to cheat HelpMates with `/hm create` |\n| `helpmates.command.spawn.base` | Allows to cheat HelpMates with `/hm spawn` |\n| `helpmates.command.delete.base` | Allows `/hm delete` to delete a players HelpMate |\n| `helpmates.command.cast.base` | Allows casting HelpMates into other types with `/hm cast` |\n| `helpmates.interact.ignoreowner` | Allows interaction with HelpMates you did not create |\n\nOptions:\n* `helpmates.option.create.limit` - Maximum amount a player may have at a time\n\n## Commands\n\n| Command | Alias | Description |\n| --- | --- | --- |\n| /hm create | create, give, op, opmate | Create a HelpMate.\u003cbr\u003e-t EntityType will overwrite the entity type,\u003cbr\u003e-f Fuel will set the initial fuel (max 100000) |\n| /hm spawn | | Create a Admin HelpMate that does not consume Redstone and does not drop.\u003cbr\u003e-t EntityType will overwrite the entity type,\u003cbr\u003e-f Fuel will set the initial fuel (max 100000)\u003cbr\u003e-at Location to spawn at (for command blocks) |\n| /hm delete \u003cPlayer\u003e | delete | Remove all HelpMates spawned by this player |\n| /hm cast | cast, convert, change, type | Allows to change type with named lapis |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdosmike%2Fhelpmates-sponge-","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdosmike%2Fhelpmates-sponge-","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdosmike%2Fhelpmates-sponge-/lists"}