Создание визуальной новеллы в Godot: полное руководство для начинающих

extends Control

# Переменные для хранения текущего состояния
var current_dialogue = []
var dialogue_index = 0
var finished = false

# Ссылки на узлы
onready var dialogue_text = $DialoguePanel/DialogueText
onready var name_label = $DialoguePanel/NameLabel
onready var character_sprite = $CharacterSprite
onready var background = $Background

# Загрузка диалога при старте
func _ready():
load_dialogue("res://dialogue/intro.json")
show_dialogue()

# Загрузка диалогового файла
func load_dialogue(file_path):
var file = File.new()
file.open(file_path, File.READ)
var json = JSON.parse(file.get_as_text())
file.close()
current_dialogue = json.result
dialogue_index = 0

# Отображение текущего диалога
func show_dialogue():
if dialogue_index >= current_dialogue.size():
return

var current = current_dialogue[dialogue_index]
name_label.text = current.name
dialogue_text.text = current.text

# Обновление фона и персонажа, если указано
if current.has("background"):
var bg_texture = load("res://assets/backgrounds/" + current.background)
background.texture = bg_texture

if current.has("character"):
var char_texture = load("res://assets/characters/" + current.character)
character_sprite.texture = char_texture

[
{
"name": "Анна",
"text": "Привет! Как твои дела?",
"character": "anna_smile.png",
"position": "center",
"background": "cafe.jpg"
},
{
"name": "Игрок",
"text": "Привет, Анна! У меня всё хорошо, спасибо.",
"character": ""
},
{
"name": "Анна",
"text": "Я хотела спросить тебя о...",
"character": "anna_curious.png",
"position": "center"
}
]

extends Node

signal dialogue_started
signal dialogue_ended
signal dialogue_next(dialogue_data)

var dialogue_data = []
var dialogue_index = 0
var is_dialogue_active = false

# Загружает диалоговый файл
func load_dialogue(file_path):
var file = File.new()
if !file.file_exists(file_path):
print("Ошибка: файл диалога не найден: " + file_path)
return false

file.open(file_path, File.READ)
var json_text = file.get_as_text()
file.close()

var json = JSON.parse(json_text)
if json.error != OK:
print("Ошибка разбора JSON: ", json.error_string)
return false

dialogue_data = json.result
dialogue_index = 0
return true

# Запускает отображение диалога
func start_dialogue(file_path):
if load_dialogue(file_path):
is_dialogue_active = true
dialogue_index = 0
emit_signal("dialogue_started")
next_dialogue()

# Переход к следующему диалогу
func next_dialogue():
if dialogue_index >= dialogue_data.size():
is_dialogue_active = false
emit_signal("dialogue_ended")
return

emit_signal("dialogue_next", dialogue_data[dialogue_index])
dialogue_index += 1

# Проверка активности диалога
func is_active():
return is_dialogue_active

extends Control

signal dialogue_next_requested

onready var name_label = $NameLabel
onready var dialogue_text = $DialogueText
onready var next_button = $NextButton

func _ready():
# Подключаем сигнал к кнопке
next_button.connect("pressed", self, "_on_next_button_pressed")

# Подписываемся на сигналы менеджера диалогов
DialogueManager.connect("dialogue_started", self, "_on_dialogue_started")
DialogueManager.connect("dialogue_ended", self, "_on_dialogue_ended")
DialogueManager.connect("dialogue_next", self, "_on_dialogue_next")

# Обработка нажатия на кнопку "Далее"
func _on_next_button_pressed():
emit_signal("dialogue_next_requested")
DialogueManager.next_dialogue()

# Обработка начала диалога
func _on_dialogue_started():
show()

# Обработка конца диалога
func _on_dialogue_ended():
hide()

# Отображение текущего диалога
func _on_dialogue_next(data):
name_label.text = data.name if data.has("name") else ""
dialogue_text.text = data.text if data.has("text") else ""

extends Node2D

export var character_name = ""
export(Dictionary) var expressions = {}
export var default_position = Vector2(512, 300)

onready var sprite = $Sprite

# Инициализация персонажа
func _ready():
position = default_position

# Установка выражения лица персонажа
func set_expression(expression_name):
if expressions.has(expression_name):
sprite.texture = expressions[expression_name]
else:
print("Выражение не найдено: ", expression_name)

# Анимированное перемещение персонажа
func move_to(target_position, duration = 1.0):
$Tween.interpolate_property(
self, "position",
position, target_position,
duration, Tween.TRANS_CUBIC, Tween.EASE_IN_OUT
)
$Tween.start()

# Появление персонажа с эффектом
func appear(duration = 0.5):
modulate.a = 0
$Tween.interpolate_property(
self, "modulate:a",
0, 1,
duration, Tween.TRANS_CUBIC, Tween.EASE_IN_OUT
)
$Tween.start()

# Исчезновение персонажа с эффектом
func disappear(duration = 0.5):
$Tween.interpolate_property(
self, "modulate:a",
1, 0,
duration, Tween.TRANS_CUBIC, Tween.EASE_IN_OUT
)
$Tween.start()

extends Node

var characters = {}

# Добавление нового персонажа
func add_character(character_name, character_scene):
var instance = character_scene.instance()
add_child(instance)
characters[character_name] = instance
instance.hide()

# Показ персонажа
func show_character(character_name, expression = "", position = "center"):
if !characters.has(character_name):
print("Персонаж не найден: ", character_name)
return

var character = characters[character_name]
character.show()
character.appear()

if expression != "":
character.set_expression(expression)

if position == "left":
character.move_to(Vector2(300, 300))
elif position == "center":
character.move_to(Vector2(512, 300))
elif position == "right":
character.move_to(Vector2(724, 300))

# Скрытие персонажа
func hide_character(character_name):
if characters.has(character_name):
characters[character_name].disappear()
yield(get_tree().create_timer(0.5), "timeout")
characters[character_name].hide()

DialogueManager.start_dialogue("res://dialogue/test_dialogue.json")

[
{
"id": "start",
"name": "Анна",
"text": "Привет! Куда бы ты хотел пойти сегодня?",
"character": "anna_smile.png",
"position": "center",
"next": "choice_1"
},
{
"id": "choice_1",
"type": "choice",
"choices": [
{
"text": "Давай пойдем в парк",
"next": "park_route"
},
{
"text": "Может быть, в кафе?",
"next": "cafe_route"
},
{
"text": "Я бы предпочел остаться дома",
"next": "home_route"
}
]
},
{
"id": "park_route",
"name": "Анна",
"text": "Отличная идея! Погода сегодня прекрасная для прогулки.",
"character": "anna_happy.png",
"background": "park.jpg",
"next": "park_continue"
},
{
"id": "cafe_route",
"name": "Анна",
"text": "О, я знаю отличное место неподалеку!",
"character": "anna_excited.png",
"background": "cafe.jpg",
"next": "cafe_continue"
}
]

extends Node

signal dialogue_started
signal dialogue_ended
signal dialogue_next(dialogue_data)
signal choice_presented(choices)

var dialogue_data = {} # Изменено на словарь для поиска по ID
var current_id = "start"
var is_dialogue_active = false

# Загружает диалоговый файл
func load_dialogue(file_path):
var file = File.new()
if !file.file_exists(file_path):
print("Ошибка: файл диалога не найден: " + file_path)
return false

file.open(file_path, File.READ)
var json_text = file.get_as_text()
file.close()

var json = JSON.parse(json_text)
if json.error != OK:
print("Ошибка разбора JSON: ", json.error_string)
return false

# Преобразуем массив в словарь для быстрого доступа по ID
dialogue_data.clear()
for entry in json.result:
if entry.has("id"):
dialogue_data[entry.id] = entry

return true

# Запускает отображение диалога
func start_dialogue(file_path, start_id = "start"):
if load_dialogue(file_path):
is_dialogue_active = true
current_id = start_id
emit_signal("dialogue_started")
next_dialogue()

# Переход к следующему диалогу
func next_dialogue():
if !dialogue_data.has(current_id):
is_dialogue_active = false
emit_signal("dialogue_ended")
return

var current = dialogue_data[current_id]

# Проверяем, является ли текущий узел выбором
if current.has("type") and current.type == "choice":
emit_signal("choice_presented", current.choices)
else:
emit_signal("dialogue_next", current)

# Если есть указание на следующий узел, переходим к нему
if current.has("next"):
current_id = current.next
else:
is_dialogue_active = false
emit_signal("dialogue_ended")

extends Control

signal choice_made(index)

onready var choice_container = $VBoxContainer

# Шаблон кнопки выбора
var choice_button = preload("res://scenes/ChoiceButton.tscn")

func _ready():
# Подписываемся на сигнал менеджера диалогов
DialogueManager.connect("choice_presented", self, "show_choices")
hide()

# Отображение вариантов выбора
func show_choices(choices):
# Очистка предыдущих вариантов
for child in choice_container.get_children():
child.queue_free()

# Создание кнопок для каждого варианта
for i in range(choices.size()):
var choice = choices[i]
var button = choice_button.instance()
button.text = choice.text
button.connect("pressed", self, "_on_choice_made", [i])
choice_container.add_child(button)

show()

# Обработка выбора игрока
func _on_choice_made(index):
emit_signal("choice_made", index)
DialogueManager.choose_option(index)
hide()

extends Node

# Переменные, отслеживающие выборы и прогресс игрока
var variables = {
"trust_anna": 0,
"visited_park": false,
"visited_cafe": false,
"visited_home": false
}

# Инкрементирует числовую переменную
func increment(var_name, value = 1):
if variables.has(var_name):
if typeof(variables[var_name]) == TYPE_INT or typeof(variables[var_name]) == TYPE_REAL:
variables[var_name] += value

# Устанавливает значение переменной
func set_var(var_name, value):
variables[var_name] = value

# Получает значение переменной
func get_var(var_name):
if variables.has(var_name):
return variables[var_name]
return null

# Проверка условия
func check_condition(condition):
# Простой парсер условий, например "trust_anna > 5"
var parts = condition.split(" ")
if parts.size() != 3:
return false

var var_name = parts[0]
var operator = parts[1]
var value = int(parts[2])

if !variables.has(var_name):
return false

match operator:
"==": return variables[var_name] == value
">": return variables[var_name] > value
"<": return variables[var_name] < value
">=": return variables[var_name] >= value
"<=": return variables[var_name] <= value
"!=": return variables[var_name] != value

return false

# Сохранение состояния игры
func save_game(slot_name = "save1"):
var save_data = {
"variables": variables,
"current_scene": get_tree().current_scene.filename,
"timestamp": OS.get_datetime()
}

var save_file = File.new()
save_file.open("user://"+slot_name+".save", File.WRITE)
save_file.store_line(to_json(save_data))
save_file.close()

# Загрузка состояния игры
func load_game(slot_name = "save1"):
var save_file = File.new()
if !save_file.file_exists("user://"+slot_name+".save"):
return false

save_file.open("user://"+slot_name+".save", File.READ)
var save_data = parse_json(save_file.get_line())
save_file.close()

if save_data:
variables = save_data.variables
# Переход на сохраненную сцену
get_tree().change_scene(save_data.current_scene)
return true

return false

{
"id": "park_decision",
"type": "conditional",
"conditions": [
{
"condition": "trust_anna > 5",
"next": "anna_reveals_secret"
},
{
"condition": "trust_anna <= 5",
"next": "normal_park_walk"
}
]
}

# Обработка условного перехода
func process_conditional(conditional_node):
for condition_entry in conditional_node.conditions:
if GameState.check_condition(condition_entry.condition):
current_id = condition_entry.next
return true
return false

# Модифицируем функцию next_dialogue
func next_dialogue():
if !dialogue_data.has(current_id):
is_dialogue_active = false
emit_signal("dialogue_ended")
return

var current = dialogue_data[current_id]

# Обрабатываем разные типы узлов
if current.has("type"):
match current.type:
"choice":
emit_signal("choice_presented", current.choices)
return
"conditional":
if process_conditional(current):
next_dialogue()
else:
# Если ни одно условие не выполнено
is_dialogue_active = false
emit_signal("dialogue_ended")
return
"set_variable":
GameState.set_var(current.variable, current.value)
if current.has("next"):
current_id = current.next
next_dialogue()
return

# Стандартный диалоговый узел
emit_signal("dialogue_next", current)

# Если есть указание на следующий узел, переходим к нему
if current.has("next"):
current_id = current.next
else:
is_dialogue_active = false
emit_signal("dialogue_ended")

# Функция для плавного затемнения экрана
func fade_to_black(duration = 1.0):
var fade_overlay = $FadeOverlay
$Tween.interpolate_property(
fade_overlay, "modulate:a",
0.0, 1.0, duration,
Tween.TRANS_CUBIC, Tween.EASE_IN
)
$Tween.start()
yield($Tween, "tween_completed")

# Функция для плавного проявления экрана
func fade_from_black(duration = 1.0):
var fade_overlay = $FadeOverlay
$Tween.interpolate_property(
fade_overlay, "modulate:a",
1.0, 0.0, duration,
Tween.TRANS_CUBIC, Tween.EASE_OUT
)
$Tween.start()
yield($Tween, "tween_completed")

# Функция для смены фона с эффектом
func change_background(new_bg_path, transition_type = "fade"):
match transition_type:
"fade":
yield(fade_to_black(0.5), "completed")
$Background.texture = load(new_bg_path)
yield(fade_from_black(0.5), "completed")
"dissolve":
var old_bg = $Background.texture
$Background.texture = load(new_bg_path)
$Tween.interpolate_property(
$Background, "modulate:a",
0, 1, 1.0,
Tween.TRANS_CUBIC, Tween.EASE_IN_OUT
)
$Tween.start()

extends Node

# Ноды для разных типов звука
onready var music_player = $MusicPlayer
onready var sfx_player = $SFXPlayer
onready var voice_player = $VoicePlayer

# Кэш звуковых файлов
var music_cache = {}
var sfx_cache = {}
var voice_cache = {}

# Настройки громкости
var music_volume = 1.0
var sfx_volume = 1.0
var voice_volume = 1.0

# Воспроизведение фоновой музыки
func play_music(music_path, fade_in = 2.0):
var new_music

# Проверяем кэш
if music_cache.has(music_path):
new_music = music_cache[music_path]
else:
new_music = load(music_path)
music_cache[music_path] = new_music

# Если уже играет музыка, делаем плавный переход
if music_player.playing:
$MusicTween.interpolate_property(
music_player, "volume_db",
music_player.volume_db, -80, 1.0,
Tween.TRANS_CUBIC, Tween.EASE_IN
)
$MusicTween.start()
yield($MusicTween, "tween_completed")

music_player.stream = new_music
music_player.play()

# Плавное нарастание громкости
music_player.volume_db = -80
$MusicTween.interpolate_property(
music_player, "volume_db",
-80, linear2db(music_volume), fade_in,
Tween.TRANS_CUBIC, Tween.EASE_OUT
)
$MusicTween.start()

# Воспроизведение звукового эффекта
func play_sfx(sfx_path):
var sfx

# Проверяем кэш
if sfx_cache.has(sfx_path):
sfx = sfx_cache[sfx_path]
else:
sfx = load(sfx_path)
sfx_cache[sfx_path] = sfx

sfx_player.stream = sfx
sfx_player.volume_db = linear2db(sfx_volume)
sfx_player.play()

# Воспроизведение озвучки
func play_voice(voice_path):
if voice_player.playing:
voice_player.stop()

var voice

# Проверяем кэш
if voice_cache.has(voice_path):
voice = voice_cache[voice_path]
else:
voice = load(voice_path)
voice_cache[voice_path] = voice

voice_player.stream = voice
voice_player.volume_db = linear2db(voice_volume)
voice_player.play()

# Установка громкости музыки
func set_music_volume(volume):
music_volume = clamp(volume, 0, 1)
music_player.volume_db = linear2db(music_volume)

# Установка громкости звуковых эффектов
func set_sfx_volume(volume):
sfx_volume = clamp(volume, 0, 1)

# Установка громкости озвучки
func set_voice_volume(volume):
voice_volume = clamp(volume, 0, 1)
if voice_player.playing:
voice_player.volume_db = linear2db(voice_volume)

extends Control

onready var music_slider = $Settings/MusicSlider
onready var sfx_slider = $Settings/SFXSlider
onready var voice_slider = $Settings/VoiceSlider
onready var fullscreen_check = $Settings/FullscreenCheck

func _ready():
# Инициализация значений слайдеров
music_slider.value = AudioManager.music_volume
sfx_slider.value = AudioManager.sfx_volume
voice_slider.value = AudioManager.voice_volume

# Состояние полноэкранного режима
fullscreen_check.pressed = OS.window_fullscreen

# Подключение сигналов
music_slider.connect("value_changed", self, "_on_music_volume_changed")
sfx_slider.connect("value_changed", self, "_on_sfx_volume_changed")
voice_slider.connect("value_changed", self, "_on_voice_volume_changed")
fullscreen_check.connect("toggled", self, "_on_fullscreen_toggled")

# Обработчики событий
func _on_music_volume_changed(value):
AudioManager.set_music_volume(value)

func _on_sfx_volume_changed(value):
AudioManager.set_sfx_volume(value)

func _on_voice_volume_changed(value):
AudioManager.set_voice_volume(value)

func _on_fullscreen_toggled(enabled):
OS.window_fullscreen = enabled

# Сохранение настроек
func save_settings():
var config = ConfigFile.new()
config.set_value("audio", "music_volume", AudioManager.music_volume)
config.set_value("audio", "sfx_volume", AudioManager.sfx_volume)
config.set_value("audio", "voice_volume", AudioManager.voice_volume)
config.set_value("video", "fullscreen", OS.window_fullscreen)
config.save("user://settings.cfg")

# Загрузка настроек
func load_settings():
var config = ConfigFile.new()
var err = config.load("user://settings.cfg")
if err != OK:
return

AudioManager.set_music_volume(config.get_value("audio", "music_volume", 1.0))
AudioManager.set_sfx_volume(config.get_value("audio", "sfx_volume", 1.0))
AudioManager.set_voice_volume(config.get_value("audio", "voice_volume", 1.0))
OS.window_fullscreen = config.get_value("video", "fullscreen", false)

# Обновление UI
music_slider.value = AudioManager.music_volume
sfx_slider.value = AudioManager.sfx_volume
voice_slider.value = AudioManager.voice_volume
fullscreen_check.pressed = OS.window_fullscreen