# CustomPeds

**Repository Path**: marissa-ymy/custom-peds

## Basic Information

- **Project Name**: CustomPeds
- **Description**: GTA V CustomPeds模组源码！！！
- **Primary Language**: C#
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-01
- **Last Updated**: 2026-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CustomPeds - 侠盗猎车手V角色定制与行为增强模组

[![.NET Framework](https://img.shields.io/badge/.NET%20Framework-4.8-blue.svg)](https://dotnet.microsoft.com/download/dotnet-framework)
[![Platform](https://img.shields.io/badge/Platform-Windows%20x64-green.svg)](https://www.microsoft.com/windows)
[![GTA V](https://img.shields.io/badge/GTA%20V-ScriptHookV%20Compatible-orange.svg)](https://github.com/crosire/scripthookvdotnet)

## 📋 项目概述

**CustomPeds** 是一个基于 **ScriptHookVDotNet2** 框架开发的侠盗猎车手V（Grand Theft Auto V）高级角色定制与行为增强模组。该项目通过反编译重构技术，实现了对原版游戏角色的深度定制化功能，为玩家提供了前所未有的角色个性化体验。

## 🚀 核心特性

### 🎭 高级角色定制系统
- **多维度外观定制**：支持面部特征、发型、服装、配饰等全方位角色外观调整
- **实时预览系统**：提供即时视觉反馈的角色定制界面
- **预设管理**：支持角色外观配置的保存、加载与分享
- **高级纹理控制**：精确控制角色皮肤、服装纹理与材质效果

### 🤖 智能行为引擎
- **自适应AI行为**：基于环境感知的智能角色行为决策系统
- **多状态管理**：支持步行、驾驶、战斗等多种行为状态切换
- **动态跟随系统**：智能化的角色跟随与路径规划算法
- **行为模式配置**：可自定义的角色行为参数与响应机制

### 🎮 交互式游戏体验
- **多角色管理**：支持同时控制多个自定义角色
- **车辆交互增强**：智能化的车辆驾驶与乘客系统
- **战斗行为优化**：增强的角色战斗能力与战术决策
- **环境适应能力**：角色对环境变化的智能响应

### 🛠️ 技术架构优势
- **模块化设计**：高度解耦的代码架构，便于功能扩展与维护
- **性能优化**：智能缓存机制与异步处理，确保游戏流畅性
- **内存管理**：高效的内存分配与垃圾回收策略
- **错误处理**：完善的异常捕获与日志记录系统

## 🏗️ 技术架构

### 核心技术栈
- **.NET Framework 4.8**：提供稳定的运行时环境
- **ScriptHookVDotNet2**：GTA V脚本开发框架
- **NativeUI**：原生游戏界面集成
- **C# 12.0**：现代编程语言特性支持

### 架构设计模式
```
┌─────────────────────────────────────────────────────────────┐
│                    Presentation Layer                        │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐   │
│  │  MainMenu   │ │ BadgeMenu   │ │   ComponentMenu     │   │
│  └─────────────┘ └─────────────┘ └─────────────────────┘   │
├─────────────────────────────────────────────────────────────┤
│                     Business Logic Layer                     │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐   │
│  │   Origin    │ │  Behavior   │ │    AnimationHelper  │   │
│  └─────────────┘ └─────────────┘ └─────────────────────┘   │
├─────────────────────────────────────────────────────────────┤
│                      Data Access Layer                       │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐   │
│  │     Skin    │ │   Decoration│ │    ScriptSettings   │   │
│  └─────────────┘ └─────────────┘ └─────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
```

### 核心模块说明

#### 🎯 主控制模块 (Main.cs)
- 游戏状态管理
- 角色生命周期控制
- 事件分发与处理
- 性能监控与优化

#### 🎨 外观系统 (Skin.cs)
- 角色外观数据结构
- 纹理与材质管理
- 外观预设系统
- 实时渲染优化

#### 🧠 行为引擎 (Behavior.cs)
- AI决策算法
- 状态机管理
- 环境感知系统
- 行为模式配置

#### 🎭 角色管理 (Origin.cs)
- 角色属性管理
- 技能系统
- 装备管理
- 状态同步

## 📦 安装与配置

### 系统要求
- **操作系统**：Windows 10/11 (64位)
- **游戏版本**：Grand Theft Auto V (最新版本)
- **运行环境**：.NET Framework 4.8
- **内存要求**：建议8GB以上

### 安装步骤

1. **下载依赖文件**
   ```bash
   # 确保已安装ScriptHookV
   # 下载ScriptHookVDotNet2
   # 获取NativeUI.dll
   ```

2. **部署模组文件**
   ```
   GTA V根目录/
   ├── scripts/
   │   ├── CustomPeds.dll
   │   ├── CustomPeds.ini
   │   └── NativeUI.dll
   ├── ScriptHookV.dll
   └── ScriptHookVDotNet2.dll
   ```

3. **配置文件设置**
   ```ini
   [Keys]
   start_Key=O
   
   [Settings]
   enable_logging=true
   debug_mode=false
   ```

### 配置选项

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `start_Key` | 主菜单快捷键 | O |
| `enable_logging` | 启用日志记录 | true |
| `debug_mode` | 调试模式 | false |
| `performance_mode` | 性能优化模式 | balanced |

## 🎮 使用方法

### 基本操作
1. **启动游戏**：运行GTA V并加载存档
2. **激活模组**：按 `O` 键打开主菜单
3. **角色定制**：使用菜单系统调整角色外观
4. **行为设置**：配置角色AI行为参数
5. **保存配置**：将设置保存为预设文件

### 高级功能
- **多角色切换**：支持P1、P2、P3、Clone四个角色槽位
- **车辆交互**：智能化的驾驶与乘客系统
- **战斗增强**：优化的战斗AI与战术决策
- **环境适应**：角色对环境变化的智能响应

## 🔧 开发与扩展

### 开发环境搭建
```bash
# 克隆项目
git clone [repository-url]
cd custom-peds

# 安装依赖
dotnet restore

# 构建项目
dotnet build

# 运行测试
dotnet test
```

### 代码结构
```
CustomPeds/
├── Core/                 # 核心功能模块
│   ├── Main.cs          # 主控制逻辑
│   ├── Origin.cs        # 角色管理
│   └── Behavior.cs      # 行为引擎
├── UI/                   # 用户界面
│   ├── MainMenu.cs      # 主菜单
│   └── SubMenus/        # 子菜单系统
├── Systems/              # 功能系统
│   ├── Skin.cs          # 外观系统
│   ├── Animation.cs     # 动画系统
│   └── Sound.cs         # 音效系统
└── Utils/                # 工具类
    ├── LogHelper.cs      # 日志工具
    └── ConfigHelper.cs   # 配置工具
```

### 扩展开发指南
1. **新增功能模块**：继承Script基类，实现自定义逻辑
2. **界面扩展**：使用NativeUI框架创建新的菜单界面
3. **行为定制**：在Behavior类中添加新的AI行为模式
4. **数据持久化**：利用XML序列化保存自定义配置

## 📊 性能优化

### 优化策略
- **智能缓存**：减少重复计算与资源加载
- **异步处理**：非阻塞式操作提升响应性
- **内存池**：优化对象创建与销毁
- **LOD系统**：根据距离动态调整渲染质量

### 性能监控
- 帧率监控与优化
- 内存使用分析
- CPU占用率控制
- 加载时间优化

## 🐛 故障排除

### 常见问题

| 问题 | 解决方案 |
|------|----------|
| 模组无法加载 | 检查ScriptHookV安装与版本兼容性 |
| 游戏崩溃 | 验证.NET Framework版本与依赖完整性 |
| 性能下降 | 调整性能模式设置，关闭调试功能 |
| 功能异常 | 查看日志文件，检查配置文件设置 |

### 日志分析
```csharp
// 启用详细日志
LogHelper.EnableVerboseLogging();

// 查看错误日志
var errors = LogHelper.GetErrorLogs();
```

### 调试模式
```ini
[Debug]
enable_debug=true
log_level=verbose
performance_monitoring=true
```

## 🤝 贡献指南

### 贡献方式
1. **问题报告**：提交详细的Bug报告与功能请求
2. **代码贡献**：遵循项目编码规范，提交Pull Request
3. **文档完善**：改进README、API文档与使用说明
4. **测试支持**：参与功能测试与性能优化

### 开发规范
- 遵循C#编码约定
- 添加适当的注释与文档
- 确保代码通过静态分析
- 编写单元测试覆盖新功能

## 📄 许可证

本项目采用 **MIT许可证**，详情请参阅 [LICENSE](LICENSE) 文件。

## 🙏 致谢

- **ScriptHookV团队**：提供优秀的GTA V脚本开发框架
- **NativeUI开发者**：贡献高质量的用户界面组件
- **开源社区**：持续的技术支持与改进建议

## 📞 联系方式

- **项目维护**：本项目为反编译重构项目，原作者已失联
- **技术支持**：通过GitHub Issues获取帮助
- **社区讨论**：欢迎加入相关论坛与Discord服务器

---

**⚠️ 免责声明**：本模组仅供学习和研究使用，使用者需遵守相关法律法规和游戏服务条款。开发者不对因使用本模组导致的任何问题承担责任。

**🔄 版本更新**：项目将持续优化与功能增强，建议定期关注最新版本发布。