Contributing Translations

How to translate the Accessible Arena mod into your language.

Quick Start

Open lang/en.json (English reference) and the target lang/{code}.json
Translate the values (right side of the colon). Never change the keys (left side).
Keep all {0}, {1} placeholders in your translation - they get replaced with dynamic values at runtime
Submit a pull request

File Format

Each locale file is flat JSON with key-value pairs:

{
  "KeyName": "Translated text",
  "Greeting_Format": "Hello {0}, you have {1} items"
}

Rules:

Keys (left side) must stay exactly as-is in English
Values (right side) are what you translate
Placeholders like {0}, {1} must appear in your translation (order can change to fit your grammar)
Use \" for quotes inside strings, \n for line breaks

Supported Languages

Code	Language
en	English (reference)
de	German
fr	French
es	Spanish
it	Italian
pt-BR	Portuguese (Brazil)
ja	Japanese
ko	Korean
ru	Russian
pl	Polish
zh-CN	Chinese (Simplified)
zh-TW	Chinese (Traditional)

Pluralization

Some strings come in sets with suffixes. The mod picks the right form based on the count.

Standard languages (en, de, fr, es, it, pt-BR):

_One - used when count is exactly 1
_Format - used for all other counts (0, 2, 3, …)

Slavic languages (ru, pl):

_One - count is 1
_Few - count ends in 2-4 but not 12-14 (e.g., 2, 3, 4, 22, 23, 24)
_Format - everything else (0, 5-20, 25-30, …)

East Asian languages (ja, ko, zh-CN, zh-TW):

Only _Format is used (no singular/plural distinction)
You can include _One for completeness, but it won’t be used

Example set:

"ZoneWithCount_One": "{0}, 1 card",
"ZoneWithCount_Few": "{0}, {1} karty",
"ZoneWithCount_Format": "{0}, {1} cards"

If a _Few key is missing for Russian/Polish, the mod falls back to _Format.

String Reference

Below is every key in en.json with context about where it appears and what the placeholders mean.

General UI

Key	English	Context
`ModLoaded`	“MTGA Accessibility Mod loaded”	Announced once when the game starts
`Back`	“Back”	Announced when navigating back
`NoSelection`	“No selection”	When nothing is focused
`NoAlternateAction`	“No alternate action available”	When user tries an alternate action on an element that doesn’t have one
`NoNextItem`	“No next item”	Reached end of a list
`NoPreviousItem`	“No previous item”	Reached beginning of a list
`ItemDisabled`	“Item is disabled”	When trying to activate a disabled element

Card Actions

Key	English	Placeholders	Context
`Activating_Format`	“Activating {0}”	{0} = element name	Announced when clicking a UI element
`CannotActivate_Format`	“Cannot activate {0}”	{0} = element name	Element couldn’t be activated
`CouldNotPlay_Format`	“Could not play {0}”	{0} = card name	Card play failed
`NoAbilityAvailable_Format`	“{0} has no activatable ability”	{0} = card name	Right-click on card with no ability
`NoCardSelected`	“No card selected”		Trying to play when nothing is focused

Key	English	Context
`NavigateWithArrows`	“Arrow keys to navigate”	Appended to screen announcements as a hint
`BeginningOfList`	“Beginning of list”	Navigated past the first item
`EndOfList`	“End of list”	Navigated past the last item
`NavigateHint`	“Arrow keys to navigate, Enter to select”	General navigation hint
`BrowserHint`	“Tab to see card, Enter to keep on top”	Scry/Surveil browser hint
`EnterToSelect`	“Enter to select”	Short action hint
`TabToNavigate`	“Tab to navigate”	Short action hint

Key	English	Context
`OpeningPlayModes`	“Opening play modes…”	Navigating to play mode screen
`OpeningDeckManager`	“Opening deck manager…”	Navigating to deck screen
`OpeningStore`	“Opening store…”	Navigating to store
`OpeningMastery`	“Opening mastery…”	Navigating to mastery/battle pass
`OpeningProfile`	“Opening profile…”	Navigating to player profile
`OpeningSettings`	“Opening settings…”	Navigating to settings
`QuittingGame`	“Quitting game…”	Player is quitting
`CannotNavigateHome`	“Cannot navigate to Home”	Home navigation failed
`HomeNotAvailable`	“Home button not available”	Home button not found
`ReturningHome`	“Returning to Home”	Going back to home screen
`OpeningColorChallenges`	“Opening color challenges”	Navigating to color challenge
`NavigatingBack`	“Back”	Going back one screen
`ClosingSettings`	“Closing settings”	Leaving settings screen
`ClosingPlayBlade`	“Closing play menu”	Closing the play mode panel
`ExitingDeckBuilder`	“Exiting deck builder”	Leaving deck builder

Deck Info

Key	English	Context
`DeckInfoCardCount`	“Card Count”	Deck statistics section label
`DeckInfoManaCurve`	“Mana Curve”	Deck statistics section label
`DeckInfoTypeBreakdown`	“Types”	Deck statistics section label

Key	English	Context
`BirthYearField`	“Birth year field. Use arrow keys to select year.”	Account creation form
`BirthMonthField`	“Birth month field. Use arrow keys to select month.”	Account creation form
`BirthDayField`	“Birth day field. Use arrow keys to select day.”	Account creation form
`CountryField`	“Country field. Use arrow keys to select country.”	Account creation form
`EmailField`	“Email field. Type your email address.”	Login/account form
`PasswordField`	“Password field. Type your password.”	Login/account form
`ConfirmPasswordField`	“Confirm password field. Retype your password.”	Account creation form
`AcceptTermsCheckbox`	“Accept terms checkbox. Press Enter to toggle.”	Account creation form
`LoggingIn`	“Logging in…”	During login
`CreatingAccount`	“Creating account…”	During account creation
`SubmittingPasswordReset`	“Submitting password reset request…”	Password reset
`CheckingQueuePosition`	“Checking queue position…”	Server queue
`OpeningSupportWebsite`	“Opening support website…”	Help link
`NoTermsContentFound`	“No terms content found”	Terms of service empty

Key	English	Placeholders	Context
`EndOfBattlefield`	“End of battlefield”		Scrolled past last row
`BeginningOfBattlefield`	“Beginning of battlefield”		Scrolled past first row
`EndOfRow`	“End of row”		Last card in a battlefield row
`BeginningOfRow`	“Beginning of row”		First card in a battlefield row
`RowEmpty_Format`	“{0} is empty”	{0} = row name (e.g., “Creatures”)	Empty battlefield row
`RowWithCount_One`	“{0}, 1 card”	{0} = row name	Row with one card
`RowWithCount_Format`	“{0}, {1} cards”	{0} = row name, {1} = count	Row with multiple cards
`RowEmptyShort_Format`	“{0}, empty”	{0} = row name	Short form for empty row

Key	English	Placeholders	Context
`EndOfZone`	“End of zone”		Last card in hand/graveyard/exile
`BeginningOfZone`	“Beginning of zone”		First card in zone
`ZoneNotFound_Format`	“{0} not found”	{0} = zone name	Zone doesn’t exist
`ZoneEmpty_Format`	“{0}, empty”	{0} = zone name	Zone has no cards
`ZoneWithCount_One`	“{0}, 1 card”	{0} = zone name	Zone with one card
`ZoneWithCount_Format`	“{0}, {1} cards”	{0} = zone name, {1} = count	Zone with multiple cards
`ZoneEntry_Format`	“{0}: {1} cards. {2}, 1 of {3}”	{0} = zone name, {1} = total, {2} = first card, {3} = total	Entering a zone
`ZoneEntryEmpty_Format`	“{0}: empty”	{0} = zone name	Entering an empty zone
`CardInZone_Format`	“{0}, {1}, {2} of {3}”	{0} = card, {1} = zone label, {2} = position, {3} = total	Card position in zone

Targeting

Key	English	Placeholders	Context
`NoValidTargets`	“No valid targets”		No targets available
`NoTargetSelected`	“No target selected”		Confirm without selecting
`TargetingCancelled`	“Targeting cancelled”		User cancelled targeting
`SelectTargetNoValid`	“Select a target. No valid targets found.”		Targeting with none available
`Targeted_Format`	“Targeted {0}”	{0} = target name	Successfully targeted
`CouldNotTarget_Format`	“Could not target {0}”	{0} = target name	Target failed

Spells and Abilities

Key	English	Context
`NoPlayableCards`	“No playable cards”	No cards can be played right now
`SpellCast`	“Spell cast”	A spell was successfully cast
`SpellCastPrefix`	“Cast”	Prefix: “Cast Lightning Bolt”
`SpellUnknown`	“unknown spell”	Spell name couldn’t be determined
`ResolveStackFirst`	“Resolve stack first. Press Space to resolve or Tab to select targets.”	Stack needs resolving
`AbilityTriggered`	“triggered”	Label for triggered abilities on stack
`AbilityActivated`	“activated”	Label for activated abilities on stack
`AbilityUnknown`	“Ability”	Fallback ability name
`WaitingForPlayable`	“Waiting for playable cards…”	Auto-pass while no actions available

Discard

Key	English	Placeholders	Context
`NoSubmitButtonFound`	“No submit button found”		Internal error
`CouldNotSubmitDiscard`	“Could not submit discard”		Discard submission failed
`DiscardCount_One`	“Discard 1 card”		Discard prompt for 1
`DiscardCount_Format`	“Discard {0} cards”	{0} = count	Discard prompt for multiple
`CardsSelected_One`	“1 card selected”		Selection count
`CardsSelected_Format`	“{0} cards selected”	{0} = count	Selection count
`NeedHaveSelected_Format`	“Need {0}, have {1} selected”	{0} = required, {1} = current	How many more to select
`SubmittingDiscard_Format`	“Submitting {0} cards for discard”	{0} = count	Confirming discard
`CouldNotSelect_Format`	“Could not select {0}”	{0} = card name	Card selection failed

Card Details

Key	English	Context
`EndOfCard`	“End of card”	Scrolled past last detail line
`BeginningOfCard`	“Beginning of card”	Scrolled past first detail line
`CardInfoName`	“Name”	Card detail label
`CardInfoQuantity`	“Quantity”	How many copies owned
`CardInfoCollection`	“Collection”	Collection/set name
`CardInfoManaCost`	“Mana Cost”	Card’s mana cost
`CardInfoPowerToughness`	“Power and Toughness”	Creature P/T
`CardInfoType`	“Type”	Card type line
`CardInfoRules`	“Rules”	Rules text
`CardInfoChosen`	“Chosen”	Block label for the chosen type/color recorded on a card by effects like Cavern of Souls (LinkedInfoText). Read after rules text.
`CardInfoNamedCard`	“Named card”	Block label for card names recorded on a card by Pithing Needle / Meddling Mage / Cabal Therapy (LinkedInfoTitleLocIds). Read after rules text.
`CardInfoFlavor`	“Flavor”	Flavor text
`CardInfoArtist`	“Artist”	Card artist
`CardPosition_Format`	“{0}{1}, {2} of {3}”	{0} = card name, {1} = status suffix, {2} = position, {3} = total

Library, Hand, and Counts

Key	English	Placeholders	Context
`LibraryCount_One`	“Library, 1 card”		Your library has 1 card
`LibraryCount_Format`	“Library, {0} cards”	{0} = count	Your library count
`OpponentLibraryCount_One`	“Opponent’s library, 1 card”		Opponent’s library has 1 card
`OpponentLibraryCount_Format`	“Opponent’s library, {0} cards”	{0} = count	Opponent’s library count
`OpponentHandCount_One`	“Opponent’s hand, 1 card”		Opponent has 1 card in hand
`OpponentHandCount_Format`	“Opponent’s hand, {0} cards”	{0} = count	Opponent’s hand count
`LibraryCountNotAvailable`	“Library count not available”		Data unavailable
`OpponentLibraryCountNotAvailable`	“Opponent’s library count not available”		Data unavailable
`OpponentHandCountNotAvailable`	“Opponent’s hand count not available”		Data unavailable

Player Info

Key	English	Placeholders	Context
`PlayerInfo`	“Player info”		Player info zone label
`You`	“You”		Label for your player
`Opponent`	“Opponent”		Label for opponent
`EndOfProperties`	“End of properties”		Scrolled past last property
`PlayerType`	“player”		Word “player” for announcements
`Life_Format`	“{0} life”	{0} = life total	Life announcement
`LifeNotAvailable`	“Life not available”		Life data unavailable
`TimerNotAvailable`	“Timer not available”		Timer data unavailable
`Timeouts_One`	“1 timeout”		Player has 1 timeout
`Timeouts_Format`	“{0} timeouts”	{0} = count	Player timeout count
`GamesWon_One`	“1 game won”		Best-of-3 wins
`GamesWon_Format`	“{0} games won”	{0} = count	Best-of-3 wins
`WinsNotAvailable`	“Wins not available”		Data unavailable
`RankNotAvailable`	“Rank not available”		Data unavailable

Emotes

Key	English	Placeholders	Context
`Emotes`	“Emotes”		Emote menu label
`EmoteSent_Format`	“{0} sent”	{0} = emote name	Emote was sent
`EmotesNotAvailable`	“Emotes not available”		Emote system unavailable

Input Fields

Key	English	Placeholders	Context
`InputFieldEmpty`	“empty”		Input field has no text
`InputFieldStart`	“start”		Cursor at start
`InputFieldEnd`	“end”		Cursor at end
`InputFieldStar`	“star”		Star character for passwords
`InputFieldCharacterCount_One`	“1 character”		Field has 1 character
`InputFieldCharacterCount_Format`	“{0} characters”	{0} = count	Character count
`InputFieldContent_Format`	“{0}: {1}”	{0} = label, {1} = content	Field with content
`InputFieldEmptyWithLabel_Format`	“{0}, empty”	{0} = label	Empty field with label
`InputFieldPasswordWithCount_Format`	“{0}, {1} characters”	{0} = label, {1} = count	Password field (content hidden)
`EditingTextField`	“Editing. Type to enter text, Escape to exit.”		Entered edit mode
`ExitedEditMode`	“Exited edit mode”		Left edit mode
`TextField`	“text field”		Generic label
`HasCharacters_Format`	“has {0} characters”	{0} = count	Character count info
`ExitedInputField`	“Exited input field”		Left input field

Character Names (for reading input aloud)

These are the spoken names for special characters when reading input fields character by character.

Key	English	Context
`CharSpace`	“space”	Space character
`CharDot`	“dot”	Period (.)
`CharComma`	“comma”	Comma (,)
`CharExclamation`	“exclamation”	Exclamation mark (!)
`CharQuestion`	“question”	Question mark (?)
`CharAt`	“at”	At sign (@)
`CharHash`	“hash”	Hash (#)
`CharDollar`	“dollar”	Dollar ($)
`CharPercent`	“percent”	Percent (%)
`CharAnd`	“and”	Ampersand (&)
`CharStar`	“star”	Asterisk (*)
`CharDash`	“dash”	Hyphen (-)
`CharUnderscore`	“underscore”	Underscore (_)
`CharPlus`	“plus”	Plus (+)
`CharEquals`	“equals”	Equals (=)
`CharSlash`	“slash”	Forward slash (/)
`CharBackslash`	“backslash”	Backslash ()
`CharColon`	“colon”	Colon (:)
`CharSemicolon`	“semicolon”	Semicolon (;)
`CharQuote`	“quote”	Double quote (“)
`CharApostrophe`	“apostrophe”	Single quote (‘)
`CharOpenParen`	“open paren”	Opening parenthesis
`CharCloseParen`	“close paren”	Closing parenthesis
`CharOpenBracket`	“open bracket”	Opening square bracket
`CharCloseBracket`	“close bracket”	Closing square bracket
`CharOpenBrace`	“open brace”	Opening curly brace
`CharCloseBrace`	“close brace”	Closing curly brace
`CharLessThan`	“less than”	Less than (<)
`CharGreaterThan`	“greater than”	Greater than (>)
`CharPipe`	“pipe”	Pipe (	)
`CharTilde`	“tilde”	Tilde (~)
`CharBacktick`	“backtick”	Backtick (`)
`CharCaret`	“caret”	Caret (^)

Mana Symbols

Spoken names for mana symbols on cards.

Key	English	Placeholders	Context
`ManaTap`	“Tap”		Tap symbol (T)
`ManaUntap`	“Untap”		Untap symbol (Q)
`ManaWhite`	“White”		White mana (W)
`ManaBlue`	“Blue”		Blue mana (U)
`ManaBlack`	“Black”		Black mana (B)
`ManaRed`	“Red”		Red mana (R)
`ManaGreen`	“Green”		Green mana (G)
`ManaColorless`	“Colorless”		Colorless mana (C)
`ManaX`	“X”		Variable mana (X)
`ManaSnow`	“Snow”		Snow mana (S)
`ManaEnergy`	“Energy”		Energy counter (E)
`ManaFree`	“Free”		Used as the whole mana-cost line for cards costing 0 — both printed zero-cost cards (Memnite, Mox Amber) and cards discounted to 0 by cost reducers / Suspend / Cascade. Pick whatever word your locale uses for “free spell” or “no cost” — short and unambiguous when announced after “Mana Cost:”.
`ManaPhyrexian_Format`	“Phyrexian {0}”	{0} = color name	Phyrexian mana (e.g., “Phyrexian Red”)
`ManaHybrid_Format`	“{0} or {1}”	{0} = color 1, {1} = color 2	Hybrid mana (e.g., “White or Blue”)

Key	English	Context
`SettingsMenuTitle`	“Mod Settings”	Settings menu title
`SettingsMenuInstructions`	“Arrow Up and Down to navigate, Enter to change, Backspace or F2 to close”	Settings hint
`SettingsMenuClosed`	“Mod settings closed”	Leaving settings
`SettingLanguage`	“Language”	Language setting label
`SettingTutorialMessages`	“Tutorial messages”	Tutorial hints toggle
`SettingVerboseAnnouncements`	“Verbose announcements”	Verbose mode toggle
`SettingOn`	“On”	Toggle state
`SettingOff`	“Off”	Toggle state
`SettingChanged_Format`	“{0} set to {1}”	{0} = setting name, {1} = new value
`SettingItemPosition_Format`	“{0} of {1}: {2}”	{0} = position, {1} = total, {2} = item text

Key	English	Context
`HelpMenuTitle`	“Help Menu”	Help screen title
`HelpMenuInstructions`	“Arrow Up and Down to navigate, Backspace or F1 to close”	Help hint
`HelpItemPosition_Format`	“{0} of {1}: {2}”	{0} = position, {1} = total, {2} = help text
`HelpMenuClosed`	“Help closed”	Leaving help

Help Categories

Key	English	Context
`HelpCategoryGlobal`	“Global shortcuts”	Help section heading
`HelpCategoryMenuNavigation`	“Menu navigation”	Help section heading
`HelpCategoryDuelZones`	“Zones in duel”	Help section heading
`HelpCategoryDuelInfo`	“Duel information”	Help section heading
`HelpCategoryCardNavigation`	“Card navigation in zone”	Help section heading
`HelpCategoryCardDetails`	“Card details”	Help section heading
`HelpCategoryCombat`	“Combat”	Help section heading
`HelpCategoryBrowser`	“Browser (Scry, Surveil, Mulligan)”	Help section heading
`HelpCategoryInputFields`	“Input fields”	Help section heading
`HelpCategoryDebug`	“Debug keys (developers)”	Help section heading

Help Items

These are the individual shortcut descriptions shown in the help menu. Translate naturally - the key names describe the shortcut, but the value should read well as a spoken instruction.

Key	English
`HelpF1Help`	“F1: Help menu”
`HelpF2Settings`	“F2: Settings menu”
`HelpF3Context`	“F3: Current screen”
`HelpCtrlRRepeat`	“Control plus R: Repeat last announcement”
`HelpBackspace`	“Backspace: Back, dismiss, or cancel”
`HelpArrowUpDown`	“Arrow Up or Down: Navigate menu items”
`HelpTabNavigation`	“Tab or Shift plus Tab: Navigate menu items, or switch groups in collection”
`HelpArrowLeftRight`	“Arrow Left or Right: Carousel and stepper controls”
`HelpHomeEnd`	“Home or End: Jump to first or last item”
`HelpPageUpDown`	“Page Up or Page Down: Previous or next page in collection”
`HelpNumberKeysFilters`	“Number keys 1 to 0: Activate filters 1 to 10 in collection”
`HelpEnterSpace`	“Enter or Space: Activate”
`HelpEnterEditField`	“Enter: Start editing text field”
`HelpEscapeExitField`	“Escape: Stop editing, stay on field”
`HelpTabNextField`	“Tab: Stop editing and move to next element”
`HelpShiftTabPrevField`	“Shift plus Tab: Stop editing and move to previous element”
`HelpArrowsInField`	“Arrows in field: Left or Right reads character, Up or Down reads content”
`HelpCHand`	“C: Your hand, Shift plus C: Opponent hand count”
`HelpBBattlefield`	“B: Your creatures, Shift plus B: Opponent creatures”
`HelpALands`	“A: Your lands, Shift plus A: Opponent lands”
`HelpRNonCreatures`	“R: Your non-creatures, Shift plus R: Opponent non-creatures”
`HelpGGraveyard`	“G: Your graveyard, Shift plus G: Opponent graveyard”
`HelpXExile`	“X: Your exile, Shift plus X: Opponent exile”
`HelpSStack`	“S: Stack”
`HelpDLibrary`	“D: Your library count, Shift plus D: Opponent library count”
`HelpLLifeTotals`	“L: Life totals”
`HelpTTurnPhase`	“T: Turn and phase”
`HelpVPlayerInfo`	“V: Player info zone”
`HelpLeftRightCards`	“Left or Right arrow: Previous or next card”
`HelpHomeEndCards`	“Home or End: First or last card”
`HelpEnterPlay`	“Enter: Play or activate card”
`HelpTabTargets`	“Tab: Cycle through targets or playable cards”
`HelpUpDownDetails`	“Up or Down arrow: Navigate card details”
`HelpSpaceCombat`	“Space: Confirm attackers or blockers”
`HelpBackspaceCombat`	“Backspace: No attacks or cancel blocks”
`HelpTabBrowser`	“Tab: Navigate all cards”
`HelpCDZones`	“C or D: Jump to keep or bottom zone”
`HelpEnterToggle`	“Enter: Toggle card between zones”
`HelpSpaceConfirm`	“Space: Confirm selection”
`HelpF4Refresh`	“F4: Refresh current navigator”
`HelpF11CardDump`	“F11: Dump card details to log (pack opening)”
`HelpF12UIDump`	“F12: Dump UI hierarchy to log”

Browser (Scry, Surveil, Mulligan)

Key	English	Placeholders	Context
`NoCards`	“No cards”		Browser has no cards
`NoButtonSelected`	“No button selected”		No browser button focused
`NoButtonsAvailable`	“No buttons available”		No browser buttons exist
`CouldNotTogglePosition`	“Could not toggle position”		Card move failed
`Selected`	“selected”		Card toggled to selected state
`Deselected`	“deselected”		Card toggled to deselected state
`InHand`	“in hand”		Card location label
`OnStack`	“on stack”		Card location label
`Confirmed`	“Confirmed”		Browser submission confirmed
`Cancelled`	“Cancelled”		Browser submission cancelled
`NoConfirmButton`	“No confirm button found”		Confirm button missing
`KeepOnTop`	“keep”		Scry: card stays on top of library
`PutOnBottom`	“selected”		Scry: card put on bottom of library
`CouldNotClick_Format`	“Could not click {0}”	{0} = button name	Button click failed
`BrowserCards_One`	“{0}. 1 card. Tab to navigate, Enter to select”	{0} = browser title	Browser with 1 card
`BrowserCards_Format`	“{0}. {1} cards. Tab to navigate, Enter to select”	{0} = browser title, {1} = count	Browser with multiple cards
`BrowserOptions_Format`	“{0}. Tab to navigate options”	{0} = browser title	Browser with options

Mastery / Battle Pass

Key	English	Placeholders	Context
`MasteryActivation_Format`	“{0}. Level {1} of {2}, {3}. Arrow keys to navigate levels.”	{0} = title, {1} = current, {2} = max, {3} = status	Mastery screen activation
`MasteryLevel_Format`	“Level {0}: {1}”	{0} = level, {1} = reward	Level description
`MasteryLevelWithStatus_Format`	“Level {0}: {1}. {2}”	{0} = level, {1} = reward, {2} = status	Level with status
`MasteryTier_Format`	“{0}: {1}”	{0} = tier name, {1} = reward	Tier description
`MasteryTierWithQuantity_Format`	“{0}: {1}x {2}”	{0} = tier, {1} = quantity, {2} = reward	Tier with quantity
`MasteryPage_Format`	“Page {0} of {1}”	{0} = current, {1} = total	Page navigation
`MasteryLevelDetail_Format`	“Level {0}. {1}”	{0} = level, {1} = details	Level detail view
`MasteryLevelDetailWithStatus_Format`	“Level {0}. {1}. {2}”	{0} = level, {1} = details, {2} = status	Level detail with status
`MasteryCompleted`	“completed”		Level completed
`MasteryCurrentLevel`	“current level”		Currently active level
`MasteryPremiumLocked`	“premium locked”		Requires battle pass
`MasteryFree`	“Free”		Free track
`MasteryPremium`	“Premium”		Premium track
`MasteryRenewal`	“Renewal”		Renewal track
`MasteryNoReward`	“no reward”		Level has no reward
`MasteryStatus`	“Status”		Status label
`MasteryStatusInfo_Format`	“Level {0} of {1}”	{0} = current, {1} = max	Status info
`MasteryStatusInfoWithXP_Format`	“Level {0} of {1}, {2}”	{0} = current, {1} = max, {2} = XP text	Status with XP

Prize Wall

Key	English	Placeholders	Context
`PrizeWallActivation_Format`	“Prize Wall. {0} items. {1} spheres available. Arrow keys to navigate.”	{0} = item count, {1} = sphere count	Prize wall activation
`PrizeWallItem_Format`	“{0} of {1}: {2}”	{0} = position, {1} = total, {2} = item	Prize wall item
`PrizeWallSphereStatus_Format`	“{0} spheres available”	{0} = count	Sphere count
`PopupCancel`	“Cancel”		Cancel button label

UI Structure Announcements

Key	English	Placeholders	Context
`ItemsCount_One`	“1 item”		Generic item count
`ItemsCount_Format`	“{0} items”	{0} = count	Generic item count
`ItemCount_One`	“1 item”		Same, alternate key
`ItemCount_Format`	“{0} items”	{0} = count	Same, alternate key
`ActivationWithItems_Format`	“{0}. {1}. {2}”	{0} = screen name, {1} = item count, {2} = hint	Screen activation
`GroupCount_Format`	“{0} groups”	{0} = count	Number of UI groups
`GroupItemCount_Format`	“{0}, {1}”	{0} = group name, {1} = item count text	Group with count
`ItemPositionOf_Format`	“{0} of {1}: {2}”	{0} = position, {1} = total, {2} = item text	Item position
`ScreenGroupsSummary_Format`	“{0}. {1}. {2}”	{0} = screen name, {1} = group summary, {2} = hint	Screen with groups
`ScreenItemsSummary_Format`	“{0}. {1}. {2}”	{0} = screen name, {1} = item summary, {2} = hint	Screen with items
`ObjectivesEntry_Format`	“Objectives, {0}”	{0} = count text	Objectives section
`PositionOf_Format`	“{0} of {1}”	{0} = position, {1} = total	Generic position
`LabelValue_Format`	“{0}: {1}”	{0} = label, {1} = value	Generic label: value pair
`NoItemsFound`	“No items found.”		Empty list
`NoNavigableItemsFound`	“No navigable items found.”		No interactive elements

Search and Filters

Key	English	Placeholders	Context
`SearchResults_Format`	“Search results: {0} cards”	{0} = count	Card search results
`SearchResultsItems_Format`	“Search results: {0} items”	{0} = count	Generic search results
`NoSearchResults`	“No search results”		Empty search
`ApplyingFilters`	“Applying filters”		Filters being applied
`FiltersReset`	“Filters reset”		Filters cleared
`FiltersCancelled`	“Filters cancelled”		Filter dialog cancelled
`FiltersDismissed`	“Filters dismissed”		Filter panel closed
`FilterLabel_Format`	“{0}: {1}”	{0} = filter name, {1} = value	Active filter
`NoFilter_Format`	“No filter {0}. {1} filters available.”	{0} = number, {1} = total	Invalid filter number
`NoFiltersAvailable`	“No filters available”		No filters on screen

Miscellaneous UI

Key	English	Placeholders	Context
`DropdownClosed`	“Dropdown closed”		Dropdown menu closed
`DropdownOpened`	“Dropdown opened. Use arrow keys to select, Enter to confirm.”		Dropdown opened
`PopupClosed`	“Popup closed”		Popup dismissed
`CouldNotClosePopup`	“Could not close popup”		Popup dismiss failed
`Percent_Format`	“{0} percent”	{0} = number	Percentage value
`ActionNotAvailable`	“Action not available”		Generic action not possible
`Mana_Format`	“Mana: {0}”	{0} = mana symbols	Mana display
`FirstSection`	“First section”		Navigated to first section
`LastSection`	“Last section”		Navigated to last section
`StartOfRow`	“Start of row”		Row boundary
`EndOfRowNav`	“End of row”		Row boundary
`Opening_Format`	“Opening {0}”	{0} = target name	Opening something
`Toggled_Format`	“{0}, toggled”	{0} = element name	Element toggled
`FirstPack`	“First pack”		First pack in opening
`LastPack`	“Last pack”		Last pack in opening
`Page_Format`	“Page {0} of {1}”	{0} = current, {1} = total	Pagination
`PageLabel_Format`	“{0} page”	{0} = page name	Named page
`Activated_Format`	“Activated {0}”	{0} = element name	Element activated
`BackToMailList`	“Back to mail list”		Returning to inbox
`AtTopLevel`	“At top level. Use Done button to exit.”		Top of navigation
`NoItemsAvailable_Format`	“{0}. No items available.”	{0} = section name	Empty section
`Loading_Format`	“Loading {0}…”	{0} = what’s loading	Loading state
`TabItems_Format`	“{0}. {1} items.”	{0} = tab name, {1} = count	Tab with items
`TabNoItems_Format`	“{0}. No items available.”	{0} = tab name	Empty tab
`NoPurchaseOption`	“No purchase option available”		Store: can’t buy
`NoDetailsAvailable`	“No details available”		No details to show
`NoCardDetails`	“No card details available”		Card info missing
`Tabs_Format`	“Tabs. {0} tabs.”	{0} = count	Tab bar summary
`OptionsAvailable_Format`	“{0} options available. {1}”	{0} = count, {1} = hint	Options list
`Continuing`	“Continuing”		Continuing past a screen
`FoundRewards_Format`	“Found {0} rewards”	{0} = count	Rewards found
`Characters_Format`	“{0} characters”	{0} = count	Character count
`PaymentPage_Format`	“Payment page. {0} elements.”	{0} = count	Store payment screen
`CouldNotMove_Format`	“Could not move {0}”	{0} = card name	Card move failed
`MovedTo_Format`	“{0} moved to {1}”	{0} = card name, {1} = destination	Card moved
`CouldNotSend_Format`	“Could not send {0}”	{0} = emote name	Emote send failed
`PortraitNotFound`	“Portrait not found”		Avatar not found
`PortraitNotAvailable`	“Portrait not available”		Avatar unavailable
`PortraitButtonNotFound`	“Portrait button not found”		Avatar button missing
`NoActiveScreen`	“No active screen”		F3 with no screen
`NoCardToInspect`	“No card selected to inspect.”		Debug: no card
`NoElementSelected`	“No element selected for pack investigation.”		Debug: no element
`DebugDumpComplete`	“Debug dump complete. Check log.”		F12 debug dump
`CardDetailsDumped`	“Card details dumped to log.”		F11 debug dump
`NoPackToInspect`	“No pack to inspect.”		Debug: no pack
`CouldNotFindPackParent`	“Could not find pack parent.”		Debug: pack parent missing
`PackDetailsDumped`	“Pack details dumped to log.”		Debug: pack dump done

Language Names

These should be translated into the target language (so French users see “Fran\u00e7ais”, not “French”).

Key	English	Context
`LangEnglish`	“English”	Language picker
`LangGerman`	“German”	Language picker
`LangFrench`	“French”	Language picker
`LangSpanish`	“Spanish”	Language picker
`LangItalian`	“Italian”	Language picker
`LangPortuguese`	“Portuguese”	Language picker
`LangJapanese`	“Japanese”	Language picker
`LangKorean`	“Korean”	Language picker
`LangRussian`	“Russian”	Language picker
`LangPolish`	“Polish”	Language picker
`LangChineseSimplified`	“Chinese Simplified”	Language picker
`LangChineseTraditional`	“Chinese Traditional”	Language picker

Element Groups

Group names for UI sections announced when navigating between groups.

Key	English	Context
`GroupPrimaryActions`	“Primary Actions”	Main buttons
`GroupPlay`	“Play”	Play section
`GroupProgress`	“Progress”	Progress section
`GroupObjectives`	“Objectives”	Daily/weekly quests
`GroupSocial`	“Social”	Friends section
`GroupFilters`	“Filters”	Filter controls
`GroupContent`	“Content”	Main content area
`GroupSettings`	“Settings”	Settings section
`GroupSecondaryActions`	“Secondary Actions”	Secondary buttons
`GroupDialog`	“Dialog”	Dialog/popup buttons
`GroupFriends`	“Friends”	Friends list
`GroupTabs`	“Tabs”	Tab navigation
`GroupPlayOptions`	“Play Options”	Play mode options
`GroupFolders`	“Folders”	Deck folders
`GroupSettingsMenu`	“Settings Menu”	Settings menu section
`GroupTutorial`	“Tutorial”	Tutorial section
`GroupCollection`	“Collection”	Card collection
`GroupDeckList`	“Deck List”	Deck listing
`GroupDeckInfo`	“Deck Info”	Deck information
`GroupMailList`	“Mail List”	Inbox
`GroupMail`	“Mail”	Mail content
`GroupRewards`	“Rewards”	Rewards section
`GroupOther`	“Other”	Uncategorized elements

Screen Titles

These are announced when entering a screen. They should be short and descriptive.

Key	English	Context
`ScreenHome`	“Home”	Main menu
`ScreenDecks`	“Decks”	Deck manager
`ScreenProfile`	“Profile”	Player profile
`ScreenStore`	“Store”	In-game store
`ScreenMastery`	“Mastery”	Battle pass screen
`ScreenAchievements`	“Achievements”	Achievement list
`ScreenLearnToPlay`	“Learn to Play”	Tutorial section
`ScreenPackOpening`	“Pack Opening”	Opening packs
`ScreenColorChallenge`	“Color Challenge”	Tutorial challenges
`ScreenDeckBuilder`	“Deck Builder”	Building a deck
`ScreenDeckSelection`	“Deck Selection”	Choosing a deck
`ScreenEvent`	“Event”	Event details
`ScreenRewards`	“Rewards”	Reward screen
`ScreenPacks`	“Packs”	Pack selection
`ScreenCardUnlocked`	“Card Unlocked”	New card reward
`ScreenCardUnlocked_One`	“Card Unlocked, 1 card”	1 card unlocked
`ScreenCardUnlocked_Format`	“Card Unlocked, {0} cards”	{0} = count of cards unlocked
`ScreenPackContents`	“Pack Contents”	Viewing pack cards
`ScreenPackContents_One`	“Pack Contents, 1 card”	Pack with 1 card
`ScreenPackContents_Format`	“Pack Contents, {0} cards”	{0} = count of cards
`ScreenFriends`	“Friends”	Friends list
`ScreenHomeWithEvents`	“Home with Events”	Home when events shown
`ScreenHomeWithColorChallenge`	“Home with Color Challenge”	Home during tutorial
`ScreenNavigationBar`	“Navigation Bar”	Bottom nav bar
`ScreenCollection`	“Collection”	Card collection
`ScreenSettings`	“Settings”	Settings menu
`ScreenMenu`	“Menu”	Generic menu
`ScreenPlayModeSelection`	“Play Mode Selection”	Choosing play mode
`ScreenDirectChallenge`	“Direct Challenge”	Direct challenge screen
`ScreenFriendChallenge`	“Friend Challenge”	Friend challenge screen
`ScreenConfirmation`	“Confirmation”	Confirmation dialog
`ScreenInviteFriend`	“Invite Friend”	Friend invite dialog
`ScreenSocial`	“Social”	Social features
`ScreenPlay`	“Play”	Play screen
`ScreenEvents`	“Events”	Events list
`ScreenFindMatch`	“Find Match”	Matchmaking
`ScreenMatchEnded`	“Match ended”	Post-match screen
`ScreenSearchingForMatch`	“Searching for match”	Matchmaking in progress
`ScreenLoading`	“Loading”	Loading screen
`ScreenSettingsGameplay`	“Settings, Gameplay”	Gameplay settings tab
`ScreenSettingsGraphics`	“Settings, Graphics”	Graphics settings tab
`ScreenSettingsAudio`	“Settings, Audio”	Audio settings tab
`ScreenDownload`	“Download screen”	Asset download
`ScreenAdvancedFilters`	“Advanced Filters”	Advanced filter panel
`ScreenPrizeWall`	“Prize Wall”	Prize wall screen
`ScreenDuel`	“Duel”	Active game
`ScreenPreGame`	“Pre-game screen”	Before match starts
`ScreenWhatsNew`	“What’s New”	What’s new overlay
`ScreenAnnouncement`	“Announcement”	Announcement overlay
`ScreenRewardPopup`	“Reward popup”	Reward popup overlay
`ScreenOverlay`	“Overlay”	Generic overlay
`WaitingForServer`	“Waiting for server”	Server response pending

Zone Names

Zone names announced during duel navigation when pressing zone shortcut keys.

Key	English	Context
`Zone_Hand`	“Your hand”	Announced when pressing C to enter your hand
`Zone_Battlefield`	“Battlefield”	General battlefield label
`Zone_Graveyard`	“Your graveyard”	Announced when pressing G for your graveyard
`Zone_Exile`	“Exile”	Announced when pressing X for exile zone
`Zone_Stack`	“Stack”	Announced when pressing S for the stack
`Zone_Library`	“Your library”	Your library zone
`Zone_Command`	“Command zone”	Commander format command zone
`Zone_OpponentHand`	“Opponent’s hand”	Announced when pressing Shift+C for opponent hand count
`Zone_OpponentGraveyard`	“Opponent’s graveyard”	Announced when pressing Shift+G
`Zone_OpponentLibrary`	“Opponent’s library”	Announced when pressing Shift+D
`Zone_OpponentExile`	“Opponent’s exile”	Announced when pressing Shift+X

Battlefield Rows

Battlefield row names announced when navigating rows with Shift+Up/Down or shortcut keys.

Key	English	Context
`Row_PlayerCreatures`	“Your creatures”	Announced when pressing B
`Row_PlayerNonCreatures`	“Your non-creatures”	Announced when pressing R
`Row_PlayerLands`	“Your lands”	Announced when pressing A
`Row_EnemyCreatures`	“Enemy creatures”	Announced when pressing Shift+B
`Row_EnemyNonCreatures`	“Enemy non-creatures”	Announced when pressing Shift+R
`Row_EnemyLands`	“Enemy lands”	Announced when pressing Shift+A

Browser Zone Names

Zone names used in Scry, Surveil, and London mulligan browser navigation. Announced when pressing C or D to jump between zones.

Key	English	Placeholders	Context
`BrowserZone_KeepOnTop`	“Keep on top”		Scry: zone label for cards staying on top of library
`BrowserZone_PutOnBottom`	“Put on bottom”		Scry: zone label for cards going to bottom
`BrowserZone_KeepPile`	“Keep pile”		London mulligan: zone label for cards kept in hand
`BrowserZone_BottomPile`	“Bottom pile”		London mulligan: zone label for cards put on bottom
`BrowserZone_KeepShort`	“keep”		Short zone label suffix for keep zone
`BrowserZone_BottomShort`	“bottom”		Short zone label suffix for bottom zone
`BrowserZone_Surveil_Graveyard`	“Graveyard”		Surveil: zone label for cards going to graveyard (replaces “Put on bottom” so the bottom-zone announcement matches what surveil actually does — mill, not put on bottom of library)
`BrowserZone_Surveil_GraveyardShort`	“graveyard”		Surveil: short zone label suffix for graveyard zone
`BrowserZone_Empty_Format`	“{0}: empty”	{0} = zone name	Announced when entering an empty browser zone
`BrowserZone_Entry_Format`	“{0}: {1} cards. {2}, 1 of {3}”	{0} = zone name, {1} = total cards, {2} = first card name, {3} = total	Announced when entering a browser zone with cards
`BrowserZone_Card_Format`	“{0}, {1}, {2} of {3}”	{0} = card name, {1} = zone label, {2} = position, {3} = total	Card position within a browser zone
`BrowserZone_NoCardSelected`	“No card selected”		No card is focused in browser

Browser Types

Friendly names for browser types, announced when a browser opens (e.g., “Scry. 2 cards. Tab to navigate…”).

Key	English	Context
`Browser_Scry`	“Scry”	Scry effect browser
`Browser_Surveil`	“Surveil”	Surveil effect browser
`Browser_ReadAhead`	“Read ahead”	Read ahead (Saga) browser
`Browser_SearchLibrary`	“Search library”	Library search effect
`Browser_Mulligan`	“Mulligan”	London mulligan browser
`Browser_OpeningHand`	“Opening hand”	Opening hand display
`Browser_OrderCards`	“Order cards”	Card ordering effect
`Browser_SplitCards`	“Split cards into piles”	Fact or Fiction style pile splitting
`Browser_AssignDamage`	“Assign damage”	Damage assignment browser
`Browser_ViewAttachments`	“View attachments”	Viewing card attachments
`Browser_ChooseFromList`	“Choose from list”	Generic list choice
`Browser_SelectCards`	“Select cards”	Card selection browser
`Browser_SelectGroup`	“Select group”	Group selection browser
`Browser_ChooseManaType`	“Choose mana type”	Mana type choice
`Browser_ChooseKeyword`	“Choose keyword”	Keyword ability choice
`Browser_ChooseDungeonRoom`	“Choose dungeon room”	Dungeon room choice
`Browser_MutateChoice`	“Mutate choice”	Mutate positioning choice
`Browser_ChooseYesOrNo`	“Choose yes or no”	Yes/no decision
`Browser_OptionalAction`	“Optional action”	Optional ability trigger
`Browser_Information`	“Information”	Informational display
`Browser_ChooseAction`	“Choose action”	Action choice browser
`Browser_Default`	“Browser”	Fallback browser name for unknown types

Combat States

Status strings appended to card names during combat to describe their combat state.

Key	English	Placeholders	Context
`Combat_Attacking`	“attacking”		Card is declared as an attacker
`Combat_CanAttack`	“can attack”		Card is eligible to attack
`Combat_Blocking_Format`	“blocking {0}”	{0} = attacker name	Card is blocking a specific attacker
`Combat_Blocking`	“blocking”		Card is blocking (no specific attacker known)
`Combat_BlockedBy_Format`	“blocked by {0}”	{0} = blocker name(s)	Attacker is blocked by named creature(s)
`Combat_SelectedToBlock`	“selected to block”		Card has been selected as a blocker
`Combat_CanBlock`	“can block”		Card is eligible to block
`Combat_Tapped`	“tapped”		Card is tapped
`Combat_PTBlocking_Format`	“{0}/{1} blocking”	{0} = power, {1} = toughness	Blocker with P/T shown
`Combat_Assigned`	“assigned”		Blocker has been assigned to an attacker

Target Actions

Announcement strings for target and selection actions during spells and abilities.

Key	English	Placeholders	Context
`Target_Targeted_Format`	“Targeted {0}”	{0} = target name	Announced when a target is selected via targeting mode
`Target_Selected_Format`	“Selected {0}”	{0} = target name	Announced when a target is selected via selection mode

Card Relationships

Strings describing card relationships (enchantments, attachments, targeting) shown in card details and announcements.

Key	English	Placeholders	Context
`Card_EnchantedBy_One_Format`	“enchanted by {0}”	{0} = enchantment name	Card has one enchantment attached
`Card_EnchantedBy_Many_Format`	“enchanted by {0}”	{0} = comma-separated enchantment names	Card has multiple enchantments
`Card_AttachedTo_Format`	“attached to {0}”	{0} = host card name	Card is attached to another card (equipment, aura)
`Card_Targeting_One_Format`	“targeting {0}”	{0} = target name	Spell or ability targeting one card
`Card_Targeting_Two_Format`	“targeting {0} and {1}”	{0} = first target, {1} = second target	Spell targeting exactly two cards
`Card_Targeting_Many_Format`	“targeting {0}”	{0} = comma-separated target names	Spell targeting three or more cards
`Card_TargetedBy_One_Format`	“targeted by {0}”	{0} = source name	Card is targeted by one spell/ability
`Card_TargetedBy_Two_Format`	“targeted by {0} and {1}”	{0} = first source, {1} = second source	Card targeted by two sources
`Card_TargetedBy_Many_Format`	“targeted by {0}”	{0} = comma-separated source names	Card targeted by three or more sources

Duel Announcements

All duel event announcements. These are spoken automatically as game events occur.

Game Start and Turns:

Key	English	Placeholders	Context
`Duel_Started_Format`	“Duel started. {0} cards in hand”	{0} = hand size	Announced at duel start
`Duel_YourTurn_Format`	“Turn {0}”	{0} = turn number	Announced at start of your turn
`Duel_OpponentTurn`	“Opponent’s turn”		Announced at start of opponent’s turn
`Duel_TurnChanged`	“Turn changed”		Generic turn change notification
`Duel_Your`	“Your”		Possessive label for your phase announcements
`Duel_Opponents`	“Opponent’s”		Possessive label for opponent’s phase announcements
`Duel_You`	“You”		Subject label for your actions
`Duel_Opponent`	“Opponent”		Subject label for opponent actions

Phases (capitalized, announced as phase transitions):

Key	English	Context
`Duel_Phase_FirstMain`	“First main phase”	Phase announcement
`Duel_Phase_SecondMain`	“Second main phase”	Phase announcement
`Duel_Phase_DeclareAttackers`	“Declare attackers”	Phase announcement
`Duel_Phase_DeclareBlockers`	“Declare blockers”	Phase announcement
`Duel_Phase_CombatDamage`	“Combat damage”	Phase announcement
`Duel_Phase_EndOfCombat`	“End of combat”	Phase announcement
`Duel_Phase_Combat`	“Combat phase”	Phase announcement
`Duel_Phase_Upkeep`	“Upkeep”	Phase announcement
`Duel_Phase_Draw`	“Draw”	Phase announcement
`Duel_Phase_EndStep`	“End step”	Phase announcement

Phase Descriptions (lowercase, used in combined turn/phase strings):

Key	English	Context
`Duel_PhaseDesc_FirstMain`	“first main phase”	Used in turn info via T key
`Duel_PhaseDesc_SecondMain`	“second main phase”	Used in turn info via T key
`Duel_PhaseDesc_DeclareAttackers`	“declare attackers”	Used in turn info via T key
`Duel_PhaseDesc_DeclareBlockers`	“declare blockers”	Used in turn info via T key
`Duel_PhaseDesc_CombatDamage`	“combat damage”	Used in turn info via T key
`Duel_PhaseDesc_EndOfCombat`	“end of combat”	Used in turn info via T key
`Duel_PhaseDesc_Combat`	“combat phase”	Used in turn info via T key
`Duel_PhaseDesc_Upkeep`	“upkeep”	Used in turn info via T key
`Duel_PhaseDesc_Draw`	“draw”	Used in turn info via T key
`Duel_PhaseDesc_EndStep`	“end step”	Used in turn info via T key
`Duel_PhaseDesc_Beginning`	“beginning phase”	Used in turn info via T key
`Duel_PhaseDesc_Ending`	“ending phase”	Used in turn info via T key
`Duel_PhaseDesc_Turn`	“turn”	Used in turn info via T key

Turn and Phase Combined Formats:

Key	English	Placeholders	Context
`Duel_TurnPhase_Format`	“{0} {1}, turn {2}”	{0} = “Your”/”Opponent’s”, {1} = phase desc, {2} = turn number	Full turn/phase info via T key
`Duel_TurnPhaseNoCount_Format`	“{0} {1}”	{0} = “Your”/”Opponent’s”, {1} = phase desc	Turn/phase when turn number unknown

Card Draws:

Key	English	Placeholders	Context
`Duel_Drew_One`	“Drew 1 card”		You drew one card
`Duel_Drew_Format`	“Drew {0} cards”	{0} = count	You drew multiple cards
`Duel_OpponentDrew_One`	“Opponent drew 1 card”		Opponent drew one card
`Duel_OpponentDrew_Format`	“Opponent drew {0} cards”	{0} = count	Opponent drew multiple cards

Life Changes:

Key	English	Placeholders	Context
`Duel_LifeGained_Format`	“{0} gained {1} life”	{0} = “You”/”Opponent”, {1} = amount	Life gain event
`Duel_LifeLost_Format`	“{0} lost {1} life”	{0} = “You”/”Opponent”, {1} = amount	Life loss event

Damage:

Key	English	Placeholders	Context
`Duel_DamageDeals_Format`	“{0} deals {1} to {2}”	{0} = source, {1} = amount, {2} = target	Damage event with named source
`Duel_DamageAmount_Format`	“{0} to {1}”	{0} = amount, {1} = target	Damage amount to target
`Duel_DamageToYou`	“you”		Target label when damage goes to you
`Duel_DamageToOpponent`	“opponent”		Target label when damage goes to opponent
`Duel_DamageTarget`	“target”		Generic target label for damage
`Duel_CombatDamageSource`	“Combat damage”		Source label for combat damage
`Duel_DamageTo_Format`	“{0} deals {1} to {2}”	{0} = source, {1} = amount, {2} = target	Alternate damage format
`Duel_DamageAmountTo_Format`	“{0} damage to {1}”	{0} = amount, {1} = target	Damage amount description
`Duel_CreatureDamage_Format`	“{0} deals {1} to {2}”	{0} = creature, {1} = amount, {2} = target	Creature dealing damage

Combat Events:

Key	English	Placeholders	Context
`Duel_CombatBegins`	“Combat begins”		Combat phase started
`Duel_AttackerDeclared`	“Attacker declared”		You declared an attacker
`Duel_OpponentAttackerDeclared`	“Opponent’s attacker declared”		Opponent declared an attacker
`Duel_Attacking_Format`	“{0} attacking”	{0} = creature name	Named creature is attacking
`Duel_AttackingPT_Format`	“{0} {1} attacking”	{0} = creature name, {1} = P/T	Named creature with P/T attacking
`Duel_AttackerRemoved`	“Attacker removed”		An attacker was undeclared
`Duel_Attackers_One`	“1 attacker”		Attacker count summary
`Duel_Attackers_Format`	“{0} attackers”	{0} = count	Multiple attackers count

Battlefield Enter/Leave:

Key	English	Placeholders	Context
`Duel_OpponentPlayedCard`	“Opponent played a card”		Opponent played a card (name unknown)
`Duel_OpponentEnteredBattlefield_One`	“Opponent: 1 permanent entered battlefield”		One opponent permanent entered
`Duel_OpponentEnteredBattlefield_Format`	“Opponent: {0} permanents entered battlefield”	{0} = count	Multiple opponent permanents entered
`Duel_LeftBattlefield_One`	“1 permanent left battlefield”		One permanent left battlefield
`Duel_LeftBattlefield_Format`	“{0} permanents left battlefield”	{0} = count	Multiple permanents left
`Duel_EntersBattlefield_Format`	“{0} enters battlefield”	{0} = card name	Named card entering battlefield
`Duel_EntersBattlefieldFromLibrary_Format`	“{0} enters battlefield from library”	{0} = card name	Card entering from library
`Duel_EntersBattlefieldFromLibraryEnchanting_Format`	“{0} enters battlefield from library, enchanting {1}”	{0} = card name, {1} = target	Card entering from library attached to target
`Duel_TokenCreated_Format`	“{0} token created”	{0} = token name	A token was created
`Duel_Played_Format`	“{0} played {1}”	{0} = player, {1} = card name	Player played a card
`Duel_Enchanted_Format`	“{0} enchanted {1}”	{0} = aura name, {1} = target	Aura attached to a permanent

Graveyard Events:

Key	English	Placeholders	Context
`Duel_CardToYourGraveyard`	“Card went to your graveyard”		Generic graveyard event (name unknown)
`Duel_CardToOpponentGraveyard`	“Card went to opponent’s graveyard”		Generic graveyard event for opponent
`Duel_Died_Format`	“{0}{1} died”	{0} = owner prefix, {1} = card name	Creature died (state-based action)
`Duel_Destroyed_Format`	“{0}{1} was destroyed”	{0} = owner prefix, {1} = card name	Permanent was destroyed
`Duel_Sacrificed_Format`	“{0}{1} was sacrificed”	{0} = owner prefix, {1} = card name	Permanent was sacrificed
`Duel_Countered_Format`	“{0}{1} was countered”	{0} = owner prefix, {1} = spell name	Spell was countered
`Duel_Discarded_Format`	“{0}{1} was discarded”	{0} = owner prefix, {1} = card name	Card was discarded
`Duel_Milled_Format`	“{0}{1} was milled”	{0} = owner prefix, {1} = card name	Card was milled from library
`Duel_WentToGraveyard_Format`	“{0}{1} went to graveyard”	{0} = owner prefix, {1} = card name	Generic card-to-graveyard
`Duel_SpellResolved`	“Spell resolved”		A spell on the stack resolved
`Duel_ReturnedFromGraveyard_Format`	“{0} returned from graveyard”	{0} = card name	Card returned from graveyard to battlefield
`Duel_ReturnedFromGraveyardEnchanting_Format`	“{0} returned from graveyard, enchanting {1}”	{0} = card name, {1} = target	Card returned from graveyard attached to target

Exile Events:

Key	English	Placeholders	Context
`Duel_Exiled_Format`	“{0}{1} was exiled”	{0} = owner prefix, {1} = card name	Card was exiled from battlefield
`Duel_ExiledFromGraveyard_Format`	“{0}{1} was exiled from graveyard”	{0} = owner prefix, {1} = card name	Card exiled from graveyard
`Duel_ExiledFromHand_Format`	“{0}{1} was exiled from hand”	{0} = owner prefix, {1} = card name	Card exiled from hand
`Duel_ExiledFromLibrary_Format`	“{0}{1} was exiled from library”	{0} = owner prefix, {1} = card name	Card exiled from library
`Duel_CounteredAndExiled_Format`	“{0}{1} was countered and exiled”	{0} = owner prefix, {1} = spell name	Spell countered and exiled
`Duel_ReturnedFromExile_Format`	“{0} returned from exile”	{0} = card name	Card returned from exile to battlefield
`Duel_ReturnedFromExileEnchanting_Format`	“{0} returned from exile, enchanting {1}”	{0} = card name, {1} = target	Card returned from exile attached to target

Hand Events:

Key	English	Placeholders	Context
`Duel_ReturnedToHand_Format`	“{0}{1} returned to hand”	{0} = owner prefix, {1} = card name	Card bounced to hand from battlefield
`Duel_ReturnedToHandFromGraveyard_Format`	“{0}{1} returned to hand from graveyard”	{0} = owner prefix, {1} = card name	Card returned to hand from graveyard
`Duel_ReturnedToHandFromExile_Format`	“{0}{1} returned to hand from exile”	{0} = owner prefix, {1} = card name	Card returned to hand from exile

Counters:

Key	English	Placeholders	Context
`Duel_CounterGained_Format`	“{0} gained {1} {2} counter”	{0} = card name, {1} = count, {2} = counter type	Singular counter gained
`Duel_CounterGainedPlural_Format`	“{0} gained {1} {2} counters”	{0} = card name, {1} = count, {2} = counter type	Multiple counters gained
`Duel_CounterLost_Format`	“{0} lost {1} {2} counter”	{0} = card name, {1} = count, {2} = counter type	Singular counter lost
`Duel_CounterLostPlural_Format`	“{0} lost {1} {2} counters”	{0} = card name, {1} = count, {2} = counter type	Multiple counters lost
`Duel_CounterCreature`	“creature”		Default counter type label

Reveals:

Key	English	Placeholders	Context
`Duel_Revealed_Format`	“Revealed {0}”	{0} = card name	A card was revealed

Game End:

Key	English	Context
`Duel_Victory`	“Victory!”	You won the game
`Duel_Defeat`	“Defeat”	You lost the game
`Duel_GameEnded`	“Game ended”	Generic game end

Browser Hints:

Key	English	Placeholders	Context
`Duel_ScryHint`	“Scry. Tab to see card, Enter to keep on top, Space to put on bottom”		Announced when scry browser opens
`Duel_SurveilHint`	“Surveil. Tab to see card, Enter to keep on top, Space to put in graveyard”		Announced when surveil browser opens
`Duel_EffectHint_Format`	“{0}. Tab to navigate, Enter to select”	{0} = effect name	Announced for other browser-style effects
`Duel_LookAtTopCard`	“Look at top card”		Announced for top-of-library peek effects
`Duel_NothingResolving`	“Nothing on the stack”		Announced when the player presses N to read the currently-resolving stack item and the stack is empty. Pick whatever your locale uses for the empty-stack case.

London Mulligan:

Key	English	Placeholders	Context
`Duel_SelectForBottom_One`	“Select 1 card to put on bottom. {0} cards. Enter to toggle, Space when done”	{0} = total cards in hand	Mulligan prompt for 1 card
`Duel_SelectForBottom_Format`	“Select {0} cards to put on bottom. {1} cards. Enter to toggle, Space when done”	{0} = cards to select, {1} = total cards	Mulligan prompt for multiple cards
`Duel_SelectedForBottom_Format`	“{0} of {1} selected for bottom”	{0} = currently selected, {1} = required	Selection progress during mulligan

Owner Prefix:

Key	English	Context
`Duel_OwnerPrefix_Opponent`	“Opponent’s “	Prepended to card names for opponent’s cards in zone change announcements. Note the trailing space.

Translation Tips

Be concise. These strings are read aloud by a screen reader. Short and clear is better than long and formal.
Use your language’s MTG terminology. For terms like “Library”, “Graveyard”, “Exile” - use whatever the official Magic: The Gathering translations use in your language.
Keep key names from help items. Keyboard keys like “F1”, “Tab”, “Enter”, “Backspace”, “Space”, “Escape” should stay as-is (they are the key labels on the keyboard). Translate the descriptions around them.
Test with a screen reader. If possible, run the mod with your language selected and listen to how the translations sound when spoken aloud. Some phrasing that reads well on screen sounds awkward when spoken.
Placeholders can be reordered. If your language puts the count before the noun, that’s fine: "{1} cartes dans {0}" works just as well as "{0}, {1} cards".

NumberWords

The NumberWords key maps spelled-out number words to digits. The mod uses this when the game’s prompt text spells out a number as a word instead of a digit (e.g. German “Wirf zwei Karten ab” instead of “Discard 2 cards”). The mod first tries to find a digit with a regex; NumberWords is the fallback.

Format: comma-separated word=number pairs, all lowercase:

"NumberWords": "one=1,two=2,three=3,four=4,five=5,six=6,seven=7,eight=8,nine=9,ten=10"

Tips:

Include all grammatical forms your language uses in game prompts (e.g. German needs “eine=1,einer=1,einem=1,einen=1,ein=1,zwei=2,…”)
Numbers 1-10 are usually enough - higher counts are rare in game prompts
Languages that always use digits in game prompts (Japanese, Korean, Chinese) can leave this empty: "NumberWords": ""
Matching is case-insensitive and whole-word only, so “ein” won’t match inside “einen” (both should be listed separately)

How to Test

Build the mod: dotnet build src/AccessibleArena.csproj
Copy the DLL to the game’s Mods folder
Launch the game, press F2 to open settings, change language
Navigate through screens and listen to announcements

If you can’t build the mod, you can still submit translations - the maintainers will build and test.

Checking for Missing Keys

To find keys that exist in en.json but are missing from your language file, you can compare the key lists. Every key in en.json should have a corresponding entry in your language file. Missing keys will automatically fall back to English, so partial translations are fine - but complete translations are better.