mcpywrap

# 🧰 mcpywrap **ModSDK and Resource Pack Full-Lifecycle Management Tool for Minecraft China Edition** [](https://pypi.org/project/mcpywrap/) [](LICENSE) mcpywrap is a Python-based full-lifecycle management tool for ModSDK/resource packs in Minecraft China Edition. It supports dependency management, syntax conversion, and automated building, helping developers achieve efficient collaboration and code reuse. ## 🌟 Core Features - 🧩 **Modular Development** - Addons-based dependency management (package management and dependency-based development and testing process) - 🔄 **Modern Syntax** - Supports Python3 modern syntax features, enhancing the development experience - 📦 **Ecosystem Compatibility** - Seamlessly integrates with the PyPI ecosystem, supporting standard `pyproject.toml` configuration - 🚀 **Intelligent Building** - One-click packaging of finished Addons that comply with MCStudio specifications - 🔥 **Hot Reload Development** - Real-time monitoring of code changes, supports MCStudio hot updates ## 📖 Why Choose This Tool? ### Traditional Development Pain Points - 📜 **Difficult Code Reuse** - **File copying** leads to chaotic version management - 🚧 **Low Collaboration Efficiency** - High maintenance costs for **duplicate code** across multiple projects - ⚠️ **Code Quality** - Lack of modern development tools and syntax support ### mcpywrap Solution 1. **Standardized Development** Declare project metadata and dependencies through `pyproject.toml` to achieve true modular development 2. **Directly Start Testing and Editing** - Start the game instance directly via `mcpy run`, supporting hot reloading and real-time building to improve development efficiency - Edit using the MC Studio Editor via the `mcpy edit` command 3. **Ecosystem Integration** Relying on the pip package management system, it supports dependency version locking and automatic resolution ## 🚀 Quick Start ### Prerequisites - Python ≥ 3.8 - pip ≥ 21.0 ### Installation ```bash pip install mcpywrap ``` ### Initialize Project ```bash # First, enter the project directory mcpy init ``` Interactively create the project structure and automatically generate a standard Mod framework. ### Run Test ```bash mcpy run ``` ## 🛠 Workflow Guide ### Dependency Management | Command | Description | |-------------------------------|---------------------| | `mcpy` | Maintain the project, installing it into the system's site-package environment | | `mcpy add <package> [version]` | Add a dependency with a specified version | | `mcpy remove <package>` | Remove a dependency | ### Complete Command Reference ```bash mcpy --help ``` #### Dependency Management | Command | Description | |-------------------------------|---------------------| | `mcpy add <package> [version]` | Add a dependency with a specified version and install it into the project | | `mcpy remove <package>` | Remove a dependency from the project configuration and optionally uninstall it | #### Project Initialization and Development | Command | Description | |-------------------------------|---------------------| | `mcpy init` | Interactively initialize the project, creating basic package information and configuration | | `mcpy mod` | Wizard-style creation of a basic Python Mod framework | | `mcpy build` | Build as an MCStudio project | | `mcpy dev` | Use watch mode for real-time building and hot reloading | | `mcpy edit` | Edit using the MC Studio Editor | #### ModSDK and Game Instance | Command | Description | |-------------------------------|---------------------| | `mcpy modsdk` | Manage Netease Minecraft ModSDK | | `mcpy run` | Game instance running and management | #### Publish Project | Command | Description | |-------------------------------|---------------------| | `mcpy publish` | Publish the project to PyPI | #### Game Instance Management Details ```bash # Start the latest game instance mcpy run # Create a new game instance mcpy run -n # List all available game instances mcpy run -l # Delete the specified game instance mcpy run -d <Instance ID Prefix> ``` ## 🤝 Contributing Welcome to submit Issues and PRs! Please read the [Contribution Guide](CONTRIBUTING.md) first. ## Open Source License [MIT License](LICENSE) © 2025 EaseCation