Update version to 1.1.0, enhance README with new features, and add profile management commands. upgraded dependency versions and added Folia compatibility tests.

Author: BuddySirJava

README.md

@@ -4,104 +4,27 @@
 
 # Mint
 
-🍃 **A Lovingly Crafted Quality of Life Extension** — Quark-style tweaks for Paper and Folia (Experimental). 🍃
+🍃 **A Lovingly Crafted Quality of Life Extension** — Quark-style tweaks for Paper and Folia. 🍃
 
 ![Minecraft](https://img.shields.io/badge/Minecraft-Paper%20%7C%20Folia-orange)
 ![License](https://img.shields.io/github/license/BuddySirJava/Mint?label=License&color=blue)
 
 </div>
 
-Mint provides 20+ lightweight, vanilla-friendly gameplay tweaks. It features per-player toggles, WorldGuard/GriefPrevention integration, multiple storage backends, and requires zero client-side mods.
+Mint ships **29** lightweight, vanilla-friendly gameplay modules. Each one can be toggled per-player, integrates with common protection plugins, supports multiple storage backends, and requires no client mods.
 
 ## Features
 
-**Building & Placement**
+Mint ships 29 lightweight modules grouped by category:
 
-- **Vertical & Mixed Slabs:** Place slabs vertically, or combine two different slab types in one block space.
+- [Building](docs/building.md)
+- [Farming](docs/farming.md)
+- [Inventory](docs/inventory.md)
+- [Interaction](docs/interaction.md)
+- [Mobility](docs/mobility.md)
+- [Transport](docs/transport.md)
+- [Entity](docs/entity.md)
 
-  <details>
-  <summary>View Demo</summary>
-
-  ![Vertical Slab Demo](media/modules/vertical-slab.gif)
-
-  ![Mixed Slab Demo](media/modules/mixed-slab.gif)
-
-  </details>
-
-- **Block Decoration:** Apply decorative skins to various blocks (fences, stairs, trapdoors, pots, etc.).
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![Block Decoration Demo](media/modules/block-decoration.gif)
-
-  </details>
-
-- **Carpet Geometry:** Craft geometric carpet patterns via the stonecutter.
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![Carpet Geometry Demo](media/modules/carpet-geometry.gif)
-
-  </details>
-
-- **Ladder Place:** Quickly place ladders above/below your current position.
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![Fast Ladder Demo](media/modules/fast-ladder.gif)
-
-  </details>
-
-**Movement & Transportation**
-
-- **Bedrock Bridging:** Placement preview and godbridge mode.
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![Bedrock Bridging Demo](media/modules/bedrock-bridging.gif)
-
-  </details>
-
-- **Fast Ladders & Sprint Retention:** Climb smoother and keep momentum after stopping.
-- **Vehicles:** Smoother boat handling, faster minecarts, and chain-linkable carts.
-- **Chicken Glide:** Carry chickens for a slow-falling glide effect.
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![Chicken Glide Demo](media/modules/chicken-pickup.gif)
-
-  </details>
-
-**Interaction & Convenience**
-
-- **Inventory & Tools:** Shift-right-click to sort containers, Auto-Tool selection, and Auto-Refill for hotbars.
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![AutoTool Demo](media/modules/autotool.gif)
-
-  </details>
-
-- **Doors:** Double doors open together, left-click to knock.
-- **Slab Breaker:** Break exactly one half of a double slab.
-
-  <details>
-  <summary>View Demo</summary>
-
-  ![Slab Breaker Demo](media/modules/slab-breaker.gif)
-
-  </details>
-
-**Aesthetics**
-
-- **Frames & Paintings:** Toggle item frame visibility with shears; scroll through painting variants.
-- **Leash Decoration:** Link fences with leads and swing from them.
 
 ## Installation
 
@@ -111,26 +34,36 @@ Mint provides 20+ lightweight, vanilla-friendly gameplay tweaks. It features per
 
 **Requirements:** Paper 1.21.4+ Java 21+. (Folia support is currently **Experimental**)
 
+**Optional integrations:** PlaceholderAPI, WorldGuard, GriefPrevention, Towny, and BentoBox (soft-dependencies).
+
 ## Commands & Permissions
 
-| Command                             | Description              | Permission                  |
+| Command | Description | Permission |
 | ----------------------------------- | ------------------------ | --------------------------- |
-| `/mint`                             | Open personal module GUI | `mint.gui` (Default: true)  |
-| `/mint help` / `about`              | Standard info commands   | -                           |
-| `/mint admin reload`                | Reload configuration     | `mint.admin`, `mint.reload` |
-| `/mint admin modules`               | List all module states   | `mint.admin`                |
-| `/mint admin toggle <mod> [player]` | Toggle a module          | `mint.admin`, `mint.toggle` |
-| `/mint admin global <mod> <on/off>` | Globally toggle a module | `mint.admin.global`         |
-| `/mint admin save`                  | Save config to disk      | `mint.reload`               |
+| `/mint` | Open personal module GUI | `mint.gui` (Default: true) |
+| `/mint help` / `about` | Standard info commands | — |
+| `/mint admin reload` | Reload configuration | `mint.admin`, `mint.reload` |
+| `/mint admin modules` | List all module states | `mint.admin` |
+| `/mint admin toggle <mod> [player]` | Toggle a module | `mint.toggle`; `mint.toggle.others` when `[player]` is set |
+| `/mint admin global <mod> <on/off>` | Globally toggle a module in config | `mint.admin.global` |
+| `/mint admin profile list` | List saved module presets | `mint.admin.profile` |
+| `/mint admin profile save <name> [player]` | Snapshot a player's enabled modules | `mint.admin.profile` |
+| `/mint admin profile load <name> [player]` | Apply a preset to a player | `mint.admin.profile` |
+| `/mint admin profile delete <name>` | Remove a preset from config | `mint.admin.profile` |
+| `/mint admin save` | Save config to disk | `mint.reload` |
 
 *Bypass region protections using `mint.bypass.protection`.*
 
 ## Technical Details
 
 - **Storage:** Supports YAML (default), H2, MySQL, MariaDB, and MongoDB.
-- **Performance:** Fully Folia-compatible and multi-threaded.
-- **Protection:** Automatically respects WorldGuard and GriefPrevention build permissions.
+- **Performance:** Folia-aware scheduling; async access is guarded for region-thread safety.
+- **Protection:** Respects WorldGuard, GriefPrevention, Towny, and BentoBox build rules when those plugins are present.
 - **Customization:** Full GUI and message customization via `gui.yml` and `lang.yml` (MiniMessage supported).
+- **PlaceholderAPI:** `%mint_modules_total%` (personal modules count), `%mint_modules_server_total%`, `%mint_modules_enabled_count%` (personal enabled for the player). `%mint_module_<key>%` uses per-player state for personal modules and config-only for server-wide modules (`%mint_global_<key>%` always reflects config).
+- **Tests:** `mvn test` runs unit tests (including Folia compatibility guards).
+
+**Config note:** Reacharound Placement still honors the legacy `modules.bedrock-bridging.enabled` flag if `modules.reacharound-placement.enabled` is absent, so older configs keep working.
 
 ## Building from Source
 ```bash

docs/building.md

@@ -0,0 +1,72 @@
+# Building Modules
+
+These modules focus on placement, decoration, and building convenience.
+
+## Reacharound Placement
+- **Config key:** `modules.reacharound-placement`
+- **Description:** Allows Quark-style reacharound placement when normal targeting misses.
+- **Permission node:** `mint.module.reacharound-placement` (default; override with `modules.reacharound-placement.permission`)
+
+## Block Decoration
+- **Config key:** `modules.blockdecoration`
+- **Description:** Decorates supported blocks with display skins.
+- **Permission node:** `mint.module.blockdecoration` (default; override with `modules.blockdecoration.permission`)
+- **Preview:** `../media/modules/block-decoration.gif`
+
+![Block Decoration Preview](../media/modules/block-decoration.gif)
+
+## Carpet Geometry
+- **Config key:** `modules.carpetgeometry`
+- **Description:** Uses a stonecutter to craft geometric patterns into carpets.
+- **Permission node:** `mint.module.carpetgeometry` (default; override with `modules.carpetgeometry.permission`)
+- **Preview:** `../media/modules/carpet-geometry.gif`
+
+![Carpet Geometry Preview](../media/modules/carpet-geometry.gif)
+
+## Ladder Place
+- **Config key:** `modules.ladder-place`
+- **Description:** Places ladders quickly above or below your current position.
+- **Permission node:** `mint.module.ladder-place` (default; override with `modules.ladder-place.permission`)
+- **Preview:** `../media/modules/fast-ladder.gif`
+
+![Ladder Place Preview](../media/modules/fast-ladder.gif)
+
+## Sign Items
+- **Config key:** `modules.sign-items`
+- **Description:** Places items on hanging signs using display entities.
+- **Permission node:** `mint.module.sign-items` (default; override with `modules.sign-items.permission`)
+- **Preview:** `../media/modules/signitems.png`
+
+![Sign Items Preview](../media/modules/signitems.png)
+
+## Slab Breaker
+- **Config key:** `modules.slab-breaker`
+- **Description:** Breaks only one half of double slabs.
+- **Permission node:** `mint.module.slab-breaker` (default; override with `modules.slab-breaker.permission`)
+- **Preview:** `../media/modules/slab-breaker.gif`
+
+![Slab Breaker Preview](../media/modules/slab-breaker.gif)
+
+## Mixed Slab
+- **Config key:** `modules.mixedslab`
+- **Description:** Places two different slab types in one block space.
+- **Permission node:** `mint.module.mixedslab` (default; override with `modules.mixedslab.permission`)
+- **Preview:** `../media/modules/mixed-slab.gif`
+
+![Mixed Slab Preview](../media/modules/mixed-slab.gif)
+
+## Vertical Slab
+- **Config key:** `modules.verticalslab`
+- **Description:** Enables vertical slab placement visuals.
+- **Permission node:** `mint.module.verticalslab` (default; override with `modules.verticalslab.permission`)
+- **Preview:** `../media/modules/vertical-slab.gif`
+
+![Vertical Slab Preview](../media/modules/vertical-slab.gif)
+
+## Dyeable Item Frames
+- **Config key:** `modules.dyeable-item-frames`
+- **Description:** Dyes item frames using mixed dye combinations with a wool-style texture overlay.
+- **Permission node:** `mint.module.dyeable-item-frames` (default; override with `modules.dyeable-item-frames.permission`)
+- **Preview:** `../media/modules/itemframes.png`
+
+![Dyeable Item Frames Preview](../media/modules/itemframes.png)

docs/entity.md

@@ -0,0 +1,21 @@
+# Entity Modules
+
+These modules modify mob and creature-specific behavior.
+
+## Chicken Glide
+- **Config key:** `modules.chicken-glide`
+- **Description:** Lets players carry chickens and glide with slow falling.
+- **Permission node:** `mint.module.chicken-glide` (default; override with `modules.chicken-glide.permission`)
+- **Preview:** `../media/modules/chicken-pickup.gif`
+
+![Chicken Glide Preview](../media/modules/chicken-pickup.gif)
+
+## Feather Pluck
+- **Config key:** `modules.feather-pluck`
+- **Description:** Plucks feathers from chickens with shears using cooldown and feedback cues.
+- **Permission node:** `mint.module.feather-pluck` (default; override with `modules.feather-pluck.permission`)
+
+## Vexes Die With Their Masters
+- **Config key:** `modules.vexes-die-with-their-masters`
+- **Description:** Removes vexes when their summoner dies.
+- **Permission node:** `N/A` (server-scoped module; no per-player permission gate)

docs/farming.md

@@ -0,0 +1,23 @@
+# Farming Modules
+
+These modules improve crop handling, growth, and world interaction utilities.
+
+## Crop Interact
+- **Config key:** `modules.crop-interact`
+- **Description:** Right-clicks mature crops to harvest and automatically replant.
+- **Permission node:** `mint.module.crop-interact` (default; override with `modules.crop-interact.permission`)
+
+## Bone Meal Anything
+- **Config key:** `modules.bone-meal-anything`
+- **Description:** Allows bone meal to grow nether wart, sugar cane, and cactus with vanilla-like limits.
+- **Permission node:** `mint.module.bone-meal-anything` (default; override with `modules.bone-meal-anything.permission`)
+
+## Chopdown
+- **Config key:** `modules.chopdown`
+- **Description:** Drops trees with opposite-side fall and vanilla-like leaf loot handling.
+- **Permission node:** `mint.module.chopdown` (default; override with `modules.chopdown.permission`)
+
+## Torch Lighting
+- **Config key:** `modules.torch-lighting`
+- **Description:** Sneak right-click with a torch to ignite lightable blocks.
+- **Permission node:** `mint.module.torch-lighting` (default; override with `modules.torch-lighting.permission`)

docs/interaction.md

@@ -0,0 +1,28 @@
+# Interaction Modules
+
+These modules add social, decorative, and utility interactions.
+
+## Double Door
+- **Config key:** `modules.doubledoor`
+- **Description:** Opens paired double doors together.
+- **Permission node:** `mint.module.doubledoor` (default; override with `modules.doubledoor.permission`)
+
+## Door Knock
+- **Config key:** `modules.door-knock`
+- **Description:** Left-clicks doors to play a knock sound.
+- **Permission node:** `mint.module.door-knock` (default; override with `modules.door-knock.permission`)
+
+## Invisible Frame
+- **Config key:** `modules.invisible-frame`
+- **Description:** Toggles item frame visibility with shears.
+- **Permission node:** `mint.module.invisible-frame` (default; override with `modules.invisible-frame.permission`)
+
+## Painting Scroll
+- **Config key:** `modules.painting-scroll`
+- **Description:** Scrolls paintings to cycle fitting variants.
+- **Permission node:** `mint.module.painting-scroll` (default; override with `modules.painting-scroll.permission`)
+
+## Leash Decoration
+- **Config key:** `modules.leash-decoration`
+- **Description:** Links fences with leads and lets players swing from them.
+- **Permission node:** `mint.module.leash-decoration` (default; override with `modules.leash-decoration.permission`)

docs/inventory.md

@@ -0,0 +1,26 @@
+# Inventory Modules
+
+These modules streamline inventory management and tool usage.
+
+## Shift Right Click Sort
+- **Config key:** `modules.shift-right-click-sort`
+- **Description:** Shift-right-click inventories to sort instantly.
+- **Permission node:** `mint.module.shift-right-click-sort` (default; override with `modules.shift-right-click-sort.permission`)
+
+## Auto Tool
+- **Config key:** `modules.auto-tool`
+- **Description:** Automatically switches to the proper tool when breaking blocks.
+- **Permission node:** `mint.module.auto-tool` (default; override with `modules.auto-tool.permission`)
+- **Preview:** `../media/modules/autotool.gif`
+
+![Auto Tool Preview](../media/modules/autotool.gif)
+
+## Auto Refill
+- **Config key:** `modules.auto-refill`
+- **Description:** Automatically refills depleted hotbar block stacks from your inventory.
+- **Permission node:** `mint.module.auto-refill` (default; override with `modules.auto-refill.permission`)
+
+## Expanded Item Interactions
+- **Config key:** `modules.expanded-item-interactions`
+- **Description:** Adds shulker insert, armor swap, and lava-item destroy interactions in inventories.
+- **Permission node:** `mint.module.expanded-item-interactions` (default; override with `modules.expanded-item-interactions.permission`)

docs/mobility.md

@@ -0,0 +1,13 @@
+# Mobility Modules
+
+These modules improve player movement and traversal feel.
+
+## Fast Ladders
+- **Config key:** `modules.fast-ladders`
+- **Description:** Climbs ladders faster and more smoothly using movement keys.
+- **Permission node:** `mint.module.fast-ladders` (default; override with `modules.fast-ladders.permission`)
+
+## Sprint Retention
+- **Config key:** `modules.sprintretention`
+- **Description:** Applies brief Speed after releasing sprint so momentum lingers.
+- **Permission node:** `mint.module.sprintretention` (default; override with `modules.sprintretention.permission`)

docs/transport.md

@@ -0,0 +1,13 @@
+# Transport Modules
+
+These modules improve vehicle handling and travel.
+
+## Boat Improvements
+- **Config key:** `modules.boat-improvements`
+- **Description:** Improves boats with cruise assist on water, ice glide, easier beach slides, and less mob bumping.
+- **Permission node:** `mint.module.boat-improvements` (default; override with `modules.boat-improvements.permission`)
+
+## Minecart Improvements
+- **Config key:** `modules.minecart-improvements`
+- **Description:** Boosts minecart speed and allows linking carts with chains.
+- **Permission node:** `mint.module.minecart-improvements` (default; override with `modules.minecart-improvements.permission`)