From beafd62b6e900bc9af4fb9b8e1ab3831da8e6be8 Mon Sep 17 00:00:00 2001 From: ShimmyMySherbet <44135337+ShimmyMySherbet@users.noreply.github.com> Date: Wed, 19 Feb 2020 22:44:54 +1100 Subject: [PATCH] Create README.md --- README.md | 133 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..a00dac2 --- /dev/null +++ b/README.md @@ -0,0 +1,133 @@ +# UnturnedHTTPServer +A simple HTTP server that runs as a plugin, allowing you to run a website off your server! + +With this plugin, you can run a simple HTTP server off of your Unturned Server. You can also manage/check the status of the http server in-game. + +## Permission Nodes: + + + + + + + + + + + + + + + + + + + + + +
Permission NodeRelated Permission
httpserverBase Permission Node to run /HttpServer
httpserver.startAllows the user to Start the HTTP server
httpserver.stopAllows the user to Stop the HTTP Server
httpserver.statusAllows the user to check the status of the HTTP Server
+ +## Commands: +/HTTPServer is the command you use to controll the HTTP Server in-game. With it, you can Start, Stop, and Check the status of the HTTP Server. + +### Starting the Server: (Using settings in the config) + +/HTTPServer Start + +### Starting the Server: (Using the specified port) + +/HTTPServer Start (Port) + +### Stopping the Server: + +/HTTPServer Stop + +### Checking the Server's Status: + +/HTTPServer Status + +## Config + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Settings KeyRelevant Setting
HTTPServerAddressThe Prefix for the HTTP Server (See below)
AutostartHTTPServerSpecifies if the HTTP Server should start when the Unturned Server Starts
AllowHTTPControlsSpecifies if the HTTP Server Start/Stop Commands are enabled.
VerboseOutputEnables/Disables Verbose Output (Verbose output can get spamy on large servers)
HTTPServerDirectoryThe Directory (folder) that contains the files/folders to host, Defaults to the 'Server" folder inside of the Plugin's config folder
RootServerFileSpecifies the root file (e.g, the file you get when going to www.domain.com), set it do %auto for auto-detect
+ +### Server Prefix: +The server prefix specifies how the server runs. It must end in a forward slash, specify the method (http or https), the scope, and the port. + +#### Method +Most people will just use https. But you can use https, but you need an SSL certificate to be installed on the host computer. + +#### Scope +The 3 most common scopes are Local, Specific, and All. + + + + + + + + + + + + + + + + + + + + + + + + + + +
ScopeKeyInfoExample
All*Allows the server to be connected to from any domainhttp://*:80/
Spcific(Server IP or Domain)Allows the server to be only connected to via the keyhttp://domain.com:80/
LocalLocalhostOnly allows the server to be connected to via localhost (The host pc)http://localhost:80/
+ +Most People will just want to use the default, All (*). + + +## Setup: + +After seting up the plugin on your server, there are 2 more things you need to do. + +### Port Forward +Port forward the TCP port the HTTP server is running off + +### Open the port +See this Article for info on how to do this on Windows. + + + +