Skip to content

affenity/bloxy

Repository files navigation


NPM CircleCI codecov Codacy Badge FOSSA Status Dependencies Status Roblox API Discord


NPM Package


About

This version is currently in development and may have unforeseen and/or untested bugs. If you find any, please, open up an issue / pull request, so we can make bloxy better together

A powerful Node.JS module that lets you interact with the Roblox Web API easily, fast and reliably.

  • It is object-oriented (OO)
  • It's got great documentation
  • Predictable method -and property names
  • Highest coverage of the api of all the other modules on NPM!

Getting Started

Bloxy has 5 dependencies:

  • got - To handle the HTTP requests (bloxy allows your own)
  • lodash - For various purposes
  • signalr-client - To connect with the WebSocket endpoints
  • tough-cookie - For everything cookie-related
  • tslib Necessary with built TypeScript projects :)

Make sure you are able to install each one of these packages, as they are all vital to the functionality of this module!

Prerequisites

To be able to use bloxy, here's what you need to know:

  • some knowledge of OOP and how it works
  • knowledge about JS
  • a computer

Installing

Installing bloxy is easy! Simply enter the following command, and you should be good to go👍

npm install bloxy --save

Installing the dependencies may take longer!

Contributing

Please, before making an issue or pull request, please make sure you have done this already:

  • Made sure there are no similar issues / PRs like this - if so, rather give them a comment!
  • Asked for help in the Roblox API Community - Sometimes, even the best of us need help.
  • (Issues only) Follow the style / template as shown in example-issue - Consistency works!

Examples

Check out below for some examples of how to use bloxy!


Logging in
With cookies
// In an async environment
const bloxy = require("bloxy");
const client = new bloxy.Client({
    credentials: {
        cookie: "cookie"
    }
});

const authenticatedUser = await client.login();
console.log(`Logged in as ${authenticatedUser.id}`) // --> "Logged in as X"
Giving a user a certain role
const bloxy = require("bloxy");
const client = new bloxy.Client({
    credentials: {
        cookie: "cookie"
    }
});

await client.login();

const group = await client.getGroup(3544434);
await group.updateMember(
    321, // User id
    123 // Role id
);

Acknowledgements

  • Sentanos - For helpful solutions and ideas - roblox-js

License

This project is licensed under the MIT License.

FOSSA Status