Skip to content

User defined default project directory for Project Manager #111629

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Cautami wants to merge 4 commits into from
Closed

User defined default project directory for Project Manager #111629

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c0dfa46
Add user_defined_project_path, update relevant code
Cautami Oct 14, 2025
620541b
Switch everything to prefer user_defined_project_path
Cautami Oct 14, 2025
4fef493
Add user_defined to xml, update default_path
Cautami Oct 14, 2025
9bce603
Merge branch 'godotengine:master' into default-project-directory
Cautami Oct 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion doc/classes/EditorSettings.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -695,7 +695,10 @@
[b]Note:[/b] Setting this path to a folder with very large amounts of files/folders can slow down the project manager startup significantly. To keep the project manager quick to start up, it is recommended to set this value to a folder as "specific" as possible.
</member>
<member name="filesystem/directories/default_project_path" type="String" setter="" getter="">
The folder where new projects should be created by default when clicking the project manager's [b]New Project[/b] button. This can be set to the same value as [member filesystem/directories/autoscan_project_path] for convenience.
The default folder Godot automatically selects based on operating system. This can be set to the same value as [member filesystem/directories/autoscan_project_path] for convenience.
</member>
<member name="filesystem/directories/user_defined_project_path" type="String" setter="" getter="">
The folder where new projects should be created by default when clicking the project manager's [b]New Project[/b] button. The user can define this option in the Project Manager's Settings menu.
</member>
<member name="filesystem/external_programs/3d_model_editor" type="String" setter="" getter="">
The program that opens 3D model scene files when clicking "Open in External Program" option in Filesystem Dock. If not specified, the file will be opened in the system's default program.
Expand Down
6 changes: 3 additions & 3 deletions editor/project_manager/project_dialog.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -390,7 +390,7 @@ void ProjectDialog::_install_path_changed() {
void ProjectDialog::_browse_project_path() {
String path = project_path->get_text();
if (path.is_relative_path()) {
path = EDITOR_GET("filesystem/directories/default_project_path");
path = EDITOR_GET("filesystem/directories/user_defined_project_path");
}
if (mode == MODE_IMPORT && install_path->is_visible_in_tree()) {
// Select last ZIP file.
Expand Down Expand Up @@ -421,7 +421,7 @@ void ProjectDialog::_browse_install_path() {

String path = install_path->get_text();
if (path.is_relative_path() || !DirAccess::dir_exists_absolute(path)) {
path = EDITOR_GET("filesystem/directories/default_project_path");
path = EDITOR_GET("filesystem/directories/user_defined_project_path");
}
if (create_dir->is_pressed()) {
// Select parent directory of install path.
Expand Down Expand Up @@ -862,7 +862,7 @@ void ProjectDialog::show_dialog(bool p_reset_name) {
install_path->set_text(original_dir);
fdialog_project->set_current_dir(original_dir);
} else {
String fav_dir = EDITOR_GET("filesystem/directories/default_project_path");
String fav_dir = EDITOR_GET("filesystem/directories/user_defined_project_path");
fav_dir = fav_dir.simplify_path();
if (!fav_dir.is_empty()) {
project_path->set_text(fav_dir);
Expand Down
4 changes: 2 additions & 2 deletions editor/project_manager/project_manager.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1712,7 +1712,7 @@ ProjectManager::ProjectManager() {
scan_dir->set_access(EditorFileDialog::ACCESS_FILESYSTEM);
scan_dir->set_file_mode(EditorFileDialog::FILE_MODE_OPEN_DIR);
scan_dir->set_title(TTRC("Select a Folder to Scan")); // Must be after mode or it's overridden.
scan_dir->set_current_dir(EDITOR_GET("filesystem/directories/default_project_path"));
scan_dir->set_current_dir(EDITOR_GET("filesystem/directories/user_defined_project_path"));
add_child(scan_dir);
scan_dir->connect("dir_selected", callable_mp(project_list, &ProjectList::find_projects));

Expand Down Expand Up @@ -1881,7 +1881,7 @@ ProjectManager::ProjectManager() {

Ref<DirAccess> dir_access = DirAccess::create(DirAccess::AccessType::ACCESS_FILESYSTEM);

String default_project_path = EDITOR_GET("filesystem/directories/default_project_path");
String default_project_path = EDITOR_GET("filesystem/directories/user_defined_project_path");
if (!default_project_path.is_empty() && !dir_access->dir_exists(default_project_path)) {
Error error = dir_access->make_dir_recursive(default_project_path);
if (error != OK) {
Expand Down
24 changes: 24 additions & 0 deletions editor/project_manager/quick_settings_dialog.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@
#include "scene/gui/box_container.h"
#include "scene/gui/button.h"
#include "scene/gui/label.h"
#include "scene/gui/line_edit.h"
#include "scene/gui/option_button.h"
#include "scene/gui/panel_container.h"

Expand Down Expand Up @@ -149,6 +150,12 @@ void QuickSettingsDialog::_update_current_values() {
}
}

// Default directory option.
{
const String current_directory = EDITOR_GET("filesystem/directories/user_defined_project_path");
default_directory_input->set_text(current_directory);
}

// Project directory naming options.
{
const int current_directory_naming = EDITOR_GET("project_manager/directory_naming_convention");
Expand Down Expand Up @@ -209,6 +216,10 @@ void QuickSettingsDialog::_directory_naming_convention_selected(int p_id) {
_set_setting_value("project_manager/directory_naming_convention", p_id);
}

void QuickSettingsDialog::_directory_input_changed(const String &p_text) {
_set_setting_value("filesystem/directories/user_defined_project_path", p_text);
}

void QuickSettingsDialog::_set_setting_value(const String &p_setting, const Variant &p_value, bool p_restart_required) {
EditorSettings::get_singleton()->set(p_setting, p_value);
EditorSettings::get_singleton()->notify_changes();
Expand Down Expand Up @@ -361,6 +372,19 @@ QuickSettingsDialog::QuickSettingsDialog() {
_add_setting_control(TTRC("Check for Updates"), check_for_update_button);
}

// Default directory input.
{
HBoxContainer *dir_container = memnew(HBoxContainer);

default_directory_input = memnew(LineEdit);
default_directory_input->set_h_size_flags(Control::SIZE_EXPAND_FILL);
default_directory_input->set_placeholder(EDITOR_GET("filesystem/directories/default_project_path"));
default_directory_input->connect("text_changed", callable_mp(this, &QuickSettingsDialog::_directory_input_changed));
dir_container->add_child(default_directory_input);

_add_setting_control(TTRC("Default Project Directory"), dir_container);
}

// Project directory naming options.
{
directory_naming_convention_button = memnew(OptionButton);
Expand Down
4 changes: 4 additions & 0 deletions editor/project_manager/quick_settings_dialog.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@

class Button;
class Label;
class LineEdit;
class MarginContainer;
class OptionButton;
class PanelContainer;
Expand All @@ -49,6 +50,7 @@ class QuickSettingsDialog : public AcceptDialog {
Vector<String> editor_scales;
Vector<String> editor_network_modes;
Vector<String> editor_check_for_updates;
Vector<String> editor_default_directory;
Vector<String> editor_directory_naming_conventions;

void _fetch_setting_values();
Expand All @@ -68,6 +70,7 @@ class QuickSettingsDialog : public AcceptDialog {
OptionButton *scale_option_button = nullptr;
OptionButton *network_mode_option_button = nullptr;
OptionButton *check_for_update_button = nullptr;
LineEdit *default_directory_input = nullptr;
OptionButton *directory_naming_convention_button = nullptr;

Label *custom_theme_label = nullptr;
Expand All @@ -79,6 +82,7 @@ class QuickSettingsDialog : public AcceptDialog {
void _scale_selected(int p_id);
void _network_mode_selected(int p_id);
void _check_for_update_selected(int p_id);
void _directory_input_changed(const String &p_text);
void _directory_naming_convention_selected(int p_id);
void _set_setting_value(const String &p_setting, const Variant &p_value, bool p_restart_required = false);

Expand Down
1 change: 1 addition & 0 deletions editor/settings/editor_settings.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -641,6 +641,7 @@ void EditorSettings::_load_defaults(Ref<ConfigFile> p_extra_config) {
EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_GLOBAL_DIR, "filesystem/directories/autoscan_project_path", "", "")
const String fs_dir_default_project_path = OS::get_singleton()->has_environment("HOME") ? OS::get_singleton()->get_environment("HOME") : OS::get_singleton()->get_system_dir(OS::SYSTEM_DIR_DOCUMENTS);
EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_DIR, "filesystem/directories/default_project_path", fs_dir_default_project_path, "")
EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_DIR, "filesystem/directories/user_defined_project_path", fs_dir_default_project_path, "")

// On save
_initial_set("filesystem/on_save/compress_binary_resources", true);
Expand Down