bcsfe-wrapper-python 0.1.2__tar.gz → 0.1.4__tar.gz

bcsfe_wrapper_python-0.1.4/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include bcsfe_wrapper *

{bcsfe_wrapper_python-0.1.2/bcsfe_wrapper_python.egg-info → bcsfe_wrapper_python-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bcsfe-wrapper-python
-Version: 0.1.2
+Version: 0.1.4
 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.4/bcsfe_wrapper/__init__.py

@@ -0,0 +1,9 @@
+import os
+import sys
+
+# パッケージ内のbcsfeをインポート可能にするためのパス調整
+_current_dir = os.path.dirname(os.path.abspath(__file__))
+if _current_dir not in sys.path:
+    sys.path.insert(0, _current_dir)
+
+from .wrapper import BCSFEWrapper

bcsfe_wrapper_python-0.1.4/bcsfe_wrapper/wrapper.py

@@ -0,0 +1,112 @@
+import os
+import sys
+from typing import Any, List, Optional, Tuple, Dict, Union
+
+from bcsfe import core
+from bcsfe.cli import edits
+
+class BCSFEWrapper:
+    def __init__(self, save_path_or_data: Union[str, bytes], cc: str = "jp", gv: str = "13.1.0"):
+        core.core_data.init_data()
+        self.cc = core.CountryCode.from_code(cc)
+        self.gv = core.GameVersion.from_string(gv)
+        
+        if isinstance(save_path_or_data, str):
+            self.save_path = core.Path(save_path_or_data)
+            self.save_file = core.SaveFile(self.save_path.read(), cc=self.cc, gv=self.gv)
+            self.save_file.save_path = self.save_path
+        else:
+            self.save_file = core.SaveFile(core.Data(save_path_or_data), cc=self.cc, gv=self.gv)
+            self.save_path = None
+
+    @classmethod
+    def from_server(cls, transfer_code: str, confirmation_code: str, cc: str = "jp", gv: str = "13.1.0") -> 'BCSFEWrapper':
+        country_code = core.CountryCode.from_code(cc)
+        game_version = core.GameVersion.from_string(gv)
+        
+        # 正しいメソッド名は from_codes
+        server_handler, result = core.ServerHandler.from_codes(
+            transfer_code, confirmation_code, country_code, game_version, print=False
+        )
+        
+        if server_handler is None:
+            raise RuntimeError(f"Download failed. Check your codes or internet connection.")
+            
+        return cls(server_handler.save_file.to_data().get_bytes(), cc=cc, gv=gv)
+
+    def save(self, output_path: Optional[str] = None):
+        path = core.Path(output_path) if output_path else self.save_path
+        if not path: raise ValueError("Output path must be specified.")
+        self.save_file.to_file(path)
+
+    def upload_to_server(self) -> Tuple[Optional[str], Optional[str]]:
+        handler = core.ServerHandler(self.save_file, print=False)
+        # 正しいメソッド名は get_codes
+        codes = handler.get_codes()
+        if codes:
+            return codes
+        return None, None
+
+    def edit_catfood(self, amount: int): self.save_file.catfood = amount
+    def edit_xp(self, amount: int): self.save_file.xp = amount
+    def edit_normal_tickets(self, amount: int): self.save_file.normal_tickets = amount
+    def edit_rare_tickets(self, amount: int): self.save_file.rare_tickets = amount
+    def edit_platinum_tickets(self, amount: int): self.save_file.platinum_tickets = amount
+    def edit_legend_tickets(self, amount: int): self.save_file.legend_tickets = amount
+    def edit_np(self, amount: int): self.save_file.np = amount
+    def edit_leadership(self, amount: int): self.save_file.leadership = amount
+    def edit_battle_items(self, amount: int):
+        for item in self.save_file.battle_items.items: item.amount = amount
+    def edit_catseyes(self, amount: int):
+        for i in range(len(self.save_file.catseyes)): self.save_file.catseyes[i] = amount
+    def edit_catfruit(self, amount: int):
+        for i in range(len(self.save_file.catfruit)): self.save_file.catfruit[i] = amount
+
+    def unlock_cats(self, cat_ids: List[int]):
+        for cid in cat_ids:
+            cat = self.save_file.cats.get_cat_by_id(cid)
+            if cat: cat.unlock(self.save_file)
+
+    def unlock_all_cats(self):
+        for cat in self.save_file.cats.cats: cat.unlock(self.save_file)
+
+    def upgrade_cats(self, cat_ids: List[int], base: int = 19, plus: int = 0):
+        for cid in cat_ids:
+            cat = self.save_file.cats.get_cat_by_id(cid)
+            if cat:
+                cat.upgrade.base = base
+                cat.upgrade.plus = plus
+
+    def upgrade_all_cats(self, base: Optional[int] = None, plus: Optional[int] = None):
+        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):
+        for cid in cat_ids:
+            cat = self.save_file.cats.get_cat_by_id(cid)
+            if cat: cat.set_form(form)
+
+    def true_form_all_cats(self):
+        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_story_chapters(self, chapters: List[int] = [0, 1, 2]):
+        for c_id in chapters:
+            if c_id < len(self.save_file.story.chapters):
+                chapter = self.save_file.story.chapters[c_id]
+                chapter.clear_all(self.save_file)
+                for stage in chapter.stages: stage.treasure = 3
+
+    def edit_gamatoto_xp(self, xp: int): self.save_file.gamatoto.xp = xp
+    def edit_ototo_engineers(self, amount: int): self.save_file.ototo.engineers = amount
+    def unban(self):
+        self.save_file.show_ban_message = False
+        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.2 → bcsfe_wrapper_python-0.1.4/bcsfe_wrapper_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bcsfe-wrapper-python
-Version: 0.1.2
+Version: 0.1.4
 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.4/bcsfe_wrapper_python.egg-info/SOURCES.txt

@@ -0,0 +1,207 @@
+MANIFEST.in
+README.md
+setup.py
+bcsfe_wrapper/__init__.py
+bcsfe_wrapper/wrapper.py
+bcsfe_wrapper/bcsfe/__init__.py
+bcsfe_wrapper/bcsfe/__main__.py
+bcsfe_wrapper/bcsfe/py.typed
+bcsfe_wrapper/bcsfe/cli/__init__.py
+bcsfe_wrapper/bcsfe/cli/color.py
+bcsfe_wrapper/bcsfe/cli/dialog_creator.py
+bcsfe_wrapper/bcsfe/cli/feature_handler.py
+bcsfe_wrapper/bcsfe/cli/file_dialog.py
+bcsfe_wrapper/bcsfe/cli/main.py
+bcsfe_wrapper/bcsfe/cli/recent_saves.py
+bcsfe_wrapper/bcsfe/cli/save_management.py
+bcsfe_wrapper/bcsfe/cli/server_cli.py
+bcsfe_wrapper/bcsfe/cli/edits/__init__.py
+bcsfe_wrapper/bcsfe/cli/edits/aku_realm.py
+bcsfe_wrapper/bcsfe/cli/edits/basic_items.py
+bcsfe_wrapper/bcsfe/cli/edits/cat_editor.py
+bcsfe_wrapper/bcsfe/cli/edits/clear_tutorial.py
+bcsfe_wrapper/bcsfe/cli/edits/enemy_editor.py
+bcsfe_wrapper/bcsfe/cli/edits/event_tickets.py
+bcsfe_wrapper/bcsfe/cli/edits/fixes.py
+bcsfe_wrapper/bcsfe/cli/edits/map.py
+bcsfe_wrapper/bcsfe/cli/edits/max_all.py
+bcsfe_wrapper/bcsfe/cli/edits/rare_ticket_trade.py
+bcsfe_wrapper/bcsfe/cli/edits/storage.py
+bcsfe_wrapper/bcsfe/core/__init__.py
+bcsfe_wrapper/bcsfe/core/country_code.py
+bcsfe_wrapper/bcsfe/core/crypto.py
+bcsfe_wrapper/bcsfe/core/game_version.py
+bcsfe_wrapper/bcsfe/core/locale_handler.py
+bcsfe_wrapper/bcsfe/core/log.py
+bcsfe_wrapper/bcsfe/core/max_value_helper.py
+bcsfe_wrapper/bcsfe/core/theme_handler.py
+bcsfe_wrapper/bcsfe/core/game/__init__.py
+bcsfe_wrapper/bcsfe/core/game/localizable.py
+bcsfe_wrapper/bcsfe/core/game/battle/__init__.py
+bcsfe_wrapper/bcsfe/core/game/battle/battle_items.py
+bcsfe_wrapper/bcsfe/core/game/battle/cleared_slots.py
+bcsfe_wrapper/bcsfe/core/game/battle/enemy.py
+bcsfe_wrapper/bcsfe/core/game/battle/slots.py
+bcsfe_wrapper/bcsfe/core/game/catbase/__init__.py
+bcsfe_wrapper/bcsfe/core/game/catbase/beacon_base.py
+bcsfe_wrapper/bcsfe/core/game/catbase/cat.py
+bcsfe_wrapper/bcsfe/core/game/catbase/drop_chara.py
+bcsfe_wrapper/bcsfe/core/game/catbase/gambling.py
+bcsfe_wrapper/bcsfe/core/game/catbase/gatya.py
+bcsfe_wrapper/bcsfe/core/game/catbase/gatya_item.py
+bcsfe_wrapper/bcsfe/core/game/catbase/item_pack.py
+bcsfe_wrapper/bcsfe/core/game/catbase/login_bonuses.py
+bcsfe_wrapper/bcsfe/core/game/catbase/matatabi.py
+bcsfe_wrapper/bcsfe/core/game/catbase/medals.py
+bcsfe_wrapper/bcsfe/core/game/catbase/mission.py
+bcsfe_wrapper/bcsfe/core/game/catbase/my_sale.py
+bcsfe_wrapper/bcsfe/core/game/catbase/nyanko_club.py
+bcsfe_wrapper/bcsfe/core/game/catbase/officer_pass.py
+bcsfe_wrapper/bcsfe/core/game/catbase/playtime.py
+bcsfe_wrapper/bcsfe/core/game/catbase/powerup.py
+bcsfe_wrapper/bcsfe/core/game/catbase/scheme_items.py
+bcsfe_wrapper/bcsfe/core/game/catbase/special_skill.py
+bcsfe_wrapper/bcsfe/core/game/catbase/stamp.py
+bcsfe_wrapper/bcsfe/core/game/catbase/talent_orbs.py
+bcsfe_wrapper/bcsfe/core/game/catbase/unlock_popups.py
+bcsfe_wrapper/bcsfe/core/game/catbase/upgrade.py
+bcsfe_wrapper/bcsfe/core/game/catbase/user_rank_rewards.py
+bcsfe_wrapper/bcsfe/core/game/gamoto/__init__.py
+bcsfe_wrapper/bcsfe/core/game/gamoto/base_materials.py
+bcsfe_wrapper/bcsfe/core/game/gamoto/cat_shrine.py
+bcsfe_wrapper/bcsfe/core/game/gamoto/catamins.py
+bcsfe_wrapper/bcsfe/core/game/gamoto/gamatoto.py
+bcsfe_wrapper/bcsfe/core/game/gamoto/ototo.py
+bcsfe_wrapper/bcsfe/core/game/map/__init__.py
+bcsfe_wrapper/bcsfe/core/game/map/aku.py
+bcsfe_wrapper/bcsfe/core/game/map/challenge.py
+bcsfe_wrapper/bcsfe/core/game/map/chapters.py
+bcsfe_wrapper/bcsfe/core/game/map/dojo.py
+bcsfe_wrapper/bcsfe/core/game/map/enigma.py
+bcsfe_wrapper/bcsfe/core/game/map/event.py
+bcsfe_wrapper/bcsfe/core/game/map/ex_stage.py
+bcsfe_wrapper/bcsfe/core/game/map/gauntlets.py
+bcsfe_wrapper/bcsfe/core/game/map/item_reward_stage.py
+bcsfe_wrapper/bcsfe/core/game/map/legend_quest.py
+bcsfe_wrapper/bcsfe/core/game/map/map_names.py
+bcsfe_wrapper/bcsfe/core/game/map/map_option.py
+bcsfe_wrapper/bcsfe/core/game/map/map_reset.py
+bcsfe_wrapper/bcsfe/core/game/map/outbreaks.py
+bcsfe_wrapper/bcsfe/core/game/map/story.py
+bcsfe_wrapper/bcsfe/core/game/map/timed_score.py
+bcsfe_wrapper/bcsfe/core/game/map/tower.py
+bcsfe_wrapper/bcsfe/core/game/map/uncanny.py
+bcsfe_wrapper/bcsfe/core/game/map/zero_legends.py
+bcsfe_wrapper/bcsfe/core/io/__init__.py
+bcsfe_wrapper/bcsfe/core/io/adb_handler.py
+bcsfe_wrapper/bcsfe/core/io/bc_csv.py
+bcsfe_wrapper/bcsfe/core/io/command.py
+bcsfe_wrapper/bcsfe/core/io/config.py
+bcsfe_wrapper/bcsfe/core/io/data.py
+bcsfe_wrapper/bcsfe/core/io/git_handler.py
+bcsfe_wrapper/bcsfe/core/io/json_file.py
+bcsfe_wrapper/bcsfe/core/io/path.py
+bcsfe_wrapper/bcsfe/core/io/root_handler.py
+bcsfe_wrapper/bcsfe/core/io/save.py
+bcsfe_wrapper/bcsfe/core/io/thread_helper.py
+bcsfe_wrapper/bcsfe/core/io/waydroid.py
+bcsfe_wrapper/bcsfe/core/io/yaml.py
+bcsfe_wrapper/bcsfe/core/server/__init__.py
+bcsfe_wrapper/bcsfe/core/server/client_info.py
+bcsfe_wrapper/bcsfe/core/server/event_data.py
+bcsfe_wrapper/bcsfe/core/server/game_data_getter.py
+bcsfe_wrapper/bcsfe/core/server/headers.py
+bcsfe_wrapper/bcsfe/core/server/managed_item.py
+bcsfe_wrapper/bcsfe/core/server/request.py
+bcsfe_wrapper/bcsfe/core/server/server_handler.py
+bcsfe_wrapper/bcsfe/core/server/updater.py
+bcsfe_wrapper/bcsfe/files/max_values.json
+bcsfe_wrapper/bcsfe/files/locales/en/core/config.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/files.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/input.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/locale.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/main.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/save.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/server.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/theme.properties
+bcsfe_wrapper/bcsfe/files/locales/en/core/updater.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/bannable_items.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/cats.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/enemy.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/fixes.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/gambling.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/gamototo.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/gatya.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/gold_pass.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/items.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/map.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/medals.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/missions.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/playtime.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/scheme_items.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/special_skills.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/talent_orbs.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/treasures.properties
+bcsfe_wrapper/bcsfe/files/locales/en/edits/user_rank.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/metadata.json
+bcsfe_wrapper/bcsfe/files/locales/tw/core/config.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/files.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/input.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/locale.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/main.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/save.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/server.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/theme.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/core/updater.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/bannable_items.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/cats.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/enemy.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/fixes.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/gambling.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/gamototo.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/gatya.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/gold_pass.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/items.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/map.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/medals.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/missions.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/playtime.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/scheme_items.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/special_skills.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/talent_orbs.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/treasures.properties
+bcsfe_wrapper/bcsfe/files/locales/tw/edits/user_rank.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/metadata.json
+bcsfe_wrapper/bcsfe/files/locales/vi/core/config.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/files.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/input.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/locale.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/main.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/save.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/server.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/theme.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/core/updater.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/bannable_items.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/cats.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/enemy.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/fixes.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/gambling.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/gamototo.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/gatya.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/gold_pass.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/items.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/map.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/medals.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/missions.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/playtime.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/scheme_items.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/special_skills.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/talent_orbs.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/treasures.properties
+bcsfe_wrapper/bcsfe/files/locales/vi/edits/user_rank.properties
+bcsfe_wrapper/bcsfe/files/themes/default.json
+bcsfe_wrapper/bcsfe/files/themes/discord.json
+bcsfe_wrapper_python.egg-info/PKG-INFO
+bcsfe_wrapper_python.egg-info/SOURCES.txt
+bcsfe_wrapper_python.egg-info/dependency_links.txt
+bcsfe_wrapper_python.egg-info/top_level.txt

{bcsfe_wrapper_python-0.1.2 → bcsfe_wrapper_python-0.1.4}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='bcsfe-wrapper-python',
-    version='0.1.2',
+    version='0.1.4',
     packages=find_packages(), include_package_data=True,
     install_requires=[
         # 依存関係があればここに記述

bcsfe_wrapper_python-0.1.2/MANIFEST.in

@@ -1 +0,0 @@
-recursive-include bcsfe_wrapper/bcsfe *

bcsfe_wrapper_python-0.1.2/bcsfe_wrapper/__init__.py

@@ -1 +0,0 @@
-from .wrapper import BCSFEWrapper

bcsfe_wrapper_python-0.1.2/bcsfe_wrapper/wrapper.py

@@ -1,178 +0,0 @@
-import os
-import sys
-from typing import Any, List, Optional, Tuple, Dict, Union
-
-# bcsfeモジュールをインポートできるようにパスを追加
-sys.path.insert(0, os.path.abspath(os.path.dirname(__file__)))
-
-from .bcsfe.bcsfe import core
-from .bcsfe.bcsfe.cli import edits
-
-class BCSFEWrapper:
-    """
-    BCSFE-Pythonの全機能をPythonから呼び出すための包括的ラッパークラス。
-    """
-
-    def __init__(self, save_path_or_data: Union[str, bytes], cc: str = "jp", gv: str = "13.1.0"):
-        """
-        初期化処理。
-        
-        :param save_path_or_data: セーブファイルのパスまたはバイナリデータ
-        :param cc: 国コード (jp, en, kr, tw)
-        :param gv: ゲームバージョン (例: 13.1.0)
-        """
-        core.core_data.init_data()
-        
-        if isinstance(save_path_or_data, str):
-            self.save_path = core.Path(save_path_or_data)
-            self.save_file = core.SaveFile(self.save_path.read())
-            self.save_file.save_path = self.save_path
-        else:
-            self.save_file = core.SaveFile(save_path_or_data)
-            self.save_path = None
-
-    @classmethod
-    def from_server(cls, transfer_code: str, confirmation_code: str, cc: str = "jp") -> 'BCSFEWrapper':
-        """
-        サーバーからセーブデータをダウンロードしてインスタンスを作成します。
-        """
-        country_code = core.CountryCode.from_code(cc)
-        handler = core.ServerHandler(country_code)
-        save_data, error = handler.download_save(transfer_code, confirmation_code)
-        if save_data is None:
-            raise RuntimeError(f"Download failed: {error}")
-        return cls(save_data.to_data().get_bytes(), cc=cc)
-
-    def save(self, output_path: Optional[str] = None):
-        """現在の状態をファイルに保存します。"""
-        path = core.Path(output_path) if output_path else self.save_path
-        if not path:
-            raise ValueError("Output path must be specified.")
-        self.save_file.to_file(path)
-
-    def upload_to_server(self) -> Tuple[Optional[str], Optional[str]]:
-        """現在のセーブデータをサーバーにアップロードし、引き継ぎコードと認証番号を返します。"""
-        handler = core.ServerHandler(self.save_file.cc)
-        response, error = handler.upload_save(self.save_file)
-        if response:
-            return response.get("transfer_code"), response.get("confirmation_code")
-        return None, None
-
-    # --- 基本アイテム編集 (edits.basic_items) ---
-
-    def edit_catfood(self, amount: int):
-        self.save_file.catfood = amount
-
-    def edit_xp(self, amount: int):
-        self.save_file.xp = amount
-
-    def edit_normal_tickets(self, amount: int):
-        self.save_file.normal_tickets = amount
-
-    def edit_rare_tickets(self, amount: int):
-        self.save_file.rare_tickets = amount
-
-    def edit_platinum_tickets(self, amount: int):
-        self.save_file.platinum_tickets = amount
-
-    def edit_legend_tickets(self, amount: int):
-        self.save_file.legend_tickets = amount
-
-    def edit_np(self, amount: int):
-        self.save_file.np = amount
-
-    def edit_leadership(self, amount: int):
-        self.save_file.leadership = amount
-
-    def edit_battle_items(self, amount: int):
-        for item in self.save_file.battle_items.items:
-            item.amount = amount
-
-    def edit_catseyes(self, amount: int):
-        for i in range(len(self.save_file.catseyes)):
-            self.save_file.catseyes[i] = amount
-
-    def edit_catfruit(self, amount: int):
-        for i in range(len(self.save_file.catfruit)):
-            self.save_file.catfruit[i] = amount
-
-    # --- キャラクター編集 (edits.cat_editor) ---
-
-    def unlock_cats(self, cat_ids: List[int]):
-        """指定したIDのキャラを解放します。"""
-        for cid in cat_ids:
-            cat = self.save_file.cats.get_cat_by_id(cid)
-            if cat: cat.unlock(self.save_file)
-
-    def unlock_all_cats(self):
-        """全キャラを解放します。"""
-        for cat in self.save_file.cats.cats:
-            cat.unlock(self.save_file)
-
-    def upgrade_cats(self, cat_ids: List[int], base: int = 19, plus: int = 0):
-        """指定したキャラのレベルを設定します。"""
-        for cid in cat_ids:
-            cat = self.save_file.cats.get_cat_by_id(cid)
-            if cat:
-                cat.upgrade.base = base
-                cat.upgrade.plus = plus
-
-    def upgrade_all_cats(self, base: Optional[int] = None, plus: Optional[int] = None):
-        """全キャラをレベル最大にします。"""
-        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):
-        """指定したキャラの形態を設定します (0:第1, 1:第2, 2:第3, 3:第4)。"""
-        for cid in cat_ids:
-            cat = self.save_file.cats.get_cat_by_id(cid)
-            if cat: cat.set_form(form)
-
-    def true_form_all_cats(self):
-        """全キャラを第3形態以上にします。"""
-        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)
-
-    # --- ステージ編集 (edits.clear_tutorial, edits.map) ---
-
-    def clear_tutorial(self):
-        edits.clear_tutorial.clear_tutorial(self.save_file, False)
-
-    def clear_story_chapters(self, chapters: List[int] = [0, 1, 2]):
-        """指定したストーリー章をクリアし、お宝を最高にします。"""
-        for c_id in chapters:
-            if c_id < len(self.save_file.story.chapters):
-                chapter = self.save_file.story.chapters[c_id]
-                chapter.clear_all(self.save_file)
-                for stage in chapter.stages:
-                    stage.treasure = 3
-
-    # --- ガマトト・オトト (edits.basic_items) ---
-
-    def edit_gamatoto_xp(self, xp: int):
-        self.save_file.gamatoto.xp = xp
-
-    def edit_ototo_engineers(self, amount: int):
-        self.save_file.ototo.engineers = amount
-
-    # --- その他・アカウント (edits.fixes, edits.basic_items) ---
-
-    def unban(self):
-        """BANメッセージを非表示にし、フラグをリセットします。"""
-        self.save_file.show_ban_message = False
-        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:
-        """生のSaveFileオブジェクトを取得して、より詳細な編集を可能にします。"""
-        return self.save_file