editor_settings.cpp 103 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216
  1. /**************************************************************************/
  2. /* editor_settings.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "editor_settings.h"
  31. #include "core/config/project_settings.h"
  32. #include "core/input/input_event.h"
  33. #include "core/input/input_map.h"
  34. #include "core/input/shortcut.h"
  35. #include "core/io/certs_compressed.gen.h"
  36. #include "core/io/dir_access.h"
  37. #include "core/io/file_access.h"
  38. #include "core/io/ip.h"
  39. #include "core/io/resource_loader.h"
  40. #include "core/io/resource_saver.h"
  41. #include "core/object/class_db.h"
  42. #include "core/os/keyboard.h"
  43. #include "core/os/os.h"
  44. #include "core/string/translation_server.h"
  45. #include "core/version.h"
  46. #include "editor/editor_node.h"
  47. #include "editor/editor_paths.h"
  48. #include "editor/editor_property_name_processor.h"
  49. #include "editor/editor_translation.h"
  50. #include "editor/engine_update_label.h"
  51. #include "modules/regex/regex.h"
  52. #include "scene/gui/color_picker.h"
  53. #include "scene/main/node.h"
  54. #include "scene/main/scene_tree.h"
  55. #include "scene/main/window.h"
  56. #include "scene/resources/animation.h"
  57. // PRIVATE METHODS
  58. Ref<EditorSettings> EditorSettings::singleton = nullptr;
  59. // Properties
  60. bool EditorSettings::_set(const StringName &p_name, const Variant &p_value) {
  61. _THREAD_SAFE_METHOD_
  62. bool changed = _set_only(p_name, p_value);
  63. if (changed && initialized) {
  64. changed_settings.insert(p_name);
  65. if (p_name == SNAME("text_editor/external/exec_path")) {
  66. const StringName exec_args_name = "text_editor/external/exec_flags";
  67. const String exec_args_value = _guess_exec_args_for_extenal_editor(p_value);
  68. if (!exec_args_value.is_empty() && _set_only(exec_args_name, exec_args_value)) {
  69. changed_settings.insert(exec_args_name);
  70. }
  71. }
  72. emit_signal(SNAME("settings_changed"));
  73. if (p_name == SNAME("interface/editor/editor_language")) {
  74. setup_language();
  75. }
  76. }
  77. return true;
  78. }
  79. bool EditorSettings::_set_only(const StringName &p_name, const Variant &p_value) {
  80. _THREAD_SAFE_METHOD_
  81. if (p_name == "shortcuts") {
  82. Array arr = p_value;
  83. for (int i = 0; i < arr.size(); i++) {
  84. Dictionary dict = arr[i];
  85. String shortcut_name = dict["name"];
  86. Array shortcut_events = dict["shortcuts"];
  87. Ref<Shortcut> sc;
  88. sc.instantiate();
  89. sc->set_events(shortcut_events);
  90. add_shortcut(shortcut_name, sc);
  91. }
  92. return false;
  93. } else if (p_name == "builtin_action_overrides") {
  94. Array actions_arr = p_value;
  95. for (int i = 0; i < actions_arr.size(); i++) {
  96. Dictionary action_dict = actions_arr[i];
  97. String action_name = action_dict["name"];
  98. Array events = action_dict["events"];
  99. InputMap *im = InputMap::get_singleton();
  100. im->action_erase_events(action_name);
  101. builtin_action_overrides[action_name].clear();
  102. for (int ev_idx = 0; ev_idx < events.size(); ev_idx++) {
  103. im->action_add_event(action_name, events[ev_idx]);
  104. builtin_action_overrides[action_name].push_back(events[ev_idx]);
  105. }
  106. }
  107. return false;
  108. }
  109. bool changed = false;
  110. if (p_value.get_type() == Variant::NIL) {
  111. if (props.has(p_name)) {
  112. props.erase(p_name);
  113. changed = true;
  114. }
  115. } else {
  116. if (props.has(p_name)) {
  117. if (p_value != props[p_name].variant) {
  118. props[p_name].variant = p_value;
  119. changed = true;
  120. }
  121. } else {
  122. props[p_name] = VariantContainer(p_value, last_order++);
  123. changed = true;
  124. }
  125. if (save_changed_setting) {
  126. if (!props[p_name].save) {
  127. props[p_name].save = true;
  128. changed = true;
  129. }
  130. }
  131. }
  132. return changed;
  133. }
  134. bool EditorSettings::_get(const StringName &p_name, Variant &r_ret) const {
  135. _THREAD_SAFE_METHOD_
  136. if (p_name == "shortcuts") {
  137. Array save_array;
  138. const HashMap<String, List<Ref<InputEvent>>> &builtin_list = InputMap::get_singleton()->get_builtins();
  139. for (const KeyValue<String, Ref<Shortcut>> &shortcut_definition : shortcuts) {
  140. Ref<Shortcut> sc = shortcut_definition.value;
  141. if (builtin_list.has(shortcut_definition.key)) {
  142. // This shortcut was auto-generated from built in actions: don't save.
  143. // If the builtin is overridden, it will be saved in the "builtin_action_overrides" section below.
  144. continue;
  145. }
  146. Array shortcut_events = sc->get_events();
  147. Dictionary dict;
  148. dict["name"] = shortcut_definition.key;
  149. dict["shortcuts"] = shortcut_events;
  150. if (!sc->has_meta("original")) {
  151. // Getting the meta when it doesn't exist will return an empty array. If the 'shortcut_events' have been cleared,
  152. // we still want save the shortcut in this case so that shortcuts that the user has customized are not reset,
  153. // even if the 'original' has not been populated yet. This can happen when calling save() from the Project Manager.
  154. save_array.push_back(dict);
  155. continue;
  156. }
  157. Array original_events = sc->get_meta("original");
  158. bool is_same = Shortcut::is_event_array_equal(original_events, shortcut_events);
  159. if (is_same) {
  160. continue; // Not changed from default; don't save.
  161. }
  162. save_array.push_back(dict);
  163. }
  164. r_ret = save_array;
  165. return true;
  166. } else if (p_name == "builtin_action_overrides") {
  167. Array actions_arr;
  168. for (const KeyValue<String, List<Ref<InputEvent>>> &action_override : builtin_action_overrides) {
  169. const List<Ref<InputEvent>> *defaults = InputMap::get_singleton()->get_builtins().getptr(action_override.key);
  170. if (!defaults) {
  171. continue;
  172. }
  173. List<Ref<InputEvent>> events = action_override.value;
  174. Dictionary action_dict;
  175. action_dict["name"] = action_override.key;
  176. // Convert the list to an array, and only keep key events as this is for the editor.
  177. Array events_arr;
  178. for (const Ref<InputEvent> &ie : events) {
  179. Ref<InputEventKey> iek = ie;
  180. if (iek.is_valid()) {
  181. events_arr.append(iek);
  182. }
  183. }
  184. Array defaults_arr;
  185. for (const Ref<InputEvent> &default_input_event : *defaults) {
  186. if (default_input_event.is_valid()) {
  187. defaults_arr.append(default_input_event);
  188. }
  189. }
  190. bool same = Shortcut::is_event_array_equal(events_arr, defaults_arr);
  191. // Don't save if same as default.
  192. if (same) {
  193. continue;
  194. }
  195. action_dict["events"] = events_arr;
  196. actions_arr.push_back(action_dict);
  197. }
  198. r_ret = actions_arr;
  199. return true;
  200. }
  201. const VariantContainer *v = props.getptr(p_name);
  202. if (!v) {
  203. return false;
  204. }
  205. r_ret = v->variant;
  206. return true;
  207. }
  208. void EditorSettings::_initial_set(const StringName &p_name, const Variant &p_value, bool p_basic) {
  209. set(p_name, p_value);
  210. props[p_name].initial = p_value;
  211. props[p_name].has_default_value = true;
  212. props[p_name].basic = p_basic;
  213. }
  214. struct _EVCSort {
  215. String name;
  216. Variant::Type type = Variant::Type::NIL;
  217. int order = 0;
  218. bool basic = false;
  219. bool save = false;
  220. bool restart_if_changed = false;
  221. bool operator<(const _EVCSort &p_vcs) const { return order < p_vcs.order; }
  222. };
  223. void EditorSettings::_get_property_list(List<PropertyInfo> *p_list) const {
  224. _THREAD_SAFE_METHOD_
  225. RBSet<_EVCSort> vclist;
  226. for (const KeyValue<String, VariantContainer> &E : props) {
  227. const VariantContainer *v = &E.value;
  228. if (v->hide_from_editor) {
  229. continue;
  230. }
  231. _EVCSort vc;
  232. vc.name = E.key;
  233. vc.order = v->order;
  234. vc.type = v->variant.get_type();
  235. vc.basic = v->basic;
  236. vc.save = v->save;
  237. if (vc.save) {
  238. if (v->initial.get_type() != Variant::NIL && v->initial == v->variant) {
  239. vc.save = false;
  240. }
  241. }
  242. vc.restart_if_changed = v->restart_if_changed;
  243. vclist.insert(vc);
  244. }
  245. for (const _EVCSort &E : vclist) {
  246. uint32_t pusage = PROPERTY_USAGE_NONE;
  247. if (E.save || !optimize_save) {
  248. pusage |= PROPERTY_USAGE_STORAGE;
  249. }
  250. if (!E.name.begins_with("_") && !E.name.begins_with("projects/")) {
  251. pusage |= PROPERTY_USAGE_EDITOR;
  252. } else {
  253. pusage |= PROPERTY_USAGE_STORAGE; //hiddens must always be saved
  254. }
  255. PropertyInfo pi(E.type, E.name);
  256. pi.usage = pusage;
  257. if (hints.has(E.name)) {
  258. pi = hints[E.name];
  259. }
  260. if (E.basic) {
  261. pi.usage |= PROPERTY_USAGE_EDITOR_BASIC_SETTING;
  262. }
  263. if (E.restart_if_changed) {
  264. pi.usage |= PROPERTY_USAGE_RESTART_IF_CHANGED;
  265. }
  266. p_list->push_back(pi);
  267. }
  268. p_list->push_back(PropertyInfo(Variant::ARRAY, "shortcuts", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL)); //do not edit
  269. p_list->push_back(PropertyInfo(Variant::ARRAY, "builtin_action_overrides", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL));
  270. }
  271. void EditorSettings::_add_property_info_bind(const Dictionary &p_info) {
  272. ERR_FAIL_COND_MSG(!p_info.has("name"), "Property info is missing \"name\" field.");
  273. ERR_FAIL_COND_MSG(!p_info.has("type"), "Property info is missing \"type\" field.");
  274. if (p_info.has("usage")) {
  275. WARN_PRINT("\"usage\" is not supported in add_property_info().");
  276. }
  277. PropertyInfo pinfo;
  278. pinfo.name = p_info["name"];
  279. ERR_FAIL_COND(!props.has(pinfo.name));
  280. pinfo.type = Variant::Type(p_info["type"].operator int());
  281. ERR_FAIL_INDEX(pinfo.type, Variant::VARIANT_MAX);
  282. if (p_info.has("hint")) {
  283. pinfo.hint = PropertyHint(p_info["hint"].operator int());
  284. }
  285. if (p_info.has("hint_string")) {
  286. pinfo.hint_string = p_info["hint_string"];
  287. }
  288. add_property_hint(pinfo);
  289. }
  290. // Default configs
  291. bool EditorSettings::has_default_value(const String &p_setting) const {
  292. _THREAD_SAFE_METHOD_
  293. if (!props.has(p_setting)) {
  294. return false;
  295. }
  296. return props[p_setting].has_default_value;
  297. }
  298. void EditorSettings::_set_initialized() {
  299. initialized = true;
  300. }
  301. void EditorSettings::_load_defaults(Ref<ConfigFile> p_extra_config) {
  302. _THREAD_SAFE_METHOD_
  303. // Sets up the editor setting with a default value and hint PropertyInfo.
  304. #define EDITOR_SETTING(m_type, m_property_hint, m_name, m_default_value, m_hint_string) \
  305. _initial_set(m_name, m_default_value); \
  306. hints[m_name] = PropertyInfo(m_type, m_name, m_property_hint, m_hint_string);
  307. #define EDITOR_SETTING_BASIC(m_type, m_property_hint, m_name, m_default_value, m_hint_string) \
  308. _initial_set(m_name, m_default_value, true); \
  309. hints[m_name] = PropertyInfo(m_type, m_name, m_property_hint, m_hint_string);
  310. #define EDITOR_SETTING_USAGE(m_type, m_property_hint, m_name, m_default_value, m_hint_string, m_usage) \
  311. _initial_set(m_name, m_default_value); \
  312. hints[m_name] = PropertyInfo(m_type, m_name, m_property_hint, m_hint_string, m_usage);
  313. /* Languages */
  314. {
  315. String lang_hint = "en";
  316. String host_lang = OS::get_singleton()->get_locale();
  317. // Skip locales if Text server lack required features.
  318. Vector<String> locales_to_skip;
  319. if (!TS->has_feature(TextServer::FEATURE_BIDI_LAYOUT) || !TS->has_feature(TextServer::FEATURE_SHAPING)) {
  320. locales_to_skip.push_back("ar"); // Arabic
  321. locales_to_skip.push_back("fa"); // Persian
  322. locales_to_skip.push_back("ur"); // Urdu
  323. }
  324. if (!TS->has_feature(TextServer::FEATURE_BIDI_LAYOUT)) {
  325. locales_to_skip.push_back("he"); // Hebrew
  326. }
  327. if (!TS->has_feature(TextServer::FEATURE_SHAPING)) {
  328. locales_to_skip.push_back("bn"); // Bengali
  329. locales_to_skip.push_back("hi"); // Hindi
  330. locales_to_skip.push_back("ml"); // Malayalam
  331. locales_to_skip.push_back("si"); // Sinhala
  332. locales_to_skip.push_back("ta"); // Tamil
  333. locales_to_skip.push_back("te"); // Telugu
  334. }
  335. if (!locales_to_skip.is_empty()) {
  336. WARN_PRINT("Some locales are not properly supported by selected Text Server and are disabled.");
  337. }
  338. String best;
  339. int best_score = 0;
  340. for (const String &locale : get_editor_locales()) {
  341. // Skip locales which we can't render properly (see above comment).
  342. // Test against language code without regional variants (e.g. ur_PK).
  343. String lang_code = locale.get_slicec('_', 0);
  344. if (locales_to_skip.has(lang_code)) {
  345. continue;
  346. }
  347. lang_hint += ",";
  348. lang_hint += locale;
  349. int score = TranslationServer::get_singleton()->compare_locales(host_lang, locale);
  350. if (score > 0 && score >= best_score) {
  351. best = locale;
  352. best_score = score;
  353. }
  354. }
  355. if (best_score == 0) {
  356. best = "en";
  357. }
  358. EDITOR_SETTING_USAGE(Variant::STRING, PROPERTY_HINT_ENUM, "interface/editor/editor_language", best, lang_hint, PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING);
  359. }
  360. // Asset library
  361. _initial_set("asset_library/use_threads", true);
  362. /* Interface */
  363. // Editor
  364. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/localize_settings", true, "")
  365. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/dock_tab_style", 0, "Text Only,Icon Only,Text and Icon")
  366. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/ui_layout_direction", 0, "Based on Application Locale,Left-to-Right,Right-to-Left,Based on System Locale", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  367. // Display what the Auto display scale setting effectively corresponds to.
  368. const String display_scale_hint_string = vformat("Auto (%d%%),75%%,100%%,125%%,150%%,175%%,200%%,Custom", Math::round(get_auto_display_scale() * 100));
  369. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/display_scale", 0, display_scale_hint_string, PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  370. EDITOR_SETTING_USAGE(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/editor/custom_display_scale", 1.0, "0.5,3,0.01", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  371. String ed_screen_hints = "Auto (Remembers last position):-5,Screen With Mouse Pointer:-4,Screen With Keyboard Focus:-3,Primary Screen:-2";
  372. for (int i = 0; i < DisplayServer::get_singleton()->get_screen_count(); i++) {
  373. ed_screen_hints += ",Screen " + itos(i + 1) + ":" + itos(i);
  374. }
  375. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/editor_screen", EditorSettings::InitialScreen::INITIAL_SCREEN_AUTO, ed_screen_hints)
  376. #ifdef WINDOWS_ENABLED
  377. String tablet_hints = "Use Project Settings:-1";
  378. for (int i = 0; i < DisplayServer::get_singleton()->tablet_get_driver_count(); i++) {
  379. String drv_name = DisplayServer::get_singleton()->tablet_get_driver_name(i);
  380. if (EditorPropertyNameProcessor::get_singleton()) {
  381. drv_name = EditorPropertyNameProcessor::get_singleton()->process_name(drv_name, EditorPropertyNameProcessor::STYLE_CAPITALIZED); // Note: EditorPropertyNameProcessor is not available when doctool is used, but this value is not part of docs.
  382. }
  383. tablet_hints += vformat(",%s:%d", drv_name, i);
  384. }
  385. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/tablet_driver", -1, tablet_hints);
  386. #else
  387. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/tablet_driver", -1, "Default:-1");
  388. #endif
  389. String project_manager_screen_hints = "Screen With Mouse Pointer:-4,Screen With Keyboard Focus:-3,Primary Screen:-2";
  390. for (int i = 0; i < DisplayServer::get_singleton()->get_screen_count(); i++) {
  391. project_manager_screen_hints += ",Screen " + itos(i + 1) + ":" + itos(i);
  392. }
  393. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/project_manager_screen", EditorSettings::InitialScreen::INITIAL_SCREEN_PRIMARY, project_manager_screen_hints)
  394. {
  395. EngineUpdateLabel::UpdateMode default_update_mode = EngineUpdateLabel::UpdateMode::NEWEST_UNSTABLE;
  396. if (String(GODOT_VERSION_STATUS) == String("stable")) {
  397. default_update_mode = EngineUpdateLabel::UpdateMode::NEWEST_STABLE;
  398. }
  399. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "network/connection/check_for_updates", int(default_update_mode), "Disable Update Checks,Check Newest Preview,Check Newest Stable,Check Newest Patch"); // Uses EngineUpdateLabel::UpdateMode.
  400. }
  401. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/use_embedded_menu", false, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  402. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/use_native_file_dialogs", false, "", PROPERTY_USAGE_DEFAULT)
  403. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/expand_to_title", true, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  404. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "interface/editor/main_font_size", 14, "8,48,1")
  405. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "interface/editor/code_font_size", 14, "8,48,1")
  406. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/code_font_contextual_ligatures", 1, "Enabled,Disable Contextual Alternates (Coding Ligatures),Use Custom OpenType Feature Set")
  407. _initial_set("interface/editor/code_font_custom_opentype_features", "");
  408. _initial_set("interface/editor/code_font_custom_variations", "");
  409. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/font_antialiasing", 1, "None,Grayscale,LCD Subpixel")
  410. #ifdef MACOS_ENABLED
  411. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/font_hinting", 0, "Auto (None),None,Light,Normal")
  412. #else
  413. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/font_hinting", 0, "Auto (Light),None,Light,Normal")
  414. #endif
  415. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/font_subpixel_positioning", 1, "Disabled,Auto,One Half of a Pixel,One Quarter of a Pixel")
  416. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/font_disable_embedded_bitmaps", true, "");
  417. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/font_allow_msdf", true, "")
  418. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "interface/editor/main_font", "", "*.ttf,*.otf,*.woff,*.woff2,*.pfb,*.pfm")
  419. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "interface/editor/main_font_bold", "", "*.ttf,*.otf,*.woff,*.woff2,*.pfb,*.pfm")
  420. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "interface/editor/code_font", "", "*.ttf,*.otf,*.woff,*.woff2,*.pfb,*.pfm")
  421. _initial_set("interface/editor/separate_distraction_mode", false, true);
  422. _initial_set("interface/editor/automatically_open_screenshots", true, true);
  423. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/single_window_mode", false, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  424. _initial_set("interface/editor/mouse_extra_buttons_navigate_history", true);
  425. _initial_set("interface/editor/save_each_scene_on_quit", true, true); // Regression
  426. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/save_on_focus_loss", false, "")
  427. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/accept_dialog_cancel_ok_buttons", 0,
  428. vformat("Auto (%s),Cancel First,OK First", DisplayServer::get_singleton()->get_swap_cancel_ok() ? "OK First" : "Cancel First"),
  429. PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED);
  430. #ifdef DEV_ENABLED
  431. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/show_internal_errors_in_toast_notifications", 0, "Auto (Enabled),Enabled,Disabled")
  432. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/show_update_spinner", 0, "Auto (Enabled),Enabled,Disabled")
  433. #else
  434. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/show_internal_errors_in_toast_notifications", 0, "Auto (Disabled),Enabled,Disabled")
  435. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/show_update_spinner", 0, "Auto (Disabled),Enabled,Disabled")
  436. #endif
  437. _initial_set("interface/editor/keep_screen_on", false, true);
  438. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "interface/editor/low_processor_mode_sleep_usec", 6900, "1,100000,1", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  439. // Default unfocused usec sleep is for 10 FPS. Allow an unfocused FPS limit
  440. // as low as 1 FPS for those who really need low power usage (but don't need
  441. // to preview particles or shaders while the editor is unfocused). With very
  442. // low FPS limits, the editor can take a small while to become usable after
  443. // being focused again, so this should be used at the user's discretion.
  444. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "interface/editor/unfocused_low_processor_mode_sleep_usec", 100000, "1,1000000,1", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  445. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/import_resources_when_unfocused", false, "")
  446. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/editor/vsync_mode", 1, "Disabled,Enabled,Adaptive,Mailbox")
  447. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/update_continuously", false, "")
  448. bool is_android_editor = false;
  449. #ifdef ANDROID_ENABLED
  450. if (!OS::get_singleton()->has_feature("xr_editor")) {
  451. is_android_editor = true;
  452. }
  453. #endif
  454. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/editor/collapse_main_menu", is_android_editor, "")
  455. _initial_set("interface/editors/show_scene_tree_root_selection", true);
  456. _initial_set("interface/editors/derive_script_globals_by_name", true);
  457. _initial_set("docks/scene_tree/ask_before_revoking_unique_name", true);
  458. // Inspector
  459. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "interface/inspector/max_array_dictionary_items_per_page", 20, "10,100,1")
  460. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/show_low_level_opentype_features", false, "")
  461. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/inspector/float_drag_speed", 5.0, "0.1,100,0.01")
  462. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/inspector/nested_color_mode", 0, "Containers & Resources,Resources,External Resources")
  463. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/delimitate_all_container_and_resources", true, "")
  464. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_ENUM, "interface/inspector/default_property_name_style", EditorPropertyNameProcessor::STYLE_CAPITALIZED, "Raw (e.g. \"z_index\"),Capitalized (e.g. \"Z Index\"),Localized (e.g. \"Z Index\")", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED);
  465. // The lowest value is equal to the minimum float step for 32-bit floats.
  466. // The step must be set manually, as changing this setting should not change the step here.
  467. EDITOR_SETTING_USAGE(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/inspector/default_float_step", 0.001, "0.0000001,1,0.0000001", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING);
  468. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/disable_folding", false, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED);
  469. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/auto_unfold_foreign_scenes", true, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  470. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/horizontal_vector2_editing", false, "")
  471. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/horizontal_vector_types_editing", true, "")
  472. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/open_resources_in_current_inspector", true, "")
  473. PackedStringArray open_in_new_inspector_defaults;
  474. // Required for the script editor to work.
  475. open_in_new_inspector_defaults.push_back("Script");
  476. // Required for the GridMap editor to work.
  477. open_in_new_inspector_defaults.push_back("MeshLibrary");
  478. _initial_set("interface/inspector/resources_to_open_in_new_inspector", open_in_new_inspector_defaults);
  479. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/inspector/default_color_picker_mode", (int32_t)ColorPicker::MODE_RGB, "RGB,HSV,RAW,OKHSL")
  480. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/inspector/default_color_picker_shape", (int32_t)ColorPicker::SHAPE_OKHSL_CIRCLE, "HSV Rectangle,HSV Rectangle Wheel,VHS Circle,OKHSL Circle")
  481. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/inspector/color_picker_show_intensity", true, "");
  482. // Theme
  483. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_ENUM, "interface/theme/follow_system_theme", false, "")
  484. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_ENUM, "interface/theme/preset", "Default", "Default,Breeze Dark,Godot 2,Gray,Light,Solarized (Dark),Solarized (Light),Black (OLED),Custom")
  485. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_ENUM, "interface/theme/spacing_preset", "Default", "Compact,Default,Spacious,Custom")
  486. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/theme/icon_and_font_color", 0, "Auto,Dark,Light")
  487. EDITOR_SETTING_BASIC(Variant::COLOR, PROPERTY_HINT_NONE, "interface/theme/base_color", Color(0.2, 0.23, 0.31), "")
  488. EDITOR_SETTING_BASIC(Variant::COLOR, PROPERTY_HINT_NONE, "interface/theme/accent_color", Color(0.41, 0.61, 0.91), "")
  489. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/theme/use_system_accent_color", false, "")
  490. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/theme/contrast", 0.3, "-1,1,0.01")
  491. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/theme/draw_extra_borders", false, "")
  492. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/theme/icon_saturation", 1.0, "0,2,0.01")
  493. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/theme/relationship_line_opacity", 0.1, "0.00,1,0.01")
  494. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "interface/theme/border_size", 0, "0,2,1")
  495. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "interface/theme/corner_radius", 3, "0,6,1")
  496. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "interface/theme/base_spacing", 4, "0,8,1")
  497. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "interface/theme/additional_spacing", 0, "0,8,1")
  498. EDITOR_SETTING_USAGE(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "interface/theme/custom_theme", "", "*.res,*.tres,*.theme", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  499. // Touchscreen
  500. bool has_touchscreen_ui = DisplayServer::get_singleton()->is_touchscreen_available();
  501. bool is_native_touchscreen = has_touchscreen_ui && !OS::get_singleton()->has_feature("xr_editor"); // Disable some touchscreen settings by default for the XR Editor.
  502. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/touchscreen/enable_touch_optimizations", is_native_touchscreen, "")
  503. set_restart_if_changed("interface/touchscreen/enable_touch_optimizations", true);
  504. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/touchscreen/enable_long_press_as_right_click", is_native_touchscreen, "")
  505. set_restart_if_changed("interface/touchscreen/enable_long_press_as_right_click", true);
  506. EDITOR_SETTING(Variant::BOOL, PROPERTY_HINT_NONE, "interface/touchscreen/enable_pan_and_scale_gestures", has_touchscreen_ui, "")
  507. set_restart_if_changed("interface/touchscreen/enable_pan_and_scale_gestures", true);
  508. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "interface/touchscreen/scale_gizmo_handles", has_touchscreen_ui ? 3 : 1, "1,5,1")
  509. set_restart_if_changed("interface/touchscreen/scale_gizmo_handles", true);
  510. // Only available in the Android/XR editor.
  511. String touch_actions_panel_hints = "Disabled:0,Embedded Panel:1,Floating Panel:2";
  512. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "interface/touchscreen/touch_actions_panel", 1, touch_actions_panel_hints)
  513. // Scene tabs
  514. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "interface/scene_tabs/display_close_button", 1, "Never,If Tab Active,Always"); // TabBar::CloseButtonDisplayPolicy
  515. _initial_set("interface/scene_tabs/show_thumbnail_on_hover", true);
  516. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "interface/scene_tabs/maximum_width", 350, "0,9999,1", PROPERTY_USAGE_DEFAULT)
  517. _initial_set("interface/scene_tabs/show_script_button", false, true);
  518. _initial_set("interface/scene_tabs/restore_scenes_on_load", true, true);
  519. // Multi Window
  520. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/multi_window/enable", true, "");
  521. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/multi_window/restore_windows_on_load", true, "");
  522. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "interface/multi_window/maximize_window", false, "");
  523. set_restart_if_changed("interface/multi_window/enable", true);
  524. /* Filesystem */
  525. // External Programs
  526. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/external_programs/raster_image_editor", "", "")
  527. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/external_programs/vector_image_editor", "", "")
  528. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/external_programs/audio_editor", "", "")
  529. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/external_programs/3d_model_editor", "", "")
  530. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/external_programs/terminal_emulator", "", "")
  531. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_PLACEHOLDER_TEXT, "filesystem/external_programs/terminal_emulator_flags", "", "Call flags with placeholder: {directory}.");
  532. // Directories
  533. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_GLOBAL_DIR, "filesystem/directories/autoscan_project_path", "", "")
  534. 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);
  535. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_GLOBAL_DIR, "filesystem/directories/default_project_path", fs_dir_default_project_path, "")
  536. // On save
  537. _initial_set("filesystem/on_save/compress_binary_resources", true);
  538. _initial_set("filesystem/on_save/safe_save_on_backup_then_rename", true);
  539. // EditorFileServer
  540. _initial_set("filesystem/file_server/port", 6010);
  541. _initial_set("filesystem/file_server/password", "");
  542. // File dialog
  543. _initial_set("filesystem/file_dialog/show_hidden_files", false);
  544. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "filesystem/file_dialog/display_mode", 0, "Thumbnails,List")
  545. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "filesystem/file_dialog/thumbnail_size", 64, "32,128,16")
  546. // Quick Open dialog
  547. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "filesystem/quick_open_dialog/max_results", 100, "0,10000,1", PROPERTY_USAGE_DEFAULT)
  548. _initial_set("filesystem/quick_open_dialog/show_search_highlight", true);
  549. _initial_set("filesystem/quick_open_dialog/enable_fuzzy_matching", true);
  550. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "filesystem/quick_open_dialog/max_fuzzy_misses", 2, "0,10,1", PROPERTY_USAGE_DEFAULT)
  551. _initial_set("filesystem/quick_open_dialog/include_addons", false);
  552. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "filesystem/quick_open_dialog/default_display_mode", 0, "Adaptive,Last Used")
  553. // Import (for glft module)
  554. EDITOR_SETTING_USAGE(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/import/blender/blender_path", "", "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  555. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "filesystem/import/blender/rpc_port", 6011, "0,65535,1", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  556. EDITOR_SETTING_USAGE(Variant::FLOAT, PROPERTY_HINT_RANGE, "filesystem/import/blender/rpc_server_uptime", 5, "0,300,1,or_greater,suffix:s", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  557. EDITOR_SETTING_USAGE(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "filesystem/import/fbx/fbx2gltf_path", "", "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  558. // Tools (denoise)
  559. EDITOR_SETTING_USAGE(Variant::STRING, PROPERTY_HINT_GLOBAL_DIR, "filesystem/tools/oidn/oidn_denoise_path", "", "", PROPERTY_USAGE_DEFAULT)
  560. /* Docks */
  561. // SceneTree
  562. _initial_set("docks/scene_tree/ask_before_deleting_related_animation_tracks", true);
  563. _initial_set("docks/scene_tree/start_create_dialog_fully_expanded", false);
  564. _initial_set("docks/scene_tree/auto_expand_to_selected", true);
  565. _initial_set("docks/scene_tree/center_node_on_reparent", false);
  566. _initial_set("docks/scene_tree/hide_filtered_out_parents", true);
  567. _initial_set("docks/scene_tree/accessibility_warnings", false);
  568. // FileSystem
  569. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "docks/filesystem/thumbnail_size", 64, "32,128,16")
  570. _initial_set("docks/filesystem/always_show_folders", true);
  571. _initial_set("docks/filesystem/textfile_extensions", "txt,md,cfg,ini,log,json,yml,yaml,toml,xml");
  572. _initial_set("docks/filesystem/other_file_extensions", "ico,icns");
  573. // Property editor
  574. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "docks/property_editor/auto_refresh_interval", 0.2, "0.01,1,0.001"); // Update 5 times per second by default.
  575. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "docks/property_editor/subresource_hue_tint", 0.75, "0,1,0.01")
  576. /* Text editor */
  577. // Theme
  578. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_ENUM, "text_editor/theme/color_theme", "Default", "Default,Godot 2,Custom")
  579. // Theme: Highlighting
  580. _load_godot2_text_editor_theme();
  581. // Appearance
  582. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "text_editor/appearance/enable_inline_color_picker", true, "");
  583. // Appearance: Caret
  584. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/appearance/caret/type", 0, "Line,Block")
  585. _initial_set("text_editor/appearance/caret/caret_blink", true, true);
  586. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "text_editor/appearance/caret/caret_blink_interval", 0.5, "0.1,10,0.01")
  587. _initial_set("text_editor/appearance/caret/highlight_current_line", true, true);
  588. _initial_set("text_editor/appearance/caret/highlight_all_occurrences", true, true);
  589. // Appearance: Guidelines
  590. _initial_set("text_editor/appearance/guidelines/show_line_length_guidelines", true, true);
  591. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/appearance/guidelines/line_length_guideline_soft_column", 80, "20,160,1")
  592. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/appearance/guidelines/line_length_guideline_hard_column", 100, "20,160,1")
  593. // Appearance: Gutters
  594. _initial_set("text_editor/appearance/gutters/show_line_numbers", true, true);
  595. _initial_set("text_editor/appearance/gutters/line_numbers_zero_padded", false, true);
  596. _initial_set("text_editor/appearance/gutters/highlight_type_safe_lines", true, true);
  597. _initial_set("text_editor/appearance/gutters/show_info_gutter", true, true);
  598. // Appearance: Minimap
  599. _initial_set("text_editor/appearance/minimap/show_minimap", true, true);
  600. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/appearance/minimap/minimap_width", 80, "50,250,1")
  601. // Appearance: Lines
  602. _initial_set("text_editor/appearance/lines/code_folding", true, true);
  603. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/appearance/lines/word_wrap", 0, "None,Boundary")
  604. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/appearance/lines/autowrap_mode", 3, "Arbitrary:1,Word:2,Word (Smart):3")
  605. // Appearance: Whitespace
  606. _initial_set("text_editor/appearance/whitespace/draw_tabs", true, true);
  607. _initial_set("text_editor/appearance/whitespace/draw_spaces", false, true);
  608. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/appearance/whitespace/line_spacing", 4, "0,50,1")
  609. // Behavior
  610. // Behavior: General
  611. _initial_set("text_editor/behavior/general/empty_selection_clipboard", true);
  612. // Behavior: Navigation
  613. _initial_set("text_editor/behavior/navigation/move_caret_on_right_click", true, true);
  614. _initial_set("text_editor/behavior/navigation/scroll_past_end_of_file", false, true);
  615. _initial_set("text_editor/behavior/navigation/smooth_scrolling", true, true);
  616. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/behavior/navigation/v_scroll_speed", 80, "1,10000,1")
  617. _initial_set("text_editor/behavior/navigation/drag_and_drop_selection", true, true);
  618. _initial_set("text_editor/behavior/navigation/stay_in_script_editor_on_node_selected", true, true);
  619. _initial_set("text_editor/behavior/navigation/open_script_when_connecting_signal_to_existing_method", true, true);
  620. _initial_set("text_editor/behavior/navigation/use_default_word_separators", true); // Includes ´`~$^=+|<> General punctuation and CJK punctuation.
  621. _initial_set("text_editor/behavior/navigation/use_custom_word_separators", false);
  622. _initial_set("text_editor/behavior/navigation/custom_word_separators", ""); // Custom word separators.
  623. // Behavior: Indent
  624. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/behavior/indent/type", 0, "Tabs,Spaces")
  625. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/behavior/indent/size", 4, "1,64,1") // size of 0 crashes.
  626. _initial_set("text_editor/behavior/indent/auto_indent", true);
  627. _initial_set("text_editor/behavior/indent/indent_wrapped_lines", true);
  628. // Behavior: Files
  629. _initial_set("text_editor/behavior/files/trim_trailing_whitespace_on_save", false);
  630. _initial_set("text_editor/behavior/files/trim_final_newlines_on_save", true);
  631. _initial_set("text_editor/behavior/files/autosave_interval_secs", 0);
  632. _initial_set("text_editor/behavior/files/restore_scripts_on_load", true);
  633. _initial_set("text_editor/behavior/files/convert_indent_on_save", true);
  634. _initial_set("text_editor/behavior/files/auto_reload_scripts_on_external_change", true);
  635. _initial_set("text_editor/behavior/files/auto_reload_and_parse_scripts_on_save", true);
  636. _initial_set("text_editor/behavior/files/open_dominant_script_on_scene_change", false, true);
  637. _initial_set("text_editor/behavior/files/drop_preload_resources_as_uid", true, true);
  638. // Behavior: Documentation
  639. _initial_set("text_editor/behavior/documentation/enable_tooltips", true, true);
  640. // Script list
  641. _initial_set("text_editor/script_list/show_members_overview", true, true);
  642. _initial_set("text_editor/script_list/sort_members_outline_alphabetically", false, true);
  643. _initial_set("text_editor/script_list/script_temperature_enabled", true);
  644. _initial_set("text_editor/script_list/script_temperature_history_size", 15);
  645. _initial_set("text_editor/script_list/highlight_scene_scripts", true);
  646. _initial_set("text_editor/script_list/group_help_pages", true);
  647. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/script_list/sort_scripts_by", 0, "Name,Path,None");
  648. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/script_list/list_script_names_as", 0, "Name,Parent Directory And Name,Full Path");
  649. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "text_editor/external/exec_path", "", "");
  650. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_PLACEHOLDER_TEXT, "text_editor/external/exec_flags", "{file}", "Call flags with placeholders: {project}, {file}, {col}, {line}.");
  651. // Completion
  652. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "text_editor/completion/idle_parse_delay", 1.5, "0.1,10,0.01")
  653. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "text_editor/completion/idle_parse_delay_with_errors_found", 0.5, "0.1,5,0.01")
  654. _initial_set("text_editor/completion/auto_brace_complete", true, true);
  655. _initial_set("text_editor/completion/code_complete_enabled", true, true);
  656. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "text_editor/completion/code_complete_delay", 0.3, "0.01,5,0.01,or_greater")
  657. _initial_set("text_editor/completion/put_callhint_tooltip_below_current_line", true);
  658. _initial_set("text_editor/completion/complete_file_paths", true);
  659. _initial_set("text_editor/completion/add_type_hints", true, true);
  660. _initial_set("text_editor/completion/add_string_name_literals", false, true);
  661. _initial_set("text_editor/completion/add_node_path_literals", false, true);
  662. _initial_set("text_editor/completion/use_single_quotes", false, true);
  663. _initial_set("text_editor/completion/colorize_suggestions", true);
  664. // External editor (ScriptEditorPlugin)
  665. _initial_set("text_editor/external/use_external_editor", false, true);
  666. _initial_set("text_editor/external/exec_path", "");
  667. // Help
  668. _initial_set("text_editor/help/show_help_index", true);
  669. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/help/help_font_size", 16, "8,48,1")
  670. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/help/help_source_font_size", 15, "8,48,1")
  671. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "text_editor/help/help_title_font_size", 23, "8,64,1")
  672. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "text_editor/help/class_reference_examples", 0, "GDScript,C#,GDScript and C#")
  673. _initial_set("text_editor/help/sort_functions_alphabetically", true);
  674. /* Editors */
  675. // GridMap
  676. // GridMapEditor
  677. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/grid_map/pick_distance", 5000.0, "1,8192,0.1,or_greater");
  678. EDITOR_SETTING_USAGE(Variant::INT, PROPERTY_HINT_RANGE, "editors/grid_map/palette_min_width", 230, "100,500,1", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED);
  679. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "editors/grid_map/preview_size", 64, "16,128,1")
  680. // 3D
  681. EDITOR_SETTING_BASIC(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d/primary_grid_color", Color(0.56, 0.56, 0.56, 0.5), "")
  682. EDITOR_SETTING_BASIC(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d/secondary_grid_color", Color(0.38, 0.38, 0.38, 0.5), "")
  683. // Use a similar color to the 2D editor selection.
  684. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d/selection_box_color", Color(1.0, 0.5, 0), "", PROPERTY_USAGE_DEFAULT)
  685. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d/active_selection_box_color", Color(1.5, 0.75, 0, 1.0), "", PROPERTY_USAGE_DEFAULT)
  686. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/instantiated", Color(0.7, 0.7, 0.7, 0.6), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  687. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/joint", Color(0.5, 0.8, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  688. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/aabb", Color(0.28, 0.8, 0.82), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  689. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/stream_player_3d", Color(0.4, 0.8, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  690. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/camera", Color(0.8, 0.4, 0.8), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  691. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/decal", Color(0.6, 0.5, 1.0), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  692. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/fog_volume", Color(0.5, 0.7, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  693. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/particles", Color(0.8, 0.7, 0.4), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  694. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/particle_attractor", Color(1, 0.7, 0.5), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  695. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/particle_collision", Color(0.5, 0.7, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  696. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/joint_body_a", Color(0.6, 0.8, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  697. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/joint_body_b", Color(0.6, 0.9, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  698. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/lightmap_lines", Color(0.5, 0.6, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  699. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/lightprobe_lines", Color(0.5, 0.6, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  700. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/occluder", Color(0.8, 0.5, 1), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  701. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/reflection_probe", Color(0.6, 1, 0.5), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  702. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/visibility_notifier", Color(0.8, 0.5, 0.7), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  703. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/voxel_gi", Color(0.5, 1, 0.6), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  704. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/path_tilt", Color(1.0, 1.0, 0.4, 0.9), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  705. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/skeleton", Color(1, 0.8, 0.4), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  706. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/selected_bone", Color(0.8, 0.3, 0.0), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  707. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/csg", Color(0.0, 0.4, 1, 0.15), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  708. EDITOR_SETTING(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/gridmap_grid", Color(0.8, 0.5, 0.1), "")
  709. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/spring_bone_joint", Color(0.8, 0.9, 0.6), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  710. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/spring_bone_collision", Color(0.6, 0.8, 0.9), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  711. EDITOR_SETTING_USAGE(Variant::COLOR, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_colors/spring_bone_inside_collision", Color(0.9, 0.6, 0.8), "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  712. _initial_set("editors/3d_gizmos/gizmo_settings/bone_axis_length", (float)0.1);
  713. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d_gizmos/gizmo_settings/bone_shape", 1, "Wire,Octahedron");
  714. EDITOR_SETTING_USAGE(Variant::FLOAT, PROPERTY_HINT_NONE, "editors/3d_gizmos/gizmo_settings/path3d_tilt_disk_size", 0.8, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  715. // If a line is a multiple of this, it uses the primary grid color.
  716. // Use a power of 2 value by default as it's more common to use powers of 2 in level design.
  717. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "editors/3d/primary_grid_steps", 8, "1,100,1")
  718. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "editors/3d/grid_size", 200, "1,2000,1")
  719. // Higher values produce graphical artifacts when far away unless View Z-Far
  720. // is increased significantly more than it really should need to be.
  721. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "editors/3d/grid_division_level_max", 2, "-1,3,1")
  722. // Lower values produce graphical artifacts regardless of view clipping planes, so limit to -2 as a lower bound.
  723. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "editors/3d/grid_division_level_min", 0, "-2,2,1")
  724. // -0.2 seems like a sensible default. -1.0 gives Blender-like behavior, 0.5 gives huge grids.
  725. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/grid_division_level_bias", -0.2, "-1.0,0.5,0.1")
  726. _initial_set("editors/3d/grid_xz_plane", true);
  727. _initial_set("editors/3d/grid_xy_plane", false);
  728. _initial_set("editors/3d/grid_yz_plane", false);
  729. // Use a lower default FOV for the 3D camera compared to the
  730. // Camera3D node as the 3D viewport doesn't span the whole screen.
  731. // This means it's technically viewed from a further distance, which warrants a narrower FOV.
  732. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/default_fov", 70.0, "1,179,0.1,degrees")
  733. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/default_z_near", 0.05, "0.01,10,0.01,or_greater,suffix:m")
  734. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/default_z_far", 4000.0, "0.1,4000,0.1,or_greater,suffix:m")
  735. // 3D: Navigation
  736. _initial_set("editors/3d/navigation/invert_x_axis", false, true);
  737. _initial_set("editors/3d/navigation/invert_y_axis", false, true);
  738. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/navigation/navigation_scheme", 0, "Godot:0,Maya:1,Modo:2,Tablet/Trackpad:4,Custom:3")
  739. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/navigation/orbit_mouse_button", 1, "Left Mouse,Middle Mouse,Right Mouse,Mouse Button 4,Mouse Button 5")
  740. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/navigation/pan_mouse_button", 1, "Left Mouse,Middle Mouse,Right Mouse,Mouse Button 4,Mouse Button 5")
  741. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/navigation/zoom_mouse_button", 1, "Left Mouse,Middle Mouse,Right Mouse,Mouse Button 4,Mouse Button 5")
  742. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/navigation/zoom_style", 0, "Vertical,Horizontal")
  743. _initial_set("editors/3d/navigation/emulate_numpad", true, true);
  744. _initial_set("editors/3d/navigation/emulate_3_button_mouse", false, true);
  745. _initial_set("editors/3d/navigation/warped_mouse_panning", true, true);
  746. // 3D: Navigation feel
  747. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/navigation_feel/orbit_sensitivity", 0.25, "0.01,20,0.001")
  748. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/navigation_feel/translation_sensitivity", 1.0, "0.01,20,0.001")
  749. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/navigation_feel/orbit_inertia", 0.0, "0,1,0.001")
  750. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/navigation_feel/translation_inertia", 0.05, "0,1,0.001")
  751. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/navigation_feel/zoom_inertia", 0.05, "0,1,0.001")
  752. _initial_set("editors/3d/navigation/show_viewport_rotation_gizmo", true);
  753. _initial_set("editors/3d/navigation/show_viewport_navigation_gizmo", DisplayServer::get_singleton()->is_touchscreen_available());
  754. // 3D: Freelook
  755. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/freelook/freelook_navigation_scheme", 0, "Default,Partially Axis-Locked (id Tech),Fully Axis-Locked (Minecraft)")
  756. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/freelook/freelook_sensitivity", 0.25, "0.01,2,0.001")
  757. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/freelook/freelook_inertia", 0.0, "0,1,0.001")
  758. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/freelook/freelook_base_speed", 5.0, "0,10,0.01,or_greater")
  759. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/3d/freelook/freelook_activation_modifier", 0, "None,Shift,Alt,Meta,Ctrl")
  760. _initial_set("editors/3d/freelook/freelook_speed_zoom_link", false);
  761. // 3D: Manipulator
  762. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "editors/3d/manipulator_gizmo_size", 80, "16,160,1");
  763. EDITOR_SETTING_USAGE(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/3d/manipulator_gizmo_opacity", 0.9, "0,1,0.01", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED)
  764. // 2D
  765. _initial_set("editors/2d/grid_color", Color(1.0, 1.0, 1.0, 0.07), true);
  766. _initial_set("editors/2d/guides_color", Color(0.6, 0.0, 0.8), true);
  767. _initial_set("editors/2d/smart_snapping_line_color", Color(0.9, 0.1, 0.1), true);
  768. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/2d/bone_width", 5.0, "0.01,20,0.01,or_greater")
  769. _initial_set("editors/2d/bone_color1", Color(1.0, 1.0, 1.0, 0.7));
  770. _initial_set("editors/2d/bone_color2", Color(0.6, 0.6, 0.6, 0.7));
  771. _initial_set("editors/2d/bone_selected_color", Color(0.9, 0.45, 0.45, 0.7));
  772. _initial_set("editors/2d/bone_ik_color", Color(0.9, 0.9, 0.45, 0.7));
  773. _initial_set("editors/2d/bone_outline_color", Color(0.35, 0.35, 0.35, 0.5));
  774. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/2d/bone_outline_size", 2.0, "0.01,8,0.01,or_greater")
  775. _initial_set("editors/2d/viewport_border_color", Color(0.4, 0.4, 1.0, 0.4), true);
  776. _initial_set("editors/2d/use_integer_zoom_by_default", false, true);
  777. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/2d/zoom_speed_factor", 1.1, "1.01,2,0.01")
  778. EDITOR_SETTING_BASIC(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/2d/ruler_width", 16.0, "12.0,30.0,1.0")
  779. // Bone mapper (BoneMapEditorPlugin)
  780. _initial_set("editors/bone_mapper/handle_colors/unset", Color(0.3, 0.3, 0.3));
  781. _initial_set("editors/bone_mapper/handle_colors/set", Color(0.1, 0.6, 0.25));
  782. _initial_set("editors/bone_mapper/handle_colors/missing", Color(0.8, 0.2, 0.8));
  783. _initial_set("editors/bone_mapper/handle_colors/error", Color(0.8, 0.2, 0.2));
  784. // Panning
  785. // Enum should be in sync with ControlScheme in ViewPanner.
  786. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/panning/2d_editor_panning_scheme", 0, "Scroll Zooms,Scroll Pans");
  787. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/panning/sub_editors_panning_scheme", 0, "Scroll Zooms,Scroll Pans");
  788. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/panning/animation_editors_panning_scheme", 1, "Scroll Zooms,Scroll Pans");
  789. _initial_set("editors/panning/simple_panning", false);
  790. _initial_set("editors/panning/warped_mouse_panning", true);
  791. _initial_set("editors/panning/2d_editor_pan_speed", 20, true);
  792. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "editors/panning/zoom_style", 0, "Vertical,Horizontal");
  793. // Tiles editor
  794. _initial_set("editors/tiles_editor/display_grid", true);
  795. _initial_set("editors/tiles_editor/highlight_selected_layer", true);
  796. _initial_set("editors/tiles_editor/grid_color", Color(1.0, 0.5, 0.2, 0.5));
  797. // Polygon editor
  798. _initial_set("editors/polygon_editor/point_grab_radius", has_touchscreen_ui ? 32 : 8);
  799. _initial_set("editors/polygon_editor/show_previous_outline", true);
  800. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/polygon_editor/auto_bake_delay", 1.5, "-1.0,10.0,0.01");
  801. // Animation
  802. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/animation/default_animation_step", Animation::DEFAULT_STEP, "0.0,10.0,0.00000001");
  803. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "editors/animation/default_fps_mode", 0, "Seconds,FPS");
  804. _initial_set("editors/animation/default_fps_compatibility", true);
  805. _initial_set("editors/animation/autorename_animation_tracks", true);
  806. _initial_set("editors/animation/confirm_insert_track", true, true);
  807. _initial_set("editors/animation/default_create_bezier_tracks", false, true);
  808. _initial_set("editors/animation/default_create_reset_tracks", true, true);
  809. _initial_set("editors/animation/onion_layers_past_color", Color(1, 0, 0));
  810. _initial_set("editors/animation/onion_layers_future_color", Color(0, 1, 0));
  811. // Shader editor
  812. _initial_set("editors/shader_editor/behavior/files/restore_shaders_on_load", true, true);
  813. // Visual editors
  814. EDITOR_SETTING(Variant::STRING, PROPERTY_HINT_ENUM, "editors/visual_editors/color_theme", "Default", "Default,Legacy,Custom")
  815. _load_default_visual_shader_editor_theme();
  816. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/visual_editors/minimap_opacity", 0.85, "0.0,1.0,0.01")
  817. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "editors/visual_editors/lines_curvature", 0.5, "0.0,1.0,0.01")
  818. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "editors/visual_editors/grid_pattern", 1, "Lines,Dots")
  819. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "editors/visual_editors/visual_shader/port_preview_size", 160, "100,400,0.01")
  820. // Export (EditorExportPlugin)
  821. _initial_set("export/ssh/ssh", "");
  822. _initial_set("export/ssh/scp", "");
  823. /* Run */
  824. // Window placement
  825. #ifndef ANDROID_ENABLED
  826. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "run/window_placement/rect", 1, "Top Left,Centered,Custom Position,Force Maximized,Force Fullscreen")
  827. // Keep the enum values in sync with the `DisplayServer::SCREEN_` enum.
  828. String screen_hints = "Same as Editor:-5,Previous Screen:-4,Next Screen:-3,Primary Screen:-2"; // Note: Main Window Screen:-1 is not used for the main window.
  829. for (int i = 0; i < DisplayServer::get_singleton()->get_screen_count(); i++) {
  830. screen_hints += ",Screen " + itos(i + 1) + ":" + itos(i);
  831. }
  832. _initial_set("run/window_placement/rect_custom_position", Vector2());
  833. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "run/window_placement/screen", -5, screen_hints)
  834. #endif
  835. // Should match the ANDROID_WINDOW_* constants in 'platform/android/java/editor/src/main/java/org/godotengine/editor/BaseGodotEditor.kt'.
  836. String android_window_hints = "Auto (based on screen size):0,Same as Editor:1,Side-by-side with Editor:2";
  837. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "run/window_placement/android_window", 0, android_window_hints)
  838. String game_embed_mode_hints = "Disabled:-1,Use Per-Project Configuration:0,Embed Game:1,Make Game Workspace Floating:2";
  839. #ifdef ANDROID_ENABLED
  840. if (OS::get_singleton()->has_feature("xr_editor")) {
  841. game_embed_mode_hints = "Disabled:-1";
  842. } else {
  843. game_embed_mode_hints = "Disabled:-1,Auto (based on screen size):0,Enabled:1";
  844. }
  845. #endif
  846. int default_game_embed_mode = OS::get_singleton()->has_feature("xr_editor") ? -1 : 0;
  847. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "run/window_placement/game_embed_mode", default_game_embed_mode, game_embed_mode_hints);
  848. // Auto save
  849. _initial_set("run/auto_save/save_before_running", true, true);
  850. // Bottom panel
  851. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "run/bottom_panel/action_on_play", EditorNode::ACTION_ON_PLAY_OPEN_OUTPUT, "Do Nothing,Open Output,Open Debugger")
  852. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "run/bottom_panel/action_on_stop", EditorNode::ACTION_ON_STOP_DO_NOTHING, "Do Nothing,Close Bottom Panel")
  853. // Output
  854. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_RANGE, "run/output/font_size", 13, "8,48,1")
  855. _initial_set("run/output/always_clear_output_on_play", true, true);
  856. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "run/output/max_lines", 10000, "100,100000,1")
  857. // Platform
  858. _initial_set("run/platforms/linuxbsd/prefer_wayland", false, true);
  859. set_restart_if_changed("run/platforms/linuxbsd/prefer_wayland", true);
  860. /* Network */
  861. // General
  862. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "network/connection/network_mode", 0, "Offline,Online");
  863. // HTTP Proxy
  864. _initial_set("network/http_proxy/host", "");
  865. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "network/http_proxy/port", 8080, "1,65535,1")
  866. // SSL
  867. EDITOR_SETTING_USAGE(Variant::STRING, PROPERTY_HINT_GLOBAL_FILE, "network/tls/editor_tls_certificates", _SYSTEM_CERTS_PATH, "*.crt,*.pem", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED);
  868. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "network/tls/enable_tls_v1.3", true, "")
  869. // Debug
  870. _initial_set("network/debug/remote_host", "127.0.0.1"); // Hints provided in setup_network
  871. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "network/debug/remote_port", 6007, "1,65535,1")
  872. /* Debugger/profiler */
  873. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "debugger/auto_switch_to_remote_scene_tree", false, "")
  874. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "debugger/auto_switch_to_stack_trace", true, "")
  875. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "debugger/max_node_selection", 20, "1,100,1")
  876. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "debugger/profiler_frame_history_size", 3600, "60,10000,1")
  877. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "debugger/profiler_frame_max_functions", 64, "16,512,1")
  878. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_RANGE, "debugger/profiler_target_fps", 60, "1,1000,1")
  879. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "debugger/remote_scene_tree_refresh_interval", 1.0, "0.1,10,0.01,or_greater")
  880. EDITOR_SETTING(Variant::FLOAT, PROPERTY_HINT_RANGE, "debugger/remote_inspect_refresh_interval", 0.2, "0.02,10,0.01,or_greater")
  881. EDITOR_SETTING_BASIC(Variant::BOOL, PROPERTY_HINT_NONE, "debugger/profile_native_calls", false, "")
  882. // Version control (VersionControlEditorPlugin)
  883. _initial_set("version_control/username", "", true);
  884. _initial_set("version_control/ssh_public_key_path", "");
  885. _initial_set("version_control/ssh_private_key_path", "");
  886. /* Extra config */
  887. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "input/buffering/agile_event_flushing", false, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  888. EDITOR_SETTING_USAGE(Variant::BOOL, PROPERTY_HINT_NONE, "input/buffering/use_accumulated_input", true, "", PROPERTY_USAGE_DEFAULT | PROPERTY_USAGE_RESTART_IF_CHANGED | PROPERTY_USAGE_EDITOR_BASIC_SETTING)
  889. // TRANSLATORS: Project Manager here refers to the tool used to create/manage Godot projects.
  890. EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "project_manager/sorting_order", 0, "Last Edited,Name,Path")
  891. EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "project_manager/directory_naming_convention", 1, "No convention,kebab-case,snake_case,camelCase,PascalCase,Title Case")
  892. #if defined(WEB_ENABLED)
  893. // Web platform only supports `gl_compatibility`.
  894. const String default_renderer = "gl_compatibility";
  895. #elif defined(ANDROID_ENABLED)
  896. // Use more suitable rendering method by default.
  897. const String default_renderer = "mobile";
  898. #else
  899. const String default_renderer = "forward_plus";
  900. #endif
  901. EDITOR_SETTING_BASIC(Variant::STRING, PROPERTY_HINT_ENUM, "project_manager/default_renderer", default_renderer, "forward_plus,mobile,gl_compatibility")
  902. #undef EDITOR_SETTING
  903. #undef EDITOR_SETTING_BASIC
  904. #undef EDITOR_SETTING_USAGE
  905. if (p_extra_config.is_valid()) {
  906. if (p_extra_config->has_section("init_projects") && p_extra_config->has_section_key("init_projects", "list")) {
  907. Vector<String> list = p_extra_config->get_value("init_projects", "list");
  908. for (int i = 0; i < list.size(); i++) {
  909. String proj_name = list[i].replace("/", "::");
  910. set("projects/" + proj_name, list[i]);
  911. }
  912. }
  913. if (p_extra_config->has_section("presets")) {
  914. Vector<String> keys = p_extra_config->get_section_keys("presets");
  915. for (const String &key : keys) {
  916. Variant val = p_extra_config->get_value("presets", key);
  917. set(key, val);
  918. }
  919. }
  920. }
  921. }
  922. void EditorSettings::_load_godot2_text_editor_theme() {
  923. // Godot 2 is only a dark theme; it doesn't have a light theme counterpart.
  924. _initial_set("text_editor/theme/highlighting/symbol_color", Color(0.73, 0.87, 1.0), true);
  925. _initial_set("text_editor/theme/highlighting/keyword_color", Color(1.0, 1.0, 0.7), true);
  926. _initial_set("text_editor/theme/highlighting/control_flow_keyword_color", Color(1.0, 0.85, 0.7), true);
  927. _initial_set("text_editor/theme/highlighting/base_type_color", Color(0.64, 1.0, 0.83), true);
  928. _initial_set("text_editor/theme/highlighting/engine_type_color", Color(0.51, 0.83, 1.0), true);
  929. _initial_set("text_editor/theme/highlighting/user_type_color", Color(0.42, 0.67, 0.93), true);
  930. _initial_set("text_editor/theme/highlighting/comment_color", Color(0.4, 0.4, 0.4), true);
  931. _initial_set("text_editor/theme/highlighting/doc_comment_color", Color(0.5, 0.6, 0.7), true);
  932. _initial_set("text_editor/theme/highlighting/string_color", Color(0.94, 0.43, 0.75), true);
  933. _initial_set("text_editor/theme/highlighting/background_color", Color(0.13, 0.12, 0.15), true);
  934. _initial_set("text_editor/theme/highlighting/completion_background_color", Color(0.17, 0.16, 0.2));
  935. _initial_set("text_editor/theme/highlighting/completion_selected_color", Color(0.26, 0.26, 0.27));
  936. _initial_set("text_editor/theme/highlighting/completion_existing_color", Color(0.87, 0.87, 0.87, 0.13));
  937. _initial_set("text_editor/theme/highlighting/completion_scroll_color", Color(1, 1, 1, 0.29));
  938. _initial_set("text_editor/theme/highlighting/completion_scroll_hovered_color", Color(1, 1, 1, 0.4));
  939. _initial_set("text_editor/theme/highlighting/completion_font_color", Color(0.67, 0.67, 0.67));
  940. _initial_set("text_editor/theme/highlighting/text_color", Color(0.67, 0.67, 0.67), true);
  941. _initial_set("text_editor/theme/highlighting/line_number_color", Color(0.67, 0.67, 0.67, 0.4), true);
  942. _initial_set("text_editor/theme/highlighting/safe_line_number_color", Color(0.67, 0.78, 0.67, 0.6), true);
  943. _initial_set("text_editor/theme/highlighting/caret_color", Color(0.67, 0.67, 0.67), true);
  944. _initial_set("text_editor/theme/highlighting/caret_background_color", Color(0, 0, 0), true);
  945. _initial_set("text_editor/theme/highlighting/text_selected_color", Color(0, 0, 0, 0), true);
  946. _initial_set("text_editor/theme/highlighting/selection_color", Color(0.41, 0.61, 0.91, 0.35), true);
  947. _initial_set("text_editor/theme/highlighting/brace_mismatch_color", Color(1, 0.2, 0.2), true);
  948. _initial_set("text_editor/theme/highlighting/current_line_color", Color(0.3, 0.5, 0.8, 0.15), true);
  949. _initial_set("text_editor/theme/highlighting/line_length_guideline_color", Color(0.3, 0.5, 0.8, 0.1), true);
  950. _initial_set("text_editor/theme/highlighting/word_highlighted_color", Color(0.8, 0.9, 0.9, 0.15), true);
  951. _initial_set("text_editor/theme/highlighting/number_color", Color(0.92, 0.58, 0.2), true);
  952. _initial_set("text_editor/theme/highlighting/function_color", Color(0.4, 0.64, 0.81), true);
  953. _initial_set("text_editor/theme/highlighting/member_variable_color", Color(0.9, 0.31, 0.35), true);
  954. _initial_set("text_editor/theme/highlighting/mark_color", Color(1.0, 0.4, 0.4, 0.4), true);
  955. _initial_set("text_editor/theme/highlighting/warning_color", Color(1.0, 0.8, 0.4, 0.1), true);
  956. _initial_set("text_editor/theme/highlighting/bookmark_color", Color(0.08, 0.49, 0.98));
  957. _initial_set("text_editor/theme/highlighting/breakpoint_color", Color(0.9, 0.29, 0.3));
  958. _initial_set("text_editor/theme/highlighting/executing_line_color", Color(0.98, 0.89, 0.27));
  959. _initial_set("text_editor/theme/highlighting/code_folding_color", Color(0.8, 0.8, 0.8, 0.8));
  960. _initial_set("text_editor/theme/highlighting/folded_code_region_color", Color(0.68, 0.46, 0.77, 0.2));
  961. _initial_set("text_editor/theme/highlighting/search_result_color", Color(0.05, 0.25, 0.05, 1));
  962. _initial_set("text_editor/theme/highlighting/search_result_border_color", Color(0.41, 0.61, 0.91, 0.38));
  963. }
  964. void EditorSettings::_load_default_visual_shader_editor_theme() {
  965. // Connection type colors
  966. _initial_set("editors/visual_editors/connection_colors/scalar_color", Color(0.55, 0.55, 0.55));
  967. _initial_set("editors/visual_editors/connection_colors/vector2_color", Color(0.44, 0.43, 0.64));
  968. _initial_set("editors/visual_editors/connection_colors/vector3_color", Color(0.337, 0.314, 0.71));
  969. _initial_set("editors/visual_editors/connection_colors/vector4_color", Color(0.7, 0.65, 0.147));
  970. _initial_set("editors/visual_editors/connection_colors/boolean_color", Color(0.243, 0.612, 0.349));
  971. _initial_set("editors/visual_editors/connection_colors/transform_color", Color(0.71, 0.357, 0.64));
  972. _initial_set("editors/visual_editors/connection_colors/sampler_color", Color(0.659, 0.4, 0.137));
  973. // Node category colors (used for the node headers)
  974. _initial_set("editors/visual_editors/category_colors/output_color", Color(0.26, 0.10, 0.15));
  975. _initial_set("editors/visual_editors/category_colors/color_color", Color(0.5, 0.5, 0.1));
  976. _initial_set("editors/visual_editors/category_colors/conditional_color", Color(0.208, 0.522, 0.298));
  977. _initial_set("editors/visual_editors/category_colors/input_color", Color(0.502, 0.2, 0.204));
  978. _initial_set("editors/visual_editors/category_colors/scalar_color", Color(0.1, 0.5, 0.6));
  979. _initial_set("editors/visual_editors/category_colors/textures_color", Color(0.5, 0.3, 0.1));
  980. _initial_set("editors/visual_editors/category_colors/transform_color", Color(0.5, 0.3, 0.5));
  981. _initial_set("editors/visual_editors/category_colors/utility_color", Color(0.2, 0.2, 0.2));
  982. _initial_set("editors/visual_editors/category_colors/vector_color", Color(0.2, 0.2, 0.5));
  983. _initial_set("editors/visual_editors/category_colors/special_color", Color(0.098, 0.361, 0.294));
  984. _initial_set("editors/visual_editors/category_colors/particle_color", Color(0.12, 0.358, 0.8));
  985. }
  986. String EditorSettings::_guess_exec_args_for_extenal_editor(const String &p_path) {
  987. Ref<RegEx> regex;
  988. regex.instantiate();
  989. const String editor_pattern = R"([\\/]((?:jetbrains\s*)?rider(?:\s*(eap|\d{4}\.\d+|\d{4}\.\d+\s*dev)?)?|visual\s*studio\s*code|subl(ime\s*text)?|sublime_text|(g)?vim|emacs|atom|geany|kate|code|(vs)?codium)(?:\.app|\.exe|\.bat|\.sh)?)";
  990. regex->compile(editor_pattern);
  991. Ref<RegExMatch> editor_match = regex->search(p_path.to_lower());
  992. if (editor_match.is_null()) {
  993. return String();
  994. }
  995. const String editor = editor_match->get_string(1).to_lower();
  996. String new_exec_flags = "{file}";
  997. if (editor.begins_with("rider")) {
  998. new_exec_flags = "{project} --line {line} {file}";
  999. } else if (editor == "subl" || editor == "sublime text" || editor == "sublime_text") {
  1000. new_exec_flags = "{project} {file}:{line}:{column}";
  1001. } else if (editor == "vim" || editor == "gvim") {
  1002. new_exec_flags = "\"+call cursor({line}, {col})\" {file}";
  1003. } else if (editor == "emacs") {
  1004. new_exec_flags = "emacs +{line}:{col} {file}";
  1005. } else if (editor == "atom") {
  1006. new_exec_flags = "{file}:{line}";
  1007. } else if (editor == "geany" || editor == "kate") {
  1008. new_exec_flags = "{file} --line {line} --column {col}";
  1009. } else if (editor == "code" || editor == "visual studio code" || editor == "codium" || editor == "vscodium") {
  1010. new_exec_flags = "{project} --goto {file}:{line}:{col}";
  1011. }
  1012. return new_exec_flags;
  1013. }
  1014. bool EditorSettings::_save_text_editor_theme(const String &p_file) {
  1015. String theme_section = "color_theme";
  1016. Ref<ConfigFile> cf = memnew(ConfigFile); // hex is better?
  1017. List<String> keys;
  1018. for (const KeyValue<String, VariantContainer> &E : props) {
  1019. keys.push_back(E.key);
  1020. }
  1021. keys.sort();
  1022. for (const String &key : keys) {
  1023. if (key.begins_with("text_editor/theme/highlighting/") && key.contains("color")) {
  1024. cf->set_value(theme_section, key.replace("text_editor/theme/highlighting/", ""), ((Color)props[key].variant).to_html());
  1025. }
  1026. }
  1027. Error err = cf->save(p_file);
  1028. return err == OK;
  1029. }
  1030. bool EditorSettings::_is_default_text_editor_theme(const String &p_theme_name) {
  1031. return p_theme_name == "default" || p_theme_name == "godot 2" || p_theme_name == "custom";
  1032. }
  1033. const String EditorSettings::_get_project_metadata_path() const {
  1034. return EditorPaths::get_singleton()->get_project_settings_dir().path_join("project_metadata.cfg");
  1035. }
  1036. #ifndef DISABLE_DEPRECATED
  1037. void EditorSettings::_remove_deprecated_settings() {
  1038. erase("network/connection/engine_version_update_mode");
  1039. erase("run/output/always_open_output_on_play");
  1040. erase("run/output/always_close_output_on_stop");
  1041. erase("text_editor/theme/line_spacing"); // See GH-106137.
  1042. }
  1043. #endif
  1044. // PUBLIC METHODS
  1045. EditorSettings *EditorSettings::get_singleton() {
  1046. return singleton.ptr();
  1047. }
  1048. String EditorSettings::get_existing_settings_path() {
  1049. const String config_dir = EditorPaths::get_singleton()->get_config_dir();
  1050. int minor = GODOT_VERSION_MINOR;
  1051. String filename;
  1052. do {
  1053. if (GODOT_VERSION_MAJOR == 4 && minor < 3) {
  1054. // Minor version is used since 4.3, so special case to load older settings.
  1055. filename = vformat("editor_settings-%d.tres", GODOT_VERSION_MAJOR);
  1056. minor = -1;
  1057. } else {
  1058. filename = vformat("editor_settings-%d.%d.tres", GODOT_VERSION_MAJOR, minor);
  1059. minor--;
  1060. }
  1061. } while (minor >= 0 && !FileAccess::exists(config_dir.path_join(filename)));
  1062. return config_dir.path_join(filename);
  1063. }
  1064. String EditorSettings::get_newest_settings_path() {
  1065. const String config_file_name = vformat("editor_settings-%d.%d.tres", GODOT_VERSION_MAJOR, GODOT_VERSION_MINOR);
  1066. return EditorPaths::get_singleton()->get_config_dir().path_join(config_file_name);
  1067. }
  1068. void EditorSettings::create() {
  1069. // IMPORTANT: create() *must* create a valid EditorSettings singleton,
  1070. // as the rest of the engine code will assume it. As such, it should never
  1071. // return (incl. via ERR_FAIL) without initializing the singleton member.
  1072. if (singleton.ptr()) {
  1073. ERR_PRINT("Can't recreate EditorSettings as it already exists.");
  1074. return;
  1075. }
  1076. String config_file_path;
  1077. Ref<ConfigFile> extra_config = memnew(ConfigFile);
  1078. if (!EditorPaths::get_singleton()) {
  1079. ERR_PRINT("Bug (please report): EditorPaths haven't been initialized, EditorSettings cannot be created properly.");
  1080. goto fail;
  1081. }
  1082. if (EditorPaths::get_singleton()->is_self_contained()) {
  1083. Error err = extra_config->load(EditorPaths::get_singleton()->get_self_contained_file());
  1084. if (err != OK) {
  1085. ERR_PRINT("Can't load extra config from path: " + EditorPaths::get_singleton()->get_self_contained_file());
  1086. }
  1087. }
  1088. if (EditorPaths::get_singleton()->are_paths_valid()) {
  1089. // Validate editor config file.
  1090. ERR_FAIL_COND(!DirAccess::dir_exists_absolute(EditorPaths::get_singleton()->get_config_dir()));
  1091. config_file_path = get_existing_settings_path();
  1092. if (!FileAccess::exists(config_file_path)) {
  1093. config_file_path = get_newest_settings_path();
  1094. goto fail;
  1095. }
  1096. singleton = ResourceLoader::load(config_file_path, "EditorSettings");
  1097. if (singleton.is_null()) {
  1098. ERR_PRINT("Could not load editor settings from path: " + config_file_path);
  1099. config_file_path = get_newest_settings_path();
  1100. goto fail;
  1101. }
  1102. singleton->set_path(get_newest_settings_path()); // Settings can be loaded from older version file, so make sure it's newest.
  1103. singleton->save_changed_setting = true;
  1104. print_verbose("EditorSettings: Load OK!");
  1105. singleton->setup_language();
  1106. singleton->setup_network();
  1107. singleton->load_favorites_and_recent_dirs();
  1108. singleton->list_text_editor_themes();
  1109. #ifndef DISABLE_DEPRECATED
  1110. singleton->_remove_deprecated_settings();
  1111. #endif
  1112. return;
  1113. }
  1114. fail:
  1115. // patch init projects
  1116. String exe_path = OS::get_singleton()->get_executable_path().get_base_dir();
  1117. if (extra_config->has_section("init_projects")) {
  1118. Vector<String> list = extra_config->get_value("init_projects", "list");
  1119. for (int i = 0; i < list.size(); i++) {
  1120. list.write[i] = exe_path.path_join(list[i]);
  1121. }
  1122. extra_config->set_value("init_projects", "list", list);
  1123. }
  1124. singleton.instantiate();
  1125. singleton->set_path(config_file_path, true);
  1126. singleton->save_changed_setting = true;
  1127. singleton->_load_defaults(extra_config);
  1128. singleton->setup_language();
  1129. singleton->setup_network();
  1130. singleton->list_text_editor_themes();
  1131. }
  1132. void EditorSettings::setup_language() {
  1133. String lang = _EDITOR_GET("interface/editor/editor_language");
  1134. if (lang == "en") {
  1135. TranslationServer::get_singleton()->set_locale(lang);
  1136. return; // Default, nothing to do.
  1137. }
  1138. // Load editor translation for configured/detected locale.
  1139. load_editor_translations(lang);
  1140. load_property_translations(lang);
  1141. // Load class reference translation.
  1142. load_doc_translations(lang);
  1143. // Load extractable translation for projects.
  1144. load_extractable_translations(lang);
  1145. TranslationServer::get_singleton()->set_locale(lang);
  1146. }
  1147. void EditorSettings::setup_network() {
  1148. List<IPAddress> local_ip;
  1149. IP::get_singleton()->get_local_addresses(&local_ip);
  1150. String hint;
  1151. String current = has_setting("network/debug/remote_host") ? get("network/debug/remote_host") : "";
  1152. String selected = "127.0.0.1";
  1153. // Check that current remote_host is a valid interface address and populate hints.
  1154. for (const IPAddress &ip : local_ip) {
  1155. // link-local IPv6 addresses don't work, skipping them
  1156. if (String(ip).begins_with("fe80:0:0:0:")) { // fe80::/64
  1157. continue;
  1158. }
  1159. // Same goes for IPv4 link-local (APIPA) addresses.
  1160. if (String(ip).begins_with("169.254.")) { // 169.254.0.0/16
  1161. continue;
  1162. }
  1163. // Select current IP (found)
  1164. if (ip == current) {
  1165. selected = ip;
  1166. }
  1167. if (!hint.is_empty()) {
  1168. hint += ",";
  1169. }
  1170. hint += ip;
  1171. }
  1172. // Add hints with valid IP addresses to remote_host property.
  1173. add_property_hint(PropertyInfo(Variant::STRING, "network/debug/remote_host", PROPERTY_HINT_ENUM, hint));
  1174. // Fix potentially invalid remote_host due to network change.
  1175. set("network/debug/remote_host", selected);
  1176. }
  1177. void EditorSettings::save() {
  1178. //_THREAD_SAFE_METHOD_
  1179. if (!singleton.ptr()) {
  1180. return;
  1181. }
  1182. Error err = ResourceSaver::save(singleton);
  1183. if (err != OK) {
  1184. ERR_PRINT("Error saving editor settings to " + singleton->get_path());
  1185. } else {
  1186. singleton->changed_settings.clear();
  1187. print_verbose("EditorSettings: Save OK!");
  1188. }
  1189. }
  1190. PackedStringArray EditorSettings::get_changed_settings() const {
  1191. PackedStringArray arr;
  1192. for (const String &setting : changed_settings) {
  1193. arr.push_back(setting);
  1194. }
  1195. return arr;
  1196. }
  1197. bool EditorSettings::check_changed_settings_in_group(const String &p_setting_prefix) const {
  1198. for (const String &setting : changed_settings) {
  1199. if (setting.begins_with(p_setting_prefix)) {
  1200. return true;
  1201. }
  1202. }
  1203. return false;
  1204. }
  1205. void EditorSettings::mark_setting_changed(const String &p_setting) {
  1206. changed_settings.insert(p_setting);
  1207. }
  1208. void EditorSettings::destroy() {
  1209. if (!singleton.ptr()) {
  1210. return;
  1211. }
  1212. save();
  1213. singleton = Ref<EditorSettings>();
  1214. }
  1215. void EditorSettings::set_optimize_save(bool p_optimize) {
  1216. optimize_save = p_optimize;
  1217. }
  1218. // Properties
  1219. void EditorSettings::set_setting(const String &p_setting, const Variant &p_value) {
  1220. _THREAD_SAFE_METHOD_
  1221. set(p_setting, p_value);
  1222. }
  1223. Variant EditorSettings::get_setting(const String &p_setting) const {
  1224. _THREAD_SAFE_METHOD_
  1225. if (ProjectSettings::get_singleton()->has_editor_setting_override(p_setting)) {
  1226. return ProjectSettings::get_singleton()->get_editor_setting_override(p_setting);
  1227. }
  1228. return get(p_setting);
  1229. }
  1230. bool EditorSettings::has_setting(const String &p_setting) const {
  1231. _THREAD_SAFE_METHOD_
  1232. return props.has(p_setting);
  1233. }
  1234. void EditorSettings::erase(const String &p_setting) {
  1235. _THREAD_SAFE_METHOD_
  1236. props.erase(p_setting);
  1237. }
  1238. void EditorSettings::raise_order(const String &p_setting) {
  1239. _THREAD_SAFE_METHOD_
  1240. ERR_FAIL_COND(!props.has(p_setting));
  1241. props[p_setting].order = ++last_order;
  1242. }
  1243. void EditorSettings::set_restart_if_changed(const StringName &p_setting, bool p_restart) {
  1244. _THREAD_SAFE_METHOD_
  1245. if (!props.has(p_setting)) {
  1246. return;
  1247. }
  1248. props[p_setting].restart_if_changed = p_restart;
  1249. }
  1250. void EditorSettings::set_basic(const StringName &p_setting, bool p_basic) {
  1251. _THREAD_SAFE_METHOD_
  1252. if (!props.has(p_setting)) {
  1253. return;
  1254. }
  1255. props[p_setting].basic = p_basic;
  1256. }
  1257. void EditorSettings::set_initial_value(const StringName &p_setting, const Variant &p_value, bool p_update_current) {
  1258. _THREAD_SAFE_METHOD_
  1259. if (!props.has(p_setting)) {
  1260. return;
  1261. }
  1262. props[p_setting].initial = p_value;
  1263. props[p_setting].has_default_value = true;
  1264. if (p_update_current) {
  1265. set(p_setting, p_value);
  1266. }
  1267. }
  1268. Variant _EDITOR_DEF(const String &p_setting, const Variant &p_default, bool p_restart_if_changed, bool p_basic) {
  1269. ERR_FAIL_NULL_V_MSG(EditorSettings::get_singleton(), p_default, "EditorSettings not instantiated yet.");
  1270. Variant ret = p_default;
  1271. if (EditorSettings::get_singleton()->has_setting(p_setting)) {
  1272. ret = EDITOR_GET(p_setting);
  1273. } else {
  1274. EditorSettings::get_singleton()->set_manually(p_setting, p_default);
  1275. }
  1276. EditorSettings::get_singleton()->set_restart_if_changed(p_setting, p_restart_if_changed);
  1277. EditorSettings::get_singleton()->set_basic(p_setting, p_basic);
  1278. if (!EditorSettings::get_singleton()->has_default_value(p_setting)) {
  1279. EditorSettings::get_singleton()->set_initial_value(p_setting, p_default);
  1280. }
  1281. return ret;
  1282. }
  1283. Variant _EDITOR_GET(const String &p_setting) {
  1284. ERR_FAIL_COND_V(!EditorSettings::get_singleton() || !EditorSettings::get_singleton()->has_setting(p_setting), Variant());
  1285. return EditorSettings::get_singleton()->get_setting(p_setting);
  1286. }
  1287. bool EditorSettings::_property_can_revert(const StringName &p_name) const {
  1288. const VariantContainer *property = props.getptr(p_name);
  1289. if (property) {
  1290. return property->has_default_value;
  1291. }
  1292. return false;
  1293. }
  1294. bool EditorSettings::_property_get_revert(const StringName &p_name, Variant &r_property) const {
  1295. const VariantContainer *value = props.getptr(p_name);
  1296. if (value && value->has_default_value) {
  1297. r_property = value->initial;
  1298. return true;
  1299. }
  1300. return false;
  1301. }
  1302. void EditorSettings::add_property_hint(const PropertyInfo &p_hint) {
  1303. _THREAD_SAFE_METHOD_
  1304. hints[p_hint.name] = p_hint;
  1305. }
  1306. // Metadata
  1307. void EditorSettings::set_project_metadata(const String &p_section, const String &p_key, const Variant &p_data) {
  1308. const String path = _get_project_metadata_path();
  1309. if (project_metadata.is_null()) {
  1310. project_metadata.instantiate();
  1311. Error err = project_metadata->load(path);
  1312. if (err != OK && err != ERR_FILE_NOT_FOUND) {
  1313. ERR_PRINT("Cannot load project metadata from file '" + path + "'.");
  1314. }
  1315. }
  1316. project_metadata->set_value(p_section, p_key, p_data);
  1317. Error err = project_metadata->save(path);
  1318. ERR_FAIL_COND_MSG(err != OK, "Cannot save project metadata to file '" + path + "'.");
  1319. }
  1320. Variant EditorSettings::get_project_metadata(const String &p_section, const String &p_key, const Variant &p_default) const {
  1321. if (project_metadata.is_null()) {
  1322. project_metadata.instantiate();
  1323. const String path = _get_project_metadata_path();
  1324. Error err = project_metadata->load(path);
  1325. ERR_FAIL_COND_V_MSG(err != OK && err != ERR_FILE_NOT_FOUND, p_default, "Cannot load project metadata from file '" + path + "'.");
  1326. }
  1327. return project_metadata->get_value(p_section, p_key, p_default);
  1328. }
  1329. void EditorSettings::set_favorites(const Vector<String> &p_favorites) {
  1330. favorites = p_favorites;
  1331. String favorites_file;
  1332. if (Engine::get_singleton()->is_project_manager_hint()) {
  1333. favorites_file = EditorPaths::get_singleton()->get_config_dir().path_join("favorite_dirs");
  1334. } else {
  1335. favorites_file = EditorPaths::get_singleton()->get_project_settings_dir().path_join("favorites");
  1336. }
  1337. Ref<FileAccess> f = FileAccess::open(favorites_file, FileAccess::WRITE);
  1338. if (f.is_valid()) {
  1339. for (int i = 0; i < favorites.size(); i++) {
  1340. f->store_line(favorites[i]);
  1341. }
  1342. }
  1343. }
  1344. void EditorSettings::set_favorite_properties(const HashMap<String, PackedStringArray> &p_favorite_properties) {
  1345. favorite_properties = p_favorite_properties;
  1346. String favorite_properties_file = EditorPaths::get_singleton()->get_project_settings_dir().path_join("favorite_properties");
  1347. Ref<ConfigFile> cf;
  1348. cf.instantiate();
  1349. for (const KeyValue<String, PackedStringArray> &kv : p_favorite_properties) {
  1350. cf->set_value(kv.key, "properties", kv.value);
  1351. }
  1352. cf->save(favorite_properties_file);
  1353. }
  1354. Vector<String> EditorSettings::get_favorites() const {
  1355. return favorites;
  1356. }
  1357. HashMap<String, PackedStringArray> EditorSettings::get_favorite_properties() const {
  1358. return favorite_properties;
  1359. }
  1360. void EditorSettings::set_recent_dirs(const Vector<String> &p_recent_dirs) {
  1361. recent_dirs = p_recent_dirs;
  1362. String recent_dirs_file;
  1363. if (Engine::get_singleton()->is_project_manager_hint()) {
  1364. recent_dirs_file = EditorPaths::get_singleton()->get_config_dir().path_join("recent_dirs");
  1365. } else {
  1366. recent_dirs_file = EditorPaths::get_singleton()->get_project_settings_dir().path_join("recent_dirs");
  1367. }
  1368. Ref<FileAccess> f = FileAccess::open(recent_dirs_file, FileAccess::WRITE);
  1369. if (f.is_valid()) {
  1370. for (int i = 0; i < recent_dirs.size(); i++) {
  1371. f->store_line(recent_dirs[i]);
  1372. }
  1373. }
  1374. }
  1375. Vector<String> EditorSettings::get_recent_dirs() const {
  1376. return recent_dirs;
  1377. }
  1378. void EditorSettings::load_favorites_and_recent_dirs() {
  1379. String favorites_file;
  1380. String favorite_properties_file;
  1381. String recent_dirs_file;
  1382. if (Engine::get_singleton()->is_project_manager_hint()) {
  1383. favorites_file = EditorPaths::get_singleton()->get_config_dir().path_join("favorite_dirs");
  1384. favorite_properties_file = EditorPaths::get_singleton()->get_config_dir().path_join("favorite_properties");
  1385. recent_dirs_file = EditorPaths::get_singleton()->get_config_dir().path_join("recent_dirs");
  1386. } else {
  1387. favorites_file = EditorPaths::get_singleton()->get_project_settings_dir().path_join("favorites");
  1388. favorite_properties_file = EditorPaths::get_singleton()->get_project_settings_dir().path_join("favorite_properties");
  1389. recent_dirs_file = EditorPaths::get_singleton()->get_project_settings_dir().path_join("recent_dirs");
  1390. }
  1391. /// File Favorites
  1392. Ref<FileAccess> f = FileAccess::open(favorites_file, FileAccess::READ);
  1393. if (f.is_valid()) {
  1394. String line = f->get_line().strip_edges();
  1395. while (!line.is_empty()) {
  1396. favorites.append(line);
  1397. line = f->get_line().strip_edges();
  1398. }
  1399. }
  1400. /// Inspector Favorites
  1401. Ref<ConfigFile> cf;
  1402. cf.instantiate();
  1403. if (cf->load(favorite_properties_file) == OK) {
  1404. Vector<String> secs = cf->get_sections();
  1405. for (String &E : secs) {
  1406. PackedStringArray properties = PackedStringArray(cf->get_value(E, "properties"));
  1407. if (EditorNode::get_editor_data().is_type_recognized(E) || ResourceLoader::exists(E, "Script")) {
  1408. for (const String &property : properties) {
  1409. if (!favorite_properties[E].has(property)) {
  1410. favorite_properties[E].push_back(property);
  1411. }
  1412. }
  1413. }
  1414. }
  1415. }
  1416. /// Recent Directories
  1417. f = FileAccess::open(recent_dirs_file, FileAccess::READ);
  1418. if (f.is_valid()) {
  1419. String line = f->get_line().strip_edges();
  1420. while (!line.is_empty()) {
  1421. recent_dirs.push_back(line);
  1422. line = f->get_line().strip_edges();
  1423. }
  1424. }
  1425. }
  1426. void EditorSettings::list_text_editor_themes() {
  1427. String themes = "Default,Godot 2,Custom";
  1428. Ref<DirAccess> d = DirAccess::open(EditorPaths::get_singleton()->get_text_editor_themes_dir());
  1429. if (d.is_valid()) {
  1430. List<String> custom_themes;
  1431. d->list_dir_begin();
  1432. String file = d->get_next();
  1433. while (!file.is_empty()) {
  1434. if (file.get_extension() == "tet" && !_is_default_text_editor_theme(file.get_basename().to_lower())) {
  1435. custom_themes.push_back(file.get_basename());
  1436. }
  1437. file = d->get_next();
  1438. }
  1439. d->list_dir_end();
  1440. custom_themes.sort();
  1441. for (const String &E : custom_themes) {
  1442. themes += "," + E;
  1443. }
  1444. }
  1445. add_property_hint(PropertyInfo(Variant::STRING, "text_editor/theme/color_theme", PROPERTY_HINT_ENUM, themes));
  1446. }
  1447. void EditorSettings::load_text_editor_theme() {
  1448. String p_file = get("text_editor/theme/color_theme");
  1449. if (_is_default_text_editor_theme(p_file.get_file().to_lower())) {
  1450. if (p_file == "Godot 2") {
  1451. _load_godot2_text_editor_theme();
  1452. }
  1453. return; // sorry for "Settings changed" console spam
  1454. }
  1455. String theme_path = EditorPaths::get_singleton()->get_text_editor_themes_dir().path_join(p_file + ".tet");
  1456. Ref<ConfigFile> cf = memnew(ConfigFile);
  1457. Error err = cf->load(theme_path);
  1458. if (err != OK) {
  1459. return;
  1460. }
  1461. Vector<String> keys = cf->get_section_keys("color_theme");
  1462. for (const String &key : keys) {
  1463. String val = cf->get_value("color_theme", key);
  1464. // don't load if it's not already there!
  1465. if (has_setting("text_editor/theme/highlighting/" + key)) {
  1466. // make sure it is actually a color
  1467. if (val.is_valid_html_color() && key.contains("color")) {
  1468. props["text_editor/theme/highlighting/" + key].variant = Color::html(val); // change manually to prevent "Settings changed" console spam
  1469. }
  1470. }
  1471. }
  1472. emit_signal(SNAME("settings_changed"));
  1473. // if it doesn't load just use what is currently loaded
  1474. }
  1475. bool EditorSettings::import_text_editor_theme(const String &p_file) {
  1476. if (!p_file.ends_with(".tet")) {
  1477. return false;
  1478. } else {
  1479. if (p_file.get_file().to_lower() == "default.tet") {
  1480. return false;
  1481. }
  1482. Ref<DirAccess> d = DirAccess::open(EditorPaths::get_singleton()->get_text_editor_themes_dir());
  1483. if (d.is_valid()) {
  1484. d->copy(p_file, EditorPaths::get_singleton()->get_text_editor_themes_dir().path_join(p_file.get_file()));
  1485. return true;
  1486. }
  1487. }
  1488. return false;
  1489. }
  1490. bool EditorSettings::save_text_editor_theme() {
  1491. String p_file = get("text_editor/theme/color_theme");
  1492. if (_is_default_text_editor_theme(p_file.get_file().to_lower())) {
  1493. return false;
  1494. }
  1495. String theme_path = EditorPaths::get_singleton()->get_text_editor_themes_dir().path_join(p_file + ".tet");
  1496. return _save_text_editor_theme(theme_path);
  1497. }
  1498. bool EditorSettings::save_text_editor_theme_as(String p_file) {
  1499. if (!p_file.ends_with(".tet")) {
  1500. p_file += ".tet";
  1501. }
  1502. if (_is_default_text_editor_theme(p_file.get_file().to_lower().trim_suffix(".tet"))) {
  1503. return false;
  1504. }
  1505. if (_save_text_editor_theme(p_file)) {
  1506. // switch to theme is saved in the theme directory
  1507. list_text_editor_themes();
  1508. String theme_name = p_file.substr(0, p_file.length() - 4).get_file();
  1509. if (p_file.get_base_dir() == EditorPaths::get_singleton()->get_text_editor_themes_dir()) {
  1510. _initial_set("text_editor/theme/color_theme", theme_name);
  1511. load_text_editor_theme();
  1512. }
  1513. return true;
  1514. }
  1515. return false;
  1516. }
  1517. bool EditorSettings::is_default_text_editor_theme() {
  1518. String p_file = get("text_editor/theme/color_theme");
  1519. return _is_default_text_editor_theme(p_file.get_file().to_lower());
  1520. }
  1521. Vector<String> EditorSettings::get_script_templates(const String &p_extension, const String &p_custom_path) {
  1522. Vector<String> templates;
  1523. String template_dir = EditorPaths::get_singleton()->get_script_templates_dir();
  1524. if (!p_custom_path.is_empty()) {
  1525. template_dir = p_custom_path;
  1526. }
  1527. Ref<DirAccess> d = DirAccess::open(template_dir);
  1528. if (d.is_valid()) {
  1529. d->list_dir_begin();
  1530. String file = d->get_next();
  1531. while (!file.is_empty()) {
  1532. if (file.get_extension() == p_extension) {
  1533. templates.push_back(file.get_basename());
  1534. }
  1535. file = d->get_next();
  1536. }
  1537. d->list_dir_end();
  1538. }
  1539. return templates;
  1540. }
  1541. String EditorSettings::get_editor_layouts_config() const {
  1542. return EditorPaths::get_singleton()->get_config_dir().path_join("editor_layouts.cfg");
  1543. }
  1544. float EditorSettings::get_auto_display_scale() {
  1545. #ifdef LINUXBSD_ENABLED
  1546. if (DisplayServer::get_singleton()->get_name() == "Wayland") {
  1547. float main_window_scale = DisplayServer::get_singleton()->screen_get_scale(DisplayServer::SCREEN_OF_MAIN_WINDOW);
  1548. if (DisplayServer::get_singleton()->get_screen_count() == 1 || Math::fract(main_window_scale) != 0) {
  1549. // If we have a single screen or the screen of the window is fractional, all
  1550. // bets are off. At this point, let's just return the current's window scale,
  1551. // which is special-cased to the scale of `SCREEN_OF_MAIN_WINDOW`.
  1552. return main_window_scale;
  1553. }
  1554. // If the above branch didn't fire, fractional scaling isn't going to work
  1555. // properly anyways (we're need the ability to change the UI scale at runtime).
  1556. // At this point it's more convenient to "supersample" like we do with other
  1557. // platforms, hoping that the user is only using integer-scaled screens.
  1558. return DisplayServer::get_singleton()->screen_get_max_scale();
  1559. }
  1560. #endif
  1561. #if defined(MACOS_ENABLED) || defined(ANDROID_ENABLED)
  1562. return DisplayServer::get_singleton()->screen_get_max_scale();
  1563. #else
  1564. const int screen = DisplayServer::get_singleton()->window_get_current_screen();
  1565. if (DisplayServer::get_singleton()->screen_get_size(screen) == Vector2i()) {
  1566. // Invalid screen size, skip.
  1567. return 1.0;
  1568. }
  1569. // Use the smallest dimension to use a correct display scale on portrait displays.
  1570. const int smallest_dimension = MIN(DisplayServer::get_singleton()->screen_get_size(screen).x, DisplayServer::get_singleton()->screen_get_size(screen).y);
  1571. if (DisplayServer::get_singleton()->screen_get_dpi(screen) >= 192 && smallest_dimension >= 1400) {
  1572. // hiDPI display.
  1573. return 2.0;
  1574. } else if (smallest_dimension >= 1700) {
  1575. // Likely a hiDPI display, but we aren't certain due to the returned DPI.
  1576. // Use an intermediate scale to handle this situation.
  1577. return 1.5;
  1578. } else if (smallest_dimension <= 800) {
  1579. // Small loDPI display. Use a smaller display scale so that editor elements fit more easily.
  1580. // Icons won't look great, but this is better than having editor elements overflow from its window.
  1581. return 0.75;
  1582. }
  1583. return 1.0;
  1584. #endif
  1585. }
  1586. // Shortcuts
  1587. void EditorSettings::_add_shortcut_default(const String &p_name, const Ref<Shortcut> &p_shortcut) {
  1588. shortcuts[p_name] = p_shortcut;
  1589. }
  1590. void EditorSettings::add_shortcut(const String &p_name, const Ref<Shortcut> &p_shortcut) {
  1591. shortcuts[p_name] = p_shortcut;
  1592. shortcuts[p_name]->set_meta("customized", true);
  1593. }
  1594. bool EditorSettings::is_shortcut(const String &p_name, const Ref<InputEvent> &p_event) const {
  1595. HashMap<String, Ref<Shortcut>>::ConstIterator E = shortcuts.find(p_name);
  1596. ERR_FAIL_COND_V_MSG(!E, false, "Unknown Shortcut: " + p_name + ".");
  1597. return E->value->matches_event(p_event);
  1598. }
  1599. Ref<Shortcut> EditorSettings::get_shortcut(const String &p_name) const {
  1600. HashMap<String, Ref<Shortcut>>::ConstIterator SC = shortcuts.find(p_name);
  1601. if (SC) {
  1602. return SC->value;
  1603. }
  1604. // If no shortcut with the provided name is found in the list, check the built-in shortcuts.
  1605. // Use the first item in the action list for the shortcut event, since a shortcut can only have 1 linked event.
  1606. Ref<Shortcut> sc;
  1607. HashMap<String, List<Ref<InputEvent>>>::ConstIterator builtin_override = builtin_action_overrides.find(p_name);
  1608. if (builtin_override) {
  1609. sc.instantiate();
  1610. sc->set_events_list(&builtin_override->value);
  1611. sc->set_name(InputMap::get_singleton()->get_builtin_display_name(p_name));
  1612. }
  1613. // If there was no override, check the default builtins to see if it has an InputEvent for the provided name.
  1614. if (sc.is_null()) {
  1615. HashMap<String, List<Ref<InputEvent>>>::ConstIterator builtin_default = InputMap::get_singleton()->get_builtins_with_feature_overrides_applied().find(p_name);
  1616. if (builtin_default) {
  1617. sc.instantiate();
  1618. sc->set_events_list(&builtin_default->value);
  1619. sc->set_name(InputMap::get_singleton()->get_builtin_display_name(p_name));
  1620. }
  1621. }
  1622. if (sc.is_valid()) {
  1623. // Add the shortcut to the list.
  1624. shortcuts[p_name] = sc;
  1625. return sc;
  1626. }
  1627. return Ref<Shortcut>();
  1628. }
  1629. void EditorSettings::get_shortcut_list(List<String> *r_shortcuts) {
  1630. for (const KeyValue<String, Ref<Shortcut>> &E : shortcuts) {
  1631. r_shortcuts->push_back(E.key);
  1632. }
  1633. }
  1634. Ref<Shortcut> ED_GET_SHORTCUT(const String &p_path) {
  1635. ERR_FAIL_NULL_V_MSG(EditorSettings::get_singleton(), nullptr, "EditorSettings not instantiated yet.");
  1636. Ref<Shortcut> sc = EditorSettings::get_singleton()->get_shortcut(p_path);
  1637. ERR_FAIL_COND_V_MSG(sc.is_null(), sc, "Used ED_GET_SHORTCUT with invalid shortcut: " + p_path);
  1638. return sc;
  1639. }
  1640. void ED_SHORTCUT_OVERRIDE(const String &p_path, const String &p_feature, Key p_keycode, bool p_physical) {
  1641. if (!EditorSettings::get_singleton()) {
  1642. return;
  1643. }
  1644. Ref<Shortcut> sc = EditorSettings::get_singleton()->get_shortcut(p_path);
  1645. ERR_FAIL_COND_MSG(sc.is_null(), "Used ED_SHORTCUT_OVERRIDE with invalid shortcut: " + p_path);
  1646. PackedInt32Array arr;
  1647. arr.push_back((int32_t)p_keycode);
  1648. ED_SHORTCUT_OVERRIDE_ARRAY(p_path, p_feature, arr, p_physical);
  1649. }
  1650. void ED_SHORTCUT_OVERRIDE_ARRAY(const String &p_path, const String &p_feature, const PackedInt32Array &p_keycodes, bool p_physical) {
  1651. if (!EditorSettings::get_singleton()) {
  1652. return;
  1653. }
  1654. Ref<Shortcut> sc = EditorSettings::get_singleton()->get_shortcut(p_path);
  1655. ERR_FAIL_COND_MSG(sc.is_null(), "Used ED_SHORTCUT_OVERRIDE_ARRAY with invalid shortcut: " + p_path);
  1656. // Only add the override if the OS supports the provided feature.
  1657. if (!OS::get_singleton()->has_feature(p_feature)) {
  1658. if (!(p_feature == "macos" && (OS::get_singleton()->has_feature("web_macos") || OS::get_singleton()->has_feature("web_ios")))) {
  1659. return;
  1660. }
  1661. }
  1662. Array events;
  1663. for (int i = 0; i < p_keycodes.size(); i++) {
  1664. Key keycode = (Key)p_keycodes[i];
  1665. if (OS::get_singleton()->has_feature("macos") || OS::get_singleton()->has_feature("web_macos") || OS::get_singleton()->has_feature("web_ios")) {
  1666. // Use Cmd+Backspace as a general replacement for Delete shortcuts on macOS
  1667. if (keycode == Key::KEY_DELETE) {
  1668. keycode = KeyModifierMask::META | Key::BACKSPACE;
  1669. }
  1670. }
  1671. Ref<InputEventKey> ie;
  1672. if (keycode != Key::NONE) {
  1673. ie = InputEventKey::create_reference(keycode, p_physical);
  1674. events.push_back(ie);
  1675. }
  1676. }
  1677. // Override the existing shortcut only if it wasn't customized by the user.
  1678. if (!sc->has_meta("customized")) {
  1679. sc->set_events(events);
  1680. }
  1681. sc->set_meta("original", events.duplicate(true));
  1682. }
  1683. Ref<Shortcut> ED_SHORTCUT(const String &p_path, const String &p_name, Key p_keycode, bool p_physical) {
  1684. PackedInt32Array arr;
  1685. arr.push_back((int32_t)p_keycode);
  1686. return ED_SHORTCUT_ARRAY(p_path, p_name, arr, p_physical);
  1687. }
  1688. Ref<Shortcut> ED_SHORTCUT_ARRAY(const String &p_path, const String &p_name, const PackedInt32Array &p_keycodes, bool p_physical) {
  1689. Array events;
  1690. for (int i = 0; i < p_keycodes.size(); i++) {
  1691. Key keycode = (Key)p_keycodes[i];
  1692. if (OS::get_singleton()->has_feature("macos") || OS::get_singleton()->has_feature("web_macos") || OS::get_singleton()->has_feature("web_ios")) {
  1693. // Use Cmd+Backspace as a general replacement for Delete shortcuts on macOS
  1694. if (keycode == Key::KEY_DELETE) {
  1695. keycode = KeyModifierMask::META | Key::BACKSPACE;
  1696. }
  1697. }
  1698. Ref<InputEventKey> ie;
  1699. if (keycode != Key::NONE) {
  1700. ie = InputEventKey::create_reference(keycode, p_physical);
  1701. events.push_back(ie);
  1702. }
  1703. }
  1704. if (!EditorSettings::get_singleton()) {
  1705. Ref<Shortcut> sc;
  1706. sc.instantiate();
  1707. sc->set_name(p_name);
  1708. sc->set_events(events);
  1709. sc->set_meta("original", events.duplicate(true));
  1710. return sc;
  1711. }
  1712. Ref<Shortcut> sc = EditorSettings::get_singleton()->get_shortcut(p_path);
  1713. if (sc.is_valid()) {
  1714. sc->set_name(p_name); //keep name (the ones that come from disk have no name)
  1715. sc->set_meta("original", events.duplicate(true)); //to compare against changes
  1716. return sc;
  1717. }
  1718. sc.instantiate();
  1719. sc->set_name(p_name);
  1720. sc->set_events(events);
  1721. sc->set_meta("original", events.duplicate(true)); //to compare against changes
  1722. EditorSettings::get_singleton()->_add_shortcut_default(p_path, sc);
  1723. return sc;
  1724. }
  1725. void EditorSettings::set_builtin_action_override(const String &p_name, const TypedArray<InputEvent> &p_events) {
  1726. List<Ref<InputEvent>> event_list;
  1727. // Override the whole list, since events may have their order changed or be added, removed or edited.
  1728. InputMap::get_singleton()->action_erase_events(p_name);
  1729. for (int i = 0; i < p_events.size(); i++) {
  1730. event_list.push_back(p_events[i]);
  1731. InputMap::get_singleton()->action_add_event(p_name, p_events[i]);
  1732. }
  1733. // Check if the provided event array is same as built-in. If it is, it does not need to be added to the overrides.
  1734. // Note that event order must also be the same.
  1735. bool same_as_builtin = true;
  1736. HashMap<String, List<Ref<InputEvent>>>::ConstIterator builtin_default = InputMap::get_singleton()->get_builtins_with_feature_overrides_applied().find(p_name);
  1737. if (builtin_default) {
  1738. const List<Ref<InputEvent>> &builtin_events = builtin_default->value;
  1739. // In the editor we only care about key events.
  1740. List<Ref<InputEventKey>> builtin_key_events;
  1741. for (Ref<InputEventKey> iek : builtin_events) {
  1742. if (iek.is_valid()) {
  1743. builtin_key_events.push_back(iek);
  1744. }
  1745. }
  1746. if (p_events.size() == builtin_key_events.size()) {
  1747. int event_idx = 0;
  1748. // Check equality of each event.
  1749. for (const Ref<InputEventKey> &E : builtin_key_events) {
  1750. if (!E->is_match(p_events[event_idx])) {
  1751. same_as_builtin = false;
  1752. break;
  1753. }
  1754. event_idx++;
  1755. }
  1756. } else {
  1757. same_as_builtin = false;
  1758. }
  1759. }
  1760. if (same_as_builtin && builtin_action_overrides.has(p_name)) {
  1761. builtin_action_overrides.erase(p_name);
  1762. } else {
  1763. builtin_action_overrides[p_name] = event_list;
  1764. }
  1765. // Update the shortcut (if it is used somewhere in the editor) to be the first event of the new list.
  1766. if (shortcuts.has(p_name)) {
  1767. shortcuts[p_name]->set_events_list(&event_list);
  1768. }
  1769. }
  1770. const Array EditorSettings::get_builtin_action_overrides(const String &p_name) const {
  1771. HashMap<String, List<Ref<InputEvent>>>::ConstIterator AO = builtin_action_overrides.find(p_name);
  1772. if (AO) {
  1773. Array event_array;
  1774. List<Ref<InputEvent>> events_list = AO->value;
  1775. for (const Ref<InputEvent> &E : events_list) {
  1776. event_array.push_back(E);
  1777. }
  1778. return event_array;
  1779. }
  1780. return Array();
  1781. }
  1782. void EditorSettings::notify_changes() {
  1783. _THREAD_SAFE_METHOD_
  1784. SceneTree *sml = Object::cast_to<SceneTree>(OS::get_singleton()->get_main_loop());
  1785. if (!sml) {
  1786. return;
  1787. }
  1788. Node *root = sml->get_root()->get_child(0);
  1789. if (!root) {
  1790. return;
  1791. }
  1792. root->propagate_notification(NOTIFICATION_EDITOR_SETTINGS_CHANGED);
  1793. }
  1794. void EditorSettings::get_argument_options(const StringName &p_function, int p_idx, List<String> *r_options) const {
  1795. const String pf = p_function;
  1796. if (p_idx == 0) {
  1797. if (pf == "has_setting" || pf == "set_setting" || pf == "get_setting" || pf == "erase" ||
  1798. pf == "set_initial_value" || pf == "set_as_basic" || pf == "mark_setting_changed") {
  1799. for (const KeyValue<String, VariantContainer> &E : props) {
  1800. if (E.value.hide_from_editor) {
  1801. continue;
  1802. }
  1803. r_options->push_back(E.key.quote());
  1804. }
  1805. } else if (pf == "get_project_metadata" && project_metadata.is_valid()) {
  1806. Vector<String> sections = project_metadata->get_sections();
  1807. for (const String &section : sections) {
  1808. r_options->push_back(section.quote());
  1809. }
  1810. } else if (pf == "set_builtin_action_override") {
  1811. for (const Variant &action : InputMap::get_singleton()->get_actions()) {
  1812. r_options->push_back(String(action).quote());
  1813. }
  1814. }
  1815. }
  1816. Object::get_argument_options(p_function, p_idx, r_options);
  1817. }
  1818. void EditorSettings::_bind_methods() {
  1819. ClassDB::bind_method(D_METHOD("has_setting", "name"), &EditorSettings::has_setting);
  1820. ClassDB::bind_method(D_METHOD("set_setting", "name", "value"), &EditorSettings::set_setting);
  1821. ClassDB::bind_method(D_METHOD("get_setting", "name"), &EditorSettings::get_setting);
  1822. ClassDB::bind_method(D_METHOD("erase", "property"), &EditorSettings::erase);
  1823. ClassDB::bind_method(D_METHOD("set_initial_value", "name", "value", "update_current"), &EditorSettings::set_initial_value);
  1824. ClassDB::bind_method(D_METHOD("add_property_info", "info"), &EditorSettings::_add_property_info_bind);
  1825. ClassDB::bind_method(D_METHOD("set_project_metadata", "section", "key", "data"), &EditorSettings::set_project_metadata);
  1826. ClassDB::bind_method(D_METHOD("get_project_metadata", "section", "key", "default"), &EditorSettings::get_project_metadata, DEFVAL(Variant()));
  1827. ClassDB::bind_method(D_METHOD("set_favorites", "dirs"), &EditorSettings::set_favorites);
  1828. ClassDB::bind_method(D_METHOD("get_favorites"), &EditorSettings::get_favorites);
  1829. ClassDB::bind_method(D_METHOD("set_recent_dirs", "dirs"), &EditorSettings::set_recent_dirs);
  1830. ClassDB::bind_method(D_METHOD("get_recent_dirs"), &EditorSettings::get_recent_dirs);
  1831. ClassDB::bind_method(D_METHOD("set_builtin_action_override", "name", "actions_list"), &EditorSettings::set_builtin_action_override);
  1832. ClassDB::bind_method(D_METHOD("check_changed_settings_in_group", "setting_prefix"), &EditorSettings::check_changed_settings_in_group);
  1833. ClassDB::bind_method(D_METHOD("get_changed_settings"), &EditorSettings::get_changed_settings);
  1834. ClassDB::bind_method(D_METHOD("mark_setting_changed", "setting"), &EditorSettings::mark_setting_changed);
  1835. ADD_SIGNAL(MethodInfo("settings_changed"));
  1836. BIND_CONSTANT(NOTIFICATION_EDITOR_SETTINGS_CHANGED);
  1837. }
  1838. EditorSettings::EditorSettings() {
  1839. last_order = 0;
  1840. _load_defaults();
  1841. callable_mp(this, &EditorSettings::_set_initialized).call_deferred();
  1842. }