Changes for page Breaking Changes

Last modified by Michael Baumgardt on 2026/04/17 12:03

From version 123.2
edited by Matthias Haan
on 2024/12/20 11:39
Change comment: There is no comment for this version
To version 106.1
edited by Daniel Turner
on 2023/08/25 10:25
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.Matthias
1 +xwiki:XWiki.Daniel
Content
... ... @@ -18,82 +18,26 @@
18 18  
19 19  = Breaking Changes =
20 20  
21 -{{toc scope="LOCAL" start="3"/}}
22 -
23 -=== Version 7.50 ===
24 -
25 -(% class="table-striped" %)
26 -|(% colspan="1" style="width:117px" %)Parameters
27 -|(% colspan="4" style="width:117px" %)The <radar> section of <holomap> parameters has drastically changed its structure.
28 -
29 -=== Version 7.00 ===
30 -
31 -
32 -(% class="table-striped" %)
33 -|(% colspan="1" style="width:117px" %)Gamestarts|(% colspan="1" style="width:119px" %)7.00 Beta 8|(% colspan="2" style="width:1625px" %)**Text references**
34 -|(% colspan="4" style="width:117px" %)//Fields containing text references in gamestarts.xml now have full text conversion applied, allowing texts to be constructed from multiple text entries, e.g. {1234,56}\n\n{1234,78}. As a result, raw text placed in the text fields needs to be formatted accordingly, e.g. "Test start (easy)" would need to be changed to "Test start \(easy\)" to avoid the text in brackets being treated as a comment.//
35 -|(% colspan="1" style="width:117px" %)Assets|(% colspan="1" style="width:119px" %)7.00 Beta 7|(% colspan="2" style="width:1625px" %)**\assets\textures\fx\highway_fx_electric_02** was deleted and replaced with **\assets\textures\fx\fx_p2_electric_01**
36 -|(% colspan="4" style="width:117px" %)highway_fx_electric_02 is still available in "legacy" folder if needed
37 -|(% colspan="1" style="width:117px" %)Parameters|(% colspan="1" style="width:119px" %)7.00 Beta 7|(% colspan="2" style="width:1625px" %)**<aiflight><skills>**: **strafespeed**, **strafeacc**, **steeringspeed**, **steeringacc** moved to separate nodes; added support for min and max values
38 -|(% colspan="4" style="width:117px" %)(((
39 -//The four parameters used to represent flat factors applied to ships' properties with respect to their respective pilots' skill levels. Parameters moved to separate nodes with support for min and max values which, if supplied, scales the factor linearly if the affected ship's unmodified property is within min and max. Factor does not affect the ship if that property is below min.//
21 +(% class="wrapped" %)
22 +|=(((
23 +Type
24 +)))|=(((
25 +Version
26 +)))|=(((
27 +Summary
40 40  )))
41 -|(% colspan="1" style="width:117px" %)Scripts|(% colspan="1" style="width:119px" %)7.00 Beta 6|(% colspan="2" style="width:1625px" %)MD action **<set_holomap_target>** parameter change.
42 -|(% colspan="4" style="width:117px" %)(((
43 -//The **pantime** parameter has never actually done anything beyond turning panning on or making the transition instant. To make this clear it has been** **replaced with the boolean parameter **instant.**//
44 -)))
45 -|(% colspan="1" style="width:117px" %)Assets|(% colspan="1" style="width:119px" %)7.00 Beta 1|(% colspan="2" style="width:1625px" %)Renamed some material names and changed file paths for textures.
46 -|(% colspan="4" style="width:117px" %)(((
47 -(% style="color:#ffffff" %)//Some material names and texture paths were changed. Please DIFF the materiallibrary.xml from 6.20 with 7.0 to see the difference//
48 -)))
49 -|(% colspan="1" style="width:117px" %)(% colspan="1" %)
29 +|(% colspan="3" %)(% colspan="3" %)
50 50  (((
51 -Scripts
52 -)))|(% colspan="1" style="width:119px" %)(((
53 -7.00 Beta 1
54 -)))|(% colspan="2" style="width:1625px" %)(((
55 -MD action **<set_presentation_cluster_persistence/>** now requires the cluster to be a presentation cluster.
31 +== 6.00 ==
56 56  )))
57 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
58 -(((
59 -// Previously it was possible to set normal clusters to be persistent presentation clusters which was an invalid state.//
60 -)))
61 -|(% colspan="1" style="width:117px" %)(% colspan="1" %)
62 -(((
63 -UI extensions
64 -)))|(% colspan="1" style="width:119px" %)(((
65 -7.00 Beta 1
66 -)))|(% colspan="2" style="width:1625px" %)(((
67 -**FFI**: RemoveBuildPlot() changed
68 -)))
69 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
70 -(((
71 -// The build plot's buildstorage is no longer removed implicitly. The buildstorage will instead be cleaned-up once it is empty and no ships are docked.//
72 -)))
73 -|(% colspan="1" style="width:117px" %)(% colspan="1" %)
74 -(((
75 -Assets
76 -)))|(% colspan="1" style="width:119px" %)(((
77 -7.00 Beta 1
78 -)))|(% colspan="2" style="width:1625px" %)(((
79 -**Some Split DLC materials moved to base game**
80 -)))
81 -|(% colspan="7" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
82 -(((
83 -// //"spl_p1_fx" AND "split_p1_hulltexture_01" were moved from Split DLC to base game
84 -)))
85 -
86 -=== Version 6.00 ===
87 -
88 -(% class="table-striped" %)
89 89  |(((
90 90  Libraries
91 91  )))|(((
92 92  6.00 Beta 7
93 -)))|(% colspan="2" %)(((
37 +)))|(((
94 94  Updated weights for ship groups in shipgroups.xml libraries of base game and all DLCs.
95 95  )))
96 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
40 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)
97 97  (((
98 98  //Previously some entries were lacking "weight" parameter, causing it to default to "1", which prevent adding new ships to the group with appropriate/configurable granularity.//
99 99  
... ... @@ -105,11 +105,11 @@
105 105  )))|(% colspan="1" %)(% colspan="1" %)
106 106  (((
107 107  6.00 Beta 4
108 -)))|(% colspan="2" %)(% colspan="1" %)
52 +)))|(% colspan="1" %)(% colspan="1" %)
109 109  (((
110 110  Changed conditions for **<event_player_travelmode_started> <event_player_travelmode_stopped> <event_player_travelmode_charge_started> <event_player_travelmode_charge_aborted>** to be raised.
111 111  )))
112 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
56 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)
113 113  (((
114 114  //The <event_player_travelmode_started>, <event_player_travelmode_stopped>, <event_player_travelmode_charge_started> and <event_player_travelmode_charge_aborted> events will no longer be raised if the player is a passenger on board a ship which enters or leaves travel mode. Previously these events would be raised whether the player was the pilot or a passenger. //
115 115  
... ... @@ -121,11 +121,11 @@
121 121  )))|(% colspan="1" %)(% colspan="1" %)
122 122  (((
123 123  6.00 Beta 3
124 -)))|(% colspan="2" %)(% colspan="1" %)
68 +)))|(% colspan="1" %)(% colspan="1" %)
125 125  (((
126 126  Changed result of **<find_object_surface>** action in the case of a failure
127 127  )))
128 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
72 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)
129 129  (((
130 130  //The 'posname' and 'rotname' result attributes of <find_object_surface> will now return null in the case of no valid surface position being found.//
131 131  
... ... @@ -139,11 +139,11 @@
139 139  )))|(% colspan="1" %)(% colspan="1" %)
140 140  (((
141 141  6.00 Beta 1
142 -)))|(% colspan="2" %)(% colspan="1" %)
86 +)))|(% colspan="1" %)(% colspan="1" %)
143 143  (((
144 144  Behaviour change for **<match_dock>** script component filter
145 145  )))
146 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
90 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)
147 147  (((
148 148  //<match_dock> nodes can now be used on container and walkablemodule classes without wrapping them in <match_content> nodes.
149 149  This has introduced a new potential pitfall: If finding or counting contained components be wary that there may be multiple positive results, even if there is only one dockingbay. e.g. matching contents for a station will include the dockingbay but also its containing walkable module as that also contains the dockingbay. To only account for docking bays, also filter by dockingbay class.//
... ... @@ -154,11 +154,11 @@
154 154  )))|(% colspan="1" %)(% colspan="1" %)
155 155  (((
156 156  6.00 Beta 1
157 -)))|(% colspan="2" %)(% colspan="1" %)
101 +)))|(% colspan="1" %)(% colspan="1" %)
158 158  (((
159 159  Changed result attribute location for **<get_attackstrength>**
160 160  )))
161 -|(% colspan="4" title="Background colour :" %)(% colspan="3" title="Background colour :" %)
105 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" title="Background colour :" %)
162 162  (((
163 163  //The 'result' attribute of get_attackstrength has been moved into the new <result> subnode and renamed to 'total'.//
164 164  )))
... ... @@ -166,10 +166,10 @@
166 166  Assets
167 167  )))|(((
168 168  6.00 Beta 1
169 -)))|(% colspan="2" %)(((
113 +)))|(((
170 170  Surface element **connections** are incompatible by default unless tagged as "**standard**", and also "**combat**" for non-missile, non-mining weapons
171 171  )))
172 -|(% colspan="4" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
116 +|(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
173 173  (((
174 174  //Connection tags used to specify compatibilities in component templates between a ship or station module and engines or shields now additionally require the use of the "standard" tag matching weapon or turret logic. For weapons that are neither Missile Launcher nor Mining Laser, the tag "combat" is also required.
175 175  Exception: special equipment that is deliberately not compatible with the majority of slots may use another tag instead of "standard", e.g. "highpower" for certain Terran weapons.//
... ... @@ -180,11 +180,11 @@
180 180  )))|(% colspan="1" %)(% colspan="1" %)
181 181  (((
182 182  6.00 Beta 1
183 -)))|(% colspan="2" %)(% colspan="1" %)
127 +)))|(% colspan="1" %)(% colspan="1" %)
184 184  (((
185 185  Changed behaviour of attribute **sortbygatedistanceto** when finding objects, discarding unreachable objects
186 186  )))
187 -|(% colspan="4" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
131 +|(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
188 188  (((
189 189  //When finding components with attribute "sortbygatedistanceto", e.g. in <find_object>, any objects with a negative gatedistance (i.e. unreachable objects) are automatically excluded from the result.//
190 190  )))
... ... @@ -192,10 +192,10 @@
192 192  Scripts
193 193  )))|(((
194 194  6.00 Beta 1
195 -)))|(% colspan="2" %)(((
139 +)))|(((
196 196  **<event_player_owned_killed_object>** and **<event_player_owned_destroyed>** are now triggered before the corresponding **<event_object_destroyed>**, instead of afterwards.
197 197  )))
198 -|(% colspan="4" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
142 +|(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
199 199  (((
200 200  //The order of events was adjusted, allowing handlers of <event_player_owned_killed_object> and <event_player_owned_destroyed> to access commander/subordinate relationship of the destroyed object.//
201 201  )))
... ... @@ -203,36 +203,32 @@
203 203  Cutscenes
204 204  )))|(((
205 205  6.00 Beta 1
206 -)))|(% colspan="2" %)(((
150 +)))|(((
207 207  Changed behaviour of **<angles>** in cutscenes
208 208  )))
209 -|(% colspan="4" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
153 +|(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)(% class="highlight-#f4f5f7" colspan="3" data-highlight-colour="#f4f5f7" title="Background color : Light grey 100%" %)
210 210  (((
211 211  //The yaw and pitch nodes in <angles> are now correctly interpreted as values in degrees.//
212 212  )))
213 -
214 -----
215 -
216 -=== Version 5.00 ===
217 -
218 -(% class="table-striped" %)
157 +|(% colspan="3" %)(% colspan="3" %)
158 +(((
159 +== 5.00 ==
160 +)))
219 219  |(((
220 220  Parameters
221 221  )))|(((
222 222  5.00 Beta 1
223 -)))|(% colspan="2" %)(((
165 +)))|(((
224 224  **<controlpanel><entry>: minduration** removed, **maxduration** renamed to duration
225 225  )))
226 -|(% colspan="7" %)(% colspan="3" %)
168 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
227 227  (((
228 228  //'minduration' was unused in X4, maxduration was and still is taken as the actual duration of control panel hacks. No functionality change.//
229 229  )))
230 -
231 -----
232 -
233 -=== Version 4.10 ===
234 -
235 -(% class="table-striped" %)
172 +|(% colspan="3" %)(% colspan="3" %)
173 +(((
174 +== 4.10 ==
175 +)))
236 236  |(% colspan="1" %)(% colspan="1" %)
237 237  (((
238 238  UI extensions
... ... @@ -239,13 +239,13 @@
239 239  )))|(% colspan="1" %)(% colspan="1" %)
240 240  (((
241 241  4.10 Beta 7
242 -)))|(% colspan="2" %)(% colspan="1" %)
182 +)))|(% colspan="1" %)(% colspan="1" %)
243 243  (((
244 -**FFI**: SetMapRenderCargoContents(), SetMapRenderWorkForceInfo(), SetMapRenderCrewInfo() and SetMapRenderDockedShipInfos() deprecated
184 +**FFI**: SetMapRenderCargoContents(%%)(), SetMapRenderWorkForceInfo(), SetMapRenderCrewInfo() and SetMapRenderDockedShipInfos()(%%) deprecated
245 245  )))
246 -|(% colspan="4" %)(% colspan="3" %)
186 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
247 247  (((
248 -//The functionality represented by SetMapRenderCargoContents(), SetMapRenderWorkForceInfo(), SetMapRenderCrewInfo() and SetMapRenderDockedShipInfos() has been removed and the function was therefore stubbed.//
188 +//The functionality represented by SetMapRenderCargoContents(%%)(), SetMapRenderWorkForceInfo(), SetMapRenderCrewInfo() and SetMapRenderDockedShipInfos()(%%) has been removed and the function was therefore stubbed.//
249 249  )))
250 250  |(% colspan="1" %)(% colspan="1" %)
251 251  (((
... ... @@ -253,11 +253,11 @@
253 253  )))|(% colspan="1" %)(% colspan="1" %)
254 254  (((
255 255  4.10 Beta 6
256 -)))|(% colspan="2" %)(% colspan="1" %)
196 +)))|(% colspan="1" %)(% colspan="1" %)
257 257  (((
258 258  **FFI**: CustomGameStartPlayerProperty2 changed
259 259  )))
260 -|(% colspan="4" %)(% colspan="3" %)
200 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
261 261  (((
262 262  //This struct was added in 4.10 Beta 2 and an additional member count was added in Beta 6.//
263 263  )))
... ... @@ -267,11 +267,11 @@
267 267  )))|(% colspan="1" %)(% colspan="1" %)
268 268  (((
269 269  4.10 Beta 3
270 -)))|(% colspan="2" %)(% colspan="1" %)
210 +)))|(% colspan="1" %)(% colspan="1" %)
271 271  (((
272 272  Renamed **<stationinfobox>** to **<infobox>**
273 273  )))
274 -|(% colspan="4" %)(% colspan="3" %)
214 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
275 275  (((
276 276  //Info box parameters are now shared across stations and ships. The node has a more generic name to reflect that.//
277 277  )))
... ... @@ -281,11 +281,11 @@
281 281  )))|(% colspan="1" %)(% colspan="1" %)
282 282  (((
283 283  4.10 Beta 2
284 -)))|(% colspan="2" %)(% colspan="1" %)
224 +)))|(% colspan="1" %)(% colspan="1" %)
285 285  (((
286 286  **FFI**: SetMacroMapPlayerSectorOffset() deprecated
287 287  )))
288 -|(% colspan="4" %)(% colspan="3" %)
228 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
289 289  (((
290 290  //The functionality represented by SetMacroMapPlayerSectorOffset() has been removed and the function was therefore stubbed. Setting the gamestart properties "sector" and "offset" will affect the universe macro map instead directly.//
291 291  )))
... ... @@ -293,10 +293,10 @@
293 293  UI extensions
294 294  )))|(((
295 295  4.10 Beta 2
296 -)))|(% colspan="2" %)(((
297 -**FFI**: FilterComponentForMapMode() and SetMapObjectFilter() changed
236 +)))|(((
237 +**FFI**: FilterComponentForMapMode(%%)() and SetMapObjectFilter() changed
298 298  )))
299 -|(% colspan="4" %)(% colspan="3" %)
239 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
300 300  (((
301 301  //These functions were added in 4.10 Beta 1 and an additional boolean parameter allowentitydeliverymissionobject was added in Beta 2.//
302 302  )))
... ... @@ -304,10 +304,10 @@
304 304  Scripts
305 305  )))|(((
306 306  4.10 Beta 1
307 -)))|(% colspan="2" %)(((
247 +)))|(((
308 308  People related attributes of mission** <delivery> **node moved
309 309  )))
310 -|(% colspan="4" %)(% colspan="3" %)
250 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
311 311  (((
312 312  //The <delivery> node of <create_mission> and <update_mission> has been changed to support a new <wares> subnode. The people related attributes: 'people' and 'skills' have been moved from the <delivery> node itself to a <people> subnode.//
313 313  )))
... ... @@ -317,11 +317,11 @@
317 317  )))|(% colspan="1" %)(% colspan="1" %)
318 318  (((
319 319  4.10 Beta 1
320 -)))|(% colspan="2" %)(% colspan="1" %)
260 +)))|(% colspan="1" %)(% colspan="1" %)
321 321  (((
322 322  **$destructible.productions** replaced with $defensible.productions
323 323  )))
324 -|(% colspan="4" %)(% colspan="3" %)
264 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
325 325  (((
326 326  //The $destructible.productions script property was removed and reimplemented as $defensible.productions meaning some old uses may no longer work unless the destructible is also a defensible. The old implementation functioned by finding the containing object of the destructible (including itself) to query for the production modules.//
327 327  )))
... ... @@ -329,19 +329,17 @@
329 329  Scripts
330 330  )))|(((
331 331  4.10 Beta 1
332 -)))|(% colspan="2" %)(((
272 +)))|(((
333 333  Removed script property **$object.spawnsourceseed**
334 334  )))
335 -|(% colspan="4" %)(% colspan="3" %)
275 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
336 336  (((
337 337  //The spawnsource seed is no longer directly accessible by scripts. Use $component.seed, which will internally use the spawnsource seed if able. Note: An improvement is that .seed on objects without a spawnsource seed will now result in a value that differs between objects of the same macro, meaning it can now reliably be used for player property or job ships.//
338 338  )))
339 -
340 -----
341 -
342 -=== Version 4.00 ===
343 -
344 -(% class="table-striped" %)
279 +|(% colspan="3" %)(% colspan="3" %)
280 +(((
281 +== 4.00 ==
282 +)))
345 345  |(% colspan="1" %)(% colspan="1" %)
346 346  (((
347 347  UI core
... ... @@ -348,11 +348,11 @@
348 348  )))|(% colspan="1" %)(% colspan="1" %)
349 349  (((
350 350  4.00 Beta 10
351 -)))|(% colspan="2" %)(% colspan="1" %)
289 +)))|(% colspan="1" %)(% colspan="1" %)
352 352  (((
353 353  Controlled ship can change without a **gameplanchange-event** occurring.
354 354  )))
355 -|(% colspan="4" %)(% colspan="3" %)
293 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
356 356  (((
357 357  //Before 4.00 Beta 10 it was ensured that there is no direct transition between the 'cockpit ui mode' of one ship to another. Instead, it was always ensured that the UI first transitions into the firstperson mode and then back into the cockpit mode (controlling then the other ship).
358 358  In order to support the new emergency eject feature which was added in 4.00 Beta 7, this assurance was dropped. As of 4.00 Beta 10 it is now possible that the ship the player controls can swap without the gameplanchange-event being risen which one could rely upon in previous versions. If your addon relied on the fact that the ship would not change without first going into first person mode, you will have to adjust your addon accordingly.//
... ... @@ -361,10 +361,10 @@
361 361  Scripts
362 362  )))|(((
363 363  4.00 Beta 7
364 -)))|(% colspan="2" %)(((
302 +)))|(((
365 365  Parameters of **<event_terraforming_project_succeeded>** and **<event_terraforming_project_failed>** changed
366 366  )))
367 -|(% colspan="4" %)(% colspan="3" %)
305 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
368 368  (((
369 369  //Old params: param = project ID, param2 = were there positive side-effects?, param3 = were there negative side-effects?
370 370  New params: param = project ID, param2 = [were there positive side-effects?, were there negative side-effects?], param3 = payout in Credits
... ... @@ -376,11 +376,11 @@
376 376  )))|(% colspan="1" %)(% colspan="1" %)
377 377  (((
378 378  4.00 Beta 6
379 -)))|(% colspan="2" %)(% colspan="1" %)
317 +)))|(% colspan="1" %)(% colspan="1" %)
380 380  (((
381 381  **FFI:** GetFactionRelationStatus() handling for faction relation range [-20,-10] changed
382 382  )))
383 -|(% colspan="4" %)(% colspan="3" %)
321 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
384 384  (((
385 385  //In order to keep consistency with regards to the new behvior 'hostile' relation state and the older (deprecated) UI functions, the behavior of the deprecated GetFactionRelationStatus() function was changed according to the behavior of the GetRelationStatus()/GetRelationStatus2() functions which was done in the previous beta.
386 386  Factions with a relation rating between -20 and -10 will now report a relation status of 'neutral' (aka: 1) instead of 'hostile'/'enemy' (aka: 0).//
... ... @@ -393,11 +393,11 @@
393 393  )))|(% colspan="1" %)(% colspan="1" %)
394 394  (((
395 395  4.00 Beta 5
396 -)))|(% colspan="2" %)(% colspan="1" %)
334 +)))|(% colspan="1" %)(% colspan="1" %)
397 397  (((
398 398  **FFI:** GetRelationStatus()/GetRelationStatus2() handling for objects in relation range [-25,-10] changed
399 399  )))
400 -|(% colspan="4" %)(% colspan="3" %)
338 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
401 401  (((
402 402  //4.00 Beta 5// //introduces a new 'hostile' relation status and the game now distinguishes between hostile and enemy relation states. Objects not yet 'hostile' with the player are now visualized differently and therefore distinguishable from real hostile ones. Because of that, several related changes were made for these objects to bring them more in line with how 'neutral' objects behave (f.e. no automatic attacking of these objects by the player property anymore, no target selection when targeting the closest enemy, etc.). To reflect this, these objects are now returning 1 (neutral) as the relation status by the GetRelationStatus()/GetRelationStatus2() functions.//
403 403  
... ... @@ -407,10 +407,10 @@
407 407  Parameters
408 408  )))|(((
409 409  4.00 Beta 1
410 -)))|(% colspan="2" %)(((
348 +)))|(((
411 411  **requiresconstructionvessel** parameter moved
412 412  )))
413 -|(% colspan="4" %)(% colspan="3" %)
351 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
414 414  (((
415 415  //The 'requiresconstructionvessel' attribute has been moved from the 'recycling' node itself, to the new 'station' subnode.//
416 416  )))
... ... @@ -418,44 +418,40 @@
418 418  Scripts
419 419  )))|(((
420 420  4.00 Beta 1
421 -)))|(% colspan="2" %)(((
359 +)))|(((
422 422  Changed behaviour of **gatedistance** script property
423 423  )))
424 -|(% colspan="4" %)(% colspan="3" %)
362 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
425 425  (((
426 426  //The 'gatedistance' script property now minimizes the number of gate jumps instead of counting the number gate jumps in the fastest route.//
427 427  )))
428 -
429 -----
430 -
431 -=== Version 3.30 ===
432 -
433 -(% class="table-striped" %)
366 +|(% colspan="3" %)(% colspan="3" %)
367 +(((
368 +== 3.30 ==
369 +)))
434 434  |(((
435 435  UI extensions
436 436  )))|(((
437 437  3.30 Beta 3
438 -)))|(% colspan="2" %)(((
439 -**FFI: **Removed** GetMissionLimit() **and** IsMissionLimitEnabled()**
374 +)))|(((
375 +**FFI: **Removed** GetMissionLimit() (%%)**and** IsMissionLimit**(%%)**Enabled()**
440 440  )))
441 -|(% colspan="7" %)(% colspan="3" %)
377 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
442 442  (((
443 -//These mission limit-related functions (added in 3.30 Beta 1 and 2) are replaced with FFI IsMissionLimitReached()//
379 +//These mission limit-related functions (added in 3.30 Beta 1 and 2) are replaced with FFI IsMissionLimit(%%)Reached()//
444 444  )))
445 -
446 -----
447 -
448 -=== Version 3.20 ===
449 -
450 -(% class="table-striped" %)
381 +|(% colspan="3" %)(% colspan="3" %)
382 +(((
383 +== 3.20 ==
384 +)))
451 451  |(((
452 452  Scripts
453 453  )))|(((
454 454  3.20 Beta 1
455 -)))|(% colspan="2" %)(((
389 +)))|(((
456 456  Parameters of **<event_player_attacked_object/>** and **<event_object_attacked_object/>** changed
457 457  )))
458 -|(% colspan="4" %)(% colspan="3" %)
392 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
459 459  (((
460 460  //Old params: param = attacked object, param2 = attack method, param3 = attacked component//
461 461  //New params: param = attacked object, param2 = attack method, param3 = attack component detail list: [attacked component, attacking weapon]
... ... @@ -467,11 +467,11 @@
467 467  )))|(% colspan="1" %)(% colspan="1" %)
468 468  (((
469 469  3.20 Beta 1
470 -)))|(% colspan="2" %)(% colspan="1" %)
404 +)))|(% colspan="1" %)(% colspan="1" %)
471 471  (((
472 472  Removed script property $trade.**restriction.faction**
473 473  )))
474 -|(% colspan="4" %)(% colspan="3" %)
408 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
475 475  (((
476 476  //$trade.restriction.faction has been replaced with $trade.restriction.factions, which returns a list of factions.//
477 477  )))
... ... @@ -479,19 +479,17 @@
479 479  UI extensions
480 480  )))|(((
481 481  3.20 Beta 1
482 -)))|(% colspan="2" %)(((
416 +)))|(((
483 483  **Lua**: **GetTradeRestrictions()**, **ToggleFactionTradeRestriction()** and **ToggleFactionTradeWareOverride()** are now obsolete!
484 484  )))
485 -|(% colspan="4" %)(% colspan="3" %)
419 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
486 486  (((
487 487  //With the addition of the Trade Rule feature the given functions are obsolete and do not function anymore. This set of functions will return dummy values to avoid breaking scripts. Use GetAllTradeRules(), GetContainerTradeRuleID(), SetContainerTradeRule() and similar trade rule functions as replacement.//
488 488  )))
489 -
490 -----
491 -
492 -=== Version 3.10 ===
493 -
494 -(% class="table-striped" %)
423 +|(% colspan="3" %)(% colspan="3" %)
424 +(((
425 +== 3.10 ==
426 +)))
495 495  |(% colspan="1" %)(% colspan="1" %)
496 496  (((
497 497  Scripts
... ... @@ -498,20 +498,18 @@
498 498  )))|(% colspan="1" %)(% colspan="1" %)
499 499  (((
500 500  3.10 Beta 1
501 -)))|(% colspan="2" %)(% colspan="1" %)
433 +)))|(% colspan="1" %)(% colspan="1" %)
502 502  (((
503 503  Removed script action **<add_build/>**
504 504  )))
505 -|(% colspan="7" %)(% colspan="3" %)
437 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
506 506  (((
507 507  //Removed <add_build/> action which was no longer needed and would result in builds being added in unsupported ways. Use other <add_build_xxx/> actions.//
508 508  )))
509 -
510 -----
511 -
512 -=== Version 3.00 ===
513 -
514 -(% class="table-striped" %)
441 +|(% colspan="3" %)(% colspan="3" %)
442 +(((
443 +== 3.00 ==
444 +)))
515 515  |(% colspan="1" %)(% colspan="1" %)
516 516  (((
517 517  Scripts
... ... @@ -518,11 +518,11 @@
518 518  )))|(% colspan="1" %)(% colspan="1" %)
519 519  (((
520 520  3.0 Beta 6
521 -)))|(% colspan="2" %)(% colspan="1" %)
451 +)))|(% colspan="1" %)(% colspan="1" %)
522 522  (((
523 523  Changed behaviour of script action **<get_suitable_job/>**
524 524  )))
525 -|(% colspan="4" %)(% colspan="3" %)
455 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
526 526  (((
527 527  //<get_suitable_job/> previously did not respect job quotas or the current number of job ships. It now does, only returning job IDs which are not exceeding the maxgalaxy quota. Using 'exceedquota' allows the action to behave as before.//
528 528  )))
... ... @@ -532,11 +532,11 @@
532 532  )))|(% colspan="1" %)(% colspan="1" %)
533 533  (((
534 534  3.0 Beta 6
535 -)))|(% colspan="2" %)(% colspan="1" %)
465 +)))|(% colspan="1" %)(% colspan="1" %)
536 536  (((
537 537  Changed behaviour of script action **<get_ware_definition/>**
538 538  )))
539 -|(% colspan="4" %)(% colspan="3" %)
469 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
540 540  (((
541 541  //<get_ware_definition/> previously filtered for equipment wares by default. This is now not the case and existing cases now use flags="equipment". Additional filter attributes for group and tags has also been added.//
542 542  )))
... ... @@ -546,11 +546,11 @@
546 546  )))|(% colspan="1" %)(% colspan="1" %)
547 547  (((
548 548  3.0 Beta 5
549 -)))|(% colspan="2" %)(% colspan="1" %)
479 +)))|(% colspan="1" %)(% colspan="1" %)
550 550  (((
551 551  Renamed all files in the **md**, ui, and **cutscenes** folders to lower-case
552 552  )))
553 -|(% colspan="4" %)(% colspan="3" %)
483 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
554 554  (((
555 555  //All MD, UI, and cutscene files have been renamed as lower-case. For most users this should have no effect since files packed in catalogs are essentially case-insensitive. However, this change can affect users on Linux systems when running a mod that contains single files instead of a catalog, and/or when playing with unpacked base game files//. If your mod has XML patch files that are not packed in a catalog, the filenames must be lower-case to match the filenames in the base game. (For info on using mod catalogs, see the Readme of the X Catalog Tool.)
556 556  
... ... @@ -562,11 +562,11 @@
562 562  )))|(% colspan="1" %)(% colspan="1" %)
563 563  (((
564 564  3.0 Beta 5
565 -)))|(% colspan="2" %)(% colspan="1" %)
495 +)))|(% colspan="1" %)(% colspan="1" %)
566 566  (((
567 567  Adjustments of some MD library cues in the base game to change their usage from **<include_actions>** to <run_actions>
568 568  )))
569 -|(% colspan="4" %)(% colspan="3" %)
499 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
570 570  (((
571 571  //Some MD library cues in the base game that were previously used with <include_actions> have been adjusted, so they must now be used with the new MD action <run_actions> instead. Mods that use such a library with <include_actions> will have to switch to <run_actions> as well. A list of affected libraries is not provided here. Note: Additional library cues may be adjusted in future builds without further warning.//
572 572  )))
... ... @@ -576,11 +576,11 @@
576 576  )))|(% colspan="1" %)(% colspan="1" %)
577 577  (((
578 578  3.0 Beta 5
579 -)))|(% colspan="2" %)(% colspan="1" %)
509 +)))|(% colspan="1" %)(% colspan="1" %)
580 580  (((
581 581  Changes to $dockingbay.**todockpos** and $dockingbay.**launchpos**
582 582  )))
583 -|(% colspan="4" %)(% colspan="3" %)
513 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
584 584  (((
585 585  //Before the change, positions are relative to $dockingbay.parent.
586 586  After the change, positions are relative to $dockingbay as specified in the documentation.//
... ... @@ -591,11 +591,11 @@
591 591  )))|(% colspan="1" %)(% colspan="1" %)
592 592  (((
593 593  3.0 Beta 2
594 -)))|(% colspan="2" %)(% colspan="1" %)
524 +)))|(% colspan="1" %)(% colspan="1" %)
595 595  (((
596 596  Support for entity flag "**skillsvisible**" dropped
597 597  )))
598 -|(% colspan="4" %)(% colspan="3" %)
528 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
599 599  (((
600 600  //Entity skills are always visible; that flag was a leftover from XR. We removed support for the script property .skillsvisible, the attribute "skillsvisible" of <set_entity_traits> and <set_npc_template_traits>, and the parameter "skillsvisible" of Lua function GetComponentData().//
601 601  )))
... ... @@ -603,10 +603,10 @@
603 603  Scripts
604 604  )))|(((
605 605  3.0 Beta 2
606 -)))|(% colspan="2" %)(((
536 +)))|(((
607 607  Changes to **<event_object_changed_owner>** and added **<event_object_changed_true_owner>**.
608 608  )))
609 -|(% colspan="4" %)(% colspan="3" %)
539 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
610 610  (((
611 611  //Before 3.0 Beta 2 there was just a single <event_object//_changed_owner> condition. This condition was triggered in multiple cases when an owner change occurred. However, the exact cases were inconsistent and also the event could have been triggered w/o an effective owner change having been applied.
612 612  3.0 Beta 2 fixes these inconsistencies and ensures that the event is only fired, if the "effective" component owner of the object changed. To handle cases where the script actually needs to be informed if the "true" owner of a component was changed (i.e. not taking the cover faction into account) a new <event_object_changed_true_owner> was introduced.
... ... @@ -619,11 +619,11 @@
619 619  )))|(% colspan="1" %)(% colspan="1" %)
620 620  (((
621 621  3.0 Beta 1
622 -)))|(% colspan="2" %)(% colspan="1" %)
552 +)))|(% colspan="1" %)(% colspan="1" %)
623 623  (((
624 624  **MissionBoard** support dropped
625 625  )))
626 -|(% colspan="4" %)(% colspan="3" %)
556 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
627 627  (((
628 628  //MissionBoards was a dummy asset type which was only used during early development and never meant to be shipped in the released version. If any mod tried to make use of this asset type, undefined behaviour would occur. Therefore we cleaned things up in 3.0 Beta 1 including deprecating/removing any related UI/script function.//
629 629  )))
... ... @@ -631,10 +631,10 @@
631 631  Job/God
632 632  )))|(((
633 633  3.0 Beta 1
634 -)))|(% colspan="2" %)(((
564 +)))|(((
635 635  By default, **job/god entries** now only spawn objects in space added by the extension in which they are defined
636 636  )))
637 -|(% colspan="4" %)(% colspan="3" %)
567 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
638 638  (((
639 639  //To better support extensions which add to the base game map, a job/god entry now defaults to only spawning objects in areas of the map that are added by the extension in which that entry is defined. You can override this behaviour by adding a matchextension="false" attribute to the job/god entry definition. This allows the entry to spawn objects anywhere that matches the entry's other criteria.//
640 640  )))
... ... @@ -644,11 +644,11 @@
644 644  )))|(% colspan="1" %)(% colspan="1" %)
645 645  (((
646 646  3.0 Beta 1
647 -)))|(% colspan="2" %)(% colspan="1" %)
577 +)))|(% colspan="1" %)(% colspan="1" %)
648 648  (((
649 649  Script action **<add_actor_to_room/> **attribute **'room'** renamed to **'object'**
650 650  )))
651 -|(% colspan="4" %)(% colspan="3" %)
581 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
652 652  (((
653 653  //Due to engine changes, script action <add_actor_to_room/> has had the attribute 'room' changed to 'object', which is more accurate. Most likely requires a 'position' if a slot is not provided.//
654 654  )))
... ... @@ -658,11 +658,11 @@
658 658  )))|(% colspan="1" %)(% colspan="1" %)
659 659  (((
660 660  3.0 Beta 1
661 -)))|(% colspan="2" %)(% colspan="1" %)
591 +)))|(% colspan="1" %)(% colspan="1" %)
662 662  (((
663 663  Script action **<set_doors_locked/>** attribute **'group'** changed
664 664  )))
665 -|(% colspan="4" %)(% colspan="3" %)
595 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
666 666  (((
667 667  //The 'group' attribute of <set_doors_locked/> can no longer be a list. It must be a single tag value. Previously, a list containing one tag was accepted, which was redundant.//
668 668  )))
... ... @@ -672,11 +672,11 @@
672 672  )))|(% colspan="1" %)(% colspan="1" %)
673 673  (((
674 674  3.0 Beta 1
675 -)))|(% colspan="2" %)(% colspan="1" %)
605 +)))|(% colspan="1" %)(% colspan="1" %)
676 676  (((
677 677  Script conditions **<event_hack_*/>** and **<event_controlpanel_hack_*/>** removed
678 678  )))
679 -|(% colspan="4" %)(% colspan="3" %)
609 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
680 680  (((
681 681  //These events were never triggered, with the exception of <event_hack_started/> on the player entity for instant control panel hacks. Use <event_player_hacked_object> instead.//
682 682  )))
... ... @@ -686,11 +686,11 @@
686 686  )))|(% colspan="1" %)(% colspan="1" %)
687 687  (((
688 688  3.0 Beta 1
689 -)))|(% colspan="2" %)(% colspan="1" %)
619 +)))|(% colspan="1" %)(% colspan="1" %)
690 690  (((
691 691  Script actions **<set_hack_target/>** and **<abort_hack/>** removed
692 692  )))
693 -|(% colspan="4" %)(% colspan="3" %)
623 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
694 694  (((
695 695  //These actions had no effect and were removed.//
696 696  )))
... ... @@ -700,11 +700,11 @@
700 700  )))|(% colspan="1" %)(% colspan="1" %)
701 701  (((
702 702  3.0 Beta 1
703 -)))|(% colspan="2" %)(% colspan="1" %)
633 +)))|(% colspan="1" %)(% colspan="1" %)
704 704  (((
705 705  **<setup_conversation_minigame/>** script action removed
706 706  )))
707 -|(% colspan="4" %)(% colspan="3" %)
637 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
708 708  (((
709 709  //The script action was a leftover from the XR era and was never supported in X4 and couldn't be used in a meaningful way. It was therefore decided to better drop it altogether as it's not expected having been used by any mods.//
710 710  )))
... ... @@ -714,11 +714,11 @@
714 714  )))|(% colspan="1" %)(% colspan="1" %)
715 715  (((
716 716  3.0 Beta 1
717 -)))|(% colspan="2" %)(% colspan="1" %)
647 +)))|(% colspan="1" %)(% colspan="1" %)
718 718  (((
719 719  <add_player_choice_*> **confidence** attribute removed
720 720  )))
721 -|(% colspan="4" %)(% colspan="3" %)
651 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
722 722  (((
723 723  //The default confidence of player options is another leftover from the XR era and had no effect in X4.//
724 724  )))
... ... @@ -728,11 +728,11 @@
728 728  )))|(% colspan="1" %)(% colspan="1" %)
729 729  (((
730 730  3.0 Beta 1
731 -)))|(% colspan="2" %)(% colspan="1" %)
661 +)))|(% colspan="1" %)(% colspan="1" %)
732 732  (((
733 733  **<hack_via_control_panel/>** script action removed
734 734  )))
735 -|(% colspan="4" %)(% colspan="3" %)
665 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
736 736  (((
737 737  //Unused script action <hack_via_control_panel/> was removed.//
738 738  )))
... ... @@ -742,11 +742,11 @@
742 742  )))|(% colspan="1" %)(% colspan="1" %)
743 743  (((
744 744  3.0 Beta 1
745 -)))|(% colspan="2" %)(% colspan="1" %)
675 +)))|(% colspan="1" %)(% colspan="1" %)
746 746  (((
747 747  **Lua: **GetMiniGameCursorPosition() removed
748 748  )))
749 -|(% colspan="4" %)(% colspan="3" %)
679 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
750 750  (((
751 751  //GetMiniGameCursorPosition() was a left over from the XR era and never supposed to be shipped with X4. The function practically always returned 0 and hence we don't expect the removal of this obsolete function causing any actual mod to break.//
752 752  )))
... ... @@ -754,10 +754,10 @@
754 754  UI core
755 755  )))|(((
756 756  3.0 Beta 1
757 -)))|(% colspan="2" %)(((
687 +)))|(((
758 758  **FFI: **GetLocalizedInteractiveNotificationKey can return icon placeholders
759 759  )))
760 -|(% colspan="4" %)(% colspan="3" %)
690 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
761 761  (((
762 762  //In 3.0 Beta 1 we added support to display icons for keyboard bindings, if an icon is available for the specified keys. This results in GetLocalizedInteractiveNotificationKey() potentially returning a different text now if such an icon is assigned to the mapped key/button.//
763 763  )))
... ... @@ -767,11 +767,11 @@
767 767  )))|(% colspan="1" %)(% colspan="1" %)
768 768  (((
769 769  3.0 Beta 1
770 -)))|(% colspan="2" %)(% colspan="1" %)
700 +)))|(% colspan="1" %)(% colspan="1" %)
771 771  (((
772 772  **FFI: **UIWeaponMod returned by GetInstalledWeaponMod() now includes property SurfaceElementFactor
773 773  )))
774 -|(% colspan="4" %)(% colspan="3" %)
704 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
775 775  (((
776 776  //In 3.0 Beta 1 we added support for a new weapon mod property "SurfaceElementFactor" to allow weapons to deal increased damage to surface elements such as Shield Generators, Turrets or Engines.//
777 777  )))
... ... @@ -781,11 +781,11 @@
781 781  )))|(% colspan="1" %)(% colspan="1" %)
782 782  (((
783 783  3.0 Beta 1
784 -)))|(% colspan="2" %)(% colspan="1" %)
714 +)))|(% colspan="1" %)(% colspan="1" %)
785 785  (((
786 786  **$ware.illegal** updated
787 787  )))
788 -|(% colspan="4" %)(% colspan="3" %)
718 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
789 789  (((
790 790  //$ware.illegal used to return true if the specified ware has the 'illegal' tag which is no longer used.//
791 791  //It now returns true if $ware is illegal to any faction in the game.//
... ... @@ -796,11 +796,11 @@
796 796  )))|(% colspan="1" %)(% colspan="1" %)
797 797  (((
798 798  3.0 Beta 1
799 -)))|(% colspan="2" %)(% colspan="1" %)
729 +)))|(% colspan="1" %)(% colspan="1" %)
800 800  (((
801 801  MD script **RML_Flight_Along_Path** removed
802 802  )))
803 -|(% colspan="4" %)(% colspan="3" %)
733 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
804 804  (((
805 805  //The MD script RML_Flight_Along_Path was not referened and was removed.//
806 806  )))
... ... @@ -810,11 +810,11 @@
810 810  )))|(% colspan="1" %)(% colspan="1" %)
811 811  (((
812 812  3.0 Beta 1
813 -)))|(% colspan="2" %)(% colspan="1" %)
743 +)))|(% colspan="1" %)(% colspan="1" %)
814 814  (((
815 815  parameters of **<event_venture_mission_completed/>** changed
816 816  )))
817 -|(% colspan="4" %)(% colspan="3" %)
747 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
818 818  (((
819 819  //old params: param = venture details, param2 = ships involved, param3 = duration//
820 820  //new params: param = venture detail list: [mission name, mission type], param2 = list of ships involved, param3 = duration//
... ... @@ -823,11 +823,11 @@
823 823  Scripts
824 824  )))|(((
825 825  3.0 Beta 1
826 -)))|(% colspan="2" %)(((
756 +)))|(((
827 827  **<set_object_wing_name/>** removed,
828 828  **<set_object_fleet_name/>** added
829 829  )))
830 -|(% colspan="4" %)(% colspan="3" %)
760 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
831 831  (((
832 832  //The common action <set_object_wing_name/> has been replaced with <set_object_fleet_name/>//
833 833  )))
... ... @@ -835,28 +835,26 @@
835 835  Scripts
836 836  )))|(((
837 837  3.0 Beta 1
838 -)))|(% colspan="2" %)(((
768 +)))|(((
839 839  **$controllable.wing.*** removed,
840 840  **$controllable.fleet.*** added
841 841  )))
842 -|(% colspan="4" %)(% colspan="3" %)
772 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
843 843  (((
844 844  $controllable.wing.name, $controllable.wing.iscommander, and $controllable.wing.commander have been replaced with $controllable.fleet.name, $controllable.fleet.iscommander, and $controllable.fleet.commander
845 845  )))
846 -
847 -----
848 -
849 -=== Version 2.60 ===
850 -
851 -(% class="table-striped" %)
776 +|(% colspan="3" %)(% colspan="3" %)
777 +(((
778 +== 2.60 ==
779 +)))
852 852  |(((
853 853  Scripts
854 854  )))|(((
855 855  2.60 Beta 1
856 -)))|(% colspan="2" %)(((
784 +)))|(((
857 857  '**checkoperational**' filter behaviour changed
858 858  )))
859 -|(% colspan="10" %)(% colspan="3" %)
787 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
860 860  (((
861 861  //Actions and conditions which use the 'checkoperational' filter now behave differently. Instead of changing how 'class' and 'exactclass' behave, checkoperational == true adds an additional filter for the components being of state operational, equivalent to state="componentstate.operational". This is implicitly enabled in action elements (e.g. <find_.../>) or condition elements (e.g. <count_...>), meaning that find_ship will only find operational ships. Using such actions/conditions with checkoperational="false" will include non-operational components such as wrecked and constructions. Existing uses may find that results now exclude non-operational components.//
862 862  
... ... @@ -866,19 +866,17 @@
866 866  Scripts
867 867  )))|(((
868 868  2.60 Beta 1
869 -)))|(% colspan="2" %)(((
797 +)))|(((
870 870  $container.**supplyresources** behavior changed
871 -)))| | |
872 -|(% colspan="10" %)(% colspan="3" %)
799 +)))
800 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
873 873  (((
874 874  //The script keyword $container.supplyresources now includes reserved wares.//
875 875  )))
876 -
877 -----
878 -
879 -=== Version 2.20 ===
880 -
881 -(% class="table-striped" %)
804 +|(% colspan="3" %)(% colspan="3" %)
805 +(((
806 +== 2.20 ==
807 +)))
882 882  |(% colspan="1" %)(% colspan="1" %)
883 883  (((
884 884  UI core
... ... @@ -885,11 +885,11 @@
885 885  )))|(% colspan="1" %)(% colspan="1" %)
886 886  (((
887 887  2.20 Beta 3/4
888 -)))|(% colspan="2" %)(% colspan="1" %)
814 +)))|(% colspan="1" %)(% colspan="1" %)
889 889  (((
890 890  **Lua: GetControllerInfo()** returned mouseSteering/mouseCursor values are undefined.
891 891  )))
892 -|(% colspan="4" %)(% colspan="3" %)
818 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
893 893  (((
894 894  //2.20 Beta 3 introduced the new direct mouse steering mode. The mode was however not integrated as a first level mode and hence GetControllerInfo() returned the "gamepad" mode while direct mouse steering was active.
895 895  In 2.20 Beta 4 we improved the situation slightly so that a call to GetControllerInfo() will return either "mouseCursor" or "mouseSteering" in any of the 3 mouse modes.//
... ... @@ -902,20 +902,18 @@
902 902  )))|(% colspan="1" %)(% colspan="1" %)
903 903  (((
904 904  2.20 Beta 3
905 -)))|(% colspan="2" %)(% colspan="1" %)
831 +)))|(% colspan="1" %)(% colspan="1" %)
906 906  (((
907 907  Attribute for build related conditions e.g. **<event_build_finished/>** renamed from 'buildmodule' to 'buildprocessor'
908 908  )))
909 -|(% colspan="4" %)(% colspan="3" %)
835 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
910 910  (((
911 911  //The underlying behaviour remains the same in that it involves the buildprocessor, not the buildmodule. The attribute name has simply been corrected.//
912 912  )))
913 -
914 -----
915 -
916 -=== Version 2.00 ===
917 -
918 -(% class="table-striped" %)
839 +|(% colspan="3" %)(% colspan="3" %)
840 +(((
841 +== 2.00 ==
842 +)))
919 919  |(% colspan="1" %)(% colspan="1" %)
920 920  (((
921 921  Scripts
... ... @@ -922,11 +922,11 @@
922 922  )))|(% colspan="1" %)(% colspan="1" %)
923 923  (((
924 924  2.00 Beta 1
925 -)))|(% colspan="2" %)(% colspan="1" %)
849 +)))|(% colspan="1" %)(% colspan="1" %)
926 926  (((
927 927  **<event_build_finished/> **param2 now returns null instead of a construction sequence
928 928  )))
929 -|(% colspan="4" %)(% colspan="3" %)
853 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
930 930  (((
931 931  //The construction sequence which was finished should now be accessed via the buildtask provided via param3.//
932 932  )))
... ... @@ -936,11 +936,11 @@
936 936  )))|(% colspan="1" %)(% colspan="1" %)
937 937  (((
938 938  2.00 Beta 1
939 -)))|(% colspan="2" %)(% colspan="1" %)
863 +)))|(% colspan="1" %)(% colspan="1" %)
940 940  (((
941 941  **param.boarding.{...}** strength parameters removed
942 942  )))
943 -|(% colspan="4" %)(% colspan="3" %)
867 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
944 944  (((
945 945  //The 'recruitstrength', 'veteranstrength' and 'elitestrength' script parameters were no longer required for balancing the boarding gameplay, and were removed.//
946 946  )))
... ... @@ -950,11 +950,11 @@
950 950  )))|(% colspan="1" %)(% colspan="1" %)
951 951  (((
952 952  2.00 Beta 1
953 -)))|(% colspan="2" %)(% colspan="1" %)
877 +)))|(% colspan="1" %)(% colspan="1" %)
954 954  (((
955 955  **$defensible.boardee/$defensible.boarder** and **<set_object_boarder/>/<remove_object_boarder/>** removed
956 956  )))
957 -|(% colspan="4" %)(% colspan="3" %)
881 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
958 958  (((
959 959  //Due to changes to boarding in X4, the boarding connections accessed by these script properties and actions became redundent and thus, removed. Any connections set by these actions in a savegame will not survive loading.//
960 960  )))
... ... @@ -962,10 +962,10 @@
962 962  UI extensions
963 963  )))|(((
964 964  2.00 Beta 1
965 -)))|(% colspan="2" %)(((
889 +)))|(((
966 966  **FFI: GetUpgradeSlotCurrentComponent()/GetUpgradeSlotGroup()** works on non-operationals
967 967  )))
968 -|(% colspan="4" %)(% colspan="3" %)
892 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
969 969  (((
970 970  //Before 2.0 Beta 1 using GetUpgradeSlotCurrentComponent() or GetUpgradeSlotGroup() only performed on operational objects (i.e. not wrecked objects or objects under construction). Since this is inconsistent with the rest of the UI functions, this was considered a bug and fixed in 2.0 Beta 1. If you require the old behavior, use the FFI function: IsComponentOperational() to check the passed object's state before making the call.//
971 971  )))
... ... @@ -973,10 +973,10 @@
973 973  UI extensions
974 974  )))|(((
975 975  2.00 Beta 1
976 -)))|(% colspan="2" %)(((
900 +)))|(((
977 977  **FFI: SetFormationShape()** no longer indicates an error upon certain error cases
978 978  )))
979 -|(% colspan="4" %)(% colspan="3" %)
903 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
980 980  (((
981 981  //Before 2.0 Beta 1 a call to SetFormationShape() indicated an error state to the caller in certain cases where setting a formation shape (potentially) failed. Due to a design flaw in the handling of formations, this however doesn't do any good, since the function by itself doesn't really set the formation shape in all cases. On top of that the call can fail at random. Hence, at the moment an indication of an error case that setting a formation potentially fails is no good to the caller and he has no means to distinguish that case from a real error case.//
982 982  //Therefore, in 2.0 Beta 1 we drop the error indication in case of an attempt to set the formation fails. We are currently working on a better solution to the underlying problem and hope to have it ready as part of a following beta.//
... ... @@ -985,10 +985,10 @@
985 985  Scripts
986 986  )))|(((
987 987  2.00 Beta 1
988 -)))|(% colspan="2" %)(((
912 +)))|(((
989 989  **<create_formation/>** now requires the attributes: 'leader' and 'follower'. Attribute 'object' is now deprecated.
990 990  )))
991 -|(% colspan="4" %)(% colspan="3" %)
915 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
992 992  (((
993 993  //This now enforces a leader and at least one follower in order to create or change a formation.  Former implementation made it possible to create formations without any followers which led to issues.//
994 994  )))
... ... @@ -996,10 +996,10 @@
996 996  Scripts
997 997  )))|(((
998 998  2.00 Beta 1
999 -)))|(% colspan="2" %)(((
923 +)))|(((
1000 1000  **<event_player_changed_target/>** now fires and returns null if the player deselects a target.
1001 1001  )))
1002 -|(% colspan="4" %)(% colspan="3" %)
926 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1003 1003  (((
1004 1004  //For prior behavior, check for event.param being non-null.//
1005 1005  )))
... ... @@ -1007,10 +1007,10 @@
1007 1007  AI Scripts
1008 1008  )))|(((
1009 1009  2.00 Beta 1
1010 -)))|(% colspan="2" %)(((
934 +)))|(((
1011 1011  **<shoot/>/<shoot_at/>** attribute changes.
1012 1012  )))
1013 -|(% colspan="4" %)(% colspan="3" %)
937 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1014 1014  (((
1015 1015  //Changed: Attribute "primary" is now optional and defines whether weapons from the ship's active primary weapon group will be fired. Defaults to true.//
1016 1016  //New attribute: "secondary" is an optional attribute that defines whether weapons from the ship's active secondary weapon group will be fired. Defaults to true.//
... ... @@ -1022,10 +1022,10 @@
1022 1022  UI extensions
1023 1023  )))|(((
1024 1024  2.00 Beta 1
1025 -)))|(% colspan="2" %)(((
949 +)))|(((
1026 1026  **FFI: GetBuildTask()/GetNumBuildTasks()** got a new "buildmoduleid" parameter.
1027 1027  )))
1028 -|(% colspan="4" %)(% colspan="3" %)
952 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1029 1029  (((
1030 1030  //Added possibility to query build tasks of a certain buildmodule.//
1031 1031  )))
... ... @@ -1033,10 +1033,10 @@
1033 1033  UI extensions
1034 1034  )))|(((
1035 1035  2.00 Beta 1
1036 -)))|(% colspan="2" %)(((
960 +)))|(((
1037 1037  **Lua:** **GetLibraryEntry()** retrieved a new "buildresources" field.
1038 1038  )))
1039 -|(% colspan="4" %)(% colspan="3" %)
963 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1040 1040  (((
1041 1041  //Added list of resources a buildmodule needs to build.//
1042 1042  )))
... ... @@ -1044,10 +1044,10 @@
1044 1044  UI extensions
1045 1045  )))|(((
1046 1046  2.00 Beta 1
1047 -)))|(% colspan="2" %)(((
1048 -**Lua: CalculateTotalHullFraction() **was removed.
971 +)))|(((
972 +**Lua: CalculateTotalHullFraction() **(%%)was removed.
1049 1049  )))
1050 -|(% colspan="4" %)(% colspan="3" %)
974 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1051 1051  (((
1052 1052  //Unused, derelict function from XR - use GetComponentData(..., "hullpercent") instead.//
1053 1053  )))
... ... @@ -1055,27 +1055,25 @@
1055 1055  UI extensions
1056 1056  )))|(((
1057 1057  2.00 Beta 1
1058 -)))|(% colspan="2" %)(((
1059 -**FFI: RequestDockAtReason()/UndockPlayerShip() **changed their return values.
982 +)))|(((
983 +**FFI: RequestDockAtReason()/UndockPlayerShip()(%%) **changed their return values.
1060 1060  )))
1061 -|(% colspan="4" %)(% colspan="3" %)
985 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1062 1062  (((
1063 1063  //Changed return value type to const char* to better identify failure reasons in Lua script.//
1064 1064  )))
1065 -
1066 -----
1067 -
1068 -=== Version 1.50 ===
1069 -
1070 -(% class="table-striped" %)
989 +|(% colspan="3" %)(% colspan="3" %)
990 +(((
991 +== 1.50 ==
992 +)))
1071 1071  |(((
1072 1072  UI extensions
1073 1073  )))|(((
1074 1074  1.50 Beta 3
1075 -)))|(% colspan="2" %)(((
997 +)))|(((
1076 1076  **Lua: GetComponentData() **changed behavior of "docksizes" property.
1077 1077  )))
1078 -|(% colspan="4" %)(% colspan="3" %)
1000 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1079 1079  (((
1080 1080  //The "docksizes" property no longer includes internal ship storage docks.//
1081 1081  )))
... ... @@ -1083,10 +1083,10 @@
1083 1083  All
1084 1084  )))|(((
1085 1085  1.50 Beta 2
1086 -)))|(% colspan="2" %)(((
1008 +)))|(((
1087 1087  **Meaning of "Shipyard"** was corrected throughout Lua/MD/AI scripts, so that Wharfs are not Shipyards (unlike in XR).
1088 1088  )))
1089 -|(% colspan="4" %)(% colspan="3" %)
1011 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1090 1090  (((
1091 1091  //Shipyards (formerly also known as Capital Shipyards) can build capital ships, while Wharfs only build non-capital ships. To check whether a station is a Shipyard or a Wharf, check whether the station "can build ships".//
1092 1092  
... ... @@ -1098,10 +1098,10 @@
1098 1098  UI extensions
1099 1099  )))|(((
1100 1100  1.50 Beta 2
1101 -)))|(% colspan="2" %)(((
1023 +)))|(((
1102 1102  **FFI: UpgradeGroupInfo **datatype was changed.
1103 1103  )))
1104 -|(% colspan="4" %)(% colspan="3" %)
1026 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1105 1105  (((
1106 1106  //Added new "operational" field to retrieve information about number of operational upgrades in a group.//
1107 1107  )))
... ... @@ -1111,11 +1111,11 @@
1111 1111  )))|(% colspan="1" %)(% colspan="1" %)
1112 1112  (((
1113 1113  1.50 Beta 1
1114 -)))|(% colspan="2" %)(% colspan="1" %)
1036 +)))|(% colspan="1" %)(% colspan="1" %)
1115 1115  (((
1116 1116  **FFI: SetGuidance()** removed useinfopoint argument.
1117 1117  )))
1118 -|(% colspan="4" %)(% colspan="3" %)
1040 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1119 1119  (((
1120 1120  //In X Rebirth "info points" existed (which were mainly used as interaction points to scan stations/access information about modules). These were removed in X4 but this left-over property here was missed to be removed in-time for release. It was therefore removed now in order to move towards a stable/clean UI API.//
1121 1121  
... ... @@ -1125,44 +1125,40 @@
1125 1125  UI extensions
1126 1126  )))|(((
1127 1127  1.50 Beta 1
1128 -)))|(% colspan="2" %)(((
1050 +)))|(((
1129 1129  **FFI: CancelConstruction() **changed its return value.
1130 1130  )))
1131 -|(% colspan="4" %)(% colspan="3" %)
1053 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1132 1132  (((
1133 1133  //CancelConstruction() now returns if the cancellation was successful. //
1134 1134  )))
1135 -
1136 -----
1137 -
1138 -=== Version 1.32 ===
1139 -
1140 -(% class="table-striped" %)
1057 +|(% colspan="3" %)(% colspan="3" %)
1058 +(((
1059 +== 1.32 ==
1060 +)))
1141 1141  |(((
1142 1142  UI extensions
1143 1143  )))|(((
1144 1144  1.32
1145 -)))|(% colspan="2" %)(((
1065 +)))|(((
1146 1146  **Lua: GetComponentData() **removed the "nextdestname" property.
1147 1147  )))
1148 -|(% colspan="4" %)(% colspan="3" %)
1068 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1149 1149  (((
1150 1150  //Instead of "nextdestname", use the properties "destination" or "destinationsector" to retrieve a destination component, then retrieve its "name" property.//
1151 1151  )))
1152 -
1153 -----
1154 -
1155 -=== Version 1.20 ===
1156 -
1157 -(% class="table-striped" %)
1072 +|(% colspan="3" %)(% colspan="3" %)
1073 +(((
1074 +== 1.20 ==
1075 +)))
1158 1158  |(((
1159 1159  UI extensions
1160 1160  )))|(((
1161 1161  1.20
1162 -)))|(% colspan="2" %)(((
1080 +)))|(((
1163 1163  **FFI: GetAAOption()** got a new "useconfig" parameter.
1164 1164  )))
1165 -|(% colspan="4" %)(% colspan="3" %)
1083 +|(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="3" data-highlight-colour="grey" %)
1166 1166  (((
1167 1167  //The AA setting was changed to check the new setting with the user. In order to restore the old setting GetAAOption() gets the option to retrieve the config settings.//
1168 1168  )))
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,0 +1,1 @@
1 +78577854
space
... ... @@ -1,0 +1,1 @@
1 +X4WIKI
url
... ... @@ -1,0 +1,1 @@
1 +https://www.egosoft.com:8444/confluence/wiki/spaces/X4WIKI/pages/78577854/Breaking Changes