From b00dc9ba171ad38be63a37fb419c5641b088629c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alexander=20S=C3=B6derberg?= Date: Mon, 21 Sep 2020 09:21:13 +0200 Subject: [PATCH] Improve the README --- README.md | 69 ++++++++++++------- .../commands/CommandTree.java | 2 +- 2 files changed, 47 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 0b57e608..05631692 100644 --- a/README.md +++ b/README.md @@ -18,23 +18,23 @@ The code is based on a paper that can be found [here](https://github.com/Sauilit ## goals -- Allow for commands to be defined using builder patterns -- Allow for commands to be defined using annotated methods -- Allow for command pre-processing -- Allow for command suggestion outputs +- Allow for commands to be defined using builder patterns (Done) +- Allow for commands to be defined using annotated methods (Done) +- Allow for command pre-processing (Done) +- Allow for command suggestion outputs (Done) Once the core functionality is present, the framework will offer implementation modules, supporting a wide variety of platforms. ### implementations - Minecraft: - - Generic Brigadier module - - Bukkit module - - Paper module, with optional Brigadier support + - Generic Brigadier module (Done) + - Bukkit module (Done) + - Paper module, with optional Brigadier support (Done) - Sponge module - Cloudburst - - Bungee module - - Velocity module + - Bungee module (Done) + - Velocity module (Done) - Create a Discord implementation (JDA) - Create a Java CLI implementation (JLine3) @@ -71,11 +71,12 @@ only needed the first time, as Maven will perform this operation when building. There is a bash script (`build.sh`) that performs the submodule updating & builds the project. Feel free to use this if you want to. + +## use + +To use `cloud` you will first need to add it as a dependency to your project. Cloud is available from [IntellectualSites](https://intellectualsites.com)' maven repository. -## maven - -cloud is available from [IntellectualSites](https://intellectualsites.com)' maven repository: - +**maven**: ```xml intellectualsites-snapshots @@ -86,17 +87,39 @@ cloud is available from [IntellectualSites](https://intellectualsites.com)' mave ```xml com.intellectualsites - cloud-core + cloud-PLATFORM 0.1.0-SNAPSHOT -``` + + + com.intellectualsites + cloud-annotations + 0.1.0-SNAPSHOT + +``` + +**gradle**: +```groovy +repositories { + maven { url = 'https://mvn.intellectualsites.com/content/repositories/snapshots' } +} +``` + +```groovy +dependencies { + implementation 'com.intellectualsites:cloud-PLATFORM:0.1.0-SNAPSHOT' +} +``` + +Replace `PLATFORM` with your platform of choice. We currently support: `bukkit`, `paper`, `bungee` and `velocity`. All modules use the same versions. +More information about the Minecraft specific modules can be found [here](https://github.com/Sauilitired/cloud/tree/master/cloud-minecraft). + +## attributions, links & acknowledgements -### attributions, links & acknowledgements +This library is licensed under the MIT license, and the code copyright belongs to Alexander Söderberg. The implementation is based on a paper written by the copyright holder, and this paper exists under the CC Attribution 4 license. -This library is licensed under the MIT license, and the code copyright -belongs to Alexander Söderberg. The implementation is based on a paper written by the copyright holder, and this paper exists -under the CC Attribution 4 license. - -The Cloud icon was created by by -Thanga Vignesh P on Iconscout -and Digital rights were purchased under a premium plan. +The Cloud icon was created by by +Thanga Vignesh P on Iconscout and Digital rights were purchased under a premium plan. diff --git a/cloud-core/src/main/java/com/intellectualsites/commands/CommandTree.java b/cloud-core/src/main/java/com/intellectualsites/commands/CommandTree.java index 691944b5..8e2fefd0 100644 --- a/cloud-core/src/main/java/com/intellectualsites/commands/CommandTree.java +++ b/cloud-core/src/main/java/com/intellectualsites/commands/CommandTree.java @@ -73,7 +73,7 @@ import java.util.stream.Collectors; *

* Scenarios one and two would result in a {@link InvalidSyntaxException} being thrown, whereas * scenario three would result in a {@link NoSuchCommandException} if occurring at the root node - * or a {@link InvalidSyntaxException otherwise}. Only the fourth scenario would result in a complete + * or a {@link InvalidSyntaxException} otherwise. Only the fourth scenario would result in a complete * command being parsed. * * @param Command sender type