> For the complete documentation index, see [llms.txt](https://visionfrog.gitbook.io/untitled/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://visionfrog.gitbook.io/untitled/readme/effect/trigger.md). # Trigger Trigger Events ## List of Card Triggers
TriggerExplanationTypeOnlyWhen
DrawDrawCardHand
PlayPlaySpellHand
ConsumeSingle-UseSpellHand
RoundEndTurn-EndCardAll
RoundBeginTurn-StartCardAll
TimeExplodeTime ExplosionCardAll
TimeSafeSafety TimerCardAll
PlacePlacementItemLand
DestroyDestroyItemLand
GrowGrowthItem-PlantLand
HarvestHarvestItem-PlantLand
BuffAura Effect (Active on play, lost on removal)ItemLand
YearBeginYear-StartCardBag, Land
YearEndYear-EndCardBag, Land
AddPlace in bagCardBag
AfterPlayOn PlayCardHand
SellSellCardHand, Land
TypeOnly: Indicates that this event is exclusive to a specific category of cards. When: Indicates whether this event triggers while in the hand or on the field. All means it can trigger in either location. **Example:** Place is an event unique to Items, and it only triggers when the item is on the field. **Two Special Events:** TimeExplode: Triggers when Time Cost exceeds the Time Scale Limit. TimeSafe: Evaluated at the end of the turn. If no Time Explosion occurred this turn, the TimeSafe event triggers. {% hint style="info" %} The game automatically settles Time Tags during the draw phase; there is no need to add this the Effect field. {% endhint %} {% hint style="info" %} Buff does not accept If conditions. The Result must use the [Buff](/untitled/readme/event.md#buffevent) event specified in the Event list. {% endhint %} ## Relic Trigger Table
TriggerExplanationTypeOnlyWhen
GainGainRelicsAll
RoundBeginTurn-StartRelicsAll
RoundEndTurn-EndRelicsAll
TimeExplodeTime ExplosionRelicsAll
TimeSafeSafety TimerRelicsAll
YearBeginYear-StartRelicsAll
YearEndYear-EndRelicsAll
DyingNear-Death (No GlobalMultiplier)RelicsAll
## Special Trigger ### Watch Watch: Represents the need to count the play frequency of a specific card or the trigger frequency of a standard Trigger. The tracked value will be stored in [SpecialVal](/untitled/readme/value.md#cardinfo-ka-pai). The effect following a Watch command triggers whenever the tracked value **changes**. Usage Specifications: Watch(WatchType,value) WatchType Currently Supports: （1）Trigger ***This is only supported for Trinkets and cannot appear multiple times within an EffectString.*** Tracks the frequency of a specific event on the card itself. （2）Condition Tracks the play/placement frequency of cards that meet a specific Condition. Example：**Watch(Condition,Type;Is;Plant)** （3）Global Monitors the Increase/Decrease of a Global Variable [value](/untitled/readme/value.md#global-quan-ju-xin-xi). When monitoring a variable, the resulting effect cannot perform the same operation on that variable. For example: If monitoring HP reduction, the effect itself cannot cause HP reduction. Special: Monitors Overhealing. ***Watch(GlobalNum,OnExcessiveHealPlus)*** Example: ***Watch(GlobalTimes,TempTimeLabelLimitPlus)*** Tracks the number of times the Temporary Time Scale has increased. ***Watch(GlobalNum,TempTimeLabelLimitPlus)*** Tracks the increase of the Temporary Time Scale. （4）Around,Harvest Counts the harvest frequency of adjacent plants. （5）ConditionDestroy Counts the destruction frequency of items on the field meeting the Condition. Example：Watch(ConditionDestroy,Type;Is;Plant) #### Harvest （1）Harvest,Type:Value /AroundHarvest Counts the harvest frequency of plants where Type is Value. （2）Harvest,Name:Value /AroundHarvest Counts the harvest frequency of plants where Name is Value. （3）Harvest,None Counts global plant harvest frequency. （4）Havrest,NameContain:Value /AroundHarvest Counts the harvest frequency of plants with names containing Value. #### BagIn （1）BagIn,Name:Value Counts the frequency of cards named Value being put into the Bag. （2）BagIn,NameContain:Value Counts the frequency of cards named Value being put into the Bag. （3）BagIn,Type:Value Counts the frequency of cards of Type Value being put into the Bag. （4）BagIn,Catogary:Value Counts the frequency of cards of Category Category being put into the Bag. （5）BagIn,None Counts the frequency of putting card packs into the Bag. **DrawCondition** （1）DrawCondition,Condition Counts the draw frequency of cards meeting the Condition. **GlobalEvent** （1）GlobalEvent,AllGrow Counts the frequency of Global Growth triggers. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://visionfrog.gitbook.io/untitled/readme/effect/trigger.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.