Jump to content

» «

[Sanny] Custom Edit Modes

3 replies to this topic
  • OrionSR

    Chain Game Development Team

  • Feroci
  • Joined: 23 May 2007
  • None
  • Helpfulness Award [GTA & Modding]


Posted 15 October 2015 - 03:22 AM Edited by OrionSR, 18 October 2015 - 04:42 AM.

I'm working towards building custom edit modes that can support SA PS2 and mobile versions for III and VC, but first I wanted to bring my SA Mobile mode up to speed with PC, and that means finally straightening out the global variable names.


SA Mobile - Standard Files v3.2.2

SASCM.ini - opcode processing

opcodes.txt - Opcode Search text

custom.dat - loads IDE files for model ID numbers

default.ide - loaded by custom.dat

peds.ide - loaded by custom.dat
vehicles.ide - loaded by custom.dat
veh_mods.ide - loaded by custom.dat

CustomVariables.ini - Format option: Custom Variable names
keywords.txt - shortcuts for common opcodes
missions.txt - original mission names option
american.gxt - standard file, adds comment strings for GXT keys






SA Mobile - Test Files

SASCM.ini - CleoA update

opcodes.txt - CleoA update

custom.dat - with IDE lines from default.dat and gta.dat (see below)


maps\*\ *.IDE

CustomVariables.ini - matching all common Variable names with PC

CustomLabels.ini - matching Labels with PC

CustomArrays.ini - matching Arrays  with PC

american.gxt - looks like this file gets updated with patches






802  12 Girl_Weapons
1219 8 Airport_Gates



This is just the IDE lines taken from default.dat and gta.dat. These could be read automatically if SA Mobile's game directory is set to Sanny's data\SA Mobile folder, but that seems like an awkward place to sync my compiled and copied scripts. And these files seem more appropriate under the custom edit mode folder anyway.


Update: Since SA Mobile doesn't Compile + Copy it would probably be easier to simply set the game folder to Sanny's edit mode's data folder and manage file copying manually than trying to manage a custom.dat file..




The data\maps\ files are contained within main.8.com.rockstargames.gtasa.obb. Rename a copy of the file to a zip extension to extract. patch.8.com.rockstargames.gtasa.obb holds the files from the \data directory.


Update: I ran WinMerge on my IDE files for PC and SA Mobile and the files are nearly identical. The only differences are to a handful of draw distance figures. The object IDs are all the same, which suits this purpose nicely. PCv1 and PCv2 are identical. I know from previous experience that many of the PS2 object IDs don't always match with PC.


american.gxt seems to be locked away in an APK file somewhere. I'm still not sure how to get at it.


Cleo for Android Opcodes and Text


SASCM.ini supplement - append to the end of file.


opcode.txt supplement - append, no need to sort




  • Seemann and thehambone like this

  • OrionSR

    Chain Game Development Team

  • Feroci
  • Joined: 23 May 2007
  • None
  • Helpfulness Award [GTA & Modding]


Posted 18 October 2015 - 03:12 AM Edited by OrionSR, 18 October 2015 - 04:49 AM.

New Edit Mode - SA PCv2


I've been experimenting with new edit modes with some unexpected results, but I figured I'd cover an easy one before wrestling with some new ideas. San Andreas Version 2 for PC is almost the same as v1. The major difference for Sanny is that the custom label offsets are different. CustomLabels_v2.ini is already provided standard, so this is basically a copy and paste operation.


Copy Sanny's data\sa folder to data\sapcv2

Rename CustomLabels.ini to CustomLabel_v1.ini

Rename CustomLabels_v2.ini to CustomLabel.ini

* You can also change the <variables> file used in games.xml, but I kept editing the wrong file.


Open games.xml located in Sanny's data folder.

Append this edit mode just before  </games> at the end of the file.

       <game shortcut="PCv2" title="SAPCv2" mode="sa" type="">

Save the changes and (re)start Sanny. The new edit mode should be available on the list in the lower right corner.

  • OrionSR

    Chain Game Development Team

  • Feroci
  • Joined: 23 May 2007
  • None
  • Helpfulness Award [GTA & Modding]


Posted 20 October 2015 - 09:23 PM Edited by OrionSR, 24 October 2015 - 04:11 AM.

Unexpected - Quirks of Sanny's Edit Modes
Maybe I'm just not thinking about this correctly, but what I hoped to accomplish isn't as easy as I had hoped. This is a collection of notes and frustrations.
Mandatory Game Folder: Sanny insists or setting a game folder for each edit mode. With the SA Mobile edit mode all self-contained nothing should need to be read from this folder, and nothing would get written to this folder in SA Mobile mode anyway.
No Custom.dat for SA Mode: I wanted to make a self-contained PC edit mode, for a laptop without the full game for example, but can't use custom.dat to specify where to look for data fies using the standard "sa" mode.
No Compile + Copy in SA Mobile Mode: When I switched my self-contained PC edit mote to SA_Mobile to take advantage of custom.dat I lost the ability to use compile and copy to a sync or cloud folder.
File comparison of the IDE files of PCv1. PCv2, and SA Mobile show these files are nearly identical. Only a few draw distance values have been increased in Mobile, the ID values are the same. So rather than maintain a separate IDE archive for each version I'm looking for ways to share the data files. Setting the game folder to a single archive is the easy strategy for now, and avoids all the hassle of editing the paths in a custom.dat file.


I was hoping this line in games.xml would let me specify a data folder for IDE and DAT files but so far opcode.txt is the only file I can find that reads from that folder. It looks like the other Sanny files have specific lines of their own anyway.
It's starting to look like the easiest way to manage the IDE files is to simply set the game folder as required and skip managing custom.dat altogether. It doesn't really matter if I use "sa" mode or "sa_mobile" as I'll need to manage my scripts manually.
I think what would help the most is a way to separate the compile and copy folders from the data folder to be read. A system that worked well for PC only doesn't quite fit the strategies needed for managing multiple systems and edit modes.
So with than in mind I think I'll skip trying to post new edit modes for now. I'm not sure how I want to use the tools I have available.  My PS2 disks just finished copying so I'll run a compare tool on the IDE files and see how different they really are. Then I'll see if I can crank out a few CustomVariable.ini ports.
IDE File Comparison
PCv1, PCv2 and Android: Identical ID numbers, slight differences in many mobile draw distance values.
PS2v1 and PS2v2: Identical except for significant changes to VEGASE.IDE
PCv2 and PS2v2:

data\ all identical including default.ide, peds.ide and vehicles.ide
data\maps\veh_mods\veh_mods.ide identical
data\maps\generic\ identical except for a flag in dynamic.ide
data\maps\interior\ prop*.ide have flag changes, stadint.ide is identical

Otherwise, some match, others don't, and the changes are often significant.

  • Seemann likes this

  • OrionSR

    Chain Game Development Team

  • Feroci
  • Joined: 23 May 2007
  • None
  • Helpfulness Award [GTA & Modding]


Posted 22 October 2015 - 02:53 AM Edited by OrionSR, 22 October 2015 - 07:39 PM.

Edit Mode - San Andreas PS2v1


I suspect that not many people are likely to use PS2 edit modes but here they are anyway.

Both edit modes are sa so set the game directory to the edit mode folder,

Or change the mode to sa_mobile and move american.gxt to the edit mode root.




CustomArrays.ini - no change needed from PC

sascm.ini and opcodes.txt - strip all cleo opcodes



Edit Mode - San Andreas PS2v2





807  12 Girl_Weapons
1199 8 Airport_Gates

sascm.ini and opcodes.txt - strip all cleo opcodes

sascm.ini - add opcode 0A4F: (unknown, seen in PS2v2 and Xbox)




CustomVariables.ini for GTA3 Mobile


I won't be able to put together a considered Edit Mode for GTA3 anytime soon, but I made significant progress of porting the full "original" variable name list from PC to Android. When Sanny is set with local offsets and matching GXT files I get a very high degree of correspondence when comparing decompiling results using WinMerge.


The rather incomplete variable lists for San Andreas make direct comparison rather difficult. I'm not sure how to increase my confidence in the conversion without rounding out the SA variable list considerably. When I pick up this project again I'm hoping to start naming things based on the conventions used in GTA3.

1 user(s) are reading this topic

0 members, 1 guests, 0 anonymous users