words

Author: Redbot

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-04-05
+
+### Added
+- Custom category directories: override where `lua`, `macros`, or `plugins` install via `CATEGORY_PATHS` in `settings.local.toml`.
+- Clearer messages for users on why certain resources are skipped or blocked.
+
+### Changed
+- Rewrote the sync pipeline with separate discovery, planning, and execution stages.
+
 ## [1.1.2] - 2026-02-16
 
 ### Fixed

README.md

@@ -130,6 +130,18 @@ If there are local files you don't want overwritten by a resource, you can add t
 navmesh = ["befallen.navmesh", "innothuleb.navmesh"]
 ```
 
+### Custom category directories
+
+If you share `lua`, `macros`, or `plugins` directories across multiple MQ environments, you can override where an entire category is installed. Add a `CATEGORY_PATHS` section to your `settings.local.toml`:
+
+```toml
+[DEFAULT.CATEGORY_PATHS]
+lua = 'D:\\shared\\lua'
+macros = 'D:\\shared\\macros'
+```
+
+Absolute paths are used as-is. Relative paths are joined to `DOWNLOAD_FOLDER`. You can set this globally in `[DEFAULT]` or per-environment (`[LIVE.CATEGORY_PATHS]`, `[TEST.CATEGORY_PATHS]`, etc.).
+
 ## Tinkerers
 
 If you self-compile MacroQuest or use a discord friend's copy, you can still keep your scripts and plugins in sync with redfetch by opting out of Very Vanilla: