pvztools 0.0.1__tar.gz

pvztools-0.0.1/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/
+.venv/
+.pytest_cache/
+.idea/
+.vscode/

pvztools-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blue Rose
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pvztools-0.0.1/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.5
+Name: pvztools
+Version: 0.0.1
+Summary: Plants vs. Zombies (PvZ1 & mods) automation framework: memory access with signature-based address discovery, track (轨道) DSL, lineup runner.
+Project-URL: Homepage, https://github.com/BlueRoseMike/pvztools
+Project-URL: Issues, https://github.com/BlueRoseMike/pvztools/issues
+Author: Blue Rose
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,memory,plants-vs-zombies,pvz,植物大战僵尸,轨道,键控
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# pvztools
+
+Plants vs. Zombies（PvZ1 及各类改版）自动化框架 / PvZ1 automation framework.
+
+> **状态：0.0.1 为占名占坑版本，尚无可用 API。** 正式版本发布前请勿依赖本包。
+
+## 目标
+
+- **内存层**：附加游戏进程，通过特征码（AOB）扫描自适应定位基址（阳光、刷新倒计时、游戏时钟等），兼容原版多版本与各类改版。
+- **轨道 DSL**：解析社区轨道语言（如 `P|I-P|P|I-P 601|1150|601|1150`、`IP-P|IP-P 1738|1738`），支持上下半场、过渡符、波长与起手/收尾特判。
+- **执行器**：以游戏内部时钟（cs）为基准调度操作，而非墙钟延时。
+- **阵容生成**：按场地、卡槽与节奏（ch4/ch5/ch6/P4…）生成并运行无尽阵容。
+- **修改器**：可选、默认关闭的内存修改功能。
+
+## 与现有工具的关系
+
+本项目受 AsmVsZombies (AvZ)、lmintlcx/pvz、pvztoolkit 等启发，目标是提供一个 `pip install` 即用的 Python 框架。本包**不包含任何游戏文件**。
+
+## 安装
+
+```bash
+pip install pvztools
+```
+
+仅支持 Windows。
+
+## 许可证
+
+MIT

pvztools-0.0.1/README.md

@@ -0,0 +1,29 @@
+# pvztools
+
+Plants vs. Zombies（PvZ1 及各类改版）自动化框架 / PvZ1 automation framework.
+
+> **状态：0.0.1 为占名占坑版本，尚无可用 API。** 正式版本发布前请勿依赖本包。
+
+## 目标
+
+- **内存层**：附加游戏进程，通过特征码（AOB）扫描自适应定位基址（阳光、刷新倒计时、游戏时钟等），兼容原版多版本与各类改版。
+- **轨道 DSL**：解析社区轨道语言（如 `P|I-P|P|I-P 601|1150|601|1150`、`IP-P|IP-P 1738|1738`），支持上下半场、过渡符、波长与起手/收尾特判。
+- **执行器**：以游戏内部时钟（cs）为基准调度操作，而非墙钟延时。
+- **阵容生成**：按场地、卡槽与节奏（ch4/ch5/ch6/P4…）生成并运行无尽阵容。
+- **修改器**：可选、默认关闭的内存修改功能。
+
+## 与现有工具的关系
+
+本项目受 AsmVsZombies (AvZ)、lmintlcx/pvz、pvztoolkit 等启发，目标是提供一个 `pip install` 即用的 Python 框架。本包**不包含任何游戏文件**。
+
+## 安装
+
+```bash
+pip install pvztools
+```
+
+仅支持 Windows。
+
+## 许可证
+
+MIT

pvztools-0.0.1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pvztools"
+version = "0.0.1"
+description = "Plants vs. Zombies (PvZ1 & mods) automation framework: memory access with signature-based address discovery, track (轨道) DSL, lineup runner."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Blue Rose" }]
+keywords = ["pvz", "plants-vs-zombies", "植物大战僵尸", "轨道", "键控", "memory", "automation"]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Games/Entertainment",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/BlueRoseMike/pvztools"
+Issues = "https://github.com/BlueRoseMike/pvztools/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pvztools"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/pvztools", "README.md", "LICENSE", "pyproject.toml"]

pvztools-0.0.1/src/pvztools/__init__.py

@@ -0,0 +1,17 @@
+"""pvztools — Plants vs. Zombies (PvZ1 & mods) automation framework.
+
+Status: 0.0.1 is a name-reservation placeholder. The public API is not
+defined yet. Planned layers:
+
+- ``pvztools.memory``  process attach, signature (AOB) scan, version-adaptive addresses
+- ``pvztools.game``    Board / Plant / Zombie / Seed / Wave / Clock object model
+- ``pvztools.track``   轨道 DSL parser (e.g. ``P|I-P|I-P 601|1500|1500``)
+- ``pvztools.runner``  track executor bound to the in-game clock
+- ``pvztools.lineup``  endless-mode lineup generation
+- ``pvztools.cheats``  opt-in modifier (sun, cooldown, ...)
+
+Windows only. Does not ship any game files.
+"""
+
+__version__ = "0.0.1"
+__all__ = ["__version__"]