Godot 虚拟摇杆项目教程

Godot 虚拟摇杆项目教程

Virtual-Joystick-Godot A simple virtual joystick for touchscreens, for both 2D and 3D games, with useful options. 项目地址: https://gitcode.com/gh_mirrors/vi/Virtual-Joystick-Godot

1. 项目目录结构及介绍

Virtual-Joystick-Godot/
├── addons/
│   └── virtual_joystick/
│       ├── VirtualJoystick.gd
│       ├── VirtualJoystick.tscn
│       └── ...
├── LICENSE
├── README.md
├── icon.svg
├── icon.svg.import
├── project.godot
└── Test/
    └── ...

目录结构说明

• addons/: 包含虚拟摇杆的核心代码和场景文件。
  • virtual_joystick/: 虚拟摇杆的主要实现文件。
    • VirtualJoystick.gd: 虚拟摇杆的脚本文件，负责处理输入和输出。
    • VirtualJoystick.tscn: 虚拟摇杆的场景文件，定义了摇杆的外观和行为。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。
• icon.svg: 项目的图标文件。
• icon.svg.import: 图标文件的导入配置。
• project.godot: Godot 项目的配置文件。
• Test/: 包含测试场景和相关文件，用于演示虚拟摇杆的使用。

2. 项目启动文件介绍

项目的启动文件是 project.godot，这是一个 Godot 项目的配置文件，包含了项目的全局设置和启动信息。

project.godot 文件内容

[application]
config/name="Virtual Joystick"
config/icon="res://icon.png"

[display]
window/size/width=1280
window/size/height=720

[input]
# 输入配置

启动文件说明

• [application]: 定义了项目的名称和图标。
• [display]: 定义了窗口的初始大小。
• [input]: 定义了项目的输入配置，包括虚拟摇杆的输入映射。

3. 项目的配置文件介绍

项目的配置文件主要集中在 addons/virtual_joystick/VirtualJoystick.gd 和 project.godot 中。

VirtualJoystick.gd 文件内容

extends Node2D

@export var speed : float = 100
@export var joystick_left : VirtualJoystick
@export var joystick_right : VirtualJoystick

var move_vector := Vector2.ZERO

func _process(delta: float) -> void:
    # 使用输入函数进行移动
    move_vector = Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down")
    position += move_vector * speed * delta

    # 旋转
    if joystick_right and joystick_right.is_pressed:
        rotation = joystick_right.output.angle()

配置文件说明

• speed: 定义了移动速度。
• joystick_left: 左虚拟摇杆的引用。
• joystick_right: 右虚拟摇杆的引用。
• move_vector: 移动向量，通过 Input.get_vector 获取。
• _process(delta): 每帧更新函数，处理移动和旋转逻辑。

通过以上配置，可以轻松地在 Godot 项目中集成和使用虚拟摇杆。

Virtual-Joystick-Godot A simple virtual joystick for touchscreens, for both 2D and 3D games, with useful options. 项目地址: https://gitcode.com/gh_mirrors/vi/Virtual-Joystick-Godot