Difference between revisions of "Mono:Mono Lua"

From Cheat Engine
Jump to navigation Jump to search
m
m (Reverted edits by This content is not available (Talk) to last revision by Igromanru)
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The advanced MONO features of Cheat Engine are controlled by the "monoscript.lua" script in the autorun directory where cheat engine is installed.  When you attach to a process, the script scans for "mono.dll".  If it is found, the appropriate MonoDataDissector dll from the autorun directory is injected into the process which creates a named pipe waiting for a connection.  The LUA code then connects to the pipe and messages are exchanged to perform the mono functions.
+
[[Category:Mono]]
 +
[[Category:Help]]
 +
[[Category:Lua]]
 +
{{NeedWork}}
 +
{{DISPLAYTITLE:Mono - Lua}}
  
==== Main Methods ====
+
The advanced Mono features of Cheat Engine are controlled by the "monoscript.lua" script in the ''autorun'' directory where cheat engine is installed.  When you attach to a process, the script scans for "''mono.dll''".  If it is found, the appropriate ''MonoDataDissector'' dll from the ''autorun'' directory is injected into the process which creates a named pipe waiting for a connection.  The LUA code then connects to the pipe and messages are exchanged to perform the mono functions.
 +
 
 +
 
 +
 
 +
== Main Methods ==
  
 
; LaunchMonoDataCollector()
 
; LaunchMonoDataCollector()
: this is some
+
: injects the dll and returns 0 for failure, or monoBase returned from the CMD_INITMONO command on the pipe
: information
 
  
 
; varType = monoTypeToVarType(monoType)
 
; varType = monoTypeToVarType(monoType)
 
: Returns the Cheat Engine type (vtString, vtByte, vtWorkd, vtDword, vtSingle, vtDouble, vtPointer) for the given mono type
 
: Returns the Cheat Engine type (vtString, vtByte, vtWorkd, vtDword, vtSingle, vtDouble, vtPointer) for the given mono type
  
; result = LaunchMonoDataCollector()
+
;mono_object_getClass(address)
: injects the dll and returns 0 for failure, or monoBase returned from the CMD_INITMONO command on the pipe
+
: returns classId, className of the class at the given address in memory
 +
 
 +
;mono_enumDomains()
 +
: returns a table array of domainaddress for each domain in the game
 +
 
 +
;mono_setCurrentDomain(domainId)
 +
: returns ? (result of MONOCMD_SETCURRENTDOMAIN)
 +
: sets the domain the MonoDataCollector will use
 +
 
 +
;mono_enumAssemblies()
 +
: returns table of ''assemblyId'' for each assembly in the current domain from the MonoDataCollector
 +
 
 +
;mono_getImageFromAssembly(''assemblyId'')
 +
: returns the ''imageId'' for the passed assembly
 +
 
 +
;mono_image_get_name(''imageId'')
 +
: returns the ''name'' of the assembly with the given ''imageId''
 +
 
 +
;mono_image_enumClasses(''imageId'')
 +
: returns a ''table'' of ''classId'' for classes in the given assembly image
 +
 
 +
;mono_class_getName(''classId'')
 +
: returns the ''class name'' as a string
 +
 
 +
;mono_class_getNamespace(''classId'')
 +
: returns the ''namespace'' of the given class as a string
 +
 
 +
;mono_class_getParent(''classId'')
 +
: returns the ''classId'' of the parent class of the given class
 +
 
 +
;mono_class_getStaticFieldAddress(''domainId, classId'')
 +
: returns the base address for a special area that stores static addresses for a given class.  For example if you have a class that has 5 static fields, their offsets will be added to this base address to get the memory location
 +
 
 +
;mono_class_enumFields(''classId'')
 +
:returns a table of field objects for fields in the given class
 +
:  '''''field''''' - the field id
 +
:  '''''type''''' - ?? the Cheat Engine type?  (i.e. vtByte, vtWord, vtString, etc?)
 +
:  '''''monotype''''' - ?? the mono type?
 +
:  '''''parent''''' - ?? the class id?
 +
:  '''''offset''''' - the offset in bytes from the structure base address
 +
:  '''''flags''''' - ??
 +
:  '''''isStatic''''' - true/false - if true, offset is into static address, use mono_class_getStaticFieldAddress
 +
:  '''''name''''' - field name
 +
:  '''''typename''''' - name of the type with namespace (i.e. "System.Int32")
 +
 
 +
;mono_class_enumMethods(''classId'')
 +
:returns a table of method objects for the methods in the given class
 +
:  '''''method''''' - method id
 +
:  '''''name''''' - string name of the method
 +
 
 +
;mono_getJitInfo(''address'')
 +
:returns a result object with the properties given the address of code in memory
 +
:  '''''method''''' - the method id
 +
:  '''''code_start''''' - address where method code begins
 +
:  '''''code_size''''' - length of code in bytes
 +
 
 +
;mono_image_findClass(''imageId, namespace, className'')
 +
:returns the '''''classId''''' of the given class name and namespace in an image
 +
 
 +
;mono_findClass(''namespace, className'')
 +
:returns the '''''classId''''' of the given class name and namespace
 +
 
 +
;mono_class_findMethod(''classId, methodName'')
 +
:returns the '''''methodId''''' of a certain method in a class
  
mono_object_getClass(address)
+
;mono_findMethod(''namespace, className, methodName'')
-- returns classaddress, classname (or nil)
+
:returns the '''''methodId''''' of a certain method, calls '''mono_image_findClass''' and '''mono_class_findMethod'''
-- given the address of an object in memory,  
 
  
mono_enumDomains()
+
;mono_method_getName(''methodId'')
-- returns a table array of domainaddress for each domain in the game
+
:returns the name of a method given the id
  
mono_setCurrentDomain(domainaddress)
+
;mono_method_getHeader(''methodId'')
-- returns ? (result of MONOCMD_SETCURRENTDOMAIN)
+
:returns a '''''headerId'''''??
-- sets the domain the MonoDataCollector will use
 
  
mono_enumAssemblies()
+
;mono_method_getSignature(''methodId'')
-- returns table of assemblyaddress for each assembly in the current domain from the MonoDataCollector
+
:returns '''''result, parameternames, returntype'''''
 +
:  '''''result''''' - ?? string
 +
:  '''''parameterNames''''' - table of strings representing parameter names
 +
:  '''''returnType''''' - string??  - mono type string?
  
mono_getImageFromAssembly(assemblyaddress)
+
;mono_method_disassemble(''methodId'')
-- returns the imageaddress for the passed assembly
+
:returns a string - ?? the IL code ??
  
mono_image_get_name(imageaddress)
+
;mono_method_getClass(''methodId'')
-- returns the name of the assembly with the given imageaddress
+
:returns the '''''classId''''' a method belongs in
  
mono_image_enumClasses(imageaddress)
+
;mono_compile_method(''methodId'')
-- returns a table of classaddress for classes in the given assembly image
+
:JIT a method if it wasn't compiled yet, returns the address of the method
  
mono_class_getName(classaddress)
+
;mono_free_method(''methodId'')
-- returns the class name as a string
+
:(no return value) - only works on dynamic method, and only if profiler isn't being used
  
mono_class_getNamespace(classaddress)
+
;mono_methodheader_getILCode(''methodHeader'')
-- returns the namespace of the given class as a string
+
:returns '''''address, size'''''
 +
:  '''''address''''' - address of start of IL code?
 +
:  '''''size''''' - size of IL code?
  
mono_class_getParent(classaddress)
+
;mono_getILCodeFromMethod(''methodId'')
-- returns the classaddress of the parent class of the given class
+
:combination of '''mono_method_getHeader''' and '''mono_methodheader_getILCode'''
  
mono_class_getStaticFieldAddress(domainaddress, classaddress)
+
;mono_iamge_rva_map(''imageId, offset'')
-- returns the base address for a special area that stores static addresses for a given class
+
:?? not sure what this is ??
-- for example if you have a class that has 5 static fields, their offsets will be added to this base address to get the memory location
 
  
mono_class_enumFields(classaddress)
+
;mono_loadAssemblyFromFile(''fname'')
-- returns a table of field objects for fields in the given class
+
:loads a c# assembly in the target process
  
mono_class_enumMethods(classaddress)
+
;mono_invoke_method(''domainId'', ''methodId'', ''address'', ''args...'')
-- returns a table of method objects for the methods in the given class
+
:Lets you invoke a method with the given arguments. args is a tablearray of record with value and type
  
mono_getJitInfo(address)
+
== Cheat Engine Hooks ==
--
 
  
 +
;mono_initialize()
 +
: sets up hooks, calls old open process hook if there was one, calls <code>syncrhonize("mono_OpenProcessMT")</code>
  
 +
;mono_OpenProcessMT(''t'')
 +
: if parameter is not nil, calls <code>t.destroy()</code>, enumerates modules looking for 'mono.dll', adds menu item to cheat engine main form
  
==== Cheat Engine Hooks ====
+
;mono_OpenProcess(''processid'')
  
;mono_structureDissectOverrideCallback(structure, baseaddress)
+
;mono_structureDissectOverrideCallback(''structure'', ''baseaddress'')
 
:Called by CE when a structure is being dissected to fill in the values if we know the structure
 
:Called by CE when a structure is being dissected to fill in the values if we know the structure
 
:Returns true if the structure members were defined, nil if not
 
:Returns true if the structure members were defined, nil if not
 
:Calls <code>mono_object_findRealStartOfObject(baseaddress)</code>, <code>mono_class_enumFields(classaddress)</code>, <code>monoTypeToVarType(monotype)</code>
 
:Calls <code>mono_object_findRealStartOfObject(baseaddress)</code>, <code>mono_class_enumFields(classaddress)</code>, <code>monoTypeToVarType(monotype)</code>
  
;mono_structureNameLookupCallback(address)
+
;mono_structureNameLookupCallback(''address'')
 
:Returns classname,currentaddress (the real base address) or nil
 
:Returns classname,currentaddress (the real base address) or nil
 
:Called by CE when creating a new structure in the structure dissector
 
:Called by CE when creating a new structure in the structure dissector
  
mono_symbolLookupCallback(symbol)
+
;;mono_symbolLookupCallback(''symbol'')
-- returns pointer or nil
+
:returns pointer or nil
-- called by CE when it is trying to find the address to go with a symbol
+
:called by CE when it is trying to find the address to go with a symbol
-- calls mono_findMethod and mono_compile_method
+
:calls mono_findMethod and mono_compile_method
 +
 
 +
;mono_addressLookupCallback(''address'')
 +
:returns string
 +
:called by CE in the disassembly window to show a symbol name for the address
 +
:calls mono_getJitInfo(address), mono_method_getClass(method), mono_class_GetName(class), mono_class_GetNamespace(class), mono_method_getName(method)
 +
 
 +
 
 +
 
 +
== Mono Dissector Methods ==
 +
 
 +
;monoform_killform(''sender'')
 +
;monoform_miShowILDisassemblyClick(''sender'')
 +
;monoform_miRejitClick(''sender'')
 +
;monoform_miGetILCodeClick(''sender'')
 +
;monoform_EnumImages(''node'')
 +
;monoform_EnumClasses(''node'')
 +
;monoform_EnumFields(''node'')
 +
;monoform_EnumMethods(''node'')
 +
;mono_TVExpanding(''sender, node'')
 +
;mono_TVCollapsing(''sender, node'')
 +
;monoform_FindDialogFind(''sender'')
 +
;monoform_miFindClick(''sender'')
 +
;monoform_miExpandAllClick(''sender'')
 +
;monoform_miSaveClick(''sender'')
 +
;mono_dissect()
 +
;miMonoActivateClick(''sender'')
 +
;miMonoDissectClick(''sender'')
 +
 
 +
 
  
mono_addressLookupCallback(address)
+
{{MonoSeeAlso}}
-- returns string
 
-- called by CE in the disassembly window to show a symbol name for the address
 
-- calls mono_getJitInfo(address), mono_method_getClass(method), mono_class_GetName(class), mono_class_GetNamespace(class), mono_method_getName(method)
 
</pre>
 

Latest revision as of 19:10, 18 March 2019

This entry needs a lot of work. Please contribute if you can.

Check this page to see if there are some suggestions for adding to Mono:Mono Lua.


The advanced Mono features of Cheat Engine are controlled by the "monoscript.lua" script in the autorun directory where cheat engine is installed. When you attach to a process, the script scans for "mono.dll". If it is found, the appropriate MonoDataDissector dll from the autorun directory is injected into the process which creates a named pipe waiting for a connection. The LUA code then connects to the pipe and messages are exchanged to perform the mono functions.


Main Methods[edit]

LaunchMonoDataCollector()
injects the dll and returns 0 for failure, or monoBase returned from the CMD_INITMONO command on the pipe
varType = monoTypeToVarType(monoType)
Returns the Cheat Engine type (vtString, vtByte, vtWorkd, vtDword, vtSingle, vtDouble, vtPointer) for the given mono type
mono_object_getClass(address)
returns classId, className of the class at the given address in memory
mono_enumDomains()
returns a table array of domainaddress for each domain in the game
mono_setCurrentDomain(domainId)
returns ? (result of MONOCMD_SETCURRENTDOMAIN)
sets the domain the MonoDataCollector will use
mono_enumAssemblies()
returns table of assemblyId for each assembly in the current domain from the MonoDataCollector
mono_getImageFromAssembly(assemblyId)
returns the imageId for the passed assembly
mono_image_get_name(imageId)
returns the name of the assembly with the given imageId
mono_image_enumClasses(imageId)
returns a table of classId for classes in the given assembly image
mono_class_getName(classId)
returns the class name as a string
mono_class_getNamespace(classId)
returns the namespace of the given class as a string
mono_class_getParent(classId)
returns the classId of the parent class of the given class
mono_class_getStaticFieldAddress(domainId, classId)
returns the base address for a special area that stores static addresses for a given class. For example if you have a class that has 5 static fields, their offsets will be added to this base address to get the memory location
mono_class_enumFields(classId)
returns a table of field objects for fields in the given class
field - the field id
type - ?? the Cheat Engine type? (i.e. vtByte, vtWord, vtString, etc?)
monotype - ?? the mono type?
parent - ?? the class id?
offset - the offset in bytes from the structure base address
flags - ??
isStatic - true/false - if true, offset is into static address, use mono_class_getStaticFieldAddress
name - field name
typename - name of the type with namespace (i.e. "System.Int32")
mono_class_enumMethods(classId)
returns a table of method objects for the methods in the given class
method - method id
name - string name of the method
mono_getJitInfo(address)
returns a result object with the properties given the address of code in memory
method - the method id
code_start - address where method code begins
code_size - length of code in bytes
mono_image_findClass(imageId, namespace, className)
returns the classId of the given class name and namespace in an image
mono_findClass(namespace, className)
returns the classId of the given class name and namespace
mono_class_findMethod(classId, methodName)
returns the methodId of a certain method in a class
mono_findMethod(namespace, className, methodName)
returns the methodId of a certain method, calls mono_image_findClass and mono_class_findMethod
mono_method_getName(methodId)
returns the name of a method given the id
mono_method_getHeader(methodId)
returns a headerId??
mono_method_getSignature(methodId)
returns result, parameternames, returntype
result - ?? string
parameterNames - table of strings representing parameter names
returnType - string?? - mono type string?
mono_method_disassemble(methodId)
returns a string - ?? the IL code ??
mono_method_getClass(methodId)
returns the classId a method belongs in
mono_compile_method(methodId)
JIT a method if it wasn't compiled yet, returns the address of the method
mono_free_method(methodId)
(no return value) - only works on dynamic method, and only if profiler isn't being used
mono_methodheader_getILCode(methodHeader)
returns address, size
address - address of start of IL code?
size - size of IL code?
mono_getILCodeFromMethod(methodId)
combination of mono_method_getHeader and mono_methodheader_getILCode
mono_iamge_rva_map(imageId, offset)
?? not sure what this is ??
mono_loadAssemblyFromFile(fname)
loads a c# assembly in the target process
mono_invoke_method(domainId, methodId, address, args...)
Lets you invoke a method with the given arguments. args is a tablearray of record with value and type

Cheat Engine Hooks[edit]

mono_initialize()
sets up hooks, calls old open process hook if there was one, calls syncrhonize("mono_OpenProcessMT")
mono_OpenProcessMT(t)
if parameter is not nil, calls t.destroy(), enumerates modules looking for 'mono.dll', adds menu item to cheat engine main form
mono_OpenProcess(processid)
mono_structureDissectOverrideCallback(structure, baseaddress)
Called by CE when a structure is being dissected to fill in the values if we know the structure
Returns true if the structure members were defined, nil if not
Calls mono_object_findRealStartOfObject(baseaddress), mono_class_enumFields(classaddress), monoTypeToVarType(monotype)
mono_structureNameLookupCallback(address)
Returns classname,currentaddress (the real base address) or nil
Called by CE when creating a new structure in the structure dissector
mono_symbolLookupCallback(symbol)
returns pointer or nil
called by CE when it is trying to find the address to go with a symbol
calls mono_findMethod and mono_compile_method
mono_addressLookupCallback(address)
returns string
called by CE in the disassembly window to show a symbol name for the address
calls mono_getJitInfo(address), mono_method_getClass(method), mono_class_GetName(class), mono_class_GetNamespace(class), mono_method_getName(method)


Mono Dissector Methods[edit]

monoform_killform(sender)
monoform_miShowILDisassemblyClick(sender)
monoform_miRejitClick(sender)
monoform_miGetILCodeClick(sender)
monoform_EnumImages(node)
monoform_EnumClasses(node)
monoform_EnumFields(node)
monoform_EnumMethods(node)
mono_TVExpanding(sender, node)
mono_TVCollapsing(sender, node)
monoform_FindDialogFind(sender)
monoform_miFindClick(sender)
monoform_miExpandAllClick(sender)
monoform_miSaveClick(sender)
mono_dissect()
miMonoActivateClick(sender)
miMonoDissectClick(sender)


See also[edit]