![\"noblox.js\"](\"https://raw.githubusercontent.com/noblox/noblox.js/master/img/noblox-js.png\")
\r\n \r\n
\r\n \r\n ![\"JavaScript](\"https://img.shields.io/badge/code_style-standard-blue.svg?style=flat-square\"){kind=icon}
\r\n ![\"noblox.js](\"https://img.shields.io/badge/discord-noblox.js-blue.svg?style=flat-square\"){kind=icon}
\r\n ![\"NPM](\"https://img.shields.io/npm/v/noblox.js.svg?style=flat-square\")
\r\n
\r\n About •\r\n Prerequisites •\r\n Installation •\r\n Quickstart •\r\n Documentation •\r\n Common Issues •\r\n YouTube Series •\r\n Credits •\r\n License\r\n
\r\n\r\n---\r\n\r\n# ⚠️ Deprecation Notice\r\nAs of 29 March 2026, noblox.js is no longer maintained. This library is deprecated and will not receive further updates, including bug fixes or support for new Roblox API changes.\r\nWe have a few recommendations for alternatives:\r\n- If you only need OpenCloud endpoints, [relatiocc/opencloud](https://github.com/relatiocc/opencloud)\r\n- For a more fully featured library, written in typescript: [rozod](https://rozod.alrovi.com/)\r\n\r\nExisting versions will remain available on npm, but may break as the Roblox API evolves.\r\n Noblox.js and noblox.js-server are now deprecated, effective immediately. You should not create new work using these libraries, and where possible you should move off them to other ones.\r\n\r\nThank you for being a part of our community, and I hope that the library was useful to you.\r\n\r\n\r\n--- \r\n## About\r\n\r\n`noblox.js` is an open-source Roblox API wrapper written in JavaScript (with TypeScript compatibility) as a fork from sentanos's roblox-js module.\r\n\r\nThis NPM package enables operations froms the [Roblox website](https://www.roblox.com) to be executed via NodeJS; many individuals leverage `noblox.js` along side [Roblox's HTTPService](http://wiki.roblox.com/index.php?title=API:Class/HttpService) to create in-game scripts that interact with the website, i.e. promote users, shout events, and so on, or to create Discord utilities to manage their community.\r\n\r\nIf you are looking for more information on how to create something like this, check out [our sister library, `noblox.js-server`](https://github.com/noblox/noblox.js-server) or [our YouTube series](https://www.youtube.com/playlist?list=PLEW4K4VqMUb_VMA3Yp9LI4gReRyVWGTnU). Keep in mind that these resources may not always be up to date, so it is **highly** encouraged that you learn to use the `noblox.js` library directly.\r\n\r\n\r\nNote: We use the semantic release plugin. You should treat npm as the source of truth regarding package versions - the package.json version in this repository will not be up to date.\r\n---\r\n\r\n## Prerequisites\r\n\r\n- [**Node.js®**](https://nodejs.org/en/download/current/) v18.18 or later\r\n\r\n---\r\n\r\n## Installation\r\n\r\nWith node.js installed simply run: \r\n```bash\r\n# Run this to install noblox.js locally to your repository. \r\n$ npm install noblox.js\r\n\r\n# Alternatively, if you are using yarn:\r\n$ yarn add noblox.js\r\n\r\n# To use noblox.js anywhere, run this code to install the package globally:\r\n$ npm install noblox.js -g\r\n```\r\nThat's it!\r\n\r\n---\r\n\r\n## Documentation\r\n\r\nYou can locate the [`noblox.js` documentation here](https://noblox.js.org/); keep in mind some internal or legacy methods may not be documented.\r\n\r\n### Legend\r\nYou may notice our documentation utilizes emojis in every function description; they have meanings!\r\n\r\n| Icon | Description |\r\n| ---- | ----------- |\r\n| 🔐 | Authentication through `setCookie()` is required to use this method.[1](#f1)\r\n| 🔓 | Authentication through `setCookie()` is required in **some** use-cases; dependent on the target's privacy settings.\r\n| ✅ | No authentication is required to use this method.\r\n\r\n[1](#a1) : Extended permissions may be required such as edit permissions or account ownership.\r\n\r\n---\r\n\r\n## Quickstart\r\n\r\n1) [Install `noblox.js`.](#installation)\r\n\r\n2) Retrieve your `.ROBLOSECURITY` cookie. Instructions on how to do that can be found [here](https://noblox.js.org/tutorial-Authentication.html).\r\n\r\n3) Write your code.\r\n\r\n _Using `async/await` syntax:_\r\n ```js\r\n const noblox = require('noblox.js')\r\n async function startApp () {\r\n // You MUST call setCookie() before using any authenticated methods [marked by 🔐]\r\n // Replace the parameter in setCookie() with your .ROBLOSECURITY cookie.\r\n const currentUser = await noblox.setCookie('_|WARNING:-DO-NOT-SHARE-THIS.--Sharing-this-will-allow-someone-to-log-in-as-you-and-to-steal-your-ROBUX-and-items.|_6E6F626C6F782E6A73') \r\n console.log(`Logged in as ${currentUser.UserName} [${currentUser.UserID}]`)\r\n \r\n // Do everything else, calling functions and the like.\r\n const groupInfo = await noblox.getGroup(9997719)\r\n console.log(groupInfo)\r\n }\r\n startApp()\r\n ```\r\n\r\nYou are now using noblox.js!\r\n\r\n### [More examples can be found here.](https://github.com/noblox/noblox.js/tree/master/examples)\r\n\r\n**Promises are fundamental to this library**; if you are unfamiliar with JavaScript promises, we recommend you check out [our tutorial here](https://noblox.js.org/tutorial-Promises.html), and [Daniel Shiffman's JavaScript series](https://www.youtube.com/watch?v=QO4NXhWo_NM&list=PLRqwX-V7Uu6YgpA3Oht-7B4NBQwFVe3pr&index=12).\r\n\r\n---\r\n\r\n## Hiding Your Cookie\r\n\r\nIt is bad practice to store your `.ROBLOSECURITY` cookie inside your codebase; it is too easy to accidentally screenshot or push this private key to GitHub. We recommend using a [package such as `dotenv`](https://www.npmjs.com/package/dotenv) to store your private information in environmental variables.\r\n\r\nWe recommend using a secondary account for botting purposes.\r\n\r\nConsult their documentation or [follow this video](https://www.youtube.com/watch?v=17UVejOw3zA).\r\n\r\n---\r\n\r\n### Invalidating A Cookie\r\n\r\nIn the event of accidentally exposing your `.ROBLOSECURITY` cookie, do not panic. Go to [`Account Settings` > `Security`](https://www.roblox.com/my/account#!/security), select `Sign out of all other sessions`, then log out of your account. This should invalidate your `.ROBLOSECURITY` cookie. \r\n\r\n\r\n---\r\n\r\n## Common Issues\r\n\r\n> **Error: You are not logged in.**\r\n\r\nYou may be calling a function before `setCookie()` is completed; make sure that you are awaiting `setCookie()` before initializing any event listeners or function calls.\r\n\r\n`noblox.js` is a promise based library, this enables you to run operations concurrently; however if you are not awaiting your promises, this means while `setCookie()` is validating your cookie, _your other functions will continue to run_- ~30ms is a **long time** at the computer scale.\r\n\r\n**Promises are fundamental to this library**; if you are unfamiliar with JavaScript promises, we recommend you check out [our tutorial here](https://noblox.js.org/tutorial-Promises.html), and [Daniel Shiffman's JavaScript series](https://www.youtube.com/watch?v=QO4NXhWo_NM&list=PLRqwX-V7Uu6YgpA3Oht-7B4NBQwFVe3pr&index=12).\r\n\r\n> **Error: 400 The roleset is invalid or does not exist.**\r\n\r\nYou likely are using a `rankId` (0 - 255) instead of a `rolesetId` (>255); a `rolesetId` is a unique identifier for a role which you can find by calling [`getRoles(groupId)`](https://noblox.js.org/global.html#getRoles).\r\n\r\nRoblox's naming scheme is a fickle beast; similarly, a `developerProductId` is _different_ than a `productId` (which appears on the public facing dashboard); use [`getDeveloperProducts(placeId)`](https://noblox.js.org/global.html#getDeveloperProducts) to see the `developerProductId`.\r\n\r\n\r\n\r\n> **Error: Initialization failed: 401 Authorization has been denied for this request.**\r\n\r\nFirst, see the steps for `Error: You are not logged in`. \r\n\r\nIf this is unresolved, are you sure the bot has permissions to access this resource? Can you do this operation manually on the website through the bot account?\r\n\r\nAt the end of the day, a 'bot' is a user account, it cannot magically bypass privacy restrictions or group permissions.\r\n\r\n---\r\n\r\n## Credits\r\n* [suufi](https://github.com/suufi) - Lead maintainer\r\n* [sentanos](https://github.com/sentanos) - We wouldn't exist without him. 😀\r\n* [Neztore](https://github.com/Neztore) - Library maintenance and review \r\n* [alanbixby](https://github.com/alanbixby) - Library maintenance\r\n* [popeeyy](https://github.com/popeeyy) - Creation of the documentation.\r\n* [edward](https://github.com/edwrddd) - Helping with the creation of the documentation.\r\n\r\n---\r\n\r\n## License\r\n\r\n[MIT](https://github.com/noblox/noblox.js/blob/master/LICENSE)\r\n","readmeFilename":"README.md"}