From 151ad481ad82e8cca4dbd600c728899b8b10ee47 Mon Sep 17 00:00:00 2001 From: Daniel Scalzi Date: Thu, 4 Jun 2020 19:07:32 -0400 Subject: [PATCH] Update README.md. --- README.md | 59 +++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 38 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 6d72e60..86e12dd 100644 --- a/README.md +++ b/README.md @@ -6,13 +6,19 @@ Generate a distribution.json for Helios. * Node.js 12 * Java 8+ (https://adoptopenjdk.net/) - * This is required to process [XZ](https://tukaani.org/xz/format.html) files. + * This is required to run the forge installer and process [XZ](https://tukaani.org/xz/format.html) files. + + +### Notes + +* Nebula is not 100% complete. Unfinished items are listed on the [TODO list](https://github.com/dscalzi/Nebula/issues/2). +* Currently only supports creating Forge based servers. Vanilla support will be added when Helios v2 is complete. ## Setup 1. Clone the repository 2. Install the dependencies (`npm i`) -3. Create a `.env` file at the root directory of the cloned folder and set the required values. +3. Create a file called [`.env`][dotenvnpm] at the root directory of the cloned folder and set the required values. Example ```properties @@ -25,16 +31,34 @@ BASE_URL=http://localhost:8080/ Nebula is not complete. The following usage is tentative. -#### Notes +#### TL;DR Usage -Rather than updating the entire usage with minor changes, please read these notes. - -* Root and BaseUrl options are currently disabled. This information is being pulled from the `.env` for now. +* Follow the setup instructions above. +* Run the `init root` command. +* Generate servers using the `g server` command. +* Put all files in their respective folders (documented below). +* Generate the distribution using the `g distro` command. +* When in doubt, reread this document and then ask on Discord. ## Commands Commands will be documented here. You can run any command with the `--help` option to view more information. +#### Command Usage + +*Recommended* + +* Run `npm run start -- ` + +*Other* + +* Build the project using `npm run build` +* Run `node dist/index.js ` + +*Note: If you modify any files, you will have to rebuild the project. npm start does this automatically.* + +--- + ### Init Init commands are used for initializing empty file structures. @@ -49,11 +73,7 @@ __*Subcommands*__ Generate an empty standard file structure. -`init root ` - -Options: - -* `--root ` Specify the root directory. +`init root` --- @@ -75,7 +95,6 @@ Generate an new server in the root directory. Options are provided to include fo Options: -* `--root ` Specify the root directory. * `--forge ` Specify forge version. This is WITHOUT the minecraft version (ex. 14.23.5.2847) * OPTIONAL (default: null) * If not provided forge will not be enabled. @@ -87,7 +106,7 @@ Options: > > Example Usage > -> `generate server Test1 1.12.2 --root C:/TestRoot --forge 14.23.5.2847` +> `generate server Test1 1.12.2 --forge 14.23.5.2847` > --- @@ -96,21 +115,16 @@ Options: Generate a distribution file from the root file structure. -`generate distro [name] ` +`generate distro [name]` Arguments: * `name` The name of the distribution file. * OPTIONAL (default: `distribution`) -Options: - -* `--root ` Specify the root directory. -* `--baseUrl ` Base url of your file host. - > > Example Usage > -> `generate distribution --root C:/TestRoot --baseUrl https://myhost.com` +> `generate distro` > --- @@ -162,4 +176,7 @@ Ex. * `libraries` All modules of type `Library` * `forgemods` All modules of type `ForgeMod`. * `litemods` All modules of type `LiteMod`. - * `TestServer-1.12.2.png` Server icon file. \ No newline at end of file + * `TestServer-1.12.2.png` Server icon file. + + +[dotenvnpm]: https://www.npmjs.com/package/dotenv \ No newline at end of file