it is blanketcon ready

.github/workflows/bc23test.yml

@@ -0,0 +1,12 @@
+on:
+  workflow_dispatch
+
+name: Test bc23
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - run: rustup toolchain install stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo run --quiet run --test

README.md

@@ -10,7 +10,7 @@
 ![downloads](https://img.shields.io/github/downloads/ParadigmMC/mcman/total?logo=github)
 [![discord server](https://img.shields.io/discord/1108817072814817410?logo=discord)](https://discord.gg/YFuxNmKvSr)
 
-Powerful Minecraft Server Manager CLI. Easily install jars (server, plugins & mods) and write config files. Docker and git support included.
+Powerful Minecraft Server Manager CLI. Easily install jars (server, plugins & mods), write config files, manage worlds and more. Docker and git support included.
 
 ## Getting Started
 
@@ -20,7 +20,7 @@ Powerful Minecraft Server Manager CLI. Easily install jars (server, plugins & mo
 | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------ |
 
 - Join the [discord](https://discord.gg/YFuxNmKvSr) for support!
-- 📋 Want an example? Here's [iptfreedom](https://github.com/IPTFreedom/iptfreedom)
+- 📋 Some examples can be found under [examples/](./examples/)
 
 Submit a PR or open an issue if you have a mcman-server repository that we can add here!
 
@@ -32,32 +32,37 @@ Submit a PR or open an issue if you have a mcman-server repository that we can a
 - ✔️ No third-party hosts (metadata/mirrors)
 - :octocat: Fully `git`-compatible!
 - 🐳 Supports Docker, out of the box
-- 📦 Import from or export to [mrpack](./DOCS.md#mcman-import-mrpack-src)s!
-- 📦 Import from or export to [packwiz](./DOCS.md#mcman-import-mrpack-src) packs!
+- 📦 **Import** from or **export** to `mrpack`s or `packwiz` packs!
 - 📚 Supports way too many sources, some are:
   - Modrinth, CurseRinth, Spigot, Hangar, Github Releases, Jenkins, Maven
   - If you need something else, it even supports custom urls!
 - ⚙️ Better configuration files with `config/`!
   - Allows you to use **variables** inside your config files
   - Use *environment variables* for secrets
-- 🛡️ More secure than in-game plugin managers which are prone to permission attacks
+- 🌐 Keep worlds as `worlds/*.zip` for git, or set it to be downloaded from somewhere!
+- ✨ Managing a network? Use `network.toml` to manage servers' ports, have shared variables, config files, plugins or mods.
+
+## Reviews
+
+"faster than gradle builds"
+
+\- kuylar
+
+"makes even oracle linux usable"
+
+\- PureComedi
+
+"I'm technically a contributor"
+
+\- Trash Panda
 
 ## Changelog
 
 whats a semver? /s
 
 ### `0.4.0`
 
-- Added [NeoForge](https://neoforged.net/) server type
-- Added [Forge](https://forums.minecraftforge.net/) server type
-- Added Downloadable type **Maven**
-- Added [Hangar](https://hangar.papermc.io/) support
-- Improved building process
-- Implemented a lockfile to speed things up and fix the remove-issue
-- Fixed a bug on `mcman run` which messed up the output when server crashes
-- Some downloadables now support variables
-- Experimental `add` command
-- Experimental `world` feature
+- See [#31](https://github.com/ParadigmMC/mcman/issues/31)
 
 ### `0.3.0`
 

examples/network/network.toml

@@ -2,8 +2,11 @@ name = "CoolNetwork"
 proxy = "proxy"
 port = 25565
 
+[servers.game1]
+port = 25567
+
 [servers.lobby]
 port = 25566
-groups = []
 
 [variables]
+MADE_USING = "mcman"

examples/network/servers/game1/README.md

@@ -0,0 +1,13 @@
+# game1
+
+[![mcman badge](https://img.shields.io/badge/uses-mcman-purple?logo=github)](https://github.com/ParadigmMC/mcman)
+
+<!-- run 'mcman md' to update! -->
+
+<!--start:mcman-server-->
+<!--end:mcman-server-->
+
+## Mods
+
+<!--start:mcman-addons-->
+<!--end:mcman-addons-->

examples/network/servers/game1/config/server.properties

@@ -0,0 +1,2 @@
+server-port=${PORT:25565}
+motd=${NW_MADE_USING}

examples/network/servers/game1/server.toml

@@ -0,0 +1,18 @@
+name = "game1"
+mc_version = "1.20.2"
+
+[jar]
+type = "quilt"
+loader = "latest"
+installer = "latest"
+
+[variables]
+PORT = "25565"
+
+[launcher]
+nogui = true
+preset_flags = "aikars"
+eula_args = true
+
+[options]
+upload_to_mclogs = false

src/app/caching.rs

@@ -1,6 +1,6 @@
 use std::{path::{PathBuf, Path}, fs::{self, File}, io::Write};
 
-use anyhow::Result;
+use anyhow::{Result, Context};
 use serde::de::DeserializeOwned;
 
 pub struct Cache(pub PathBuf);
@@ -37,9 +37,11 @@ impl Cache {
     }
 
     pub fn write_json<T: serde::Serialize>(&self, path: &str, data: &T) -> Result<()> {
-        fs::create_dir_all(PathBuf::from(path).parent().unwrap_or(Path::new(path)))?;
+        fs::create_dir_all(self.path(path).parent().unwrap())
+            .context(format!("Creating parent directory for: {path}"))?;
         let content = serde_json::to_string(data)?;
-        let mut f = File::create(self.0.join(path))?;
+        let mut f = File::create(self.path(path))
+            .context(format!("Creating cache file at: {path}"))?;
         f.write_all(content.as_bytes())?;
 
         Ok(())

src/app/downloading.rs

@@ -150,7 +150,7 @@ impl App {
                     // file already there and is ok
                     self.log(format!(
                         "  {} {}",
-                        style("Skipped   ").green(),
+                        style("   Skipped").green(),
                         progress_bar.message()
                     ))?;
 
@@ -218,7 +218,7 @@ impl App {
             validate_hash(hasher)?;
 
             progress_bar.set_style(ProgressStyle::with_template("{prefix:.green.bold} {msg}")?);
-            progress_bar.set_prefix("Copied    ");
+            progress_bar.set_prefix("    Copied");
             progress_bar.set_message(resolved.filename.clone());
             self.log(format!(
                 "  {} {}",

src/app/feedback.rs

@@ -14,6 +14,13 @@ impl App {
         ))?)
     }
 
+    pub fn error<S: std::fmt::Display>(&self, message: S) -> Result<()> {
+        Ok(self.multi_progress.println(format!(
+            "  {} {message}",
+            style("⚠ Error").red().bold()
+        ))?)
+    }
+
     pub fn success<S: std::fmt::Display>(&self, message: S) -> Result<()> {
         Ok(self.multi_progress.suspend(|| println!(
             "  {} {message}",
@@ -37,6 +44,10 @@ impl App {
         )))
     }
 
+    pub fn println<S: std::fmt::Display>(&self, message: S) -> Result<()> {
+        Ok(self.multi_progress.suspend(|| println!("{message}")))
+    }
+
     pub fn dbg<S: std::fmt::Display>(&self, message: S) -> Result<()> {
         Ok(self.multi_progress.suspend(|| println!(
             "  {} {}",
@@ -106,4 +117,16 @@ impl App {
 
         Ok(item.0.clone())
     }
+
+    pub fn select_with_default<T: Clone>(&self, prompt: &str, items: &[SelectItem<T>], def: usize) -> Result<T> {
+        let item = &items[self.multi_progress.suspend(|| {
+            Select::with_theme(&ColorfulTheme::default())
+                .items(items)
+                .with_prompt(prompt)
+                .default(def)
+                .interact()
+        })?];
+
+        Ok(item.0.clone())
+    }
 }