{"id":20247733,"url":"https://github.com/ixnoahlive/lavacake","last_synced_at":"2025-05-07T12:32:10.579Z","repository":{"id":195853392,"uuid":"693806602","full_name":"ixnoahlive/lavacake","owner":"ixnoahlive","description":"Lavacake is a freshly baked Hypixel API Webserver!","archived":false,"fork":false,"pushed_at":"2024-04-13T08:57:46.000Z","size":102,"stargazers_count":4,"open_issues_count":7,"forks_count":1,"subscribers_count":1,"default_branch":"alpha-1","last_synced_at":"2024-08-07T03:03:03.739Z","etag":null,"topics":["bun","hypixel","hypixel-api"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ixnoahlive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-09-19T18:47:29.000Z","updated_at":"2024-08-07T03:03:09.508Z","dependencies_parsed_at":"2023-11-07T00:03:06.659Z","dependency_job_id":null,"html_url":"https://github.com/ixnoahlive/lavacake","commit_stats":null,"previous_names":["noahthenerd/lavacake","ixnoahlive/lavacake"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixnoahlive%2Flavacake","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixnoahlive%2Flavacake/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixnoahlive%2Flavacake/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixnoahlive%2Flavacake/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ixnoahlive","download_url":"https://codeload.github.com/ixnoahlive/lavacake/tar.gz/refs/heads/alpha-1","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224600216,"owners_count":17338445,"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":["bun","hypixel","hypixel-api"],"created_at":"2024-11-14T09:39:08.624Z","updated_at":"2024-11-14T09:39:09.343Z","avatar_url":"https://github.com/ixnoahlive.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/made%20for-bun-peru\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-Apache_2.0-blue\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/NoahTheNerd/lavacake\"\u003e\n    \u003cbr/\u003e\u003cbr/\u003e\n    \u003cimg src=\"https://cdn.discordapp.com/attachments/1071274344019398748/1153760402799349760/lavacake.png\" height=\"100\"\u003e\n    \u003cbr/\u003e\n    \u003cb\u003eLavacake\u003c/b\u003e\u003cbr\u003e\n    \u003ci\u003eA freshly baked Hypixel webserver!\u003c/i\u003e\n\u003c/div\u003e\n\n## 🍰 Introduction\nLavacake is a drop in \u0026 use Hypixel API webserver, so you can rest easy knowing you have time to work on your Hypixel projects without spending time coding a pesky API.\n- **It's fast!** Lavacake runs on Bun, making it lightning fast for users \u0026 developers alike.\n- **It's clean!** Lavacake cleans up the Hypixel API, adding more wrapping \u0026 removing the [junk.](#-faq)\n- **Very tasty!** Every instance of Lavacake is guaranteed to taste good. Make sure to enjoy!\n\nLooking for something with a broken scrollwheel? Check these links out to quickly jump:\n\n- [Installation Guide](#-installation)\n- [Contributing](#-contributing)\n- [FAQ](#-faq)\n\n## 🗺️ Roadmap\n|  ?  | Feature                |\n| --- | ---------------------- |\n| ✅ | Network XP Wrapping\n| ✅ | Housing Wrapping\n| ⌛ | Bed Wars Wrapping\n| ⌛ | SkyWars Wrapping\n| ⌛ | Pit Wrapping\n\n## 💖 Contributing\nContributing is simple, make a fork \u0026 merge it when you're done. We do request you to please run `bun run pretty` to format your code to be in line with our style guidelines.\n\n- [Open a pull request](/pulls)\n- [Make a fork](/fork)\n\n## 📦 Installation\nThis installation guide is intended for Linux servers as they are most common and also the best place performance-wise for Lavacake. There may be incompatibility issues for macOS and Windows.\n\n### Prerequisites\nLavacake is best run through a reverse proxy (such as NGINX) software, this is due to the extra headers provided by said software allowing ratelimits to work. Of course, a reverse proxy is **not required**. See the second link for disabling user ratelimits.\n\nYou also need Bun, Lavacake **cannot** be used with Node.js \u0026 uses native Bun features! Installing Bun only takes 10 seconds, so make sure to get it installed!\n\n- [👉 Install Bun](https://bun.sh/)\n- [Installing NGINX](https://ubuntu.com/tutorials/install-and-configure-nginx)\n- [Configuring Lavacake](#configuring-lavacake)\n\n### Installing Lavacake\nYou can either grab the latest release of Lavacake from the [releases](/releases) tab, or get a copy of the codebase with the \u003ckbd\u003e\u003c\u003e Code\u003c/kbd\u003e button.\n\nNavigate into Lavacake's directory using your command line. If you are using the same command line process as you did when installing Bun, you might have to restart the process or start a new process.\n\nOnce in the main directory containing the `package.json` file, run the following command to get all the packages:\n\n```bash\nbun install\n```\n\nYou can start Lavacake using the following command, but first look at [configuring Lavacake](#configuring-lavacake).\n\n```bash\nbun start\n```\n\n### Configuring Lavacake\nLvacake has two configuration files, one containing your tokens \u0026 the other containing your config.\n\nFirst, create a new file called `token.json` and paste in the following:\n\n```json\n{\n    \"devToken\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n    \"appToken\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n    \"active\":\"devToken\"\n}\n```\n\nThese tokens should be replaced with your as seen on the [Hypixel Developer Portal](https://developer.hypixel.net/). You should request an Application Token, and then copy that token into the `appToken` field. If you do not have an approved application yet, use a developer token and paste in in the `devToken` field. You can change the `active` field to `devToken` or `appToken` for which token to use.\n\nNow, please open config.json and we'll explain what all the funky values mean.\n\n- **apiLimit**\n    - reqAmount: The amount of requests you can handle in a certain time period. Please check the developer portal for these ratelimits.\n    - timeSec: The time period of the reqAmount in seconds.\n- **userRatelimit** (NGINX only)\n    - reqAmount: The amount of requests a user may send before being ratelimited. This is to prevent malicious API scraping \u0026 spam requests.\n    - expires: The time in seconds before a request is removed from the ratelimit.\n    - enabled: Whether or not user ratelimiting is enabled. If you do not use NGINX, this should be set to false.\n- **port**\n    - The port to run Lavacake on, e.g. `9753`. Please check [this Wikipedia article](https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers) for a list of port standards to prevent conflicts.\n\n## ❓ FAQ\n- What \"junk\" is being removed by Lavacake?\n    - At the minute, we're looking at only implementing core statistics for games \u0026 wrapping what's most used (e.g. levels \u0026 coins). It might seem generic to say junk, but not enough people will be checking the Mega SkyWars Quit Count for it to be wrapped. If there's anything missing that you would like included in Lavacake you can open an [issue](/issues) at our issues page.\n- How do I access the raw, unwrapped API data?\n    - Just put \"raw\" before an endpoint name, e.g. player -\u003e rawPlayer (camelCase)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixnoahlive%2Flavacake","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fixnoahlive%2Flavacake","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixnoahlive%2Flavacake/lists"}