bcsfe-wrapper-python 0.1.21__py3-none-any.whl → 0.1.22__py3-none-any.whl

bcsfe_wrapper/wrapper.py

@@ -64,7 +64,13 @@ class BCSFEWrapper:
         codes = handler.get_codes()
         return codes if codes else (None, None)
 
-    def _set_val(self, attr: str, amount: int): setattr(self.save_file, attr, amount)
+    def _check_save(self):
+        if self.save_file is None:
+            raise RuntimeError("セーブデータが読み込まれていません。先に from_server() などでデータをロードしてください。")
+
+    def _set_val(self, attr: str, amount: int):
+        self._check_save()
+        setattr(self.save_file, attr, amount)
     def edit_catfood(self, amount: int): self._set_val("catfood", amount)
     def edit_xp(self, amount: int): self._set_val("xp", amount)
     def edit_normal_tickets(self, amount: int): self._set_val("normal_tickets", amount)
@@ -75,52 +81,63 @@ class BCSFEWrapper:
     def edit_leadership(self, amount: int): self._set_val("leadership", amount)
     
     def edit_battle_items(self, amount: int):
+        self._check_save()
         for item in self.save_file.battle_items.items: item.amount = amount
     def edit_catseyes(self, amount: int):
+        self._check_save()
         for i in range(len(self.save_file.catseyes)): self.save_file.catseyes[i] = amount
     def edit_catfruit(self, amount: int):
+        self._check_save()
         for i in range(len(self.save_file.catfruit)): self.save_file.catfruit[i] = amount
 
     def unlock_cats(self, cat_ids: List[int]):
+        self._check_save()
         for cid in cat_ids:
-            # ユーザーが指定したIDから1を引いて内部IDに変換
             internal_id = cid - 1
             cat = self.save_file.cats.get_cat_by_id(internal_id)
             if cat: cat.unlock(self.save_file)
     def unlock_all_cats(self):
+        self._check_save()
         for cat in self.save_file.cats.cats: cat.unlock(self.save_file)
     
-    # 新機能: 指定キャラ削除（未解放に戻す）
     def remove_cats(self, cat_ids: List[int]):
+        self._check_save()
         for cid in cat_ids:
             internal_id = cid - 1
             cat = self.save_file.cats.get_cat_by_id(internal_id)
             if cat: cat.set_unlocked(False)
 
     def upgrade_cats(self, cat_ids: List[int], base: int = 19, plus: int = 0):
+        self._check_save()
         for cid in cat_ids:
             internal_id = cid - 1
             cat = self.save_file.cats.get_cat_by_id(internal_id)
             if cat: cat.upgrade.base, cat.upgrade.plus = base, plus
     def upgrade_all_cats(self, base: Optional[int] = None, plus: Optional[int] = None):
+        self._check_save()
         for cat in self.save_file.cats.cats:
             if not cat.is_unlocked(self.save_file): continue
             power_up = core.PowerUpHelper(cat, self.save_file)
             cat.upgrade.base = (base if base is not None else power_up.get_max_possible_base()) - 1
             cat.upgrade.plus = plus if plus is not None else power_up.get_max_possible_plus()
     def set_cat_form(self, cat_ids: List[int], form: int = 2):
+        self._check_save()
         for cid in cat_ids:
             internal_id = cid - 1
             cat = self.save_file.cats.get_cat_by_id(internal_id)
             if cat: cat.set_form(form)
     def true_form_all_cats(self):
+        self._check_save()
         cats = self.save_file.cats.get_unlocked_cats()
         self.save_file.cats.true_form_cats(self.save_file, cats, True, True)
         self.save_file.cats.fourth_form_cats(self.save_file, cats, True, True)
 
-    def clear_tutorial(self): edits.clear_tutorial.clear_tutorial(self.save_file, False)
+    def clear_tutorial(self):
+        self._check_save()
+        edits.clear_tutorial.clear_tutorial(self.save_file, False)
     
     def _clear_chapter_group(self, chapters_obj, chapters_to_clear: List[int]):
+        self._check_save()
         for c_id in chapters_to_clear:
             if c_id < len(chapters_obj.chapters):
                 chapter = chapters_obj.chapters[c_id]
@@ -128,13 +145,17 @@ class BCSFEWrapper:
                 for stage in chapter.stages: stage.treasure = 3
 
     def clear_empire_of_cats(self, chapters: List[int] = [0, 1, 2]):
+        self._check_save()
         self._clear_chapter_group(self.save_file.story.chapters, chapters)
     def clear_into_the_future(self, chapters: List[int] = [0, 1, 2]):
+        self._check_save()
         self._clear_chapter_group(self.save_file.story.chapters, [c + 3 for c in chapters])
     def clear_cats_of_the_cosmos(self, chapters: List[int] = [0, 1, 2]):
+        self._check_save()
         self._clear_chapter_group(self.save_file.story.chapters, [c + 6 for c in chapters])
 
     def _clear_legend_group(self, legend_obj, max_star: int = 1):
+        self._check_save()
         for map_id in range(len(legend_obj.chapters)):
             for star in range(min(max_star, legend_obj.get_total_stars(map_id))):
                 for stage_id in range(legend_obj.get_total_stages(map_id, star)):
@@ -145,22 +166,28 @@ class BCSFEWrapper:
     def clear_zero_legends(self, max_star: int = 1): self._clear_legend_group(self.save_file.zero_legends, max_star)
     
     def clear_zombie_outbreaks(self, chapters: List[int] = [0, 1, 2, 3, 4, 5, 6, 7, 8]):
+        self._check_save()
         for chapter_id in chapters:
             for stage_id in range(48):
                 self.save_file.outbreaks.clear_outbreak(chapter_id, stage_id, True)
 
-    def unlock_aku_realm(self): edits.aku_realm.unlock_aku_realm(self.save_file)
+    def unlock_aku_realm(self):
+        self._check_save()
+        edits.aku_realm.unlock_aku_realm(self.save_file)
     
     def unlock_all_medals(self):
+        self._check_save()
         for i in range(len(self.save_file.medals.medals)):
             self.save_file.medals.medals[i] = True
 
     def claim_all_stamps(self):
+        self._check_save()
         for stamp in self.save_file.stamps.stamps:
             stamp.received = True
             stamp.current_stamp = stamp.total_stamps
 
     def legend_all_gamatoto_members(self):
+        self._check_save()
         members_name = core.core_data.get_gamatoto_members_name(self.save_file)
         legend_ids = [m.member_id for m in members_name.members if m.rarity == 2]
         if not legend_ids: return
@@ -168,6 +195,7 @@ class BCSFEWrapper:
             helper.id = random.choice(legend_ids)
 
     def complete_all_treasures(self, groups: List[int] = [0, 1, 2]):
+        self._check_save()
         for group_id in groups:
             start, end = group_id * 3, (group_id + 1) * 3
             for c_id in range(start, end):
@@ -176,30 +204,32 @@ class BCSFEWrapper:
                     for stage in chapter.stages: stage.treasure = 3
 
     def max_all_upgrades(self):
+        self._check_save()
         for upgrade in self.save_file.upgrades.upgrades:
             upgrade.base = upgrade.max_base
             upgrade.plus = upgrade.max_plus
 
-    # 新機能: 施設レベルの個別指定
     def edit_upgrade_level(self, upgrade_id: int, base: Optional[int] = None, plus: Optional[int] = None):
-        """
-        0:にゃんこ砲攻撃力, 1:射程, 2:チャージ, 3:働きネコ効率, 4:お財布, 5:お城体力, 6:研究, 7:会計, 8:勉強, 9:統率力
-        """
+        self._check_save()
         if upgrade_id < len(self.save_file.upgrades.upgrades):
             upgrade = self.save_file.upgrades.upgrades[upgrade_id]
             if base is not None: upgrade.base = base
             if plus is not None: upgrade.plus = plus
 
     def instant_complete_activities(self):
+        self._check_save()
         self.save_file.gamatoto.expedition.remaining_time = 0
         self.save_file.ototo.developing_remaining_time = 0
 
     def max_all_talents(self):
+        self._check_save()
         for cat in self.save_file.cats.get_unlocked_cats():
             for talent in cat.talents:
                 talent.level = talent.max_level
 
-    def unban(self): self.save_file.show_ban_message = self.save_file.banned = False
+    def unban(self):
+        self._check_save()
+        self.save_file.show_ban_message = self.save_file.banned = False
     def get_inquiry_code(self) -> str: return self.save_file.inquiry_code
     def edit_inquiry_code(self, new_code: str): self.save_file.inquiry_code = new_code
     def get_save_file(self) -> core.SaveFile: return self.save_file

{bcsfe_wrapper_python-0.1.21.dist-info → bcsfe_wrapper_python-0.1.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bcsfe-wrapper-python
-Version: 0.1.21
+Version: 0.1.22
 Summary: A Python wrapper for BCSFE-Python to easily interact with Battle Cats save files.
 Home-page: https://github.com/fieryhenry/BCSFE-Python
 Author: Manus AI

{bcsfe_wrapper_python-0.1.21.dist-info → bcsfe_wrapper_python-0.1.22.dist-info}/RECORD

@@ -1,5 +1,5 @@
 bcsfe_wrapper/__init__.py,sha256=o2LbyVJjuRV1gap8wDbsv39kEUJM1rt8Lq49u1RYYXA,268
-bcsfe_wrapper/wrapper.py,sha256=zzd0OXdHHR7XmKipc24h7Hciyq2Koijilm4D1pRhjg0,10439
+bcsfe_wrapper/wrapper.py,sha256=nffE7JI7jasWAm_-NVWnpLgjCqXi6LVlxHWX6_xhBAc,11081
 bcsfe_wrapper/__pycache__/__init__.cpython-311.pyc,sha256=svMfcdHfIa6yhFBxIuraz6iCJ0ZuMsDRaOFR2NWWC6A,567
 bcsfe_wrapper/__pycache__/wrapper.cpython-311.pyc,sha256=ij4a4EzzZlilVhzc-SB8LHaQKWO3truExx2aGn-coMg,21944
 bcsfe_wrapper/bcsfe/__init__.py,sha256=vCHjSoJq5u684HLQXahhtA64MZWffNHFdhweP7RM0f4,144
@@ -310,7 +310,7 @@ bcsfe_wrapper/bcsfe/files/locales/vi/edits/treasures.properties,sha256=U9uKsF4y0
 bcsfe_wrapper/bcsfe/files/locales/vi/edits/user_rank.properties,sha256=FcldhzKM0UmuhmGzI3dGzxstuKcw-t-gkbmKLZT4VKg,603
 bcsfe_wrapper/bcsfe/files/themes/default.json,sha256=w8eqqd9ATIFwUcvOWTdJjyd1T3LGgUm3iVkJhT5wfEo,392
 bcsfe_wrapper/bcsfe/files/themes/discord.json,sha256=W1dtEev6tap_waHOxvSqENDcMRA9jfBvjW7t-ssdGs4,370
-bcsfe_wrapper_python-0.1.21.dist-info/METADATA,sha256=8bK_yvwx0Yv852ND7rlF-uwsRl0lQNbe-GrFv2bcux0,4518
-bcsfe_wrapper_python-0.1.21.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-bcsfe_wrapper_python-0.1.21.dist-info/top_level.txt,sha256=kqyMKpAdNg39_kGGtqsxOSLPIb-qx7R1mQj1hReUsYM,14
-bcsfe_wrapper_python-0.1.21.dist-info/RECORD,,
+bcsfe_wrapper_python-0.1.22.dist-info/METADATA,sha256=WxJ5vOUn3IxTetHnSr0_5MIkxkumbgQY2OkxSmuTK2A,4518
+bcsfe_wrapper_python-0.1.22.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+bcsfe_wrapper_python-0.1.22.dist-info/top_level.txt,sha256=kqyMKpAdNg39_kGGtqsxOSLPIb-qx7R1mQj1hReUsYM,14
+bcsfe_wrapper_python-0.1.22.dist-info/RECORD,,