This is a debugging tool. This mod adds commands /gvv and others and a hotkey(Ctrl+Shift+V) to allow you to check _G and global table of map or each mods. Only admins can use command if it is multiplay game. You have to input some code for temporary accessibility or have to edit "control.lua" of other mod or map to access global table of the mod or map. See "Helper" tab for instructions.
Providing the player with new tools or adjusting the game interface, without fundamentally changing gameplay.
Version: 0.6.0
Date: 2026-10-28
Changes:
- gvv file restructuring: core files moved from modules/ to core/ (core/utils/, core/datas/).
- Ritn mods architecture (step 1): core/defines.lua path registry (gvv.defines), core/class.lua class factory, core/setup-classes.lua, core/modules.lua sent to __core__ event_handler. load.lua and gui_event.lua become modules (modules/events.lua, modules/player.lua, modules/gui_event.lua). No behaviour change.
- Ritn mods architecture (step 2a): library sorted by part in lualib/ : lualib/common/ (util, table_to_str, sprite, luaobj_prop, copy_code, doctor), lualib/api/ (attribute_type_map, concept_fields), lualib/remote_code/. No behaviour change.
- lualib/common/check.lua: value checking functions modelled on RitnLib (isNil, isEmptyString, defaultValue, startsWith, isTable, isEmpty, isLuaObject, isValidLuaObject, dataType, tryGet, getPath, tryCatch...), standalone copy with fixes. Not used yet.
- Ritn mods architecture (step 3.0): GUI foundation copied and adapted from RitnLib 0.10.7 (source noted in each file): classes/GvvPlayer.lua, classes/GvvGui.lua (actions call class methods directly), classes/GvvGuiElement.lua (gui_name-type-name names, tags). modules/gui.lua dispatches GUI events to migrated windows first, then to the old code, now in legacy/ until it is migrated. Console commands registered by modules/commands.lua (add_commands). No behaviour change.
- Ritn mods architecture (step 3.1): main window rebuilt by classes/GvvGuiMain.lua and gui/main.lua with gvv_main-type-name element names (open, close, toggle, resize, tab change). Tab contents are still built by the old code (legacy/gui.lua build_* functions). New core/migrations.lua: the 0.6.0 migration closes the old gvv windows and clears the old element references (data kept); it replaces the 0.4 migration.
- Ritn mods architecture (step 3.2): gvv small windows (dump, input code, copy code, edit code, export, import) rebuilt by classes/GvvGuiDialog.lua and gui/dialogs.lua with gvv_dialog-type-name names; read-only texts keep their original text in element tags instead of a hidden label. Same behaviour as before (Escape, close button, closing with the main window or on main window click).
- Ritn mods architecture (step 3.3): help tab rebuilt by classes/GvvGuiHelp.lua, gui/help.lua and gui/help_pages.lua (pages content, same texts) with gvv_help-type-name names; legacy/help_menu.lua removed. Texts to copy are read-only through element tags.
- Ritn mods architecture (step 3.4): variable tracking tab and its tools rebuilt by classes/GvvGuiTracking.lua and gui/tracking.lua with gvv_tracking-type-name names; an entry code is stored in its tags instead of its name; legacy/tracking.lua removed. Same behaviour as before.
- Ritn mods architecture (step 3.5): tree search (magnifier button and one search panel per tree) rebuilt by classes/GvvGuiSearch.lua and gui/search.lua with gvv_search-type-name names; legacy/search_tree.lua removed. Same behaviour as before.
- Ritn mods architecture (step 3.6a): one generic tree engine classes/GvvGuiTree.lua (gui/tree.lua elements, one configuration file per tab in gui/tree/), used by the storage tab (gui/tree/storage.lua) with gvv_tree_storage-type-name element names; row data in element tags instead of element references in storage.
- Ritn mods architecture (step 3.6b): property and LuaObject tabs moved to the generic tree engine (gui/tree/property.lua, gui/tree/luaobject.lua), trees tools (refresh, n/a, nil, methods boxes) rebuilt by GvvGuiTree with gvv_trees-type-name names, legacy/gui_event.lua removed (Shift+X and the main window click handled by modules/gui.lua).
- Ritn mods architecture (step 3.7): legacy/ folder removed (last wrappers replaced by direct GvvGuiMain / GvvGuiDialog calls), no more GUI element references in storage (data.gui, tree rows, search results: a chosen search result is found by running the search again; the 0.6.0 migration clears the old references), unused GUI helpers removed from lualib/common/util.lua.
- Ritn mods architecture (step 4): data.lua split into prototypes/ (custom-inputs, sprites, fonts, styles), paths in gvv.defines.prototypes; same prototypes and styles as before (duplicate gvv-mod_folder-closed sprite declared once, undefined button_hovered_font_color removed from the tree rows styles, it had no effect).
- GUI errors are now also written to factorio-current.log with the call stack (the chat keeps the short message).
- Development: gvv loads the RitnTest interface when the RitnTest mod is active (in-game tests through RCON, never installed by players).
- The main gvv window now opens centred on screen (it used to open in the top left corner).
Bugfixes:
- Help tab diagnose / fix and remote.call(..., "c", ...) failed with "function diag ... is not found" for mods loading gvv through require("__gvv__.gvv")(): diag, fix and c were missing from that interface since 0.5.x. Restored, built from the console code templates.
- /gdump-json produced invalid JSON: apostrophes and some control characters were escaped Lua-style (\', \a, \v), inf/NaN and functions were written raw. Strings are now escaped per JSON rules, inf/NaN become null, functions become "function".
- /gdump-luaon produced invalid Lua: reserved words used as keys (end, for...) are now written ["end"], inf/NaN as math.huge and 0/0, functions as "function".
- Converting a table that references itself no longer crashes with a stack overflow: "<recursive table>" is written instead.
- Deep copy (search results, tracking list, docked object paths) now uses Factorio util.table.deepcopy: no crash on recursive tables, original metatables kept.
- LuaObject properties: reading methods is now protected like attributes (no error on an object that became invalid), a missing sub-object (nil) no longer crashes, read values are no longer modified (object_name injection), dead concept code removed.
- Lua objects tab: refreshing or registering an object that no longer exists (e.g. destroyed entity) raised "attempt to index local 'obj' (a nil value)" at tree.lua. A clear message is now shown: "That LuaObject is not there anymore." with the object path, and the object is removed from the tab list.
- Variable tracking: moving entries up/down, importing a list and confirming an entry edit raised "table index is nil" (variables i/value left undefined by a rename in 0.5.x). Fixed.
Published:
- Ritn
Version: 0.5.21
Date: 2026-10-25
Changes:
- converter runtime-api-stable.lua compatible for gvv (2.1.23).
Bugfixes:
- Fixed "can't send LuaDebugAdapter through remote calls" error when viewing _G/storage while running under the VSCode debugger (FMTK). LuaDebugAdapter is now blacklisted and shown as "<LuaDebugAdapter>".
- Fixed "bad argument #1 of 2 to 'pairs' (table expected, got nil)" at tree.lua when opening a folder or clicking "Continue to load" on an entry that no longer exists. A message is now shown and the tree is refreshed.
- Fixed "<ERROR> attempt to perform arithmetic on local 'counter'" for table or LuaObject keys inside sub-tables of storage/_G. Such keys are now numbered per type within their table (<table_1>, <table_2>, <LuaEntity_1>...), so none overwrites another. Non-copyable values are shown without number (<LuaGameScript>, <function>...).
Published:
- Ritn
Version: 0.5.20
Date: 2026-09-12
Changes:
- converter runtime-api-stable.lua compatible for gvv (2.1.17).
Published:
- Ritn
Version: 0.5.19
Date: 2026-07-12
Changes:
- converter runtime-api-stable.lua compatible for gvv (2.1.9).
- factorio_version : 2.1
Published:
- Ritn
Version: 0.5.18
Date: 2026-06-09
Adds:
- add: GitHub actions to deploy a version to a new tag
Published:
- Ritn
Version: 0.5.17
Date: 2026-05-28
Changes:
- change: game.players[player_index] by game.get_player(player_index)
- change: game.surfaces[player_index] by game.get_surface(surface_index)
Published:
- Ritn
Version: 0.5.16
Date: 2026-05-17
Changes:
- converter runtime-api-stable.lua compatible for gvv (2.0.76).
Published:
- Ritn
Version: 0.5.15
Date: 2025-07-15
Adds:
- converter runtime-api-stable.lua compatible for gvv (2.0.60).
Changes:
- delete runtime-api-latest.lua (2.0.59).
Published:
- Ritn
Version: 0.5.14
Date: 2025-07-15
Changes:
- Minor adjustments to internal exclude_classes logic for better compatibility.
Published:
- Ritn
Version: 0.5.13
Date: 2025-07-14
Fixes:
- Fixed global copy logic to avoid "Forbidden global read" errors when mods use strict _ENV protection (e.g., Vehicle Wagon 2 or autodrive).
- Improved recursive object wrapping to safely handle all sub-keys without triggering global lock errors.
Changes:
- Added detailed comments and cleaned up `gvv.lua` for better readability and maintenance.
- Minor adjustments to internal copy_object logic for better compatibility.
Published:
- Ritn
Version: 0.5.12
Date: 2025-07-14
Fixes:
- Fixed a critical bug causing errors when using `remote.call("__mod__gvv", "storage")` or `_G` with mods that lock the global environment (`_ENV`).
- `copy_object` function is now properly declared as local to avoid conflicts with global scope.
Published:
- Ritn
Version: 0.5.11
Date: 2025-07-10
Fixes:
- Fixed minor issues `Trackingplayer_data` <-> `Tracking` in gui_event.lua.
Published:
- Ritn
Version: 0.5.10
Date: 2025-07-10
Fixes:
- Fixed minor issues `g index is nil` in gui_event.lua.
Published:
- Ritn
Version: 0.5.9
Date: 2025-07-10
Fixes:
- Fixed major issues with `_G()` and `storage` remote call returns in gvv.lua.
- Restored original logic for `_G()` to ensure correct copying of global tables without errors on `wrap_object`.
- Excluded additional keys (`prototypes`, `helpers`, `copy_object`) to prevent unwanted entries in global dump.
Changes:
- Improved code readability by adding clear French/English comments for each recursive and object wrapping function in gvv.lua.
- Refactored variable names for clarity and context (Factorio-specific).
Published:
- Ritn
Version: 0.5.8
Date: 2025-07-10
Adds:
- Support for all LuaMapSettings sub-classes (e.g., asteroids, enemy_evolution, enemy_expansion, etc.)
with automatic concept detection and correct object_name injection.
- New file: attribute_type_map.lua, containing mappings of parent classes to their sub-class attributes
(e.g., LuaMapSettings → AsteroidMapSettings), to improve type resolution.
- New file: concept_fields.lua, defining fields for Factorio concepts to allow safe introspection even when runtime_api is missing.
Changes:
- Fixed major issues with recursive concept parsing to prevent "Unknown class for object_name" errors.
- Improved handling of inaccessible attributes ("<cannot read>") for SteeringMapSetting and similar concepts.
- Refactored luaobj_prop.lua for better stability and compatibility with Factorio 2.0.59.
- Completely rewrote gui_event.lua to be more explicit and readable (less minified), resulting in a cleaner and
easier-to-maintain codebase.
- Similarly, fully refactored gvv.lua to improve clarity and maintainability, matching the new style used in gui_event.lua.
Published:
- Ritn
Version: 0.5.7
Date: 2025-07-09
Adds:
- converter runtime-api.json to runtime-api-stable.lua compatible for gvv (2.0.55).
Changes:
- runtime-api.lua to runtime-api-latest.lua (2.0.59).
Published:
- Ritn
Version: 0.5.6
Date: 2025-07-09
Changes:
- converter runtime-api.json to runtime-api.lua compatible for gvv (2.0.59).
Published:
- Ritn
Version: 0.5.5
Date: 2024-11-16
Fixes:
- fixed : "enable_tip_triggers_in_custom_scenarios=true" removed from runtime-api.lua.
- fixed : The example of tracking for the evolution factor has been updated.
Published:
- Ritn
Version: 0.5.4
Date: 2024-10-27
Adds:
- converter runtime-api.json to runtime-api.lua compatible for gvv (thanks Thaui).
- LuaObject add: LuaPrototypes and LuaHelpers.
Fixes:
- fixed "is_valid_sprite_path". using helpers instead of game now.
Published:
- Ritn
Version: 0.5.3
Date: 2024-10-25
Fixes:
- Fixed crash when "on_runtime_mod_setting_changed" occurs. (changing gvv mod settings while playing game.)
Published:
- x2605
Version: 0.5.2
Date: 2024-10-22
Changes:
- Changed version string to Factorio 2.0
- Changed a few reserved words in source code to make compatible to 2.0
Published:
- x2605
Version: 0.5.1
Date: 2022-03-16
Changes:
- Tried "global" diagnostic in trouble shooter to do not iterate inside metatables and recursive tables.
Version: 0.5.0
Date: 2022-03-16
Changes:
- Tried afforts to avoid metatable related errors.
- "global" table bringer will now work like "_G" table bringer, not simple copy anymore. This may be worse for performance, but you can explore function and metatable statements inside of global table.
- "global" diagnostic in trouble shooter will not iterate inside metatable.
Version: 0.4.5
Date: 2021-07-29
Changes:
- In remote "_G" function, table inspecting method for Factorio stock objects(LuaBlabla...) is slightly changed to avoid(hopefully) blinded invoking metamethod of tables with custom metatable.
Version: 0.4.4
Date: 2021-07-29
Changes:
- For remote "_G" function, errors are handled per element instead of denying to load entire _G tree.
- Removed error message shortening in tree view. Now full error message is shown like as variable value.
Version: 0.4.3
Date: 2021-02-13
Changes:
- Added limiter for tree loading to prevent to render too much entries in single folder at once.
Info:
- Default limit is 500 entries per folder, and this can be changed by following command,
/c __gvv__ global.meta_data.treelimit=1234
If number of entries to load in single folder at once exceeds the limit, an alternative entry to click is generated for continue to load manually.
Version: 0.4.2
Date: 2021-02-08
Fixes:
- Fixed some types of branch line in tree view look broken in Factorio 1.1.19.
Version: 0.4.1
Date: 2020-11-25
Changes:
- * Changes from 0.3.6, 0.4.0.
- Added refresh button at tree tabs.
- Added refresh hotkey (default : SHIFT+X) usable at tracking variables tab and tree tabs.
Fixes:
- * Fixes from 0.3.6, 0.4.0.
- Fixed error shown when trying to edit tracking interval number.
- Cleared misinputs of flow/frame guistyle properties.
Version: 0.4.0
Date: 2020-11-24
Changes:
- Quick adaptation to Factorio 1.1
- Removed dodging codes for some bugs/crashes fixed in Factorio 1.1
Version: 0.3.8
Date: 2020-11-25
Changes:
- Added refresh button at tree tabs.
- Added refresh hotkey (default : SHIFT+X) usable at tracking variables tab and tree tabs.
Fixes:
- Cleared misinputs of flow/frame guistyle properties.
Version: 0.3.6
Date: 2020-10-04
Fixes:
- Fixed a normal table having a child with a key "object_name" isn't shown properly in tree GUI.
- Blacklisted LuaCustomTable, LuaMapSettings, LuaDifficultySettings and LuaFlowStatistics at remote.call("__<mod_name>__gvv","_G").
To prove their existence in "_G" and to prevent game crash. (Still cannot be opened by tree GUI.)
Reason why is that they are not supported by remote.call().
Version: 0.3.5
Date: 2020-10-04
Changes:
- In tree GUI, if an entry is a prototype object and it has a sprite then, a sprite icon will be shown at left of key name.
Supported prototypes are listed here.
https://lua-api.factorio.com/1.0.0/Concepts.html#SpritePath
Version: 0.3.4
Date: 2020-09-28
Changes:
- "global" tab now shows rest of "_G" or "global" contents even if one of both have error.
Fixes:
- Fixed remote.call("__<mod_name>__gvv","_G") pops stack overflow error when trying to bring recursive table from remote _G.
Version: 0.3.3
Date: 2020-09-23
Changes:
- Added search UI for tree viewers.
- Added "show/hide nil"
Version: 0.3.2
Date: 2020-09-14
Changes:
- Entries in "Variable trace" now can be reordered, imported and exported.
Version: 0.3.1
Date: 2020-09-12
Changes:
- Entries in "Variable trace" now can be edited.
- "_G" scope of gvv mod now have "util" of "__core__/lualib/util.lua". gvv itself doesn't use it but you can use it for custom codes.
- Changed default examples of "Variable trace" entries.
Version: 0.3.0
Date: 2020-09-11
Changes:
- "_G" global table of Lua is now shown at "global" tab.
- Added a new LuaRemote interface, remote.call("__<mod_name>__gvv","_G")
Version: 0.2.3
Date: 2020-09-10
Fixes:
- Fixed mistakes in "/gdump-json" command which was not following js object notation strictly.
- Missing LuaLazyLoadedValue in remote "diag" is now recognized as errorful entry in global.
Version: 0.2.2
Date: 2020-09-10
Changes:
- When trying to track already non-existing LuaObject reference found in "global" tab, pops error message immediately instead of opening it at "property" tab.
Fixes:
- Fixed a few missing "local" notations in source code.
Version: 0.2.1
Date: 2020-09-08
Changes:
- Removed /g-c commands because I found built-in /c commands also can access mod via /c __<mod_name>__ <code>.
- Now mods are also can be made to be temporarily accessible by gvv without changing "control.lua".
- Added mod setting option to completely turn "on_tick" event of gvv off/on. (can be used in playtime)
Info:
- Though /g-c is gone, but remote.call("__<mod_name>__gvv", "c", <script>, ...) still remains. Usable in Lua snippet of /editor or elsewhere.
- To turn off on_tick in server console, use /sc __gvv__ settings.global["gvv-mod_enable-on-tick"]={value= false }
Version: 0.2.0
Date: 2020-09-07
Changes:
- Command /g-c and same kinds now have ability to run Lua code in global scope of other mod (not only level, gvv).
- Added a new remote function, remote.call("__<mod_name>__gvv", "c", <script>, ...) . /g-c is using this for executing code in other mods.
- Added new examples of using /g-c in "Usage Tips".
- Added a new example of using new remote function for Lua snippet of /editor in "Usage Tips".
- Little bit changed stringify process of some LuaObjects not supporting .help() function, to make it do not make trouble when Factorio is updated to have .help() function for them later(or never...).
Info:
- To run Lua code in a specific mod except level or gvv, for example, mod name is my Mod-1 then type :
- /g-c --[[my Mod-1]] game.print(script.mod_name)
- New remote function is remote.call("__my Mod-1__gvv","c", script, arg1, arg2, arg3, ...) and script(string type) is for loadstring(script) function.
- arg1, arg2, arg3, ... will become local arg = {arg1, arg2, arg3, ...} inside of script.
Version: 0.1.2
Date: 2020-09-06
Changes:
- Added new commands : /g-c, /g-sc, /g-command, /g-silent-command, which are almost equivalents to built-in commands such as /c, /sc but execution scope is global of gvv, not level(map).
- Now return values in tracking list can be copied.
- Added "Usage Tips" menu in "Helper" tab.
- Added path in tooltip of object list at left side in "property" tab.
Info:
- In new "Usage Tips", I wrote tips I forgot to write before, and introduced a trick to use global table space for memo.
Fixes:
- Fixed unable to right-click in "Variable trace" if there is nothing.
- Fixed loading map saved when gvv is 0.1.0 causing global CRC check fail.
- Little fix in remote diagnose code. Changed few report name strings that is not changing behavior of previous versions to make it show key names properly in some cases.
- Fixed "global" tree gui to show functions(if they are placed in global of gvv) regardless of "method view" setting of "property" or "LuaObject". functions in global cannot be saved, and cannot be brought by LuaRemote. Only functions in gvv global can be shown because there is no need to "bring" for gvv itself.
Version: 0.1.1
Date: 2020-09-05
Changes:
- Remote code(Which I recommended to paste in remote mod/map's control.lua) is changed to shorter code referring the code inside of gvv mod. Then it doesn't need to update your remote code by hand anymore when gvv provide updated remote code. Thanks for giving me this idea.
- Added guide text that suggesting how to handle remote code at "control.lua" help page. Shortly explaining a way to put it anywhere.
- Made 2nd tab (global) to reload available mod list when everytime changed from other tab, instead of reopening whole main GUI to refresh.
- Aligned text in buttons in Troubleshooting menu to center.
Info:
- Remote code will be a function when called by require. Mods or map can freely decide whether to run the code to register gvv interface now or later or not. "now" is just having "()" brackets after require(...) function, like "require(...)()". For "later", you need to assign it to a local value first like "local something = require(...)".
- Remote code from 0.1.0 will work fine for now. No changes to it, but it is recommended to change it to code of 0.1.1. Then no further by hand.
- Still you can get raw remote code from "Helper" - "Console command - 1" page. Just delete leading "/c ".
Fixes:
- Fixed changelog.txt to be parsed correctly.
- Fixed error message shown when /gdump <modname> failed due to demand mod is not supporting remote interface is shown as the message of map.
- Fixed /gmods not showing an interface registered mod in list if global table of that have errorful entry in its global table.
Version: 0.1.0
Date: 2020-09-05
Info:
- First release to public.