This tool is designed to make DarkRift projects more structured and uniform across all users as well as providing a single interface to simplify common tasks.

To start with, the tool handles four common tasks:

• Creating projects, plugins and other resources from scratch;
• downloading and managing different versions of DarkRift;
• downloading and installing plugins from online locations; and,
• running a server from centralized binaries.

In future, this tool will likely handle:

• Package management to allow easier download of common plugins (network listeners, log writers etc.)
• Managing remote servers (e.g. executing commands over SSH/HTTP, retrieving logs)

If you've downloaded a release version you simply need to extract the archive into a folder and add the folder to your path variable.

You can test your installation with

darkrift version

You can install the DarkRift CLI tool using Scoop on Windows:

scoop install https://raw.githubusercontent.com/DarkRiftNetworking/darkrift-cli/master/scoop/darkrift-cli.json

To build from source, clone the repository and run dotnet publish. You will then have the same binaries as in the release in the bin/ folder and can follow the steps above to install.

To create a new project etc. from template use:

darkrift new project my-project
darkrift new plugin my-plugin
darkrift new log-writer my-plugin
darkrift new network-listener my-plugin

To download and install a plugin from a remote location use:

darkrift get http://url-of.your/plugin.zip

The archive will be decompressed into the plugins directory.

Note: this sub-command may be deprecated in the future if/once a full package management system is implemented.

To run your project use:

darkrift run

To pull a version of DarkRift from the remote server for use locally you can use:

darkrift pull 2.4.5

This version of DarkRift is then available for use in your projects when starting a server with darkrift run. Specifying without a version number will use your current project's version and specifying latest will get the latest version of DarkRift. You can also specify -f to force a download

In most cases you do not need to do this yourself as darkrift run will automatically download the correct version.

You can also list all the DarkRift versions you have installed with:

darkrift pull --list

To access the DarkRift documentation you can simply use:

darkrift docs 2.4.5

Specifying without a version number will use your current project's version and specifying latest will get the documentation for the latest version of DarkRift. You can also add the --local flag to download the documentation to your local machine (note, this doesn't seem to render correctly in Firefox though).

Dockerisation is not production ready and should not be used on outside of a development environment

You can use the CLI tool within docker, for example to host a dockerised DarkRift server. Images are hosted on Docker Hub.

A simple example of this would be:

docker run --name darkrift -d -p 4296:4296/tcp -p 4296:4296/udp -v $PWD/project:/project -e DR_INVOICE_NO="if-using-pro" darkriftnetworking/darkrift-cli:latest

The project volume should contain a DarkRift project with a platform of netcoreapp3.1 (and hence Pro is required). Ports are provided as an example and will depend on the listener in use. By default, the command executed is run. The HTTP healthcheck plugin will need to be enabled and running on the default port of 10666.

It is advised to set the DarkRift's data directory to a path outside of the project such as /data. It may be useful to assign this to a named volume if your plugins require persistence.

Pull requests are actively encouraged on all open source DarkRift projects! This section will provide some useful advice for extending or improving the DarkRift CLI tool.

An EditorConfig file is provided that will automatically configure your IDE with the DarkRift style guidelines while working on this project. Many IDEs support it natively but some like VS Code require an extension.

This is the structure the tool generates for projects:

<project>/
  |- .darkrift/
  |- logs/
  |- log-writers/
  |- network-listeners/
  |- plugins/
  |- Readme.md
  |- Server.config
  |- Project.xml
  '- .gitignore

This is the structure the tool generates for plugins:

<plugin>/
  |- src/
  |  '- Plugin1.cs
  |- Readme.md
  |- <plugin>.csproj
  '- .gitignore

Templates are stored in the templates/ directory and each must be added to the build file (darkrift-cli.proj) in order to be copied to the correct location.

There is a very basic templating syntax at the moment to ensure that files (particularly those with special meaning in git) are extracted correctly.

To enable templating of the file content, use __c__ in the file path as directed below.