ac6-manager 0.1.0__tar.gz

ac6_manager-0.1.0/LICENSE

@@ -0,0 +1,51 @@
+ac6-manager Non-Commercial Source License
+
+Copyright © 2026 Danila Kolesnikov
+
+1. Grant of Permission
+Permission is granted, free of charge, to any person obtaining a copy of
+this software and its source code (the "Software") to use, copy, modify,
+and redistribute it, originally or modified, for any purpose, subject to
+the restrictions below.
+
+2. Restriction on Sale
+The Software, whether in its original or modified form, may not be sold,
+licensed for a fee, or otherwise distributed in exchange for payment.
+
+This restriction applies only to the Software itself and does not restrict
+the sale of other works that use, depend upon, or are produced using the
+Software, provided that the Software itself is not being sold or distributed
+in exchange for payment.
+
+3. Attribution
+Attribution to the original author is appreciated, but not required.
+
+You may modify, rename, and redistribute the Software without identifying
+yourself as the original author, provided altered versions are plainly
+marked and you do not falsely claim to have created the original Software.
+
+4. Third-Party Material
+This license applies only to the Software and other material the copyright
+holder has the right to license.
+
+In particular, this license does not apply to third-party assets, game data,
+configuration files, or user data bundled with or referenced by the Software,
+including 'blank_save.sl2'. That particular file is a save file
+generated by Armored Core VI; it is not claimed as an original work of the
+author, and no rights to it are granted.
+
+Armored Core VI and its associated intellectual property belong to their
+respective rights holders.
+
+5. Disclaimer
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
+FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+
+6. Termination
+Any permission granted under this license terminates automatically upon a
+material violation of its terms. Permissions granted to you before such a
+violation remain unaffected.

ac6_manager-0.1.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.5
+Name: ac6-manager
+Version: 0.1.0
+Summary: An Armored Core 6 save manager
+License-File: LICENSE
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ac6-manager
+A CLI save manager for **Armored Core VI**.
+
+AC6 can only have one save file at a time. While this is normally not an issue, it gets really annoying when you, for example, have already finished New Game++ and want a fresh experience without losing hours of progress. `ac6-manager` solves this by allowing you to create and manage new saves in a local folder without having to manually go into the save folder and risk breaking the game.
+
+**As of now,** `ac6-manager` **only works with Steam Proton on Linux**. While other systems may be supported in the future, it is not guaranteed.
+
+## Install
+```
+pipx install ac6-manager
+```
+
+## Usage
+
+```
+ac6-manager [operation] 'target file'
+```
+| Command | Description |
+|---|---|
+| `ac6-manager config` | Changes current configuration |
+| `ac6-manager status` | Lists tool version, config, and current saves |
+| `ac6-manager create 'new_save_name'` | Creates a new save file with the given name |
+| `ac6-manager rename 'old_save_name' 'new_save_name'` | Renames the given save file |
+| `ac6-manager switch 'inactive_save'` | Switches the current active save with the given one |
+| `ac6-manager delete 'inactive_save'` | Deletes the given save file if it's inactive |
+
+On first run (or via `ac6-manager config`), you will be asked for your Steam library path and SteamID64 so the tool can find your current AC6 save. From there, the save will automatically be registered by the tool without further setup. Do **NOT** switch saves with the game running, as doing so will corrupt both saves involved.
+
+## License
+Licensed under the ac6-manager Non-Commercial Source License. This software is free to use, copy, modify, and redistribute. It may not be distributed for direct payment. Full license included in the package under `dist-info/licenses/LICENSE`.

ac6_manager-0.1.0/README.md

@@ -0,0 +1,30 @@
+# ac6-manager
+A CLI save manager for **Armored Core VI**.
+
+AC6 can only have one save file at a time. While this is normally not an issue, it gets really annoying when you, for example, have already finished New Game++ and want a fresh experience without losing hours of progress. `ac6-manager` solves this by allowing you to create and manage new saves in a local folder without having to manually go into the save folder and risk breaking the game.
+
+**As of now,** `ac6-manager` **only works with Steam Proton on Linux**. While other systems may be supported in the future, it is not guaranteed.
+
+## Install
+```
+pipx install ac6-manager
+```
+
+## Usage
+
+```
+ac6-manager [operation] 'target file'
+```
+| Command | Description |
+|---|---|
+| `ac6-manager config` | Changes current configuration |
+| `ac6-manager status` | Lists tool version, config, and current saves |
+| `ac6-manager create 'new_save_name'` | Creates a new save file with the given name |
+| `ac6-manager rename 'old_save_name' 'new_save_name'` | Renames the given save file |
+| `ac6-manager switch 'inactive_save'` | Switches the current active save with the given one |
+| `ac6-manager delete 'inactive_save'` | Deletes the given save file if it's inactive |
+
+On first run (or via `ac6-manager config`), you will be asked for your Steam library path and SteamID64 so the tool can find your current AC6 save. From there, the save will automatically be registered by the tool without further setup. Do **NOT** switch saves with the game running, as doing so will corrupt both saves involved.
+
+## License
+Licensed under the ac6-manager Non-Commercial Source License. This software is free to use, copy, modify, and redistribute. It may not be distributed for direct payment. Full license included in the package under `dist-info/licenses/LICENSE`.

ac6_manager-0.1.0/ac6_manager/__init__.py

@@ -0,0 +1 @@
+# SERIOUSLY fuck pip for requiring I have this file.

ac6_manager-0.1.0/ac6_manager/main.py

@@ -0,0 +1,228 @@
+#!/usr/bin/env python3
+import sys
+import os
+import shutil
+import json
+from importlib.metadata import version
+
+
+# setup
+user_data_dir = f"{os.path.expanduser('~')}/.local/share/ac6-manager"
+os.makedirs(f"{user_data_dir}/user_saves/", exist_ok=True)
+
+def error(message):
+    print("ac6-manager:", message)
+    sys.exit(1)
+
+def load_config():
+    try:
+        with open(f"{user_data_dir}/config.json", "r") as config_file:
+            return json.load(config_file)
+    except FileNotFoundError:
+        print("Config not found. Manual setup required.")
+        reset_config()
+        return load_config() # retry loading
+
+
+# command functions
+def reset_config():
+    if os.path.exists(f"{user_data_dir}/config.json"):
+        old_config = load_config()
+    else:
+        os.mkdir(f"{user_data_dir}/user_saves/First Save/")
+        old_config = {
+            "steam_lib_path": "",
+            "steam_id": "",
+            "active_save": "First Save"
+        }
+
+    def input_path():
+        while True:
+            path= input(
+                "Input your full Steam library path. It can be "
+                    "found in Steam(top left)>Settings>Storage\n"
+                f"Your previous path was: {old_config['steam_lib_path']}\n"
+                "> "
+            ).strip()
+            if os.path.exists(path):
+                return path.rstrip("/") + "/"
+            print("Nonexistant path. Please try again.")
+
+    def input_id():
+        while True:
+            user_id = input(
+                "Input your SteamID64. It can be found in Steam "
+                    "'Account details'; your ID is under your account name\n"
+                f"Your previous SteamID64 was: {old_config['steam_id']}\n"
+                "> "
+            ).strip()
+            if user_id.isdigit() and len(user_id)==17 and int(user_id)>76561197960265728:
+                return user_id
+            print("Invalid SteamID64. Please try again.")
+
+    with open(f"{user_data_dir}/config.json", "w") as config_file:
+        json.dump(
+            {
+                "steam_lib_path": input_path(),
+                "steam_id": input_id(),
+                "active_save": old_config["active_save"]
+            },
+            config_file
+        )
+
+def status():
+    saves = [f.name for f in os.scandir(f"{user_data_dir}/user_saves/") if f.is_dir()]
+    configs = load_config()
+
+    print(
+        f"Version:        {version('ac6-manager')}\n"
+        f"Steam library:  {configs['steam_lib_path']}\n"
+        f"SteamID64:      {configs['steam_id']}\n"
+        "Saves:"
+    )
+    for save in saves:
+        print(f"    {save+' (Active)'*(save==configs['active_save'])}")
+
+def create(save_name):
+    if (save_name in (".", "..")) or ("/" in save_name) or ("\0" in save_name):
+        error("create: Invalid file name")
+    try:
+        os.mkdir(f"{user_data_dir}/user_saves/{save_name}/")
+    except FileExistsError:
+        error(f"create: '{save_name}' already taken")
+    shutil.copy2(
+        f"{os.path.dirname(os.path.abspath(__file__))}/blank_save.sl2",
+        f"{user_data_dir}/user_saves/{save_name}/AC60000.sl2"
+    )
+
+def rename(save_1, save_2):
+    if not os.path.exists(f"{user_data_dir}/user_saves/{save_1}/"):
+        error("rename: Save not found")
+    elif (save_2 in (".", "..")) or ("/" in save_2) or ("\0" in save_2):
+        error("rename: Invalid file name")
+    elif save_1 == save_2:
+        print("rename: Save name unchanged")
+        return
+    elif os.path.exists(f"{user_data_dir}/user_saves/{save_2}/"):
+        error(f"rename: '{save_2}' already taken")
+
+    configs = load_config()
+    if configs["active_save"] == save_1:
+        configs["active_save"] = save_2
+        with open(f"{user_data_dir}/config.json", "w") as config_file:
+            json.dump(configs, config_file)
+
+    os.rename(
+        f"{user_data_dir}/user_saves/{save_1}/",
+        f"{user_data_dir}/user_saves/{save_2}/"
+    )
+
+def switch(save_name):
+    configs = load_config()
+    if not os.path.isdir(f"{user_data_dir}/user_saves/{save_name}/"):
+        error("switch: Save not found")
+    elif save_name == configs["active_save"]:
+        print("switch: Save already active")
+        return
+
+    # save movement
+    save_dir = (
+        configs["steam_lib_path"] +
+        "steamapps/compatdata/1888160/pfx/drive_c/users/steamuser/AppData/Roaming/ArmoredCore6/" +
+        configs["steam_id"]
+    )
+    try:
+        shutil.move(
+            f"{save_dir}/AC60000.sl2",
+            f"{user_data_dir}/user_saves/{configs['active_save']}/AC60000.sl2"
+        )
+        shutil.move(
+            f"{user_data_dir}/user_saves/{save_name}/AC60000.sl2",
+            f"{save_dir}/AC60000.sl2"
+        )
+    except Exception as e:
+        error(f"switch: File movement interrupted ({e}): manual recovery may be required")
+
+    # active save change
+    configs["active_save"] = save_name
+    with open(f"{user_data_dir}/config.json", "w") as config_file:
+        json.dump(configs, config_file)
+
+def delete(save_name):
+    if not os.path.exists(f"{user_data_dir}/user_saves/{save_name}/"):
+        error("delete: Save not found")
+    elif save_name == load_config()["active_save"]:
+        error("delete: Save currently active")
+    elif input("Type 'DELETE' to confirm: ") == "DELETE":
+        shutil.rmtree(f"{user_data_dir}/user_saves/{save_name}/")
+    else:
+        print("Deletion aborted")
+
+
+# main function
+def main():
+    match sys.argv:
+        case [_]:
+            print(
+                "Usage:  ac6-manager [operation] 'target file'\n"
+                "Operations:\n"
+                "    ac6-manager config                                   "
+                        "Changes current configuration\n"
+                "    ac6-manager status                                   "
+                        "Lists tool version, config, and current saves\n"
+                "    ac6-manager create 'new_save_name'                   "
+                        "Creates a new save file with the given name\n"
+                "    ac6-manager rename 'old_save_name' 'new_save_name'   "
+                        "Renames the given save file\n"
+                "    ac6-manager switch 'inactive file'                   "
+                        "Switches the current active save with the given one\n"
+                "    ac6-manager delete 'inactive file'                   "
+                        "Deletes the given save file if it's inactive"
+            )
+        case [_, "config"]:
+            reset_config()
+        case [_, "config", *args]:
+            error(f"config: Unknown arguments: {args}")
+
+        case [_, "status"]:
+            status()
+        case [_, "status", *args]:
+            error(f"status: Unknown arguments: {args}")
+
+        case [_, "create"]:
+            error("create: Missing argument")
+        case [_, "create", save_name]:
+            create(save_name)
+        case [_, "create", _, *args]:
+            error(f"create: Unknown arguments: {args}")
+
+        case [_, "rename"]:
+            error("rename: Missing arguments")
+        case [_, "rename", _]:
+            error("rename: Missing argument")
+        case [_, "rename", old_name, new_name]:
+            rename(old_name, new_name)
+        case [_, "rename", _, _, *args]:
+            error(f"rename: Unknown arguments: {args}")
+
+        case [_, "switch"]:
+            error("switch: Missing argument")
+        case [_, "switch", target_save]:
+            switch(target_save)
+        case [_, "switch", _, *args]:
+            error(f"switch: Unknown arguments: {args}")
+
+        case [_, "delete"]:
+            error("delete: Missing argument")
+        case [_, "delete", target_save]:
+            delete(target_save)
+        case [_, "delete", _, *args]:
+            error(f"delete: Unknown arguments: {args}")
+
+        case _:
+            error("Unknown operation")
+
+
+# testing enabler
+if __name__ == "__main__":
+    main()

ac6_manager-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ac6-manager"
+version = "0.1.0"
+description = "An Armored Core 6 save manager"
+readme = "README.md"
+dependencies = []
+requires-python = ">=3.10"
+license-files = ["LICENSE"]
+
+[project.scripts]
+ac6-manager = "ac6_manager.main:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["ac6_manager"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"ac6_manager/blank_save.sl2" = "ac6_manager/blank_save.sl2"