chore: update changelog for version 0.1.0-pre.1 and refine documentation

Author: stinowdev

CHANGELOG.md

@@ -6,6 +6,8 @@ Feature (F) and decision (D) numbers refer to [FEATURES.md](FEATURES.md).
 
 ## [Unreleased]
 
+## [0.1.0-pre.1]
+
 ### Added
 
 - Initial Pyrophobia project scaffold.

FEATURES.md

@@ -9,7 +9,7 @@ history belongs in [CHANGELOG.md](CHANGELOG.md).
 | ID | Status | Feature | Config key | Default | Authority |
 |---|---|---|---|---|---|
 | F01 | Implemented | Hold right-click to brandish a lit main-hand torch | - | - | Universal |
-| F02 | In progress | Fire sources influence nearby animals — F02a brandish scare done; ground fires later | - | range 12 / chance 0.25 / 1s | Server |
+| F02 | In progress | Fire sources influence nearby animals - F02a brandish scare done; ground fires later | - | range 12 / chance 0.25 / 1s | Server |
 | F03 | Planned | Animals can flee, disengage, investigate, or ignore fire | - | - | Server |
 | F04 | Planned | Configure fire sources, ranges, probabilities, and reactions | - | - | Server |
 
@@ -50,7 +50,7 @@ is in the main hand. Scoping the stance to actual threats is F02/F03 work.
 | D06 | Planned | Fire reactions are configurable per fire source and animal behavior profile. |
 | D07 | Active | Brandishing uses the interact (right-click) channel and only begins with no block targeted, because vanilla assigns every block-targeted right-click of a lit torch: plain right-click places it and `CanIgnite` owns the shift ignite gesture. Block-targeted input reaches the mod untouched. |
 | D08 | Active | F01 is a `CollectibleBehavior` prepended onto lit torches in `AssetsFinalize` (both sides), not Harmony. Must run before `CanIgnite` and use `PreventSubsequent` while raised so aim-crossing a block cannot start fires. Code attach (not a JSON patch) so we can skip extinct / non-torch `BlockTorch` assets. |
-| D09 | Active | F02 ships in slices. F02a: brandished torch only — no ground fires, no config. Later: placed fire sources (F02b), richer reactions (F03). |
+| D09 | Active | F02 ships in slices. F02a: brandished torch only - no ground fires, no config. Later: placed fire sources (F02b), richer reactions (F03). |
 | D10 | Active | F02a calls vanilla `AiTaskFleeEntity` / `AiTaskFleeEntityR`.InstaFleeFrom when an active aggressive targetable task is targeting the brandishing player. No custom AI task. |
 
 ## Extension inventory
@@ -62,7 +62,7 @@ is in the main hand. Scoping the stance to actual threats is F02/F03 work.
 
 ## F02a (done)
 
-Brandishing players: nearby hostiles actively targeting them get a periodic chance to flee via `InstaFleeFrom`. No network channel — relies on use sync for server brandish state (confirm on dedicated server).
+Brandishing players: nearby hostiles actively targeting them get a periodic chance to flee via `InstaFleeFrom`. No network channel - relies on use sync for server brandish state (confirm on dedicated server).
 
 **Later:** F02b ground fires, F03 reaction profiles, F04 config.
 ## Design notes

docs/MODDB.html

@@ -1,17 +1,14 @@
 <h2>Pyrophobia</h2>
-<h3>Fire changes how wildlife sees you</h3>
-<p>Pyrophobia is a fire-driven wildlife deterrence mod for Vintage Story. The
-  planned core mechanic lets a player raise a main-hand torch to scare off or
-  discourage hostile animals.</p>
-<p>Fire sources in the world, including ground torches and firepits, will also
-  influence nearby animal behavior. Some animals may retreat from fire, while
-  hungry hunters may investigate an isolated fire instead. These reactions are
-  intended to be configurable.</p>
+<h3>Raise a torch. Make wildlife think twice.</h3>
+<p>Pyrophobia is a fire-driven wildlife deterrence mod for Vintage Story.
+  Hold right-click with a lit main-hand torch to brandish it. Nearby hostiles
+  that are targeting you may break off and flee while it is raised.</p>
+<p>Ground fires, richer animal reactions, and configuration are planned for
+  later releases.</p>
 <h3>Features</h3>
 <ul>
-  <li><strong>Raised torch:</strong> deter hostile animals that are attacking or pursuing the player.</li>
-  <li><strong>Environmental fire:</strong> let torches, firepits, and other fire sources influence wildlife.</li>
-  <li><strong>Configurable reactions:</strong> tune ranges, probabilities, and animal responses.</li>
+  <li><strong>Brandish stance:</strong> raise a lit torch in first and third person (open air / creature aim). Block-targeted use stays vanilla: place, relight, shift-ignite.</li>
+  <li><strong>Scare hostiles:</strong> animals actively targeting you can flee while you brandish (chance-based, server-side).</li>
 </ul>
 <h3>Compatibility and installation</h3>
 <ul>
@@ -23,5 +20,5 @@ <h3>Compatibility and installation</h3>
   install. For a manual installation, place the zip in the Vintage Story
   <code>Mods</code> directory without unpacking it, then restart the game or server.</p>
 <h3>Project status</h3>
-<p>This is an early development baseline. The project currently contains the
-  mod scaffold and design contract; gameplay behavior is not implemented yet.</p>
+<p><strong>0.1.0-pre.1</strong> - early pre-release. Brandish + first scare
+  reaction only. Feedback welcome, especially on dedicated servers.</p>

resources/modinfo.json

@@ -4,7 +4,7 @@
   "name": "Pyrophobia",
   "authors": [ "stinow" ],
   "description": "A fire-driven wildlife deterrence system for Vintage Story.",
-  "version": "0.1.0",
+  "version": "0.1.0-pre.1",
   "side": "universal",
   "requiredOnClient": true,
   "requiredOnServer": true,

src/Scare/BrandishScareService.cs

@@ -7,7 +7,7 @@
 namespace Pyrophobia.Scare;
 
 /// <summary>
-/// F02a / D03–D05 / D09–D10: server tick - brandishing players periodically
+/// F02a / D03-D05 / D09-D10: server tick - brandishing players periodically
 /// scare hostiles that are actively targeting them via vanilla InstaFleeFrom.
 /// (Main thread. Hardcoded knobs until F04)
 /// </summary>