{"id":46377301,"url":"https://github.com/aidn3/hypixel-guild-discord-bridge","last_synced_at":"2026-04-13T11:03:56.336Z","repository":{"id":37981940,"uuid":"469858678","full_name":"aidn3/hypixel-guild-discord-bridge","owner":"aidn3","description":"Service connects multiple guilds and discord server together","archived":false,"fork":false,"pushed_at":"2026-02-25T03:56:33.000Z","size":7492,"stargazers_count":28,"open_issues_count":8,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-02-25T07:38:49.816Z","etag":null,"topics":["bridge","chat","discord","discord-bot","hypixel"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/aidn3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2022-03-14T18:30:12.000Z","updated_at":"2026-02-25T02:10:56.000Z","dependencies_parsed_at":"2023-10-15T16:46:39.514Z","dependency_job_id":"e8586abb-3aa7-4613-8de4-bb4010912d70","html_url":"https://github.com/aidn3/hypixel-guild-discord-bridge","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/aidn3/hypixel-guild-discord-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aidn3%2Fhypixel-guild-discord-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aidn3%2Fhypixel-guild-discord-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aidn3%2Fhypixel-guild-discord-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aidn3%2Fhypixel-guild-discord-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aidn3","download_url":"https://codeload.github.com/aidn3/hypixel-guild-discord-bridge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aidn3%2Fhypixel-guild-discord-bridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30111743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["bridge","chat","discord","discord-bot","hypixel"],"created_at":"2026-03-05T05:30:59.923Z","updated_at":"2026-04-13T11:03:56.330Z","avatar_url":"https://github.com/aidn3.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hypixel-guild-discord-bridge\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/plantain-00/type-coverage\"\u003e\u003cimg alt=\"type-coverage\" src=\"https://img.shields.io/badge/dynamic/json.svg?label=type-coverage\u0026prefix=%E2%89%A5\u0026suffix=%\u0026query=$.typeCoverage.atLeast\u0026uri=https%3A%2F%2Fraw.githubusercontent.com%2Faidn3%2Fhypixel-guild-discord-bridge%2Fmaster%2Fpackage.json\"\u003e\u003c/a\u003e\n  \u003cimg alt=\"A badge displaying the number of messages being sent via the project\" src=\"https://img.shields.io/badge/dynamic/json?label=Messages%20Sent\u0026query=totalChatShort\u0026url=https%3A%2F%2Faidn5.com%2Fstats.json\"\u003e\n  \u003ca href=\"https://discord.gg/ej7tQHPF8y\"\u003e\u003cimg src=\"https://img.shields.io/discord/1002575659694043206?color=5865F2\u0026logo=discord\u0026logoColor=white\" alt=\"Discord server\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Introduction\n\nA service that connects multiple Hypixel guilds and Discord servers together.\nThis project is made to be fully flexible and customisable, offering a high quality user experience while keeping it simple.\n\n\u003e **_DISCLAIMER_: This project interacts with Hypixel in an unintended way by simulating a minecraft client and by processing\n\u003e packets which might get you banned if over-abused too much.  \n\u003e Just like any other modification and service that interacts with Hypixel servers, this goes without saying: \"Use at\n\u003e your own risk\"**\n\n## Documentation And Tutorials\n\n- [Frequently asked questions](docs/FAQ.md)\n- [All Commands And Interactions](docs/COMMANDS.md)\n- [Compatibility and future support](docs/COMPATIBILITY.md)\n- [Migrating to newer version](docs/MIGRATION.md)\n- [Tracking metrics via Prometheus](docs/PROMETHEUS.md)\n- [How to create plugins](docs/PLUGIN-TUTORIAL.md)\n- [Contribute](CONTRIBUTING.md)\n- [Development Documentation](./docs/DEVELOPMENT.md)\n\n## Features\n\n- Connect multiple guilds chats together\n- Bind hypixel guild chats to Discord channels\n- Supports public, officer and private chat\n- Supports in-game moderation commands from Discord\n- Fully synchronize in-game chat and interactions with Discord including guild events such as\n  online/offline/join/leave/mute notification/etc\n- Support many commands from fun ones to management ones\n- Logs all chats/events/etc as records for staff to view\n- Provides detailed metrics per user and per guild (by Prometheus or by leaderboard)\n- Supports custom plugins with fully fleshed out public API\n- Supports proxies for Minecraft instances\n\n## Installing and Running\n\n### Prerequisites\n\n- [Nodejs version 1.20 or later](https://nodejs.dev/download)\n- [npm](https://nodejs.org/en/download/) (usually installed by default with `Nodejs`)\n- [Git](https://git-scm.com/downloads)\n- Minecraft alt account\n\n### Download\n\nClone and download the complete project by using `Git` tool:\n\n```shell\ngit clone https://github.com/aidn3/hypixel-guild-discord-bridge\n```\n\n### Configure\n\n- Explore the project files and copy the contents of `config_example.yaml` into `config.yaml`\n- Open `config.yaml` and fill in the information (Security: `config.yaml` contains sensitive information. Keep it safe!)\n- In `config.yaml` fill out `general.hypixelApiKey` and `discord.key` and `discord.adminIds`\n- (Optional) for **Advanced users only:** Edit other options in `config.yaml` to fine tune the bridge\n\n### Install And Run\n\nIf you are on linux, execute this command to auto download all libraries and start the application.\nIt will also keep the application up to date:\n\n```shell\n./start.sh\n```\n\nIf you are running the application on Windows operating system:\n\n```shell\nnpm install\nnpm start\n```\n\n### Run Via Docker\n\nAlternatively, Docker image is available to use at [GitHub Container Service](https://github.com/aidn3/hypixel-guild-discord-bridge/pkgs/container/hypixel-guild-discord-bridge).\nImage is usually up to date.\n\nTo start, first prepare the configuration as instructed in [this section](#configure). Then execute:\n\n```shell\nsudo docker container run -it --rm -v ./config.yaml:/app/config.yaml ghcr.io/aidn3/hypixel-guild-discord-bridge:latest\n```\n\nNote that the path of the configuration source file must either be relative (with the `./`) or absolute.\n\nAlternatively, providing the path as an argument to the docker container is also possible:\n\n```shell\nsudo docker container run -it --rm -v ./config.yaml:/config/config.yaml ghcr.io/aidn3/hypixel-guild-discord-bridge:latest /config/config.yaml\n```\n\n## Setup Via Discord\n\nAfter installing and running the application, basic setup needs to be done to integrate the application.\n\nUse Discord slash command `/settings` to configure the application:\n\n- Set up the public and officer channels\n- Check [How to prepare and add Minecraft account](docs/FAQ.md#how-to-prepare-a-minecraft-account-to-be-added).\n\n## Credits\n\n- The Project is inspired by [hypixel-discord-chat-bridge by Senither](https://github.com/Senither/hypixel-discord-chat-bridge).\n- [Soopyboo32](https://github.com/Soopyboo32) for providing [an awesome command API](https://soopy.dev/commands)\n- Aura#5051 for in-game commands: Calculate, 8ball, IQ, Networth, Weight, Bitches\n- [WildWolfsblut](https://github.com/WildWolfsblut) for helping with various designs and structures\n- [SkyCryptWebsite](https://github.com/SkyCryptWebsite) for providing [Senither weight](https://github.com/SkyCryptWebsite/SkyCrypt/blob/e2f421dec3a8afdd4830a26d206ec439e933266f/src/constants/weight/senither-weight.js)\n- [Elite Skyblock](https://api.eliteskyblock.com) for providing the farming weight API\n- All contributors whether by code, ideas/suggestions or testing\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faidn3%2Fhypixel-guild-discord-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faidn3%2Fhypixel-guild-discord-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faidn3%2Fhypixel-guild-discord-bridge/lists"}