# DOTA2DevEnvironment_Tools

**Repository Path**: amhcwus/dota2-dev-environment_-tools

## Basic Information

- **Project Name**: DOTA2DevEnvironment_Tools
- **Description**: 月之底的Dota 2 Mod 部署与开发环境工具
一个用于 Dota 2 RPG 地图 (Custom Game) 开发的辅助工具。提供图形化界面，帮助开发者自动管理 Mod 目录链接、修复路径问题，并一键配置VScode、git、Node.js/pnpm 开发环境。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dota 2 Mod 部署与开发环境工具

一个用于 Dota 2 RPG 地图 (Custom Game) 开发的辅助工具。提供图形化界面，帮助开发者自动管理 Mod 目录链接、修复路径问题，并一键配置 Node.js/pnpm 开发环境。

## 主要功能

### 1. Mod 部署与管理
*   **一键 mklink 同步 Git 仓库与 Mod 项目**：将 Git 仓库中的 `game` 和 `content` 通过目录联接 (Junction) 链接到 Dota 2 游戏目录，无需复制或移动文件。
    *   *新方案*：实体文件保留在 Git 仓库，Dota 2 目录下为指向 Git 的链接；首次部署或修复时仅创建/修正 Dota 端的链接指向。
    *   *兼容旧方案*：若检测到已是旧方案（Git 为链接、Dota 为实体），不修改、保持不变。
*   **智能修复**：自动检测并修正 Dota 端的链接指向；当 Dota 端为实体而 Git 端也为实体时，可选择先备份 Dota 再替换为链接，或直接替换为链接。

### 2. 开发环境全自动配置
*   **Git & Git LFS 自动安装**：
    *   自动检测 Git 环境。若缺失，自动从**国内镜像 (华为云)** 下载并静默安装。
    *   自动检测并初始化 Git LFS（大文件存储），支持国内加速下载。
*   **SSH 密钥配置向导**：
    *   **一键生成**：根据 Git 邮箱自动生成 SSH 密钥（无密码）。
    *   **一键复制**：提供公钥展示与复制功能，方便配置到 GitHub/GitLab。
    *   **SourceTree 兼容**：提供专属指引，帮助 SourceTree 用户切换到 OpenSSH 模式，无需转换格式。
*   **VS Code 一键安装**：
    *   **智能下载**：自动解析 VS Code 最新版，并**自动替换为 Azure 中国 CDN**，确保极速下载。
    *   **智能安装**：检测是否已安装，支持覆盖安装或仅检查插件。
    *   **插件预装**：自动安装开发必备插件：
        *   `MS-CEINTL.vscode-language-pack-zh-hans` (中文语言包)
        *   `bigciba.dota2-tools` (Dota 2 开发工具)
*   **Node.js & pnpm**：
    *   自动从 npmmirror 下载 LTS 版 Node.js。
    *   自动安装 pnpm 并配置国内源。
    *   自动运行 `pnpm install` 安装项目依赖。

### 3. 其他特性
*   **自动路径检测**：智能识别 Steam 和 Dota 2 安装路径（支持多库目录）。
*   **全中文界面**：友好的 GUI 操作界面。
*   **安全保护**：防止文件被占用时程序崩溃，提供明确的中文提示。

## 使用方法

### 直接运行
1.  下载最新的 dist/`Dota2ModManager.exe`。
2.  以**管理员身份**运行（程序会自动请求提权）。
3.  **Dota 2 路径**：程序会自动检测，如果不对请手动选择 `.../dota 2 beta` 文件夹。
4.  **Git 项目路径**：选择你的 Mod 源码根目录（包含 `game` 和 `content` 的那个目录）。
5.  点击相应按钮执行操作。

### 源码运行/编译
如果你想自己修改代码：

1.  安装 Python 3.9+。
2.  安装依赖：
    ```bash
    pip install pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple
    ```
3.  运行脚本：
    ```bash
    python dota2_mod_manager.py
    ```
4.  打包为 EXE：
    双击运行 `build_exe.bat` 即可在 `dist` 目录下生成可执行文件。

## 注意事项
*   **文件占用**：在执行部署或修复时，请尽量关闭 Dota 2 游戏和 VS Code，以免文件被占用导致操作失败。
*   **环境生效**：首次安装 Node.js 后，可能需要重启工具或电脑，环境变量才会生效。