# UE5.8 AngelScript Plugin

**Repository Path**: haze347/ue5.8-angel-script-plugin

## Basic Information

- **Project Name**: UE5.8 AngelScript Plugin
- **Description**: No description available
- **Primary Language**: C++
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Angelscript

让 Unreal Engine 5.8 支持使用 AngelScript 编写游戏逻辑，并支持热重载。

---

## 功能特性

- **脚本化游戏逻辑**：在 UE5 中使用 AngelScript 编写 Actor、Component、GameMode 等游戏逻辑。
- **热重载支持**：修改脚本后无需重启编辑器即可快速重载，提升迭代效率。
- **UE 反射绑定**：自动对接 UE 的反射系统，可访问蓝图 API、UCLASS、UFUNCTION、UPROPERTY 等。
- **项目级插件**：以项目插件形式集成，不修改引擎源码，方便多项目复用。

---

## 支持版本

- Unreal Engine：5.8
- 平台：Windows（Win64）

---

## 目录结构

```
.
├── Plugins/Angelscript/    # AngelScript 插件核心代码
├── ThirdPerson/            # 集成 AngelScript 插件的示例工程
└── Docs/                   # AngelScript 相关文档与扩展模块
```

---

## 安装教程

1. 获取本仓库源码：

   ```bash
   git clone <仓库地址>
   ```

2. 将 `Plugins/Angelscript/` 目录复制到你的 UE5.8 项目根目录下：

   ```
   你的项目/
   ├── Plugins/
   │   └── Angelscript/
   ├── Source/
   └── 你的项目.uproject
   ```

3. 右键点击 `.uproject` 文件，选择 **Generate Visual Studio project files**。

4. 打开生成的 `.sln`，编译 **Development Editor** 配置。

5. 启动编辑器，在 **编辑 -> 插件** 中确认 `Angelscript` 已启用。

---

## 使用说明

1. 打开集成插件的示例工程 `ThirdPerson/ThirdPerson.uproject`，查看 AngelScript 脚本的使用方式。
2. 在你的项目中新建 `.as` 脚本文件，并放置到项目的内容目录中。
3. 编写 AngelScript 类并继承自 UE 的 `AActor`、`UActorComponent` 等类型。
4. 保存脚本后，插件会自动检测变更并进行热重载。

更详细的 API 说明请参考项目内文档或 AngelScript 官方文档：
[https://www.angelcode.com/angelscript/](https://www.angelcode.com/angelscript/)

---

## 参与贡献

1. Fork 本仓库
2. 新建 `Feat_xxx` 分支
3. 提交代码
4. 新建 Pull Request

---

## 开源协议

本项目遵循 [LICENSE](LICENSE) 文件中的协议。