-# Make this field blank or 0, or increase this number to use multiple threads.
-# On multiprocessor systems, this will improve mapgen speed greatly at the cost
-# of slightly buggy caves.
-num_emerge_threads (Number of emerge threads) int 0
-
-[Content Store]
-
-# Show packages in the content store that do not qualify as 'free software'
+# WARNING: Currently there are multiple bugs that may cause crashes when
+# 'num_emerge_threads' is larger than 1. Until this warning is removed it is
+# strongly recommended this value is set to the default '1'.
+# Value 0:
+# - Automatic selection. The number of emerge threads will be
+# - 'number of processors - 2', with a lower limit of 1.
+# Any other value:
+# - Specifies the number of emerge threads, with a lower limit of 1.
+# WARNING: Increasing the number of emerge threads increases engine mapgen
+# speed, but this may harm game performance by interfering with other
+# processes, especially in singleplayer and/or when running Lua code in
+# 'on_generated'. For many users the optimum setting may be '1'.
+num_emerge_threads (Number of emerge threads) int 1
+
+[Online Content Repository]
+
+# The URL for the content repository
+contentdb_url (ContentDB URL) string https://content.minetest.net
+
+# Comma-separated list of flags to hide in the content repository.
+# "nonfree" can be used to hide packages which do not qualify as 'free software',