Project Settings

The Project Settings windows are available from Cocos Creator’s main menu (Project > Project Settings) which includes all the settings related to your project. These settings will be saved in the project’s settings / packages folder. If you need to synchronize project settings between different developers, this folder should be added in your source control system.

General

general

Default Canvas settings

The default Canvas settings include design resolution and adapted screen width/height, which are used to specify the default design resolution value in Canvas when creating a new scene or Canvas component, as well as the Fit Height, Fit Width options.

For more information, please refer to the Multi-resolution adaptation scheme documentation.

Engine Modules

modules

The setting here is to crop the modules used in the engine to reduce the size of the released engine. Modules not selected in the panel will be cropped when they are packaged and previewed. It is recommended to perform a complete test after released to avoid using cropped modules in scenes and scripts.

Macro Config

For more information and code of the engine macro module, please refer to the Engine macro documentation.

This panel here provide the convenience to modify the macro configuration. The Macro Config will take effect during preview and build. At the same time, the default value of the current macro configuration will be updated with the configuration of the custom engine.

macro

Texture Compress

In Cocos Creator 3.0, the editor has modified the use of compressed texture configuration to configure presets in project settings and select presets for image asset’s inspector. After the old version of the project is upgraded, the editor will automatically scan all the compressed texture configurations in the project and sort out as several presets.

Used to add compressed texture preset configuration, you can directly select the compressed texture preset to quickly add in the inspector of image asset. At the same time, after adding presets, you can also directly modify the presets to update batch texture compress configuration. Project settings allow users to add multiple compressed texture configurations, and each compressed texture configuration allows to add different format for different platform categories.

Platform is rough devised as following:

  1. Web: refers to the two platforms Web-Mobile and Web-Desktop
  2. Mac & Windows
  3. iOS
  4. Mini Game: Refers to the mini-games of various manufacturers’ platforms, such as WeChat Mini Games and Huawei Quick Game Waiting;
  5. Android

For the detail of the texture compression support of the platforms, please refer to the Compressed Texture Chapter documentation.

Add / remove texture compression presets

Enter the name of the compressed texture preset in the input box and press Enter or the plus button on the left to add it.

Add texture compression preset

After adding the compressed texture preset, if you need to delete it, you can directly move the mouse to the preset name and click the delete button on the right.

Delete texture compression preset

Add / remove texture compression format

Click the Add Format button, select the desired texture format, and configure the corresponding quality level. Currently, only one image format of the same type can be added at the same time.

Add texture compression format

To delete, move the mouse over the texture format and click the red delete button.

Modify compressed texture preset name

The name of the compressed texture is only used for display. When adding a compressed texture preset, uuid will be randomly generated as the ID of the preset, so directly modifying the preset name will not affect the reference to the preset in the image asset.

Modify the name of the texture compression preset

Export / import compressed texture presets

The compressed texture configuration page allows developers to import and export compressed texture presets for better cross-project reuse. It is also possible to edit the compressed texture presets externally and import them into the editor.

In most cases, importing and exporting directly works well. If, however, the configuration needs to be customized, please refer to the following interface definitions and examples:

  1. type IConfigGroups = Record<ITextureCompressPlatform, IConfigGroupsInfo>;
  2. type ITextureCompressPlatform = 'miniGame' | 'web' | 'ios' | 'android' | 'pc';
  3. type ITextureCompressType =
  4.     | 'jpg'
  5.     | 'png'
  6.     | 'webp'
  7.     | 'pvrtc_4bits_rgb'
  8.     | 'pvrtc_4bits_rgba'
  9.     | 'pvrtc_4bits_rgb_a'
  10.     | 'pvrtc_2bits_rgb'
  11.     | 'pvrtc_2bits_rgba'
  12.     | 'pvrtc_2bits_rgb_a'
  13.     | 'etc1_rgb'
  14.     | 'etc1_rgb_a'
  15.     | 'etc2_rgb'
  16.     | 'etc2_rgba'
  17.     | 'astc_4x4'
  18.     | 'astc_5x5'
  19.     | 'astc_6x6'
  20.     | 'astc_8x8'
  21.     | 'astc_10x5'
  22.     | 'astc_10x10'
  23.     | 'astc_12x12';
  24. type IConfigGroupsInfo = Record<ITextureCompressType, IQuality>
  25. interface ICompressPresetItem {
  26.     name: string;
  27.     options: IConfigGroups;
  28. }

Example:

  1. {
  2.     "default": {
  3.         "name": "default",
  4.         "options": {
  5.             "miniGame": {
  6.                 "etc1_rgb": "fast",
  7.                 "pvrtc_4bits_rgb": "fast"
  8.             },
  9.             "android": {
  10.                 "astc_8x8": "-medium",
  11.                 "etc1_rgb": "fast"
  12.             },
  13.             "ios": {
  14.                 "astc_8x8": "-medium",
  15.                 "pvrtc_4bits_rgb": "fast"
  16.             },
  17.             "web": {
  18.                 "astc_8x8": "-medium",
  19.                 "etc1_rgb": "fast",
  20.                 "pvrtc_4bits_rgb": "fast"
  21.             },
  22.         }
  23.     },
  24.     "transparent": {
  25.         "name": "transparent",
  26.         "options": {
  27.             "miniGame": {
  28.                 "etc1_rgb_a": "fast",
  29.                 "pvrtc_4bits_rgb_a": "fast"
  30.             },
  31.             "android": {
  32.                 "astc_8x8": "-medium",
  33.                 "etc1_rgb_a": "fast"
  34.             },
  35.             "ios": {
  36.                 "astc_8x8": "-medium",
  37.                 "pvrtc_4bits_rgb_a": "fast"
  38.             },
  39.             "web": {
  40.                 "astc_8x8": "-medium",
  41.                 "etc1_rgb_a": "fast",
  42.                 "pvrtc_4bits_rgb_a": "fast"
  43.             },
  44.         }
  45.     }
  46. }

Layers

Layers

  • Layers allows the camera to render part of the scene and let the light illuminate part of the scene.
  • You can customize 0 to 19 Layers, and the original settings will be deleted when you clear the input box.
  • The last 12 Layers are built-in in the engine and cannot be modified.

  • The layers of node matches the visibility option of the camera, the camera can only see nodes whose layer is included in the camera’s visibility.

    Layers-node

    Layers-camera

For more instructions, please refer to Camera Component introduction;

Physics

Used to configure the parameters of the physics environment. For details, please refer to the Physics Configs documentation.

Bone map layout settings

Explicitly specify the bone texture layout to assist the instancing of the skinning models. For details, please refer to the Joints Texture Layout documentation.