381 lines
14 KiB
Python
381 lines
14 KiB
Python
#this module loads student data and fetches live banner info from the api##
|
||
"""Student and banner data layer for the Blue Archive gacha simulator."""
|
||
######################################################################
|
||
import json
|
||
import logging
|
||
import random
|
||
from datetime import datetime, timezone
|
||
from pathlib import Path
|
||
from typing import Optional
|
||
|
||
import aiohttp
|
||
|
||
from .constants import (
|
||
BUNDLED_DB,
|
||
BANNER_API,
|
||
CHARACTER_API,
|
||
JOEXYZ_CDN,
|
||
cdn_icon_slug,
|
||
BANNER_RATES,
|
||
DEFAULT_RATES,
|
||
PULL10_RATES,
|
||
)
|
||
|
||
log = logging.getLogger(__name__)
|
||
|
||
|
||
class StudentDB:
|
||
"""In-memory student database loaded from the bundled SchaleDB JSON."""
|
||
|
||
def __init__(self) -> None:
|
||
self.students: list[dict] = []
|
||
self.by_id: dict[int, dict] = {}
|
||
self.by_name: dict[str, dict] = {}
|
||
self.by_rarity: dict[int, list[dict]] = {1: [], 2: [], 3: []}
|
||
self._loaded = False
|
||
|
||
def load(self) -> None:
|
||
if self._loaded:
|
||
return
|
||
with open(BUNDLED_DB, "r", encoding="utf-8") as f:
|
||
self.students = json.load(f)
|
||
|
||
excluded = 0
|
||
for s in self.students:
|
||
sid = s["Id"]
|
||
name = s["Name"].lower()
|
||
rarity = s["StarGrade"]
|
||
limit = s.get("IsLimited") or 0
|
||
|
||
self.by_id[sid] = s
|
||
self.by_name[name] = s
|
||
|
||
# Exclude welfare/event characters (IsLimited >= 2) from pullable pool
|
||
if limit >= 2:
|
||
excluded += 1
|
||
continue
|
||
|
||
if rarity in self.by_rarity:
|
||
self.by_rarity[rarity].append(s)
|
||
|
||
# Pre-build standard pool (IsLimited == 0 only) and full pool
|
||
self._std_pool: dict[int, list[dict]] = {1: [], 2: [], 3: []}
|
||
self._limited_pool: list[dict] = [] # all IsLimited == 1 chars
|
||
for s in self.students:
|
||
limit = s.get("IsLimited") or 0
|
||
if limit >= 2:
|
||
continue
|
||
r = s["StarGrade"]
|
||
if limit == 0 and r in self._std_pool:
|
||
self._std_pool[r].append(s)
|
||
elif limit == 1:
|
||
self._limited_pool.append(s)
|
||
|
||
self._loaded = True
|
||
log.info(
|
||
"Loaded %d students (std: %d, limited: %d, welfare: %d)",
|
||
len(self.students),
|
||
sum(len(v) for v in self._std_pool.values()),
|
||
len(self._limited_pool),
|
||
excluded,
|
||
)
|
||
|
||
async def merge_ennead(self, banner_cache: dict) -> int:
|
||
"""Merge characters from the ennead.cc API that aren't in the SchaleDB.
|
||
|
||
Fetches the full character list, maps fields to SchaleDB format, and
|
||
derives IsLimited from banner history. Only characters with IDs not
|
||
already present are added — existing SchaleDB entries are never touched.
|
||
|
||
Must be called after load() and after banners have been fetched.
|
||
Returns the number of new characters merged.
|
||
"""
|
||
try:
|
||
async with aiohttp.ClientSession() as session:
|
||
async with session.get(CHARACTER_API, timeout=aiohttp.ClientTimeout(total=15)) as resp:
|
||
if resp.status != 200:
|
||
log.warning("Ennead character API returned %d", resp.status)
|
||
return 0
|
||
chars = await resp.json()
|
||
except Exception:
|
||
log.exception("Failed to fetch ennead character API")
|
||
return 0
|
||
|
||
# Build IsLimited from all known banners (0=standard, 1=limited)
|
||
is_limited = self._build_is_limited(banner_cache)
|
||
|
||
try:
|
||
added = self._merge_chars(chars, is_limited)
|
||
if added:
|
||
log.info(
|
||
"Merged %d new characters from ennead API (total: %d, std: %d, limited: %d)",
|
||
added,
|
||
len(self.students),
|
||
sum(len(v) for v in self._std_pool.values()),
|
||
len(self._limited_pool),
|
||
)
|
||
except Exception:
|
||
log.exception("Failed to merge ennead characters")
|
||
return added
|
||
|
||
def _merge_chars(self, chars: list[dict], is_limited: dict[str, int]) -> int:
|
||
"""Add characters from the ennead API payload that aren't already loaded."""
|
||
added = 0
|
||
for c in chars:
|
||
sid = c["id"]
|
||
if sid in self.by_id:
|
||
continue # already present from SchaleDB — keep original
|
||
|
||
name = c["name"]
|
||
rarity = c["baseStar"]
|
||
limit = is_limited.get(name.lower())
|
||
if limit is None:
|
||
# Never appeared as a banner rate-up.
|
||
# 1-2★: welfare (matches SchaleDB: 19/20 welfare are 1★)
|
||
# 3★: likely upcoming limited (all known limited chars are 3★)
|
||
limit = 2 if rarity <= 2 else 1
|
||
|
||
student = {
|
||
"Id": sid,
|
||
"Name": name,
|
||
"StarGrade": rarity,
|
||
"School": c.get("school", "Unknown"),
|
||
"IsLimited": limit,
|
||
"SquadType": "Main" if c.get("squadType") == "Striker" else "Support",
|
||
"DevName": "",
|
||
}
|
||
|
||
self.by_id[sid] = student
|
||
self.by_name[name.lower()] = student
|
||
self.students.append(student)
|
||
|
||
if limit < 2:
|
||
if rarity in self.by_rarity:
|
||
self.by_rarity[rarity].append(student)
|
||
if limit == 0 and rarity in self._std_pool:
|
||
self._std_pool[rarity].append(student)
|
||
elif limit == 1:
|
||
self._limited_pool.append(student)
|
||
|
||
added += 1
|
||
return added
|
||
|
||
@staticmethod
|
||
def _build_is_limited(banner_cache: dict) -> dict[str, int]:
|
||
"""Derive IsLimited from banner history.
|
||
|
||
Returns {name_lower: 0|1} where:
|
||
0 = standard (ever appeared in a PickupGacha)
|
||
1 = limited (only in LimitedGacha / FesGacha, or never a rate-up)
|
||
"""
|
||
result: dict[str, int] = {}
|
||
all_banners = (
|
||
banner_cache.get("current", [])
|
||
+ banner_cache.get("upcoming", [])
|
||
+ banner_cache.get("ended", [])
|
||
)
|
||
for b in all_banners:
|
||
gtype = b.get("gachaType", "")
|
||
is_pickup = gtype == "PickupGacha"
|
||
for name in b.get("rateups", []):
|
||
key = name.lower()
|
||
# PickupGacha takes priority — once standard, always standard
|
||
if key not in result or is_pickup:
|
||
result[key] = 0 if is_pickup else 1
|
||
return result
|
||
|
||
@property
|
||
def pool_totals(self) -> dict[int, int]:
|
||
"""Total collectible students by rarity (excludes welfare)."""
|
||
return {r: len(v) for r, v in self.by_rarity.items()}
|
||
|
||
def get(self, student_id: int) -> Optional[dict]:
|
||
return self.by_id.get(student_id)
|
||
|
||
def get_by_name(self, name: str) -> Optional[dict]:
|
||
"""Resolve a student by name with fuzzy fallback.
|
||
|
||
Tries: exact match → strip variant suffix → substring match.
|
||
Handles banner-API names like "Maki (Camp)" when only "Maki" exists.
|
||
"""
|
||
key = name.lower().strip()
|
||
if key in self.by_name:
|
||
return self.by_name[key]
|
||
|
||
# "Maki (Camp)" → try "Maki"
|
||
if "(" in key:
|
||
base = key.split("(", 1)[0].strip()
|
||
if base in self.by_name:
|
||
return self.by_name[base]
|
||
|
||
# Last resort: substring match (e.g. "Yuuka Pajamas" → "Yuuka (Pajamas)")
|
||
for stored_name, student in self.by_name.items():
|
||
if key in stored_name or stored_name in key:
|
||
return student
|
||
|
||
return None
|
||
|
||
def build_pool(self, banner: Optional[dict]) -> dict[int, list[dict]]:
|
||
"""Build the pullable character pool for a specific banner.
|
||
|
||
Pool rules match the real game:
|
||
- Regular: standard characters only (IsLimited == 0)
|
||
- Pickup: standard pool + rate-up students
|
||
- Limited: standard pool + limited rate-up (only that banner)
|
||
- Fes: standard pool + ALL limiteds (IsLimited == 1) + rate-ups
|
||
|
||
Returns {1: [...], 2: [...], 3: [...]}.
|
||
Pass banner=None for regular recruitment.
|
||
"""
|
||
pool: dict[int, list[dict]] = {
|
||
r: list(self._std_pool[r]) for r in (1, 2, 3)
|
||
}
|
||
|
||
if banner is None:
|
||
return pool
|
||
|
||
gtype = banner.get("gachaType", "")
|
||
rateup_names = [n.lower() for n in banner.get("rateups", [])]
|
||
|
||
# For Fes banners, add ALL past limited characters to the pool
|
||
if gtype == "FesGacha":
|
||
for s in self._limited_pool:
|
||
r = s["StarGrade"]
|
||
if r in pool:
|
||
pool[r].append(s)
|
||
|
||
# Add rate-up students (they might already be in the pool, but we need
|
||
# to identify them for weighted selection later)
|
||
for name in rateup_names:
|
||
s = self.get_by_name(name)
|
||
if s and (s.get("IsLimited") or 0) < 2:
|
||
r = s["StarGrade"]
|
||
if r in pool and s not in pool[r]:
|
||
pool[r].append(s)
|
||
|
||
return pool
|
||
|
||
def weighted_pick(self, pool: list[dict], rateup_names: list[str], rarity: int) -> dict:
|
||
"""Pick a random student from a rarity pool with rate-up weighting.
|
||
|
||
For 3★: rate-up characters get 3x higher weight than standard ones,
|
||
producing roughly the same rate-up frequency as the real game's 0.7%
|
||
per rate-up out of the 3% total.
|
||
For 1-2★: uniform random (rate-ups don't affect lower rarities).
|
||
"""
|
||
if not pool:
|
||
# Fallback: any non-welfare student (shouldn't normally happen)
|
||
pullable = [s for s in self.students if s.get("IsLimited", 0) < 2]
|
||
return random.choice(pullable or self.students)
|
||
|
||
if rarity == 3 and rateup_names:
|
||
# Weighted: rate-up chars get 3x weight each vs normal chars.
|
||
# Use get_by_name so "Hoshino (Armed)" in API matches "Hoshino" in DB.
|
||
rateup_ids = set()
|
||
for rn in rateup_names:
|
||
rs = self.get_by_name(rn)
|
||
if rs:
|
||
rateup_ids.add(rs["Id"])
|
||
weights = []
|
||
for s in pool:
|
||
if s["Id"] in rateup_ids:
|
||
weights.append(3.0)
|
||
else:
|
||
weights.append(1.0)
|
||
return random.choices(pool, weights=weights, k=1)[0]
|
||
|
||
return random.choice(pool)
|
||
|
||
def random_by_rarity(self, rarity: int) -> dict:
|
||
"""Pick any student of given rarity from the full pullable pool (fallback)."""
|
||
pool = self.by_rarity.get(rarity, [])
|
||
if pool:
|
||
return random.choice(pool)
|
||
pullable = [s for s in self.students if s.get("IsLimited", 0) < 2]
|
||
return random.choice(pullable or self.students)
|
||
|
||
def cdn_icon(self, student: dict) -> str:
|
||
"""joexyz CDN icon URL for a student (face/upper-body)."""
|
||
slug = cdn_icon_slug(student["Name"])
|
||
return f"{JOEXYZ_CDN}/students/icons/{slug}.png"
|
||
|
||
def cdn_skill_portrait(self, student: dict) -> str:
|
||
"""joexyz CDN skill-portrait URL (full-body fallback)."""
|
||
dev = student.get("DevName", "")
|
||
if not dev:
|
||
return ""
|
||
return f"{JOEXYZ_CDN}/skill-portraits/Skill_Portrait_{dev}.png"
|
||
|
||
|
||
# Global singleton
|
||
db = StudentDB()
|
||
|
||
|
||
def roll_rarity(rates: tuple[float, float, float]) -> int:
|
||
"""Roll rarity tier — returns 3, 2, or 1."""
|
||
r = random.random()
|
||
if r < rates[0]:
|
||
return 3
|
||
elif r < rates[0] + rates[1]:
|
||
return 2
|
||
else:
|
||
return 1
|
||
|
||
|
||
def get_rates_for_banner(banner: dict) -> tuple[float, float, float]:
|
||
"""Return (3star_rate, 2star_rate, 1star_rate) for a banner's gachaType."""
|
||
return BANNER_RATES.get(banner.get("gachaType", ""), DEFAULT_RATES)
|
||
|
||
|
||
# --- Banner fetching ---------------------------------------------------------
|
||
|
||
async def fetch_banners(session: Optional[aiohttp.ClientSession] = None) -> dict:
|
||
"""Fetch live banner data from the BlueArchiveAPI.
|
||
|
||
Returns {"current": [...], "upcoming": [...], "ended": [...]}.
|
||
Each banner has: id, gachaType, rateups (list of names), startedAt, endedAt.
|
||
"""
|
||
close_session = session is None
|
||
if close_session:
|
||
session = aiohttp.ClientSession()
|
||
|
||
try:
|
||
async with session.get(BANNER_API) as resp:
|
||
if resp.status == 200:
|
||
data = await resp.json()
|
||
log.info("Fetched %d current, %d upcoming banners",
|
||
len(data.get("current", [])),
|
||
len(data.get("upcoming", [])))
|
||
return data
|
||
else:
|
||
log.warning("Banner API returned status %d", resp.status)
|
||
return {"current": [], "upcoming": [], "ended": []}
|
||
except Exception:
|
||
log.exception("Failed to fetch banners from API")
|
||
return {"current": [], "upcoming": [], "ended": []}
|
||
finally:
|
||
if close_session:
|
||
await session.close()
|
||
|
||
|
||
def format_banner_embed(banner: dict, index: int) -> str:
|
||
"""Format a single banner as an embed field value string."""
|
||
gtype = banner.get("gachaType", "PickupGacha")
|
||
rateups = ", ".join(banner.get("rateups", [])) or "Standard pool"
|
||
started = banner.get("startedAt", 0)
|
||
ended = banner.get("endedAt", 0)
|
||
|
||
if started and ended:
|
||
start_dt = datetime.fromtimestamp(started / 1000, tz=timezone.utc)
|
||
end_dt = datetime.fromtimestamp(ended / 1000, tz=timezone.utc)
|
||
dates = f"{start_dt.strftime('%b %d')} – {end_dt.strftime('%b %d, %Y')}"
|
||
else:
|
||
dates = "Permanent"
|
||
|
||
is_fes = " [FES - 6% 3*!]" if gtype == "FesGacha" else ""
|
||
return (
|
||
f"**#{index + 1} — {gtype}{is_fes}**\n"
|
||
f"Rate-up: {rateups}\n"
|
||
f"{dates}"
|
||
)
|