API changes at 2009-01-16

[TrueBrain]

Today, we pushed through some name consistancy changes ... this will break most (if not all) AIs again. We are sorry for this, but at this stage this simply is required. As far as I can tell, this should be the last API change for at least this month. From now on we will collect API changes a bit more, and push them through in one day. Nevertheless, expect API changes up till the point we start our release cycle.

Todays changes, consts renaming:

Code: Select all

   INVALID_TOWN_RATING        -> TOWN_RATING_INVALID
   INVALID_TRANSPORT          -> TRANSPORT_INVALID
   INVALID_ORDER              -> ORDER_INVALID
   INVALID_GROUP              -> GROUP_INVALID
   ALL/DEFAULT_GROUP          -> GROUP_ALL/DEFAULT
   VEHICLE_RAIL/ROAD/..       -> VT_RAIL/ROAD/..
   MY_COMPANY                 -> COMPANY_SELF
   FIRST/LAST/INVALID_COMPANY -> COMPANY_FIRST/LAST/INVALID

Any questions, feel free to ask!

[Moriarty]

This may already be the case - but is there an NOAI API version? As in, each time you add a bunch of features (as you're planning on doing in clumps in the future), the version number could be incremented, like with save-game versions.
Then the AI's could come with version numbers to reflect what API they're currently workable with.
Just a thought.

[Yexo]

There is no API version stored currently, and imo it's not necessary. Last week there were several API changes, but if all is well API changes should almost never happen anymore. Also, when you upload an AI to bananas you can specify a minimum and maximum version of OpenTTD that your AI works with.