Horzon-godot:基于 Godot 4.3+ 与 GDExtension C++ 的 3D 开放世界写实竞速游戏

可用于开发开放世界竞速游戏,对标《极限竞速:地平线》。具备车辆物理(悬挂、轮胎摩擦、漂移)、竞速/交通/行人AI、动态天气、大世界流式加载等核心功能,集成多场景模型与UI素材。【此简介由AI生成】

Branch1Tags0

HorizonGodot - 开放世界竞速游戏

English | 中文

🎮 项目简介

HorizonGodot 是一款基于 Godot 4.3+ 和 GDExtension C++ 开发的对标《极限竞速:地平线》的 3D 开放世界写实竞速游戏。

✅ 已完成功能

C++ 核心模块 (GDExtension)

模块 文件 功能
车辆物理 src/vehicle/car_physics.cpp 四轮独立悬挂、发动机、传动、转向、制动、空气动力学
悬挂系统 src/vehicle/suspension.cpp 弹簧力、阻尼力、缓冲块、几何倾角
轮胎摩擦 src/vehicle/tire_friction.cpp Pacejka魔术公式、温度/磨损影响
漂移系统 src/vehicle/drift_system.cpp 手刹/惯性/动力漂移、评分、连招
竞速AI src/ai/ai_racers.cpp 四难度、走线、超车、防守
交通AI src/ai/traffic_ai.cpp 车道保持、障碍检测
行人AI src/ai/pedestrian_ai.cpp 随机漫步、玩家感知
随机事件 src/ai/random_event_ai.cpp 故障车、路障等
相机系统 src/camera/cinematic_camera.cpp 多模式、动态FOV、震动、运镜
音频系统 src/audio/dynamic_audio.cpp 引擎声、胎噪、风声
赛事裁判 src/race_rule/race_judge.cpp 计时、排名、违规检测
计时系统 src/race_rule/timer_system.cpp 圈速、分段计时、倒计时
大世界 src/world/streaming_loader.cpp 流式加载、卸载
LOD系统 src/world/lod_system.cpp 细节层次管理
天气系统 src/world/weather_cycle.cpp 昼夜循环、天气变化
地形物理 src/world/terrain_physics.cpp 地形碰撞、高度图采样
植被系统 src/world/vegetation_system.cpp 植被分布和渲染

GDScript 脚本

脚本 功能
scripts/main.gd 游戏主管理器
scripts/car_controller.gd 玩家车辆控制器
scripts/camera/camera_follow.gd 相机跟随
scripts/camera/camera_switch.gd 相机切换
scripts/ui/hud.gd HUD显示
scripts/ui/hud_speed.gd 速度显示
scripts/ui/hud_rank.gd 排名显示
scripts/ui/menu_ui.gd 菜单界面
scripts/vehicle/vehicle_loader.gd 车辆加载
scripts/vehicle/vehicle_spawner.gd 车辆生成
scripts/world/day_night_switch.gd 昼夜切换
scripts/world/environment_loader.gd 环境加载管理器
scripts/world/pbr_texture_manager.gd PBR纹理管理器
scripts/ui/ui_manager.gd UI素材管理器
scripts/audio/audio_manager.gd 音频管理器

📦 已集成的素材

3D模型 (29个GLTF文件)

赛道环境

  • 山地公路 (5个): 直道、弯道、隧道、桥梁、观景台
  • 海滨公路 (3个): 直道、木板码头、灯塔
  • 沙漠峡谷 (3个): 直道、天然拱门、鬼镇
  • 森林拉力 (3个): 泥土路、瀑布、原木小屋
  • 城市都市 (3个): 直道、摩天大楼、体育场

赛道道具

  • 道路设施 (3个): 金属护栏、路灯、交通灯
  • 赛车元素 (5个): 检查点拱门、起点/终点线、轮胎墙、广告牌、看台
  • 自然元素 (4个): 松树、棕榈树、岩石、仙人掌

材质文件 (10个.tres文件)

  • 5种沥青路面材质(山地、海滨、沙漠、城市、森林)
  • 泥土、混凝土、玻璃、金属等多种材质

UI素材 (13个HTML文件)

  • HUD组件: 速度表、转速表、小地图、比赛信息
  • 主菜单: 动态背景、霓虹装饰
  • 图标集: 车辆、导航、操作、状态、设置图标
  • 其他: 加载屏幕、通知弹窗

🚀 快速开始

1. 编译 GDExtension

cd HorizonGodot
.\build_release.bat

2. 在 Godot 中打开项目

  1. 下载 Godot 4.3+
  2. 打开 Godot 编辑器
  3. 导入项目:import → 选择 project.godot
  4. 运行场景:scenes/main_world.tscn

3. 测试控制

按键 功能
W / ↑ 加速
S / ↓ 刹车
A 左转
D 右转
空格 手刹
C 切换相机视角
1-5 切换生物群落
ESC 暂停菜单

📁 项目结构

HorizonGodot/
├── src/                    # C++ 源代码
│   ├── ai/                # AI系统
│   ├── audio/             # 音频系统
│   ├── camera/            # 相机系统
│   ├── core/              # 核心工具类
│   ├── race_rule/          # 赛事系统
│   ├── vehicle/            # 车辆物理
│   └── world/              # 世界系统
├── scripts/                # GDScript 脚本
│   ├── audio/             # 音频管理
│   ├── camera/            # 相机脚本
│   ├── ui/                # UI脚本
│   ├── vehicle/            # 车辆脚本
│   └── world/              # 世界脚本
├── scenes/                # 场景文件
│   ├── main_world.tscn    # 主场景
│   └── demo_track_layout.tscn  # 演示赛道
├── assets/                 # 资源文件
│   ├── models/            # 3D模型
│   ├── materials/          # 材质
│   ├── textures/          # 纹理
│   └── audio/             # 音频
├── docs/                  # 文档
└── bin/                   # 编译输出
    └── horizongodot.dll   # GDExtension DLL

🎯 待完成

高优先级

中优先级

低优先级

📚 文档

🛠️ 技术栈

  • 引擎: Godot 4.3+
  • 扩展: GDExtension (C++)
  • 物理: Godot Physics (Jolt)
  • 渲染: Forward Plus
  • 语言: C++ (核心), GDScript (表现层)

📄 许可证

MIT License

👥 贡献者

HorizonGodot Team

🔗 相关链接


游戏开发愉快! 🎮🏁

Introduction

可用于开发开放世界竞速游戏,对标《极限竞速:地平线》。具备车辆物理(悬挂、轮胎摩擦、漂移)、竞速/交通/行人AI、动态天气、大世界流式加载等核心功能,集成多场景模型与UI素材。【此简介由AI生成】

Customize your domain