Skip to content

0demongamer0/RustWeb

 
 

Repository files navigation

RustWeb

RustWeb extends any Rust experimental server with a lightweight webserver running on your server's ip and port, which provides a lot of useful information about your server and allows players to locate themselves on the map. Additionally, it comes with the utility required to generate a top-down 2D image of your server's map.

Donate

Usage with your favorite modding framework

The plugin is not limited to a specific modding framework by design. Instead, it uses a tiny bit of glue to load it into the modding framework of your choice.

Currently available glue with setup instructions:

See also: Frequently asked questions

Web API

The webserver serves a set of JSON-formatted data files on your server's ip address and port, e.g. "http://SERVERIP:SERVERPORT/".

  • /status.json contains general information about your server, like its hostname and the maximum number of players. Includes a list of players if statusIncludesPlayers=true.

  • /monuments.json (requires authentication if displayMonuments=false) contains your server's monuments data.

  • /buildings.json (requires authentication if displayBuildings=false) contains a list of all buildings on the map.

  • /players.json (requires authentication) contains a list of all players currently connected including their locations.

  • /sleepers.json (requires authentication) contains a list of all sleepers including their locations.

  • /animals.json (requires authentication) contains a list of all animals including their locations.

  • /resources.json (requires authentication) contains a list of all resources including their locations.

To authenticate for restricted data files, use username "admin" and your RCON password.

Configuration

To change configuration parameters, edit the file "config.json" inside of the "www" directory.

  • displayMonuments specifies whether to display monuments to all players, making /monuments.json public.

  • displayBuildings specifies whether to display buildings to all players, making /buildings.json public.

  • statusIncludesPlayers specifies whether to include player names in /status.json. This is for example required for admins to see player names on mouse hover.

  • welcomeMessage specifies the welcome message displayed in game. Allows placeholders for {IP}, {PORT} and {NAME]. May be set to null to disable.

  • broadcastDeaths specifies whether to broadcast death events also in game.

RCON API

The plugin also provides a set of RCON commands for map generation:

  • map.export RESOLUTION generates a 2D top-down image of your map using the specified RESOLUTION (height and width of the output image). RESOLUTION is an integer up to a maximum value of 4000. Example: map.export 1000

  • map.monuments returns a list of all monuments on the map.

  • web.reloadconfig reloads the "config.json" file from "www".

Custom web content

The webserver serves files straight from its "www" directory which developers may use to add custom content to their server.

Screenshot

License

All rights reserved.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

RustWeb is not affiliated with, nor endorsed by Facepunch Studios LTD. All trademarks belong to their respective owners.

About

The web plugin and map generator for Rust.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 64.5%
  • C# 15.0%
  • CSS 8.9%
  • HTML 7.5%
  • Batchfile 4.1%