LUA scripting

[Enyby]

Starting from version 8.28.0 GG have support of LUA scripts.

It can be loaded and run.

https://www.lua.org/manual/5.2/manual.html

Scripting Documentation: https://gameguardian.net/help/

Spoiler

 

GG function stored in table named gg.

You can print it for get short help.

print(gg)

gg =   table(5393242c): {
       [BUILD] = 6147
       [CACHE_DIR] = /data/data/catch_.me_.if_.you_.can_/cache
       [EXT_CACHE_DIR] = /mnt/sdcard/Android/data/catch_.me_.if_.you_.can_/cache
       [EXT_FILES_DIR] = /mnt/sdcard/Android/data/catch_.me_.if_.you_.can_/files
       [FILES_DIR] = /data/data/catch_.me_.if_.you_.can_/files
       [PACKAGE] = catch_.me_.if_.you_.can_
       [REGION_ANONYMOUS] = 32
       [REGION_ASHMEM] = 524288
       [REGION_BAD] = 131072
       [REGION_CODE_APP] = 16384
       [REGION_CODE_SYS] = 32768
       [REGION_C_ALLOC] = 4
       [REGION_C_BSS] = 16
       [REGION_C_DATA] = 8
       [REGION_C_HEAP] = 1
       [REGION_JAVA] = 65536
       [REGION_JAVA_HEAP] = 2
       [REGION_OTHER] = -1032320
       [REGION_PPSSPP] = 262144
       [REGION_STACK] = 64
       [SIGN_EQUAL] = 536870912
       [SIGN_FUZZY_EQUAL] = 536870912
       [SIGN_FUZZY_GREATER] = 67108864
       [SIGN_FUZZY_LESS] = 134217728
       [SIGN_FUZZY_NOT_EQUAL] = 268435456
       [SIGN_GREATER_OR_EQUAL] = 67108864
       [SIGN_LESS_OR_EQUAL] = 134217728
       [SIGN_NOT_EQUAL] = 268435456
       [TYPE_AUTO] = 127
       [TYPE_BYTE] = 1
       [TYPE_DOUBLE] = 64
       [TYPE_DWORD] = 4
       [TYPE_FLOAT] = 16
       [TYPE_QWORD] = 32
       [TYPE_WORD] = 2
       [TYPE_XOR] = 8
       [VERSION] = 8.31.0
       [VERSION_INT] = 83100
       [alert] = function: alert /* gg.alert(string text [, string positive = 'ok' [, string negative = nil [, string neutral = nil]]]) -> int: 0 = cancel, 1 = positive, 2 = negative, 3 = neutral */
       [choice] = function: choice /* gg.choice(table items [, string selected = nil [, string message = nil]]) -> string || nil */
       [clearResults] = function: clearResults /* gg.clearResults() -> nil */
       [copyMemory] = function: copyMemory /* gg.copyMemory(long from, long to, int bytes) -> true || string with error */
       [copyText] = function: copyText /* gg.copyText(string text [, bool fixLocale = true]) -> nil */
       [dumpMemory] = function: dumpMemory /* gg.dumpMemory(long from, long to, string dir) -> true || string with error */
       [editAll] = function: editAll /* gg.editAll(string value, int type) -> count of changed || string with error */
       [getFile] = function: getFile /* gg.getFile() -> string */
       [getLine] = function: getLine /* gg.getLine() -> int */
       [getLocale] = function: getLocale /* gg.getLocale() -> string */
       [getRanges] = function: getRanges /* gg.getRanges() -> int */
       [getResultCount] = function: getResultCount /* gg.getResultCount() -> long */
       [getResults] = function: getResults /* gg.getResults(int count) -> array || string with error */
       [getSpeed] = function: getSpeed /* gg.getSpeed() -> double */
       [getTargetInfo] = function: getTargetInfo /* gg.getTargetInfo() -> table || nil */
       [getTargetPackage] = function: getTargetPackage /* gg.getTargetPackage() -> string || nil */
       [getValuesRange] = function: getValuesRange /* gg.getValuesRange(table values) -> table || string with error */
       [getValues] = function: getValues /* gg.getValues(table values) -> table || string with error */
       [gotoAddress] = function: gotoAddress /* gg.gotoAddress(long address) -> nil */
       [isPackageInstalled] = function: isPackageInstalled /* gg.isPackageInstalled(string pkg) -> bool */
       [isProcessPaused] = function: isProcessPaused /* gg.isProcessPaused() -> bool */
       [isVisible] = function: isVisible /* gg.isVisible() -> bool */
       [multiChoice] = function: multiChoice /* gg.multiChoice(table items [, table selection = {} [, string message = nil]]) -> table || nil */
       [processKill] = function: processKill /* gg.processKill() -> bool */
       [processPause] = function: processPause /* gg.processPause() -> bool */
       [processResume] = function: processResume /* gg.processResume() -> bool */
       [processToggle] = function: processToggle /* gg.processToggle() -> bool */
       [prompt] = function: prompt /* gg.prompt(table prompts [, table defaults = {} [, table types = {} ]]) -> nil || table with keys from prompts and values from inputs */
       [removeResults] = function: removeResults /* gg.removeResults(table results) -> true || string with error */
       [searchAddress] = function: searchAddress /* gg.searchAddress(string text [, long mask = -1 [, int type = gg.TYPE_AUTO [, int sign = gg.SIGN_EQUAL [, long memoryFrom = 0 [, long memoryTo = -1]]]]]) -> true || string with error */
       [searchFuzzy] = function: searchFuzzy /* gg.searchFuzzy([string difference = '0' [, int type = gg.TYPE_AUTO [, int sign = gg.SIGN_FUZZY_EQUAL [, long memoryFrom = 0 [, long memoryTo = -1]]]]]) -> true || string with error */
       [searchNumber] = function: searchNumber /* gg.searchNumber(string text [, int type = gg.TYPE_AUTO [, bool encrypted = false [, int sign = gg.TYPE_EQUAL [, longmemoryFrom = 0 [, long memoryTo = -1]]]]]) -> true || string with error */
       [setRanges] = function: setRanges /* gg.setRanges(int ranges) -> nil */
       [setSpeed] = function: setSpeed /* gg.setSpeed(double speed) -> true || string with error */
       [setValues] = function: setValues /* gg.setValues(table values) -> true || string with error */
       [setVisible] = function: setVisible /* gg.setVisible(bool visible) -> nil */
       [skipRestoreState] = function: skipRestoreState /* gg.skipRestoreState() -> nil */
       [sleep] = function: sleep /* gg.sleep(int milliseconds) -> nil */
       [startFuzzy] = function: startFuzzy /* gg.startFuzzy([int type = gg.TYPE_AUTO [, long memoryFrom = 0 [, long memoryTo = -1]]]) -> true || string with error */
       [timeJump] = function: timeJump /* gg.timeJump(string time) -> true || string with error */
       [toast] = function: toast /* gg.toast(string text [, bool fast = false]) -> nil */
}

In future we add help with examples.

 

 

[Backlift]

Interesting.

One may just load Lua script and only input the value.

Other options like type and region will be automatically set.

Also I think it could automatically calculate and add the other values based on the value found with stored offsets in it, makes many things easier.

[Enyby]

Yes. And can be created automated calculator/tool based on gg.

Present function 'toast', 'alert' and 'prompt' which allow create some dialogs for user.

For example 'Input gold amount:' and use this value for make search.

data = gg.prompt({[1]='Search value', [2]='Replace value', [3]='Max count'}, {[1]='123', [2]='456', [3]='321'})
gg.searchNumber(data[1], gg.TYPE_DWORD, false, gg.SIGN_EQUAL, 0, -1)
found = gg.getResultCount()
gg.alert('We found: '..found)
gg.getResults(data[3])
replaced = gg.editAll(data[2], gg.TYPE_DWORD)
gg.alert('We replaced: '..replaced)
gg.alert('Summary: We search '..data[1]..', found '..found..', replaced '..replaced..' to '..data[2]..' with max count '..data[3]..';')
print('Script ended.')

[Backlift]

Haha, that's what I like.

I will try to learn it.

Will make Nice scripts.

[Enyby]

d = gg.prompt({A='A', B='B', C='C'}, {A='123', B='456', C='789'})
gg.alert('A + B - 3*C = '..(d.A + d.B - 3*d.C))

[Enyby]

Script can work with files. It can be useful for create complicated things.

API to GG will be edited and extend in future releases. Now present only basic features for scripts.

Scripts can be used for automate some things like lot of same actions. For example for Asphalt 8 Enduro Double Down can be written automated scripts which make hundred of replace in one run.

[Backlift]

I found it pretty easy.

Just copied the data from post above into a text file then replaced the ".txt" extention to ".Lua" and then went to search tab and rap on "more" (three lines) button and "excute script".

So simple.

I think by working with these samples, it's easily possible to make a good one for a game.

On it now.

 

[Enyby]

No need change extension. You can load .txt files. Or any others.

[Backlift]

One thing, why the position of "C" and "B" are flipped?

The code is OK as I'm seeing it.

[Enyby]

Lua table not specified order of fields. Maybe in future I try fix this.

I make this support of scripting in last 3-4 weeks. It is first public release. Something can be not good or broken. In future we try improve it.

[Backlift]

Thanks for the hard work.

I will try to help too.

[Enyby]

Script for hack Asphalt 8 nitro:

gg.searchNumber('2;8;10;12;15;20;25;30:61', gg.TYPE_FLOAT, false, gg.SIGN_EQUAL, 0, -1)
gg.getResults(100)
print('Replaced: ', gg.editAll('1000', gg.TYPE_FLOAT))
print('Nitro hacked!')

[Backlift]

I'm working on hack for Quadropus Game.

I made it to hack the input value as double and Encrypted.

But I'm stuck in this situation:

The user needs get back into game and change the value and then come back GG and enter the new value.

Will this work? :

print('go to game and change the value and then load script again') 

So it loads the script again and it search in the found results...or it makes a new search?

_______________________________________________

added 3 minutes later

I want to make an IF Statement:

1_If found 1 value, edit value to 10000000000

2_if Not found 1 value, print'('go to game and change the value, then load the script again')

 

Possible? If yes, how?

[Enyby]

Depends on your logic. Read Lua manual reference posted in first post.

if gg.getResultCount() == 0 then
	gg.alert('Find something and run script again!')
else
	gg.alert('Wow! You found '..gg.getResultCount()..' results! Not bad!')
	gg.toast('You cool!')
end

[Enyby]

You can store state to file and load on each start script. Or wait for some actions. In last case user do not need run script each time.

But this not always possible.

function sleep(s)
  local ntime = os.clock() + s
  repeat until os.clock() > ntime
end

while gg.getResultCount() < 10 do
	c = gg.getResultCount()
	gg.toast('I wait for you! Only '..(10 - c)..' need!', true)
	sleep(3)
end

gg.alert('You done!')