Settings Reference
A complete guide to the main settings tab, including branding, battle timing, layout, AI behavior, defends, tips, and pro-only controls.
Settings Tab Reference
The Settings page controls branding, battle behavior, card layout, multiplayer sync, timers, and the front-end tip box. Some fields are available only in PRO mode, and the admin screen clearly locks those controls when the license is not active.
acb_settings. Abilities and team bonuses are stored separately and can also be backed up.
Branding and Display
| Setting | Field name | Default / range | Purpose |
|---|---|---|---|
| Card Battle Name | game_name |
Default: Card Battle Arena | Main title of the arena UI. You can rename it to something like Anime Card Battle Arena or any brand name you want. |
| Battlefield Background URL | battlefield_bg |
URL input | Background image or scene behind the battle interface. Leave blank to use the built-in fallback look. |
| Placeholder Image URL | placeholder_image |
URL input | Fallback image shown when a card or media item has no custom image. |
| Footer Copyright Text | footer_text |
Text / HTML allowed | Text displayed in the footer area. Use it for copyright, credit, or a custom footer line. |
Battle Quote Timing
This section controls how long battle quote popups remain visible and how often they appear.
| Control | Field name | Default | Range | Meaning |
|---|---|---|---|---|
| Attack Quote Duration (ms) | battle_attack_quote_duration |
1000 | 0–15000 | How long attack quotes remain on screen. |
| Taunt Quote Duration (ms) | battle_taunt_quote_duration |
1000 | 0–15000 | How long taunt quotes remain on screen. |
| Attack Quote Chance (%) | battle_attack_quote_chance |
40 | 0–100 | The chance that an attack quote will show. |
AI Difficulty
The selected difficulty changes which action weights the AI prefers during battle. The engine uses the matching profile and normalizes the values automatically.
Arena Rules and Layout
| Setting | Field name | Default / range | Notes |
|---|---|---|---|
| Max Deck Size | max_deck_size |
8 · range 3–8 | Caps how many cards a player can put into the active deck. |
| Cards Per Page PRO | cards_per_page |
8 · range 4–24 | Controls how many cards appear in the library grid. |
| Library Card Height (px) | library_card_height |
320 · range 220–520 | Sets the card height in the library view. |
| Battle Card Height (px) | battle_card_height |
560 · range 320–760 | Sets the card height inside battle mode. |
| Chosen Deck Card Height (px) | chosen_deck_card_height |
180 · range 120–260 | Controls the height of cards in the chosen deck strip. |
| Card Page Slug | card_page_slug |
cards | Used for card permalinks when card pages are enabled. |
| Enable Card Pages & Permalinks | enable_card_pages |
On by default | Registers and syncs card post pages for permalinks. |
Defend Command
The defend controls are PRO-only. They change how the battle engine handles the defend action.
| Setting | Field name | Default / range | Meaning |
|---|---|---|---|
| Defend Command Type PRO | defend_mode |
percentage / points | Chooses whether the defend action is treated as a percent or as fixed points. |
| Defend Value PRO | defend_value |
100 · range 0–999 | Primary defend strength applied by the selected mode. |
| Defend Heal Value (HP) PRO | defend_heal_value |
100 · range 0–999 | HP recovery amount linked to defend behavior. |
| Defend Heal Turns PRO | defend_heal_turns |
2 · range 1–6 | How many turns the defend heal effect stays active. |
Skills Timing
These values are stored in seconds in the UI but converted to milliseconds by the engine.
| Setting | Field name | Default | Range |
|---|---|---|---|
| Special Skill 1 Duration | battle_special_skill_1_duration |
1.5 sec | 0–30 sec |
| Special Skill 2 Duration | battle_special_skill_2_duration |
1.5 sec | 0–30 sec |
| The Ultimate Duration | battle_ultimate_duration |
2.0 sec | 0–30 sec |
Player Tips
This block controls the rotating tip box shown on the front end.
AI Action Weights by Difficulty
These values shape how often the AI chooses each action. The engine accepts relative weights and normalizes them automatically.
| Difficulty | Attack | Simple Skill | Special Skill 1 | Special Skill 2 | Ultimate |
|---|---|---|---|---|---|
| Easy | 40 | 30 | 12 | 10 | 8 |
| Normal | 28 | 34 | 16 | 12 | 10 |
| Hard | 20 | 28 | 20 | 16 | 16 |
| Nightmare | 14 | 22 | 20 | 18 | 26 |
Other Useful Toggles
Save and Sync Notes
The settings form saves into acb_settings and then refreshes the rewritten card pages when card pages are enabled. That means changes to layout, deck size, or card page slugs can affect permalinks and should be saved carefully.