当前位置：首页 > news >正文

Godot(4.x): 游戏管理器: Excel 动态依赖注入实现

news 2026/6/4 17:49:47

前言: 本文是Godot(4.x)版本实现的，基于Python与Godot实现的GodotAutoLoad模块动态注入实现解释，将会解释Godot 动态依赖表(使用Excel)注入游戏中管理器(网络AutoLoad, 登录AutoLoad等) 的具体实现与演示，同时开源供任意使用。

这里先给出实现本依赖注入框架的程序环境

Godot版本: Godot_v4.6.2-stable

Python版本: Python 3.13.13，

Python额外依赖库: Openpyxl

其它实现中注入的演示模块将会在文章具体阐述的时候提供

1. Godot 动态驱动表注入概述

1. 综合讨论与概述

以往我实现的架构多是手动添加AutoLoad管理器，管理器模块与游戏本身有一定的耦合度。即使可以通过手动复制到其他游戏项目中并微调实现跨项目使用，但是还是不太方便。这里我使用Excel依赖注入来尝试解除游戏管理器本身与游戏本体剩余的耦合性，实现模块的任意替换。

在本框架中，依赖注入是启动游戏时读取表格中存入的模块地址，解析每个模块额外的启动参数然后加载到Godot中对应的，已经创建的AutoLoad接口中实现模块的注入。这样子我们就可以通过Excel表格控制游戏中具体的模块是谁，是否启用或者是否带入其他依赖等，这样就方便了我们调试与后期模块的替换。

2. 具体实现流程概述

1. Godot启动游戏，切换场景至黑屏，启动注入，将启动参数发送给Python并等待。

2. Python执行Excel对应地址等参数转换，打包成Json固定格式放入Godot指定文件夹。

3. Godot接收到Python处理完成信号，将Json文件格式化成多种字典形式

4. Godot使用格式化完成后得到的字典，检查对应模块和参数，并开始注入至对应AutoLoad的静态数据中完成注入

5. Godot注入模块将游戏切换至主场景，开始游戏。

以上为实现流程的实现总览，演示中所有代码都将会完整解释，包括用于热重载，优化等但未使用的代码的预留代码。由于代码和演示解释较长，将会拆分文章解释，本篇文章将会重在演示功能，实现代码将会留于子文章

3. 项目结构图以及流程图概览

1. 项目流程图

Godot启动 → 进入黑屏场景 → 调用Python并等待执行
↓
Python读取Excel配置表 → 数据转换 → 生成标准JSON文件
↓
Godot检测文件生成完成 → 读取JSON并解析为字典
↓
校验模块路径与启动参数 → 注入至AutoLoad接口静态数据
↓
注入完成 → 切换至游戏主场景 → 正式运行游戏

2. 项目结构图

Python 部分: 结构图

Python文件结构:
PYTHON_CONFIGURATION_TABLE_CODE/
├── Injection_Table/
└── InjectionTable.xlsx # 注入配置表（Excel）
├── spreadsheet_processing/
├── __pycache__/ # Python 编译缓存目录
├── debug_tool
├── __pycache__/ # Python 编译缓存目录
└── debug_util.py # 调试日志工具（控制 print 输出）
├── excel_format_convert.py # Excel 数据格式转换模块
├── excel_processing.py # Excel 读取与解析模块
└── json_processing.py # JSON 生成与处理模块
├── FileProcessingMain.py # 主入口脚本(供Godot调用)
└── InjectionConvert.json # 输出的 JSON 注入文件

Python文件结构图:

Godot 部分: 结构图

1. 文件结构(主要结构):

res://
├── 00_Engine/ # 引擎核心层（注入框架与业务模块）
├── InjectionTable_Engine/ # 注入核心注入模块存放处
├── Injection_interface/ # 注入核心接口（AutoLoad入口）
├── Injection_Login_System/ # 登录系统注入模块
└── Injection_Server_System/ # 服务器/联机系统注入模块
├── 02_Game/ # 游戏业务层（场景与组件）
├── Component/ # 游戏组件
├── Level/ # 关卡/场景文件
└── System/ # 游戏系统模块
├── 05_Util/ # 通用工具库
├── Debug_Tool/ # 调试工具
└── InstantiationTool/ # 安全实例化工具
├── Python_configuration_table_code/ # Python配置解析工具目录
├── Injection_Table/ # Excel配置表存放目录
├── spreadsheet_processing/ # 表格处理核心模块
└── InjectionConvert.json # 输出的JSON配置文件
├── icon.svg
└── README.md