CYS TableTool 是一款为 UE5 设计的专业级 CSV 表格处理插件,提供完整的表格数据增删改查功能。该插件专注于游戏配置表管理,支持从 CSV 文件读取游戏配置数据、在运行时动态修改表格内容,并将修改后的数据重新保存为 CSV 格式。
插件完全支持中文编码(UTF-8),所有核心功能均可通过蓝图和 C++ 调用,适用于策划配置表管理、数据导入导出、游戏存档系统等多种应用场景。
核心功能模块:
- CSV 文件读写引擎
✅ 智能编码识别:自动检测并正确处理 UTF-8(带/不带 BOM)编码文件
✅ 同步/异步加载:支持大文件异步加载,避免主线程阻塞
✅ 标准 CSV 解析:完整支持 CSV 规范(引号转义、多行字段、特殊字符)
✅ 灵活导出选项:自定义分隔符、编码格式、是否包含表头
✅ 文件验证机制:加载前验证文件存在性、大小、格式合法性

- 表格数据操作库
| API | 功能描述 |
|---|---|
GetTableRowCount |
获取表格总行数 |
GetTableColumnCount |
获取表格总列数 |
GetCellValue |
读取指定单元格的值 |
GetRowDataByIndex |
获取完整行数据 |
FindRowByFieldValue |
精确查找:根据字段值查找行索引 |
FindAllRowsByFieldValue |
批量查找:返回所有匹配行 |
FindRowsByFieldContains |
模糊查找:支持大小写敏感的文本包含搜索 |
FindRowDataByFieldValue |
直接返回匹配行的完整数据 |
| ➕ 新增功能(Add) | |
| AddTableRow:向表格末尾添加新数据行,返回新增后的总行数 | |
| ✏️ 修改功能(Update) | |
| SetCellValue:根据行索引和列名修改单元格值 | |
| ❌ 删除功能(Delete) | |
| RemoveTableRow:删除指定索引的数据行 | |
| ClearTable:清空所有数据行(保留表头结构) | |
![]() |
|
![]() |
- 结构体验证器
功能:确保 CSV 表格与 UE5 结构体的字段完美匹配
核心能力:
✅ 字段匹配验证:检查 CSV 表头与结构体字段的对应关系
✅ 自动 GUID 处理:智能识别并去除 UE 自动生成的字段 GUID 后缀
✅ 类型转换识别:自动识别结构体属性类型(布尔/整数/浮点/字符串/向量等)
✅ 详细验证报告:返回匹配成功/失败字段的详细信息
支持的 UE 数据类型:
基础类型:bool, int32, int64, float, double
UE 类型:FString, FName, FText
复合类型:FVector, FRotator, FColor, FLinearColor


