Merge branch 'master' into auto-apply-ability-order

Resolve conflicts:
- YieldUpdate.java: keep both SetYieldPref (V2) and ClearAbilityOrders permits
- PlayerControllerHuman.applyYieldUpdate: switch to yieldController.apply()
  delegation; keep ClearAbilityOrders branch early-returning since
  orderedSALookup lives on PCH, not YieldController
- GameMenu / VGameMenu: combine V2's Yield Settings + Auto-Pass items
  with our Clear-Ability-Orders item (Auto-mode only)
- ForgePreferences: keep our UI_REORDER_SIMULTANEOUS_ABILITY_MODE
  alongside V2's YIELD_* prefs + UI_AUTO_DECISION_MODE rename

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: MostCromulent

CONTRIBUTING.md

@@ -62,6 +62,12 @@ Card scripting resources are found in the forge-gui/res/ path.
 
 Art files need to be copyright-free and they should be in the public domain.
 
+## Using AI coding agents
+
+If you use an AI agent (e.g. Claude Code, OpenAI Codex) to substantially code a contribution to Forge please identify this when you make a pull request, either by including the coding agent as a co-author or by noting in the body of the request.
+
+Agents have a tendency to add unnecessary new unit or wiring tests to the CI suite. This should be avoided unless necessary to catch potential future integration regressions.
+
 ### Project Hierarchy
 
 Forge is divided into 4 primary projects with additional projects that target specific platform releases. The primary projects are:

docs/Credit-and-Thanks.md

@@ -29,4 +29,7 @@ Some of the sprites and tiles that are used in Adventure mode come from external
 1. Forest biome = Enchanted Forest - Logan Epic Canto // The Celtic King
 1. Plains biome = Cobblestone Village - Brandon Fiechter //  Camelot - Brandon Fiechter
 1. Mountain biome = Goblin Tinker - Brandon Fiechter // Goblin King's Tavern - Brandon Fiechter
-1. Castle = Horus - Brandon Fiechter & Derek Fiechter
+1. Castle = Horus - Brandon Fiechter & Derek Fiechter
+
+## Other sprites and icons
+1. Clipboard icon by Dimitry Miroliubov at [Flaticon](https://www.flaticon.com/free-icon/clipboard_340068)

docs/Frequently-Asked-Questions.md

@@ -9,7 +9,6 @@ https://discord.com/channels/267367946135928833/1047001034788196452
 # General
 
 ## How do I download content?
-
 Forge has content downloaders within the app itself, you can use those tools to update the graphics assets. More information about card and token image assets can be found here. [Card Images, Downloading](Card-Images.md#downloading)
 
 ## My desktop match/deck view is all messed up?
@@ -20,7 +19,6 @@ Sometimes people will decide that they do not like the changes that they made an
 Also use the mentioned measure if your match or deckeditor won't start - it would help in 90% of the cases.
 
 ## I think I found a bug in Forge. What do I do?
-
 *Most users, who are running beta versions of Forge, should continue to use these instructions. As for alpha testers, these instructions have yet to be made congruent with the latest automatic bug reporting from within Forge.*
 
 Bug reports from users are the lifeblood of Forge. Please keep in mind that "beta" releases *are* test releases. Forge is constantly evolving, so we do not yet have "stable" or "production" releases. Because of the pace at which new cards are added to the multiverse by external forces, this will be the  norm for some time. We do not expect everything to work 100%. We have a small number of developers and a handful of slightly less technical people actively improving the game. We simply cannot devote the resources to test every single card, much less the nearly infinite ways the cards can interact.
@@ -38,13 +36,11 @@ Because duplicate bug reports use up our limited resources, please research your
 * If you're unsure, you can also post on one of the support channels of the discord. In case you do not get a timely response, please submit a new issue anyway to make sure it doesn't get lost.
 
 ## I have an idea to make Forge better. What do I do?
-
 Follow the directions in [Bug Reports](Frequently-Asked-Questions#i-think-i-found-a-bug-in-forge-what-do-i-do), keeping in mind that you are not reporting a bug, but rather a **Feature Request**.
 
 # Development
 
 ## I want to help develop Forge. How do I get started?
-
 Forge is written in Java, so knowledge in that language (or similar Object Oriented languages like C++ or C\#) is very helpful. However, it is possible to learn the grammar for writing the data objects of cards without programming experience.
 
 A development environment such as [IntelliJ](https://www.jetbrains.com/idea) is beneficial, as it helps writing, compiling and testing your changes.
@@ -64,25 +60,20 @@ For smaller first-time contributions using the GitHub web interface is also an a
 To obtain the source code of Forge, read our [Development Guide](Development/IntelliJ-setup/IntelliJ-setup.md).
 
 ## My system is all setup to help. What now?
-
 Take a look through the /res/cardsfolder folder. This is where all the card data lives. If you know of cards that are missing from Forge, see if there are similar cards that already exist.
 
 # Gameplay
 
 ## Where do I use Flashback or a similar ability that is in an External area?
-
 Click on the Lightning Bolt icon in the player panel. Since cards with external Activations aren't as clear to activate, we created this shortcut for this specific purpose. After the last card is removed from a zone window, that window will automatically be hidden.
 
 ## How do I target a player?
-
 Just click on the player's Avatar in the Player Panel when prompted to select a Player as a target.
 
 ## Where did my mana go?
-
 If you have an effect that generated you some mana, and you don't know where it is. Check out the Player Panel. There are 6 different mana subpools one for each color/colorless that should have it. If you accidentally tapped your mana before your Main Phase, your mana is gone. Sorry, we don't have a way at this time to revert these actions. In general, I'd say it's easier/better to start casting a spell first, then activate your mana so this doesn't happen.
 
 # Quest Mode
 
 ## What is the difference between Fantasy Quest and Normal Quest?
-
-In Normal Quest, you start with 20 life and only have access to the Card Shop. In Fantasy Quest, you start at 15 life and gain additional access to the Bazaar which allows you to buy things like extra life points, Pets, Plants and more.
+In Normal Quest, you start with 20 life and only have access to the Card Shop. In Fantasy, you start at 15 life and gain additional access to the Bazaar which allows you to buy things like extra life points, Pets, Plants and more.