noblox.js-server
v2.0.1
Published
A RESTful API for using noblox.js
Downloads
27
Readme
About
This repository hosts the code for a working RESTful API that utilizes Koa.js to expose noblox.js functions on the internet. Essentially, with this project, you can host it on your own server and interact with the Roblox API through your own Roblox game.
Prerequisites
- node.js
- a virtual private server (VPS)
- To have your code running on a 24/7 basis, you need to use a VPS. We recommend using DigitalOcean for its ease of use and. This referral link provides you with a $100 credit which can be used over 60 days. Other options include Amazon Web Services, Microsoft Azure, and Google Compute Engine.
Configuration
server.js
After installing this repository on your server, start by creating an .env
file to house your configuration settings. You can duplicate the .env.sample
file and fill in the missing details.
- Unless you know what you are doing, leave the
PORT
number the same. MAX_RANK
refers to the highest rank (1-254) the logged in account is allowed to promote users to.API_TOKEN
refers to a secret key to secure your RESTful API to avoid your API being accessed by unauthorized users. It is best to generate a key that isn't easy to guess. You can use this website to use an automatically generated key. You need not memorize this key.COOKIE
refers to the cookie of the logged-in user account the API will execute functions from. To find your cookie, please read this.
After your file is configured, use a process manager like pm2 to have your script run 24/7. We do not provide support for VPS, network, and domain configuration.
noblox.lua
If you plan on using the provided Lua module (ModuleScript) in this project, please do the following:
- Place the script only in
ServerScriptService
. - Update the
DOMAIN
value inCONFIGURATION
to reflect your server's IP address/domain & port. (e.g. if your domain name is noblox.io and this is running on port 3000, your value here would behttps://noblox.io:3000
) - Update the
API_TOKEN
value inCONFIGURATION
so that it matches what you put earlier inserver.js
. - Optional: provide a
DEFAULT_GROUP_ID
to default to having noblox.js functions run on a single group when not specified.
Credits
- suufi - Lead maintainer
License
MIT