1.0.7 release

cleolibrary · Jan 27, 2023 · e0096b3 · e0096b3
1 parent 740e670
commit e0096b3
Show file tree

Hide file tree

Showing 5 changed files with 35 additions and 5 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,19 @@
+### 1.0.7 - January 27, 2023
+
+- add a new property [`CLEO.hostVersion`](https://re.cleo.li/docs/en/api.html#cleohostversion) that returns the version of the current host. Currently only available if the current exe file has version info (e.g. GTA IV or GTA Trilogy)
+- fix a crash in GTA IV when loading a script with a syntax error
+- fix an issue in GTA IV when some commands always returned the same value (e.g. `GET_CURRENT_CHAR_WEAPON`)
+
+**BREAKING CHANGES**
+
+- bumped minimum required versions of [command definitions](https://re.cleo.li/docs/en/definitions.html)
+- [`CLEO.version`](https://re.cleo.li/docs/en/api.html#cleoversion) and [`CLEO.apiVersion`](https://re.cleo.li/docs/en/api.html#cleoapiversion) incorrectly returned empty strings for missing parts of the version string. Now they return `undefined` instead. 
+```ts
+  log(CLEO.apiVersion.patch); // was "" now undefined
+  log(CLEO.apiVersion.pre); // was "" now undefined
+  log(CLEO.apiVersion.build); // was "" now undefined
+```
+
 ### 1.0.6 - January 11, 2023
 
 - new built-in functions `addEventListener` and `dispatchEvent`. See https://re.cleo.li/docs/en/events.html

diff --git a/docs/en/api.md b/docs/en/api.md
@@ -29,6 +29,7 @@
       - [CLEO.debug](#cleodebug)
       - [CLEO.version](#cleoversion)
       - [CLEO.apiVersion](#cleoapiversion)
+      - [CLEO.hostVersion](#cleohostversion)
       - [CLEO.runScript](#cleorunscript)
 
 ## Native functions
@@ -300,6 +301,19 @@ while (true) {
   log(CLEO.apiVersion.build); // undefined
   ```
 
+  ##### CLEO.hostVersion
+
+  - `CLEO.hostVersion` - a complex property providing information about the host version. Currently only available if the current exe file has version info (e.g. GTA IV or GTA Trilogy)
+
+  ```js
+  log(CLEO.hostVersion); // "1.2.0.43"
+  log(CLEO.hostVersion.major); // "1"
+  log(CLEO.hostVersion.minor); // "2"
+  log(CLEO.hostVersion.patch); // "0"
+  log(CLEO.hostVersion.pre); // undefined
+  log(CLEO.hostVersion.build); // "43"
+  ```
+
   ##### CLEO.runScript
 
   - `CLEO.runScript(fileName, args?)` - method that spawns a new instance of the script. `fileName` is the path to the script to launch. `args` is an optional parameter to pass arguments to the script.

diff --git a/docs/en/definitions.md b/docs/en/definitions.md
@@ -6,13 +6,13 @@ At start CLEO validates that a definition file is present and correct and if not
 
 | Game                                | File                                                                                                 | Minimum Required Version |
 | ----------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------ |
-| GTA III, re3                        | [gta3.json](https://github.com/sannybuilder/library/blob/master/gta3/gta3.json)                      | `0.252`                  |
-| GTA VC, reVC                        | [vc.json](https://github.com/sannybuilder/library/blob/master/vc/vc.json)                            | `0.258`                  |
+| GTA III, re3                        | [gta3.json](https://github.com/sannybuilder/library/blob/master/gta3/gta3.json)                      | `0.253`                  |
+| GTA VC, reVC                        | [vc.json](https://github.com/sannybuilder/library/blob/master/vc/vc.json)                            | `0.259`                  |
 | GTA San Andreas (Classic) 1.0       | [sa.json](https://github.com/sannybuilder/library/blob/master/sa/sa.json)                            | `0.298`                  |
 | GTA III: The Definitive Edition     | [gta3_unreal.json](https://github.com/sannybuilder/library/blob/master/gta3_unreal/gta3_unreal.json) | `0.222`                  |
 | Vice City: The Definitive Edition   | [vc_unreal.json](https://github.com/sannybuilder/library/blob/master/vc_unreal/vc_unreal.json)       | `0.228`                  |
 | San Andreas: The Definitive Edition | [sa_unreal.json](https://github.com/sannybuilder/library/blob/master/sa_unreal/sa_unreal.json)       | `0.251`                  |
-| GTA IV                              | [gta_iv.json](https://github.com/sannybuilder/library/blob/master/gta_iv/gta_iv.json)                | `0.46`                   |
+| GTA IV                              | [gta_iv.json](https://github.com/sannybuilder/library/blob/master/gta_iv/gta_iv.json)                | `0.63`                   |
 | Unknown (32-bit)                    | [unknown_x86.json](https://github.com/sannybuilder/library/blob/master/unknown_x86/unknown_x86.json) | `0.222`                  |
 | Unknown (64-bit)                    | [unknown_x64.json](https://github.com/sannybuilder/library/blob/master/unknown_x64/unknown_x64.json) | `0.225`                  |
 | Bully: Scholarship Edition          | [bully.json](https://github.com/sannybuilder/library/blob/master/bully/bully.json)                   | `0.41`                   |

diff --git a/installer/cleo_redux.iss b/installer/cleo_redux.iss
@@ -1,5 +1,5 @@
 #define AppName "CLEO Redux"
-#define AppVersion "1.0.6"
+#define AppVersion "1.0.7"
 #define AppPublisher "Seemann"
 #define AppURL "https://re.cleo.li"
 #define SourceDir "..\"

diff --git a/website/index.html b/website/index.html
@@ -123,7 +123,7 @@ <h1 class="font-weight-bold d-flex justify-content-center">
                 data-translate="download"
                 >Download</a
               >
-              <small class="pt-1 text-muted">v1.0.6 | January 11, 2022</small>
+              <small class="pt-1 text-muted">v1.0.7 | January 27, 2022</small>
             </div>
           </div>
         </div>