roblox-rtc
v1.3.4
Published
A Roblox (near) real-time communication module between a Roblox game server and your own server.
Downloads
103
Maintainers
Readme
roblox-rtc
A Roblox (near) real-time communication module between a Roblox game server and your own server.
NOTE: BUGTESTING FINISHED!
Features
- Send a message to a specific server.
- Send a message to a server with a matching JobId (
game.JobId
). - Send a message to a server with a matching PlaceId (
game.PlaceId
). - Broadcast a message to all servers.
- Get players in a server.
Quick Start
Install:
npm install roblox-rtc
Most functions have thorough JSDocs.
Create a server:
const roblox_rtc = require("roblox-rtc")
roblox_rtc.createServer().listen(3000)
Create an HTTPS server:
const roblox_rtc = require("roblox-rtc")
const fs = require("fs")
roblox_rtx.createServer({
key: fs.readFileSync('path/to/key.pem'), // change this to your private key file. It does not have to be a .pem, it can be any file that is editable normally in a
// editor with UTF8 encoding
cert: fs.readFileSync('path/to/cert.pem') // same as above, for your certificate file
}).listen(3000, () => {
console.log('started HTTPS server on port 3000')
})
Send a message to all servers:
const roblox_rtc = require("roblox-rtc")
const server = roblox_rtc.createServer(...) // replace ... with your options...
server.send({
// your data here...
}).then(() => {
// some logic here
}).catch(() => {
// catch any errors
})
// Or you can do it asynchronously
async function main() {
await server.send({
// your data here...
})
}
server.listen(3000) // change 3000 to your port
Send data to all servers that are connected with a specific game.PlaceId
or the server with the same game.JobId
:
const roblox_rtc = require("roblox-rtc")
const server = roblox_rtc.createServer({
// your options here
})
server.send({
// your data here
}, {
PlaceId: 0, // replace with your PlaceId
// JobId: "" // replace this with the server JobId. Also, instead of doing this, you can take a Connection object and directly call send (next example)
})
server.listen(3000) // change 3000 to your port
Send a message to a server using a Connection object (and also Connection listening):
const roblox_rtc = require("roblox-rtc")
const server = roblox_rtc.createServer({
// your options here
})
server.on("connection", (conn) => {
conn.send({
// your data here...
})
})
server.listen(3000) // change 3000 to your port
Get players in a server:
const roblox_rtc = require("roblox-rtc")
const server = roblox_rtc.createServer({
// your options here
})
server.on("connection", (conn) => {
const players = conn.players
// your logic here
})
server.listen(3000) // change 3000 to your port