Skip to content

Advanced

aussig edited this page Jul 30, 2024 · 5 revisions

Advanced Functionality

This page describes advanced functionality of the plugin that you don't need to be aware of in normal use.

Forcing a Tick

In certain rare circumstances, only usually observed when either a new major game update is released or if CMDR Zoy's tick detector (used by BGS-Tally to track ticks) is down, you may need to force BGS-Tally onto a new tick.

Only do this if you know for certain that a tick has happened, but CMDR Zoy's Detector and therefore BGS-Tally are not showing it.

The function is available in the BGS-Tally settings panel:

Force Tick Button

Configuring Overlay Panel Positions

The in-game overlay displays various panels of information as you play the game. If you would like to change the positions of these panels, if you don't like the positioning or if they overlap with other plugins, then follow these steps:

  1. Locate your BGS-Tally plugin folder. You can find it in the Plugin Settings panel in EDMC: See Steps 5-7 in the Installation instructions page for info on how to do this.
  2. Locate the config folder inside your BGS-Tally folder.
  3. Locate the userconfig.template.ini file inside the config folder.
  4. Make a copy of this file, and rename it to userconfig.ini.
  5. Edit the contents of userconfig.ini to use your own preferred settings.

Warning

DO NOT EDIT config.ini, config.template.ini or userconfig.template.ini as any changes you make will be wiped out on the next plugin update.

Each panel is configured in its own section of the file, with the section title in square brackets. For example the [overlay.frame.cmdr_info] section controls the panel showing information about CMDRs you interact with in-game. The available panels are:

  • [overlay.frame.cmdr_info] - Information about CMDRs you interact with in game.
  • [overlay.frame.indicator] - Small rectangular indicator that flashes up whenever you do any BGS or TW activity.
  • [overlay.frame.info] - Panel that shows general information about the BGS-Tally plugin, for example on startup.
  • [overlay.frame.system_info] - Panel showing information about the system you have just done BGS or TW work in.
  • [overlay.frame.tick] - Panel showing the time of the last tick.
  • [overlay.frame.tickwarn] - Panel showing warning or info messages about the tick (for example if it's imminent or overdue).
  • [overlay.frame.tw] - Panel showing information about the Thargoid War progress in the current system.
  • [overlay.frame.warning] - Panel showing warning messages, for example when you have targeted a friendly ship in a CZ.

The available settings for each panel are:

  • border_colour - The colour of the border of the panel. Can be None for no border, a basic colour name such as red, or a hex colour value such as #020202.
  • fill_colour - The background fill colour of the panel. Can be None for no border, a basic colour name such as red, or a hex colour value such as #020202. Note that solid fills can be unreliable as they can sometimes obliterate the contents of the panel. Use with caution.
  • text_colour - The colour of the text in the panel. Can be None for no border, a basic colour name such as red, or a hex colour value such as #020202.
  • title_colour - The colour of the text title of the panel. Can be None for no border, a basic colour name such as red, or a hex colour value such as #020202.
  • x - The x-position of the panel. If x_center is False then this is the number of pixels from the left edge of the screen. If x_center is True then this is the number of pixels from the center of the screen (and can be negative). The total horizontal pixels is standardised at 1280 irrespective of the resolution you have your monitor set to.
  • y - The y-position of the panel. If y_center is False then this is the number of pixels from the top edge of the screen. If y_center is True then this is the number of pixels from the center of the screen (and can be negative). The total vertical pixels is standardised at 960 irrespective of the resolution you have your monitor set to.
  • w - The width of the panel. The total horizontal pixels is standardised at 1280 irrespective of the resolution you have your monitor set to.
  • h - The height of the panel. The total vertical pixels is standardised at 960 irrespective of the resolution you have your monitor set to.
  • x_center - Set to True if the panel should be horizontally centered on the screen.
  • y_center - Set to True if the panel should be vertically centered on the screen.
  • ttl - The "Time to Live" (in seconds) when data is displayed in the panel before the panel automatically disappears.
  • text_size - Set to large if the panel text should be in a large font, or normal for the normal sized font.

Note that if you remove a panel configuration section from the file, or omit any settings from within a section then those settings will revert to the defaults.

Also note that some values are automatically set by BGS-Tally and cannot be overridden - for example the colour of the text in the tick warning panel is automatic (it changes based on the relationship between the current time and the tick time), as is the TTL for the tick panel (as it is always visible).