Unity + Lua script is now most popular incremental update frameWork for mobile game in China,However, since there haven't been good tool to monitor the cpu and memory usage of lua vm, lots of developers have no idea to optimize their code,so there are many potential risks in lua codes.
this tool is designed to support an easy-to-use profiler for unity that help finding bottleneck and make your game more fast and stable.

use administrator mode to run the link.bat

If you find any bug or have any suggests join the QQ group：882425563 to contact us

Lua Profiler For Unity supports XLua、SLua、ToLua and also a remote profiler tool so it supports Windows、Android、IOS On-device Profiler.

• You must open two Unity projects,one for game client ,one for editor server
• Open LuaProfiler folder
• Copy LuaProfilerClient folder to you game project content,if your C# Lua script is in Plugins folder,Copy LuaProfilerClient to Plugins.This Tool must make sure That code must in the same DLL which has C# lua codes.If you already import Mono.ceil library,delete LuaProfilerClient/Editor/Ceil
• Use Unity5.6 or Newer Unity version to create a project, copy LuaProfilerServer to the project content
• If your Unity version is below 5,call the following code before start the game.

MikuLuaProfiler.HookLuaSetup.OnStartGame();

It use mono.ceil's IL inject feature(also use in XLua),inject the profiler code to game code

Open windows by "Window->Lua Profiler Window", toggle profiler's feature and configure the server ip address.

Select the kind of code you want profiler,C# code color is green,and lua code color is blue.

Also open windows by "Window->Lua Profiler Window", then click OpenService,wait for client connects

Press ESC or touch four fingers in screen to show this menu,you can change ip to connect and show more details of profiler info

Programmers tend to forget to release Lua objects that are cached by C#.For example, when XLua calls LuaEnv.Dispose, it throws the exception "try to dispose a LuaEnv with C# callback!"

The reason is often caused by the following code

LuaTable tb = ...
Action action = tb.rawget<Action>("action");
a();
tb.Dispose(); //This line of code tends to forget to call
a= null;      //This line of code tends to forget to call

in lua

// The lua table tends to forget to call dispose
CS.UIBehaviour.luauiTable = {}
// The callback tends to Unregister
CS.UIButton.OnClick = function() print("test") end

They can be released by C#'s destructor, but because in C# is just an index, the memory footprint is small then C# will not be GC immediately, but the memory usage on Lua is very large. This tool will provide real-time detection of the registry to help locate memory leaks quickly.

You can search history in record line

And the add、remove history

You can set index '__name' to the lua table,monitor will replace the table code by the value of this index

CS.UIBehaviour.loginUI = { __name = "LoginUI" }

• Toggle LuaChart to open lua memory chart,line color is blue.
• Toggle MonoChart to open mono memory chart,line color is green.
• Toggle FpsChart to open fps chart,line color is orange.
• Toggle PssChart to open fps chart,line color is red.
• Toggle PowerChart to open fps chart,line color is brown.

Click Record button, when game connect to server, toggle StartRecord to start or stop record.

• drag slider to modify samples
• click '<' 、 '>' to increase or discrease frames one by one
• click '<<' 、 '>>' to fast locate the frames control by Capture Lua GC、Capture Mono GC、Frame Count
• stop record and press left or right arrow keybord to increase or discrease frames one by one

Set macro USE_LUA_PROFILER to inject profiler code in you App.If you want to use luac code or luajit bytecode ,use InjectLua.exe in folder tools To inject the lua profiler code.

InjectLua.exe "inpath" "outpath"

easy66
Xavier
Jay
ZhangDi
and all members in qq group LuaProfiler