1
; 关键配置项
2
[application]
3
config/name="MyGame"
4
config/description="游戏描述"
5
run/main_scene="res://scenes/main_menu.tscn"
6
config/features=PackedStringArray("4.2", "Forward Plus")
7
config/icon="res://icon.svg"
8

9
[display]
10
window/size/viewport_width=1920
11
window/size/viewport_height=1080
12
window/stretch/mode="canvas_items"  ; 或 "viewport"
13
window/stretch/aspect="expand"
14

15
[rendering]
16
renderer/rendering_method="forward_plus"  ; 根据平台调整
17

18
[autoload]
19
GameManager="*res://autoload/game_manager.gd"
20
AudioManager="*res://autoload/audio_manager.gd"
21
SceneManager="*res://autoload/scene_manager.gd"

1
# 玩家控制器原型 - proto_player.gd
2
extends CharacterBody2D
3

4
@export var speed: float = 400.0
5
@export var jump_velocity: float = -600.0
6
@export var gravity: float = 980.0
7

8
func _physics_process(delta: float) -> void:
9
    # 重力
10
    if not is_on_floor():
11
        velocity.y += gravity * delta
12

13
    # 输入处理
14
    var direction := Input.get_axis("ui_left", "ui_right")
15
    velocity.x = direction * speed
16

17
    if Input.is_action_just_pressed("ui_accept") and is_on_floor():
18
        velocity.y = jump_velocity
19

20
    move_and_slide()

1
Main (Node)
2
├── GameManager (AutoLoad)
3
├── SceneManager (AutoLoad)
4
├── AudioManager (AutoLoad)
5
├── CurrentScene (Node)  ← 动态加载的场景根节点
6
│   ├── Level
7
│   │   ├── TileMap
8
│   │   ├── Entities
9
│   │   │   ├── Player
10
│   │   │   └── Enemies
11
│   │   └── Collectibles
12
│   ├── UI
13
│   │   ├── HUD
14
│   │   └── PauseMenu
15
│   └── Camera2D

1
# player.gd - 完整的玩家控制器示例
2
class_name Player
3
extends CharacterBody2D
4

5
# === 导出变量 ===
6
@export_group("Movement")
7
@export var max_speed: float = 300.0
8
@export var acceleration: float = 2000.0
9
@export var friction: float = 1500.0
10
@export var air_resistance: float = 500.0
11

12
@export_group("Jump")
13
@export var jump_force: float = -450.0
14
@export var coyote_time: float = 0.08
15
@export var jump_buffer: float = 0.1
16

17
# === 内部状态 ===
18
var _coyote_timer: float = 0.0
19
var _jump_buffer_timer: float = 0.0
20
var _is_jumping: bool = false
21

22
# === 节点引用 ===
23
@onready var _sprite: AnimatedSprite2D = $AnimatedSprite2D
24
@onready var _state_machine: StateMachine = $StateMachine
25

26
func _ready() -> void:
27
    add_to_group("player")
28

29
func _physics_process(delta: float) -> void:
30
    _handle_coyote_time(delta)
31
    _handle_jump_buffer(delta)
32
    _handle_movement(delta)
33
    _handle_jump()
34
    _update_animation()
35

36
    move_and_slide()
37

38
func _handle_movement(delta: float) -> void:
39
    var input_dir := Input.get_axis("move_left", "move_right")
40

41
    if input_dir != 0:
42
        var accel := acceleration if is_on_floor() else air_resistance
43
        velocity.x = move_toward(velocity.x, input_dir * max_speed, accel * delta)
44
        _sprite.flip_h = input_dir < 0
45
    else:
46
        var decel := friction if is_on_floor() else air_resistance
47
        velocity.x = move_toward(velocity.x, 0.0, decel * delta)
48

49
func _handle_jump() -> void:
50
    if _jump_buffer_timer > 0 and (_coyote_timer > 0 or is_on_floor()):
51
        velocity.y = jump_force
52
        _is_jumping = true
53
        _jump_buffer_timer = 0.0
54
        _coyote_timer = 0.0
55

56
    if Input.is_action_just_released("jump") and velocity.y < 0:
57
        velocity.y *= 0.5  # 短按小跳
58

59
func _handle_coyote_time(delta: float) -> void:
60
    if is_on_floor():
61
        _coyote_timer = coyote_time
62
        _is_jumping = false
63
    else:
64
        _coyote_timer -= delta
65

66
func _handle_jump_buffer(delta: float) -> void:
67
    if Input.is_action_just_pressed("jump"):
68
        _jump_buffer_timer = jump_buffer
69
    elif _jump_buffer_timer > 0:
70
        _jump_buffer_timer -= delta
71

72
func _update_animation() -> void:
73
    if not is_on_floor():
74
        _sprite.play("jump")
75
    elif abs(velocity.x) > 10:
76
        _sprite.play("run")
77
    else:
78
        _sprite.play("idle")
79

80
func take_damage(amount: int) -> void:
81
    GameManager.player_health -= amount
82
    if GameManager.player_health <= 0:
83
        _die()
84

85
func _die() -> void:
86
    GameManager.emit_signal("player_died")
87
    queue_free()

1
# game_manager.gd (AutoLoad)
2
extends Node
3

4
signal player_health_changed(new_health: int, max_health: int)
5
signal player_died
6
signal score_changed(new_score: int)
7
signal game_paused(is_paused: bool)
8

9
var player_health: int = 100:
10
    set(value):
11
        player_health = clamp(value, 0, max_health)
12
        player_health_changed.emit(player_health, max_health)
13
        if player_health <= 0:
14
            player_died.emit()
15

16
var max_health: int = 100
17
var score: int = 0:
18
    set(value):
19
        score = value
20
        score_changed.emit(score)
21

22
var is_paused: bool = false:
23
    set(value):
24
        is_paused = value
25
        get_tree().paused = is_paused
26
        game_paused.emit(is_paused)
27

28
func add_score(points: int) -> void:
29
    score += points
30

31
func pause_game() -> void:
32
    is_paused = true
33

34
func resume_game() -> void:
35
    is_paused = false

1
# scene_manager.gd (AutoLoad)
2
extends Node
3

4
const FADE_DURATION := 0.3
5

6
@onready var _transition_rect: ColorRect = $CanvasLayer/TransitionRect
7

8
func change_scene(path: String, transition: bool = true) -> void:
9
    if transition:
10
        await _fade_out()
11

12
    get_tree().change_scene_to_file(path)
13

14
    if transition:
15
        await get_tree().process_frame
16
        _fade_in()
17

18
func _fade_out() -> void:
19
    var tween := create_tween()
20
    tween.tween_property(_transition_rect, "modulate:a", 1.0, FADE_DURATION)
21
    await tween.finished
22

23
func _fade_in() -> void:
24
    var tween := create_tween()
25
    tween.tween_property(_transition_rect, "modulate:a", 0.0, FADE_DURATION)

1
# audio_manager.gd (AutoLoad)
2
extends Node
3

4
@onready var _music_player: AudioStreamPlayer = $MusicPlayer
5
@onready var _sfx_players: Node = $SFXPlayers
6

7
const MAX_SFX_PLAYERS := 8
8

9
func _ready() -> void:
10
    # 预创建 SFX 播放器池
11
    for i in MAX_SFX_PLAYERS:
12
        var player := AudioStreamPlayer.new()
13
        player.bus = "SFX"
14
        _sfx_players.add_child(player)
15

16
func play_music(stream: AudioStream, fade_duration: float = 1.0) -> void:
17
    if _music_player.playing:
18
        var tween := create_tween()
19
        tween.tween_property(_music_player, "volume_db", -80.0, fade_duration)
20
        await tween.finished
21

22
    _music_player.stream = stream
23
    _music_player.volume_db = -80.0
24
    _music_player.play()
25

26
    var tween := create_tween()
27
    tween.tween_property(_music_player, "volume_db", 0.0, fade_duration)
28

29
func play_sfx(stream: AudioStream, pitch_random: float = 0.0) -> void:
30
    var player := _get_available_sfx_player()
31
    if not player:
32
        return
33

34
    player.stream = stream
35
    if pitch_random > 0:
36
        player.pitch_scale = 1.0 + randf_range(-pitch_random, pitch_random)
37
    player.play()
38

39
func _get_available_sfx_player() -> AudioStreamPlayer:
40
    for player in _sfx_players.get_children():
41
        if not player.playing:
42
            return player
43
    return null

1
项目 → 导出 → 添加预设
2
├── Windows Desktop
3
│   ├── 架构: x86_64
4
│   ├── 可执行图标: res://assets/icon.ico
5
│   └── 自定义模板: (如需裁剪引擎)
6
├── macOS
7
│   ├── 应用标识符: com.yourcompany.game
8
│   └── 签名证书: (如需上架 App Store)
9
├── Android
10
│   ├── 包名: com.yourcompany.game
11
│   ├── 目标 SDK: 最新稳定版
12
│   ├── 密钥库: 创建/导入
13
│   └── 权限: 按需申请
14
└── Web
15
    ├── 导出类型: Regular
16
    └── 线程支持: (视浏览器兼容性)

1
# 类型标注（Godot 4.x 推荐）
2
var health: int = 100
3
var speed: float = 300.0
4
var target: Node2D
5

6
# 函数签名
7
func take_damage(amount: int, source: Node = null) -> void:
8
    pass
9

10
# 信号定义
11
signal health_changed(new_health: int, max_health: int)
12

13
# 枚举
14
enum State {
15
    IDLE,
16
    RUN,
17
    ATTACK,
18
    DEAD
19
}
20

21
# 数组/字典类型
22
var enemies: Array[Enemy] = []
23
var stats: Dictionary[String, int] = {}
24

25
# 常量分组
26
const MAX_SPEED: float = 500.0
27
const JUMP_FORCE: float = -450.0
28
const COYOTE_TIME: float = 0.08

1
extends Node
2

3
# 1. 类名与继承
4
class_name MyClass
5

6
# 2. 信号
7
signal my_signal
8

9
# 3. 枚举
10
enum MyEnum { A, B, C }
11

12
# 4. 常量
13
const MY_CONSTANT := 10
14

15
# 5. 导出变量 (按分组)
16
@export_group("Movement")
17
@export var speed: float
18

19
@export_group("Combat")
20
@export var damage: int
21

22
# 6. 普通变量
23
var _private_var: int
24

25
# 7. @onready 变量
26
@onready var _sprite: Sprite2D = $Sprite2D
27

28
# 8. 内置虚函数
29
func _ready() -> void:
30
    pass
31

32
func _process(delta: float) -> void:
33
    pass
34

35
func _physics_process(delta: float) -> void:
36
    pass
37

38
# 9. 公共函数
39
func public_function() -> void:
40
    pass
41

42
# 10. 私有函数
43
func _private_function() -> void:
44
    pass

1
# 发布者
2
signal enemy_died(position: Vector2, score_value: int)
3

4
func _on_health_depleted() -> void:
5
    enemy_died.emit(global_position, score_value)
6
    queue_free()
7

8
# 订阅者
9
func _ready() -> void:
10
    for enemy in get_tree().get_nodes_in_group("enemies"):
11
        enemy.enemy_died.connect(_on_enemy_died)
12

13
func _on_enemy_died(pos: Vector2, score: int) -> void:
14
    GameManager.add_score(score)
15
    spawn_death_effect(pos)

1
# game_data.gd (AutoLoad)
2
extends Node
3

4
var player_data: PlayerData
5
var settings: GameSettings
6

7
func save_game() -> void:
8
    var save_file := FileAccess.open("user://savegame.save", FileAccess.WRITE)
9
    var data := {
10
        "player": player_data.to_dict(),
11
        "settings": settings.to_dict()
12
    }
13
    save_file.store_var(data)
14

15
func load_game() -> bool:
16
    if not FileAccess.file_exists("user://savegame.save"):
17
        return false
18
    var save_file := FileAccess.open("user://savegame.save", FileAccess.READ)
19
    var data := save_file.get_var()
20
    player_data.from_dict(data["player"])
21
    settings.from_dict(data["settings"])
22
    return true