Skip to content
OpenTS Manual

Priority

Changed in 0.2.0

How firmly a team holds its members against other teams, or how hard a sound competes for a playback channel.

Team recruitment priority

Specification — Team recruitment priority
Applies to
TeamType
File
ai.ini or map file
Section
[<ObjectType ID>]
Value
integer
When omitted
7

A team can recruit an object that is already on another team only when its own Priority is strictly greater than that team’s. Teams with equal values, including all teams left at the default, never take members from each other. The value plays no part in which AI trigger is drawn and does not set a build order.

Priority also decides which teams a computer house empties when its base is attacked: those whose Priority is below SuspendPriority. At the default SuspendPriority, a team left at the default Priority is emptied every time the house calls defenders back. To protect a team, give its TeamType a Priority of at least SuspendPriority.

Sound playback priority

Specification — Sound playback priority
Applies to
Sounds
File
SOUND.INI / SOUND01.INI
Section
[<Sound ID>]
Value
string
When omitted
10

Priority= decides which sound effect gives up its voice when more sound effects want to play than Channels= allows. A higher priority wins. Write a number from 0 to 255, or one of LOWEST, LOW, NORMAL, HIGH and CRITICAL for 0, 10, 50, 100 and 255. A number outside that range is held to it, and any other word is ignored.

A new sound takes a free voice whatever its priority. When every voice is in use, the playing sound with the lowest priority is the one that can give up its voice. Among equal priorities, that is the quietest, or the oldest when their loudness is within a tenth. The new sound takes that voice when either is true:

  • its priority is higher;
  • the priorities are equal, and the playing sound is more than a tenth quieter than the new one.

Otherwise the new sound is refused and does not play. With QUEUE in its Control=, a sound refused when the game plays it keeps trying for up to two seconds first.

sound01.ini
[EXPLOLG1]
Priority=50


[MYALERT]
Priority=CRITICAL

Loudness only breaks ties between equal priorities; a quiet or distant sound keeps the priority it was given. Limit= applies first and separately, among copies of the same sound.

See also — Limit, Volume, Channels, ai-team-production, Max, Recruiter

History

  1. Changed0.2.0In development

    Define sounds with the Yuri's Revenge SOUND.INI keys