{"id":24585785,"url":"https://github.com/nugget/phoebot","last_synced_at":"2025-06-10T17:39:06.521Z","repository":{"id":39709298,"uuid":"188330942","full_name":"nugget/phoebot","owner":"nugget","description":"Phoenixcraft SMP Helper Bot","archived":false,"fork":false,"pushed_at":"2023-05-29T21:11:15.000Z","size":4417,"stargazers_count":0,"open_issues_count":19,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-24T05:14:39.451Z","etag":null,"topics":["bot","discord","discord-bot","minecraft"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nugget.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":"nugget"}},"created_at":"2019-05-24T01:25:19.000Z","updated_at":"2022-01-04T18:11:08.000Z","dependencies_parsed_at":"2024-06-20T02:47:14.291Z","dependency_job_id":"8aee4a93-3224-4036-bf29-f90785aab83d","html_url":"https://github.com/nugget/phoebot","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nugget%2Fphoebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nugget%2Fphoebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nugget%2Fphoebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nugget%2Fphoebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nugget","download_url":"https://codeload.github.com/nugget/phoebot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244085017,"owners_count":20395523,"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":["bot","discord","discord-bot","minecraft"],"created_at":"2025-01-24T05:14:43.930Z","updated_at":"2025-03-17T18:16:08.452Z","avatar_url":"https://github.com/nugget.png","language":"Go","funding_links":["https://github.com/sponsors/nugget"],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/nugget/phoebot/workflows/Go/badge.svg)](https://github.com/nugget/phoebot/actions)\n\n## Phoebot Phoenixcraft SMP Assistant\n\nPhoebot is an autonomous assistant that hangs out in the Phoenixcraft SMP\nMinecraft [Discord server] and helps out with various tasks.\n\nFor user documentaton and more information, please see [The\nWiki](https://github.com/nugget/phoebot/wiki).\n\n### Installation and Operation\n\n* To add the bot to a Discord server, visit [this activation link].\n\nPhoebot is distributed as a docker image hosted on [Docker Hub].\n\nIt's running in a Kubernetes Cluster using the object definitions found in the\n`k8s` directory.  Kubernetes is not required for operation, though.  It can be\nrun in any Docker or Docker-complaint container envrionment.  During runtime,\nthe bot will make use of the following environment variables:\n\n* `DISCORD_BOT_TOKEN` is your authentication token for the application/bot that\n  you create on the [Discord developer portal].\n \n* `MC_CHECK_INTERVAL` (optional) controls how frequently Phoebot will check for\n  updated versions of packages.\n\n* `PHOEBOT_DEBUG` (optional) causes the bot to start up with debug log level\n  instead of waiting for an operator to issue that command in chat.  See\n  \"Console Logging\" below.\n\n* `STATE_FILENAME` (defaults to `/phoebot/phoebot-state.xml`) allows you to use\n  a different location for the state file for easier local development.\n\n## Developer Notes\n\n### Building Phoebot\n\nPhoebot is written in [Go](https://golang.org) and can be built with just the\ncore Go language installed.  The preferred development environment uses\n[Bazel](https://www.bazel.build) for building, testing, and deploying the bot.\nAll you need to set up a local development environment is to install Bazel for\nyour operating system.\n\nThe root level `Makefile` contains targets for common build operations.\n\n`make run` will build and run the bot locally for testing.\n\n`make deploy` is what I use to deploy the docker image to docker hub and update\nKubernetes to run the new code.  This will only work in my production\nenvironment.  It's not set up to be generally useful.\n\n### Console Logging\n\nYou can send the command `set loglevel to \u003clevel\u003e` on Discord to dynamically\nchange the verbosity of the console logging.  This is useful for debugging.\n\n[this activation link]: https://discordapp.com/oauth2/authorize?client_id=581247665933779013\u0026scope=bot\u0026permissions=150528\n[Docker Hub]: https://cloud.docker.com/u/nugget/repository/docker/nugget/phoebot\n[Application Form]: https://docs.google.com/forms/d/e/1FAIpQLSdvj5J4vLsOIuvWof3B4jiZYXXpFKfsZMMSUtwKjTN5ThXDRw/viewform\n[Discord server]: https://discord.gg/a6KnJcj\n[hosting provider]: https://server.pro/\n[Discord developer portal]: https://discordapp.com/developers/applications\n\n\n\n```\n/data modify block x y z CustomName set value '{\"text\":\"MOO\"}'\n\n\n\n/summon zombie ~ ~1 ~ {IsBaby:1,HandItems:[{Count:1,id:golden_sword,tag:{display:{Name:\"\\\"Phoebot's Revenge\\\"\"}}},{}],ArmorItems:[{Count:1,id:golden_boots},{Count:1,id:golden_leggings},{Count:1,id:golden_chestplate},{Count:1,id:golden_helmet}],HandDropChances:[0.1f,0.0f]}\n\n\n/summon zombie 15 70 -17 {IsBaby:1,LeftHanded:1b,HandItems:[{Count:1,id:golden_sword,tag:{Enchantments:[{id:knockback,lvl:2},{id:fire_aspect,lvl:2}]}},{}],ArmorItems:[{Count:1,id:golden_boots},{Count:1,id:golden_leggings},{Count:1,id:golden_chestplate},{Count:1,id:golden_helmet,tag:{display:{Name:\"\\\"Phoebot's Revenge\\\"\"}}}],CustomName:\"\\\"Phoebot's Avenger\\\"\",ArmorDropChances:[0.0f,0.0f,0.0f,1.0f],ActiveEffects:[{Id:1,Amplifier:1,Duration:999999},{Id:24,Amplifier:0,Duration:999999}]}\n\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnugget%2Fphoebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnugget%2Fphoebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnugget%2Fphoebot/lists"}