Skip to content

Commit

Permalink
Update 1.12
Browse files Browse the repository at this point in the history 
+ Table generator.
+ Quick access to global resources.
+ Light mode button.
+ New character escapes.
  • Loading branch information
@MatiDragon-YT
MatiDragon-YT committed Feb 8, 2022
1 parent 8afca64 commit ddabe54
Show file tree
Hide file tree
Showing 158 changed files with 8,980 additions and 35,547 deletions.
31 changes: 5 additions & 26 deletions en/coding/conditions.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,32 +22,11 @@
\
`N` means the total number of conditions within the IF statement and the way the evaluation of conditions happens.

<table>
<thead>
<tr>
<th>N</th>
<th>Number of Conditions</th>
<th>Logical Operator</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>1</td>
<td>the IF statement is true if the condition is true</td>
</tr>
<tr>
<td>1..7</td>
<td>2..8</td>
<td><code>AND</code> (all conditions must be true for the IF statement to be true)</td>
</tr>
<tr>
<td>21..27</td>
<td>2..8</td>
<td><code>OR</code> (at least one of the conditions must be true for the IF statement to be true)</td>
</tr>
</tbody>
</table>
|N|Number of Conditions|Logical Operator|
|-|
|0|1|the IF statement is true if the condition is true|
|1..7|2..8|`AND` (all conditions must be true for the IF statement to be true)|
|21..27|2..8|`OR` (at least one of the conditions must be true for the IF statement to be true)|

{% hint style="info" %}
A single IF statement can contain up to 8 conditions.
Expand Down
55 changes: 9 additions & 46 deletions en/coding/hex..end.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -54,52 +54,15 @@

The following escape sequences are supported within a string literal:

<table>
<thead>
<tr>
<th>Name</th>
<th>Escape Sequence</th>
<th>Byte Form</th>
</tr>
</thead>
<tbody>
<tr>
<td>Null</td>
<td>\0</td>
<td>00</td>
</tr>
<tr>
<td>Backspace</td>
<td>\b</td>
<td>08</td>
</tr>
<tr>
<td>Tab</td>
<td>\t</td>
<td>09</td>
</tr>
<tr>
<td>Line Feed</td>
<td>\n</td>
<td>0A</td>
</tr>
<tr>
<td>Carriage Return</td>
<td>\r</td>
<td>0D</td>
</tr>
<tr>
<td>Numeric escape sequence</td>
<td>\x<code>nn</code></td>
<td><code>nn</code></td>
</tr>
<tr>
<td>Escape char</td>
<td>\<code>char</code></td>
<td><code>char</code></td>
</tr>
</tbody>
</table>
|Name|Escape Sequence|Byte Form|
|-|
|Null|\0|00|
|Backspace|\b|08|
|Tab|\t|09|
|Line Feed|\n|0A|
|Carriage Return|\r|0D|
|Numeric escape sequence|\x`nn`|`nn`|
|Escape char|\`char`|`char`|

```sb3
hex
Expand Down
84 changes: 12 additions & 72 deletions en/edit-modes/README.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -181,78 +181,18 @@

Sanny Builder offers many different modes and their number may vary from version to version:

<table>
<thead>
<tr>
<th>Title</th>
<th>Naming schema</th>
<th>Parameters order</th>
<th>Game</th>
</tr>
</thead>
<tbody>
<tr>
<td>GTA III</td>
<td>community</td>
<td>custom</td>
<td>all versions of GTA III</td>
</tr>
<tr>
<td>GTA VC</td>
<td>community</td>
<td>custom</td>
<td>all versions of Vice City</td>
</tr>
<tr>
<td>GTA SA v1.0</td>
<td>community</td>
<td>custom</td>
<td>SA v1.0</td>
</tr>
<tr>
<td>GTA SA v2.0</td>
<td>community</td>
<td>custom</td>
<td>SA v2.0</td>
</tr>
<tr>
<td>GTA SA (v1.0 - SCR)</td>
<td>Rockstar</td>
<td>original</td>
<td>SA v1.0</td>
</tr>
<tr>
<td>GTA LCS</td>
<td>Rockstar</td>
<td>original</td>
<td>all versions of Liberty City Stories</td>
</tr>
<tr>
<td>GTA VCS (PSP)</td>
<td>Rockstar</td>
<td>original</td>
<td>VCS for PSP</td>
</tr>
<tr>
<td>GTA VCS (PS2)</td>
<td>Rockstar</td>
<td>original</td>
<td>VCS for PS2</td>
</tr>
<tr>
<td>VC Mobile</td>
<td>community</td>
<td>custom</td>
<td>VC Android and iOS versions</td>
</tr>
<tr>
<td>SA Mobile</td>
<td>community</td>
<td>custom</td>
<td>SA Android and iOS versions</td>
</tr>
</tbody>
</table>
|Title|Naming schema|Parameters order|Game|
|-|
|GTA III|community|custom|all versions of GTA III|
|GTA VC|community|custom|all versions of Vice City|
|GTA SA v1.0|community|custom|SA v1.0|
|GTA SA v2.0|community|custom|SA v2.0|
|GTA SA (v1.0 - SCR)|Rockstar|original|SA v1.0|
|GTA LCS|Rockstar|original|all versions of Liberty City Stories|
|GTA VCS (PSP)|Rockstar|original|VCS for PSP|
|GTA VCS (PS2)|Rockstar|original|VCS for PS2|
|VC Mobile|community|custom|VC Android and iOS versions|
|SA Mobile|community|custom|SA Android and iOS versions|

The naming schema defines the way of describing the opcodes. The _community_ schema has the names randomly guessed over the years, such as `actor` or `thread`. The _Rockstar_ schema has the original taxonomy used by the game developers (e.g. `char` or `script`) that is consistent with the game's inner structures.

Expand Down
8 changes: 4 additions & 4 deletions en/edit-modes/enums.txt.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -49,9 +49,9 @@

It is possible to define many enumerated types in one file. Each enum must have an unique name.

<div class="warning">
:::warning
No comments or any extra syntax are allowed in the enums file.
</div>
:::

### Enum fields

Expand Down Expand Up @@ -118,7 +118,7 @@
`Month.Feb` = `"February`, \
`Month.March` = `"March"`

<div class="warning">
:::warning
An enum can't have a mix of both integer and string values. The first explicit value takes control of what type of values this enum gets:

```
Expand All @@ -130,6 +130,6 @@
X, Y = "Y" // X = "X", Y = "Y"
end
```
</div>
:::

<script src="../../js/main.min.js"></script>
68 changes: 11 additions & 57 deletions en/edit-modes/extensions.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -35,63 +35,17 @@

Sanny Builder ships some common and recognized extensions for different edit modes:

<table>
<thead>
<tr>
<th>Extension Name</th>
<th>Source</th>
<th>Edit Modes where available</th>
</tr>
</thead>
<tbody>
<tr>
<td> **CLEO** `{$USE CLEO}`</td>
<td>CLEO for GTA III<br>CLEO for Vice City CLEO 4.4 CLEO Android</td>
<td>GTA III Vice City GTA SA v1.0, v2.0, (v1.0 - SCR) SA Mobile VC Mobile</td>
</tr>
<tr>
<td> **ini** `{$USE ini}`</td>
<td>IniFiles.cleo plugin<br>(ships with CLEO)</td>
<td>GTA III<br>Vice City GTA SA v1.0, v2.0, (v1.0 - SCR)</td>
</tr>
<tr>
<td> **file** `{$USE file}`</td>
<td>FileSystemOperations plugin<br>(ships with CLEO)</td>
<td>GTA III<br>Vice City GTA SA v1.0, v2.0, (v1.0 - SCR)</td>
</tr>
<tr>
<td> **bitwise** `{$USE bitwise}`</td>
<td>IntOperations plugin<br>(ships with CLEO4)</td>
<td>GTA III<br>Vice City GTA SA v1.0, v2.0, (v1.0 - SCR)</td>
</tr>
<tr>
<td> **clipboard** `{$USE clipboard}`</td>
<td>ClipboardControl plugin</td>
<td>GTA III<br>Vice City GTA SA v1.0, v2.0, (v1.0 - SCR)</td>
</tr>
<tr>
<td> **memory** `{$USE memory}`</td>
<td>MemoryModule plugin</td>
<td>GTA III<br>Vice City</td>
</tr>
<tr>
<td> **CLEO+** `{$USE CLEO+}`</td>
<td>CLEO+ plugin</td>
<td>GTA SA v1.0, v2.0, (v1.0 - SCR)</td>
</tr>
<tr>
<td> **newOpcodes** `{$USE newOpcodes}`</td>
<td>newOpcodes plugin</td>
<td>GTA SA v1.0, v2.0</td>
</tr>
<tr>
<td> **Restoration** `{$USE Restoration}`</td>
<td><a href="https://gtamods.com/wiki/Opcodes_Restoration_Project">Opcode Restoration Project</a></td>
<td>Vice City</td>
</tr>
</tbody>
</table>

|Extension Name|Source|Edit Modes where available|
|-|
| **CLEO** `{$USE CLEO}`|CLEO for GTA III\nCLEO for Vice City CLEO 4.4 CLEO Android|GTA III Vice City GTA SA v1.0, v2.0, (v1.0 - SCR) SA Mobile VC Mobile|
| **ini** `{$USE ini}`|IniFiles.cleo plugin\n(ships with CLEO)|GTA III\nVice City GTA SA v1.0, v2.0, (v1.0 - SCR)|
| **file** `{$USE file}`|FileSystemOperations plugin\n(ships with CLEO)|GTA III\nVice City GTA SA v1.0, v2.0, (v1.0 - SCR)|
| **bitwise** `{$USE bitwise}`|IntOperations plugin\n(ships with CLEO4)|GTA III\nVice City GTA SA v1.0, v2.0, (v1.0 - SCR)|
| **clipboard** `{$USE clipboard}`|ClipboardControl plugin|GTA III\nVice City GTA SA v1.0, v2.0, (v1.0 - SCR)|
| **memory** `{$USE memory}`|MemoryModule plugin|GTA III\nVice City|
| **CLEO+** `{$USE CLEO+}`|CLEO+ plugin|GTA SA v1.0, v2.0, (v1.0 - SCR)|
| **newOpcodes** `{$USE newOpcodes}`|newOpcodes plugin|GTA SA v1.0, v2.0|
| **Restoration** `{$USE Restoration}`|<a href="https://gtamods.com/wiki/Opcodes_Restoration_Project">Opcode Restoration Project</a>|Vice City|

Using opcodes from the third-party libraries not listed there is possible, the compiler will not require the `{$USE}` directive.

Expand Down
55 changes: 9 additions & 46 deletions en/edit-modes/opcodes-list-scm.ini.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -15,52 +15,15 @@

`SCM.INI` is the file containing information about opcodes used during disassembling and compiling script files. Sanny Builder ships a list of opcodes for each [edit mode](README.md#opcodes).

<table>
<thead>
<tr>
<th>Game</th>
<th>File Name</th>
<th>Location</th>
</tr>
</thead>
<tbody>
<tr>
<td>GTA III</td>
<td>SCM.INI</td>
<td>data\gta3</td>
</tr>
<tr>
<td>Vice City</td>
<td>VCSCM.INI</td>
<td>data\vc</td>
</tr>
<tr>
<td>San Andreas</td>
<td>SASCM.INI</td>
<td>data\sa</td>
</tr>
<tr>
<td>Liberty City Stories</td>
<td>LCSSCM.INI</td>
<td>data\lcs</td>
</tr>
<tr>
<td>Vice City Stories</td>
<td>VCSSCM.INI</td>
<td>data\vcs</td>
</tr>
<tr>
<td>VC Mobile</td>
<td>VCSCM.INI</td>
<td>data\vc_mobile</td>
</tr>
<tr>
<td>SA Mobile</td>
<td>SASCM.INI</td>
<td>data\sa_mobile</td>
</tr>
</tbody>
</table>
|Game|File Name|Location|
|-|
|GTA III|SCM.INI|data\gta3|
|Vice City|VCSCM.INI|data\vc|
|San Andreas|SASCM.INI|data\sa|
|Liberty City Stories|LCSSCM.INI|data\lcs|
|Vice City Stories|VCSSCM.INI|data\vcs|
|VC Mobile|VCSCM.INI|data\vc_mobile|
|SA Mobile|SASCM.INI|data\sa_mobile|

## File Format

Expand Down
Loading

0 comments on commit ddabe54

Please sign in to comment.