From c699f1a7918fadb3be1f6d5dc7b338a2b95a3acd Mon Sep 17 00:00:00 2001
From: Mod Documentation Updater <github-actions[bot]@users.noreply.github.com>
Date: Wed, 12 Aug 2026 00:36:14 +0000
Subject: [PATCH] docs: update modding documentation

---
 docs/combat/effects.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/combat/effects.md b/docs/combat/effects.md
index 682aa3c..0849b62 100644
--- a/docs/combat/effects.md
+++ b/docs/combat/effects.md
@@ -180,10 +180,14 @@ Gives a buff to the enemy.
 {
   kind: 'buffTarget',
   amount: { value: 3, stat: undefined },
-  buff: debuffBuff
+  buff: debuffBuff,
+  hideBuff?: true, // Don't show buff in tooltips
+  initialState?: Record<string, Scaling> // Seeds the created buff's internalState (evaluated in this effect's context)
 }
 ```
 
+**New in recent update:** `initialState` seeds the created buff's `internalState` at application time, with each value resolved in the effect's scaling scope. This mirrors the `initialState` field already available on `buffSelf`. It is useful for debuffs that track a value derived from the technique's context — for example, a debuff that stores how much damage was absorbed during the application and exposes it via `stateTooltip`.
+
 ### `consumeTarget`
 
 Removes a buff from the enemy.