Skip to content
This repository has been archived by the owner on Sep 17, 2024. It is now read-only.
/ umod-plugins Public archive

A collection of uMod plugins for running on a modded PlayRust dedicated server.

License

Notifications You must be signed in to change notification settings

bbckr/umod-plugins

Repository files navigation

uMod Plugins for Rust

The Tower of Swole collection of uMod plugins for running on a modded PlayRust dedicated server.

A guide is also included on how to run and test the plugins locally.

Included plugins

For more detailed documentation on how to install and use the plugins, check out the docs folder or click the plugin name below:

Need plugin support?

Head over to the Tower of Swole discord #plugins channel using this invite link and @ masq#5845.

Local Development

Prerequistes

  • Visual Studio IDE
  • Docker + docker-compose (for running a local instance of a PlayRust dedicated server to test the plugins)
  • (Optional) Go 1.15 (for running the e2e tests against a local or remote server with the plugin installed)

Running the server locally

You can test the plugins against a local server by running it in a container via docker-compose.

# spinning up the server
docker-compose up

# tear down the server
docker-compose down

# tear down the server and volumes
docker-compose down -v

Any change you make to the files in plugins/ should be picked up by server running in the container.

Make sure your Docker daemon is allocated enough RAM to properly start up the server (~6gbs).

Enabling code completion

This requires you to open the project solution in Visual Studio.

# if you haven't already ran docker-compose up, run the container
docker-compose up -d

# copy the dlls into your project directory
docker cp local-rust-server:/steamcmd/rust/RustDedicated_Data/Managed/ ./bin/

# if you are missing references to dlls you would like to use, go to
# the .csproj file and update what is missing from the bin/

About

A collection of uMod plugins for running on a modded PlayRust dedicated server.

Topics

Resources

License

Stars

Watchers

Forks

Languages