Command API

Cargo.toml

@@ -25,9 +25,11 @@ bevy_mod_debugdump = "0.7.0"
 bitfield-struct = "0.3.1"
 byteorder = "1.4.3"
 bytes = "1.2.1"
+casey = "0.4.0"
 cesu8 = "1.1.0"
 cfb8 = "0.8.1"
 clap = { version = "4.0.30", features = ["derive"] }
+ctor = "0.2.0"
 criterion = "0.4.0"
 directories = "5.0.0"
 eframe = { version = "0.21.0", default-features = false }
@@ -79,6 +81,7 @@ valence_biome.path = "crates/valence_biome"
 valence_block.path = "crates/valence_block"
 valence_build_utils.path = "crates/valence_build_utils"
 valence_client.path = "crates/valence_client"
+valence_command.path = "crates/valence_command"
 valence_core_macros.path = "crates/valence_core_macros"
 valence_core.path = "crates/valence_core"
 valence_dimension.path = "crates/valence_dimension"

crates/valence_command/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "valence_command"
+version.workspace = true
+edition.workspace = true
+
+[dependencies]
+bevy_ecs.workspace = true
+valence_core.workspace = true
+anyhow.workspace = true
+glam.workspace = true
+serde_json.workspace = true
+serde.workspace = true
+valence_block.workspace = true
+valence_nbt.workspace = true
+valence_entity.workspace = true
+valence_instance.workspace = true
+ctor.workspace = true
+casey.workspace = true
+paste.workspace = true

crates/valence_command/README.md

@@ -0,0 +1,41 @@
+# valence_command
+
+Command API for minecraft with supported brigadier arguments.
+
+## Raw usage
+
+To use command API 'raw', you need to know `Parse` trait.
+
+```rust
+// Anything what can be &str
+let input = "gamemode @s creative";
+
+// StrReader is needed for Parse trait to work with.
+let mut reader = StrReader::new(input);
+
+// Here we are using Parse trait. It returns an ParsingResult (it is not a standard result)
+// It has 2 fields. suggestions and result
+// Result contains error or an object.
+// Suggestions contains suggestions.
+let gamemode_literal_result = <&str>::parse(None, reader, ParsingPurpose::Reading);
+
+if let Err((err_pos, err)) = gamemode_literal_result.result {
+    // Handle error
+
+    // Component of error (usually this need to be sent to an user)
+    let text = err.build();
+
+}
+
+// str itself
+let gamemode_literal = gamemode_literal_result.result.unwrap();
+
+// to parse next argument you would need to skip a whitespace, because each Parse parse only its own chars.
+// for now only "gamemode" parsed
+
+if !reader.skip_char(' ') {
+    // next char is not whitespace otherwise it is skipped and returned true.
+}
+
+// continue parsing.
+```