godot-gdscript-patterns

Godot GDScript パターン

GDScript を用いた Godot 4.x ゲーム開発のための実運用パターン集で、アーキテクチャ、シグナル、シーン、最適化を扱います。

このスキルを使用する場面

• Godot 4 でゲームを制作する場合
• GDScript でゲームシステムを実装する場合
• シーンアーキテクチャを設計する場合
• ゲームの状態を管理する場合
• GDScript のパフォーマンスを最適化する場合
• Godot のベストプラクティスを学ぶ場合

中核となる概念

1. Godot のアーキテクチャ

Node: Base building block
├── Scene: Reusable node tree (saved as .tscn)
├── Resource: Data container (saved as .tres)
├── Signal: Event communication
└── Group: Node categorization

2. GDScript の基本

class_name Player
extends CharacterBody2D

# Signals
signal health_changed(new_health: int)
signal died

# Exports (Inspector-editable)
@export var speed: float = 200.0
@export var max_health: int = 100
@export_range(0, 1) var damage_reduction: float = 0.0
@export_group("Combat")
@export var attack_damage: int = 10
@export var attack_cooldown: float = 0.5

# Onready (initialized when ready)
@onready var sprite: Sprite2D = $Sprite2D
@onready var animation: AnimationPlayer = $AnimationPlayer
@onready var hitbox: Area2D = $Hitbox

# Private variables (convention: underscore prefix)
var _health: int
var _can_attack: bool = true

func _ready() -> void:
    _health = max_health

func _physics_process(delta: float) -> void:
    var direction := Input.get_vector("left", "right", "up", "down")
    velocity = direction * speed
    move_and_slide()

func take_damage(amount: int) -> void:
    var actual_damage := int(amount * (1.0 - damage_reduction))
    _health = max(_health - actual_damage, 0)
    health_changed.emit(_health)

    if _health <= 0:
        died.emit()

詳細なパターンと実践例

詳細なパターンのドキュメントは references/details.md にあります。上記のナビゲーション層では不十分な場合に、そのファイルを読んでください。