Font size

AnyLogic Preferences

Preferences dialog box allows you to change AnyLogic preferences.

To open AnyLogic Preferences dialog box

  1. Choose Tools > Preferences... from the main menu.

General page

The General page contains controls for setting up general AnyLogic preferences:

  • Show welcome page on startup — If selected, the Welcome page will be shown every time you start AnyLogic.
  • Notify about AnyLogic updates — If selected, you will be notified about new updates of AnyLogic. In the case you have valid Support Services, you will be able to download new releases from the website.
  • Show new survey/feedback invitations — If selected, checks whether there is a new online survey to fill and prompts the user to the survey, if any.
  • The number of recently opened models in the File menu — Here you can define the maximum number of shortcuts to recently opened models that will be present in the File > Recently Opened Models submenu.
  • Default model location — Here you select the folder that will serve as a default location when creating a model or saving it with a new name.
  • Enable autosave — If selected, all AnyLogic models currently opened in the workspace will be automatically saved in the background when the defined interval (set in the Autosave interval box) will elapse from the moment of the last save. You can find more information on automatic backup and recovery of AnyLogic models in Automatic backup and recovery of models.
  • Language — AnyLogic UI is currently localized into English, Chinese, Spanish, Russian, and Portuguese (Brazil). When you start AnyLogic, it chooses the localization language according to the locale settings of your operating system (if AnyLogic is not localized for the particular user's locale, English is used). Here you can change the language of AnyLogic if you want to use another language.

Development page

The Development page contains the preferences that define development details of models and libraries.

  • Preview rename results — If selected, every time the user will rename some model element(s) using the Refactor > Rename command, the Operation results preview dialog showing all possible changes will be displayed.
  • Preview code format results — If selected, every time the user wants to format their code using the Format Code command, the Operation results preview dialog showing the preview of formatted code will be displayed.
    • Maximum line width for code format — Here the user can specify the maximum number of symbols to fit in one line of code. The code formatting operation will modify the code accordingly when executed.
  • Show tooltips in Palette and Properties — If selected, when you hover the mouse over some element name in the Palette and Properties, a tooltip showing the element description is shown.
  • Show line numbers — If selected, the line numbers are shown in Java editor.
  • Library developer mode — If selected, unhides the specific properties that may be useful only if you develop custom libraries. Please see Library Developer Mode for details.
    • Create datasets for dynamic variables — Defines the default value of the Create datasets for dynamic variables option for all new agent types the user will create (you can find this option in the Advanced section of the agent type’s properties, more details in the Create datasets for dynamic variables property description).
  • Hide Problems view when there are no errors — If selected, the Problems view will hide automatically when models do not contain any errors, otherwise the view visibility will be controlled solely by user.
  • Hide Console view when model run is finished — If selected, the Console view will hide automatically when model run is finished, otherwise the view visibility will be controlled solely by user.
  • Continue launch if project contains errors — The group of buttons defining whether AnyLogic will continue launch if a project contains errors.
    • Always — a project will be launched anyway.
    • Prompt — the message box will be shown informing about the errors and providing an ability to cancel launch or continue anyway.

Graphical editor page

The Graphical editor page of AnyLogic preferences contains settings related to the graphical editor.

  • Flowchart block connection — The section of preferences that defines rules for drawing flowcharts in the graphical editor.
    • Connect automatically, when ports are close enough — If this option is selected, the connectors between library blocks that you drop onto the agent diagram will be drawn automatically if the distance between them is less than 70 pixels.
    • Enable drawing connectors by single-clicking — This option is not selected by default. Select it if you want to start drawing connectors with one click.
    • Delete hanging connector when deleting flowchart block — This option may be useful when you do not want to delete connectors that you do not need anymore, and the new library blocks, which you might want to add instead of deleted ones, connect automatically.
  • Change agent scale on adding specific space markup elements (roads, rails) — Here you define whether AnyLogic will propose the user to change the agent scale on adding rail- or road-related space markup shapes on its graphical diagram.
  • Auto-resize 3D objects to match agent scale — Here you define whether AnyLogic will automatically resize 3D objects that you add on the agent's graphical diagram to make them correspond to the current agent scale (e.g., scale houses to correspond to railways drawn on the canvas). Note that this setting affects only the newly added 3D objects and does not affect the 3D objects already present on the graphical diagram.

Connection page

The Connection page enables to set up connection settings.

The Connection settings comprises three sections

  • General connection settings
    • If you use a proxy, select the Use proxy check box and define the settings in the Http proxy and Port edit boxes. If required, specify Login and Password.
    • If you use a proxy to access internet (e.g. a GIS map server), but you also need to bypass a proxy to connect to a local server (e.g. a database server), you can type the local server name in the Do not use proxy for addresses beginning with list (see the figure above). You can list several URLs here separated by semicolons.
  • AnyLogic License Server settings
    • The AnyLogic License Server section is available only if you use team license.
    • Server — Name (address) of Team License Server installed on a corporate server.
    • Port — Port that is used to connect to Team License Server.
  • AnyLogic Cloud connection settings
    • AnyLogic Cloud access — Enables or disables access to AnyLogic Cloud.
      This option is enabled by default and allows AnyLogic users to access AnyLogic Cloud. Use the options below to select the type of Cloud you are using:
      • AnyLogic Cloud (
      • Private Cloud installed in your proprietary network
      Disabling the AnyLogic Cloud access option will hide the toolbar Log in button and the Run Configuration editor, as well as the controls for logging into the AnyLogic Cloud account and exporting models from the AnyLogic interface.
    • Private Cloud address [Enabled if the Private Cloud installed in your proprietary network option is selected] — Enter the address of your Private Cloud instance.
      The default address is a stub. It will not connect you to any instance of Private Cloud.
    • Check Cloud compatibility — [Enabled if the Private Cloud installed in your proprietary network option is selected] Click this button to check whether it is possible to connect to your AnyLogic Private Cloud and if the instance supports all required features.
      Starting with version 8.8, AnyLogic requires that the Private Cloud instance you are using supports Java 11, that is, your Private Cloud version must be 2.3.0 or higher.

Key combinations page

The Key combinations page enables you to change the shortcut keys for the commands. The table on the page lists commands and shortcut keys assigned to them. Currently it allows to change the key combination for code completion.

To set a new shortcut for a command

  1. Select the row holding a required command in the table.
  2. Click in the Key Sequence cell and press the keys combination that you want to use as a shortcut key.

Runtime page

The Runtime preferences page allows you define a model run-time behavior.

  • Show counters at flowchart blocks — If selected, the counters will be shown near libraries' block icons (displaying the number of agents inside the block, the number of agents entered the block, etc.), see the figure below.
  • Animate ports of flowchart blocks — If selected, the states of the flowchart block ports will be animated at model runtime. If there are some agents pending at the port, the port will be highlighted with dark orange, as shown on the figure below.

  • Report warnings during model simulation — If selected, the warnings will be displayed in the console during the model run.
  • Display distant 3D objects with low level of detail — If selected, particularly complex 3D objects are displayed in a simplified manner at camera zoom out. Simplification starts when the distance from the camera to the 3D object exceeds 12 * r, where r - radius of the sphere that circumscribes the 3D object. Displaying 3D objects with low level of detail will improve the performance in models with heavy 3D animation.
  • Number of processors for parallel execution — AnyLogic supports multicore processors. When you start an optimization or a parameter variation experiment, AnyLogic may run several iterations in parallel on different processor cores. Thereby performance is multiply increased and the experiment is performed significantly faster than on single core processor. If your machine has a multicore processor, here you can set the number of processors to be used for parallel execution of model runs by AnyLogic.
  • Select browser for model animation — Here you can select the browser to run the model animation. If Embedded Chromium option is selected, the model animation will run in the default Chromium browser which is included in the AnyLogic installation package. If you want to use a browser that is not on the list of offered options, select Custom option and specify the path to the browser.

Database page

On the Database page you can tune the settings related to the built-in AnyLogic database.

  • Show warnings about data loss — If selected, the user will see warnings about data loss.
  • Show warnings about potential data loss — If selected, the user will see warnings about potential data loss.
  • Show database questions — If selected, the user will see questions generated by the database.
  • Show hidden ID column "al_id" — If selected, the hidden column al_id will be visible in the table editor. This column contains unique identifiers for the table records.
  • Remove the model log before committing to SVN repository — If you use SVN and commit your models to it, this option allows to choose whether the model log should be committed along with the model or not.
  • Connection timeout — Here you define the timeout for connection to the database (in seconds).
  • Maximum available memory for AnyLogic DB server — Here you define how much memory (in GB) you want to make available for the AnyLogic DB server. The default setting (0 GB) means that AnyLogic database will use 1/4 of the available RAM. This setting is applicable only to the models run in the AnyLogic IDE. The exported models use a common memory resource both for the model and the DB. The maximum size of the required memory should be specified either in the properties of the experiment (in case of export as a standalone Java application) or in the Run Configuration panel in case of export to the AnyLogic Cloud.

Advanced page

The Advanced page of AnyLogic preferences contains additional AnyLogic settings.

  • Show memory heap status (Restart application to apply option) — If selected, the heap status will be shown in the AnyLogic status bar (this option requires restarting AnyLogic to be applied).
  • Run button (F5) — The option sets the default behavior of the Run button, which you can find the on the AnyLogic toolbar. You can select which type of the model should be run when you click this button or press F5 on your keyboard: Launches the model just created / opened or Launches the previously run experiment.
    You can click the arrow next to the Run button on the AnyLogic toolbar to explicitly select the experiment you want to run.
  • Build model sources automatically — If the option is selected, AnyLogic will generate model's source files after each structural model change in the IDE (adding new element to the graphical editor, renaming / deleting / ignoring element, etc.). It will keep the code completion information up-to-date, however it can significantly impair the development process by doing frequent code compilations. If you deselect this option, it is you who will decide when to recompile your model by using the Build model (F7) toolbar button.
How can we improve this article?