Card Battle Arena
Documentation
Admin Controls

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.

Free mode Cards Per Page and the Defend controls are locked until PRO is activated.
What is saved The main settings array is stored in 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.
Accent ColorControls the main highlight color used across the arena shell and UI accents.
Overlay OpacityAdjusts how strong the battlefield overlay looks above the background image.
Panel GlowTurns the glowing panel styling on or off.
Footer EnabledShows or hides the footer copyright 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.

EasyAttack 40 · Simple Skill 30 · Special Skill 1 12 · Special Skill 2 10 · Ultimate 8
NormalAttack 28 · Simple Skill 34 · Special Skill 1 16 · Special Skill 2 12 · Ultimate 10
HardAttack 20 · Simple Skill 28 · Special Skill 1 20 · Special Skill 2 16 · Ultimate 16
NightmareAttack 14 · Simple Skill 22 · Special Skill 1 20 · Special Skill 2 18 · Ultimate 26

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.

Enable TipsTurns the tip box on or off.
Tip 1First rotating tip line shown to players.
Tip 2Second rotating tip line shown to players.
Tip 3Third rotating tip line shown to players.

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
Easy403012108
Normal2834161210
Hard2028201616
Nightmare1422201826

Other Useful Toggles

Drag & DropLets players move cards between zones with pointer interaction.
Legendary MechanicsEnables special legendary behavior in the battle system.
3D AnimationsTurns on more dramatic card motion and battle visuals.
Status EffectsShows status-related battle behavior when enabled.
Special EffectsEnables the effect layer used by battle visuals.
Particle LayerDisplays particle effects on supported devices.
Auto Save DeckSaves the chosen deck automatically in browser storage.
Experimental Online 2PTurns on the multiplayer polling / room flow.

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.

After changing Card Page Slug or enabling Card Pages, refresh permalinks and verify a few sample cards to make sure the new routes resolve correctly.