mirror of
https://codeberg.org/spire/webrcon.git
synced 2026-06-03 17:24:07 +02:00
add readme
This commit is contained in:
parent
d921430bd9
commit
70f9e588eb
1 changed files with 42 additions and 0 deletions
42
README.md
Normal file
42
README.md
Normal file
|
|
@ -0,0 +1,42 @@
|
|||
# WebRcon
|
||||
|
||||
Create rcon connections using websockets
|
||||
|
||||
## Plugin
|
||||
|
||||
WebRcon consists of a sourcemod plugin that accepts websocket connections and allows rcon commands to be send over the socket.
|
||||
|
||||
[Download Plugin](https://github.com/spiretf/webrcon/raw/master/plugin/webrcon.smx)
|
||||
|
||||
### Authentication
|
||||
|
||||
Authentication of the websocket connection is done by sending the password as the first message over the socket, if authentication is successfull the server will respond with `"authenticated"`
|
||||
|
||||
The provided password is checked against two server vars
|
||||
|
||||
- `rcon_password` - the regular rcon password
|
||||
- `sm_webrcon_key` - the webrcon only password, allows keeping the webrcon seperate from the one used for regular connections
|
||||
|
||||
|
||||
## JS Client
|
||||
|
||||
WebRcon comes with a javascript client which runs in nodejs or the browser (trough browserify/webpack/etc)
|
||||
|
||||
```
|
||||
npm install --save webrcon
|
||||
```
|
||||
|
||||
### Usage
|
||||
|
||||
```js
|
||||
import Rcon from 'webrcon';
|
||||
|
||||
const rcon = new Rcon('127.0.0.1', 'secret_rcon_password');
|
||||
|
||||
(async () => {
|
||||
const result = await rcon.status();
|
||||
console.log(result); // { name: 'UGC Highlander Match', map: 'pl_badwater', players: [] }
|
||||
})();
|
||||
|
||||
|
||||
```
|
||||
Loading…
Add table
Add a link
Reference in a new issue