Catsroll

App transport for shared Multi selectors and public pools. Does not calculate.

catsroll_multi_data

Prepare the on-device app. Default count is 300 unless the user specifies it. Multi includes optional Find, Found cats list, route stamps and planMode. For vague beginner questions use catsroll_guide first. Resolve exact banner/cat IDs with catalog tools and pass cat_name with each target to verify identity; never guess numeric IDs. Before choosing a banner for a target, use catsroll_events(cat_id=...) to verify pool membership. Missing targets in selected pools or permitted tickets are rejected. maxGuaranteed is a resource budget, not proof a banner offers a guarantee; forceGuaranteed explicitly simulates it. Ask missing seed, region, banner, target and resource permissions only. seek accepts ordered character IDs; no seed required. This is NOT a computed result. User clicks Calculate in app; no server fallback.

catsroll_prepare

Use for unscheduled collab/event preview requests such as 검심 배열. Resolve series using existing KR/JP names, aliases and character IDs; compare latest known KR/JP pools. Newer JP pools may be used only as a reference simulation, NOT a confirmed Korean schedule/pool. Return candidates and exact prepare rows with previewFor. Ask which variant if ambiguous. Names are joined by stable cat IDs; untranslated new units retain source names. Do not fabricate release dates or extra units. Does not calculate.

catsroll_banner_preview

Find public KR/JP banners by name/date or exact cat_id membership. For a desired character, resolve its ID with catsroll_cats then pass cat_id here WITHOUT using the cat name as the banner query. Only banners whose actual pool contains that cat are returned; source dates are not future availability. Returns IDs and pagination; does not calculate. catalog=true prepares the full dropdown catalog privately for the app, not model search results.

catsroll_events

Search verified Catsroll guidance BEFORE answering beginner, vague or conceptual questions. Pass the user question naturally, including Korean slang; empty input returns the index. Explains seeds, A/B and R/G/RG, guarantees, tickets, banner dates, future ubers, colors, Find and unsupported draws. Ask only missing essentials. This retrieves documentation, NOT predictions; use live catalogs and app results for actual outcomes.

catsroll_guide

Use for vague good-cat/what-to-pull questions and trait gaps such as 빨적 부족. Returns reviewed SS/S/A tier candidates joined by cat ID to current Catsroll names, per-form targets and abilities. No traits: high-tier broad candidates. Multiple traits: match=all unless user accepts any. Default allows 3rd form and ordinary talents, not 4th/ultra. State requirements and subjective within-series tier limits. Attached source_notes are dated opinions for the evaluated form/investment, not game facts or a global rank. For collection priority, distinguish collab scarcity from combat strength; never invent rerun schedules. Use catsroll_cats(details=true) for individual role notes. event filters actual pool membership, NOT current sale or seed reachability. No seed needed for performance candidates; use catalogs and Find for actual pulls.

catsroll_recommend

Find exact character IDs by name (all forms) before selecting targets or seed-search rolls. details=true (at most 5 results) adds current base-form abilities, available talent types and dated source opinions with explicit form/investment context. Distinguish collection scarcity, farming/combo roles and combat tiers; missing notes mean unreviewed, not weak.

catsroll_cats