{"id":29198065,"url":"https://github.com/2xxn/hypixel-fragbot","last_synced_at":"2025-08-12T13:38:55.013Z","repository":{"id":48213754,"uuid":"516782486","full_name":"2xxn/hypixel-fragbot","owner":"2xxn","description":"Simple and minimalistic \"FragBot\" for Hypixel Skyblock Dungeons","archived":false,"fork":false,"pushed_at":"2023-03-31T23:05:59.000Z","size":53,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-02T08:43:30.648Z","etag":null,"topics":["bot","fragbot","hypixel","hypixel-skyblock","minecraft","minecraft-bot","skyblock-dungeons"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/2xxn.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":"2022-07-22T14:33:38.000Z","updated_at":"2024-05-27T10:38:23.000Z","dependencies_parsed_at":"2025-03-29T11:34:42.414Z","dependency_job_id":"efbc4761-e0e8-496a-b38f-7b6d96769c26","html_url":"https://github.com/2xxn/hypixel-fragbot","commit_stats":null,"previous_names":["2xxn/hypixel-fragbot","nextu1337/hypixel-fragbot"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/2xxn/hypixel-fragbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2xxn%2Fhypixel-fragbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2xxn%2Fhypixel-fragbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2xxn%2Fhypixel-fragbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2xxn%2Fhypixel-fragbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2xxn","download_url":"https://codeload.github.com/2xxn/hypixel-fragbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2xxn%2Fhypixel-fragbot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270070353,"owners_count":24522042,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"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":["bot","fragbot","hypixel","hypixel-skyblock","minecraft","minecraft-bot","skyblock-dungeons"],"created_at":"2025-07-02T08:31:23.358Z","updated_at":"2025-08-12T13:38:54.989Z","avatar_url":"https://github.com/2xxn.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hypixel-fragbot\nSimple FragBot Library for Hypixel SkyBlock.\u003cbr\u003e\u003cbr\u003e\nPut any suggestions in the `Issues` tab!\n\n\n# Requirements\n- node.js\n- npm\n- second minecraft account (can be alt)\n\u003cbr\u003e\n\n# Important\n- Your bot account should either not have dungeons unlocked or be in Limbo (AFK for long enough).\n- In the config.json file, you can set the username to whatever you like. This value is only used for sending webhook notifications and logging purposes.\n\n# Installation\nTo install the necessary modules for the fragbot, you need to run the `install.bat` file. This will initiate the installation process using `npm`, and you should wait until it finishes installing all the modules.\n\n# Configuration\nTo set up the fragbot, you need to open the config.json file and update the email and password. If you haven't moved your account to Microsoft, change \"auth\": \"microsoft\" to \"auth\":\"mojang\".\n\nFor the webhook field, put the link to your Discord webhook where you want the notifications to go. If you don't want to receive notifications via webhook, set webhook to null, without the quotation marks.\n\nAfter you've made these changes, your config.json file should look something like this.\n\nNOTE: As of version 1.1, `blacklisted` field was changed into `whitelist` and so changed its behavior. If it's empty (like in the example), the `whitelist is turned off`. If it has 1 or more items (example: `\"whitelist\": [\"player1\",\"player2\"]`) it will be on.\n```json\n{\n    \"username\": \"FragBot\",\n    \"email\": \"example@gmail.com\",\n    \"password\": \"P4$$w0rd\",\n    \"auth\": \"microsoft\",\n    \"webhook\": \"https://discord.com/api/webhooks/XXXXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n    \"whitelist\": []\n}\n```\n\n# Running\nNow that everything is set up, run the bot using start.bat file\u003cbr\u003e\nIf for whatever reason the start file doesn't work for you, start the bot by running index.js\u003cbr\u003e\n\n# Examples\n## Simplest way to implement the FragBot\n##### (As of version 1.1, will work if account was migrated to `microsoft`)\nconfig.json:\n```json\n{\"email\": \"example@mail.com\",\"password\": \"exampleP4SSword\"}\n```\nnode.js:\n```js\nnew (require(\"./fragbot\"))(require(\"./config.json\"));\n```\n## Custom Messages\n```js\nconst FragBot = require(\"./fragbot\");\nconst config = require(\"./config.json\");\n\nlet bot = new FragBot(config);\nbot.setMessage(\"join\", \"Successfully connected to the server as %s\")\nbot.setMessage(\"end\", \"%s was kicked from the server\")\n/*\nFirst argument can be:\n- join, when fragbot joins the server\n- end, when fragbot gets kicked\n- invite, when fragbot gets invited to the party\n- joined, when fragbot joins the party\n- disband, when fragbot disbands the party (user didn't join the dungeons)\n- dungeons, when user joins the dungeons\n- disbanded, when user disbands the party\n- limbo, when fragbot gets sent to the limbo\n*/\n```\n## Event Listeners\n```js\nconst FragBot = require(\"./fragbot\");\nconst config = require(\"./config.json\");\n\nlet bot = new FragBot(config);\n\nbot.once(\"join\",()=\u003e{\n    // FragBot joined the server\n})\n\nbot.once(\"end\",()=\u003e{\n    // FragBot got kicked\n})\n\nbot.once(\"limbo\",()=\u003e{\n    // FragBot was sent to the limbo\n})\n\nbot.on(\"queued\",(username,position)=\u003e{\n    // username partied the fragbot\n})\n\nbot.on(\"dungeons\",(username)=\u003e{\n    // username joined the dungeons\n})\n\nbot.on(\"disbanded\",(username)=\u003e{\n    // username disbanded the party\n    // to add him to the blacklist do\n    // bot.config.blacklisted.push(username);\n})\n```\n## Custom Logger\n```js\nconst FragBot = require(\"./fragbot\");\nconst config = require(\"./config.json\");\nlet logs = [];\nlet bot = new FragBot(config);\n\nfunction log(message)\n{\n    logs.push(message)\n    console.log(\"[\"+new Date().toLocaleTimeString()+\"] \"+message)\n}\n\nbot.log = log\n```\n## Discord.js v12 bot\n```js\nconst Discord = require('discord.js');\nconst client = new Discord.Client();\nconst FragBot = require(\"./fragbot\");\nconst config = require(\"./config.json\");\nlet fb = null;\nclient.on('message', msg =\u003e {\n  if (msg.content === '.start') {\n    if(fb != null) return;\n    fb = new FragBot();\n    msg.channel.send(\"FragBot has been started\")\n    fb.once(\"join\",()=\u003e{msg.channel.send(fb.username+\" connected to hypixel\")})\n    fb.once(\"end\",()=\u003e{msg.channel.send(fb.username+\" was kicked from hypixel\");fb = null;})\n    fb.once(\"limbo\",()=\u003e{msg.channel.send(fb.username+\" was sent to limbo\")});\n    // cba to continue but you get the point\n  }\n});\n\nclient.login('token')\n```\n# Modules used\n```\nminecraft-protocol\nnode-fetch@2.6.5\n```\n## The fragbot was created for educational purposes. I do not take responsibility if for whatever reason your account got banned (which shouldn't happen, after the bot gets sent to limbo, it's safe)\n\n### Credits to ChatGPT for helping me enhance README.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2xxn%2Fhypixel-fragbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2xxn%2Fhypixel-fragbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2xxn%2Fhypixel-fragbot/lists"}