-
-
Notifications
You must be signed in to change notification settings - Fork 28
Debug tools for extension developers
Toast edited this page Jan 4, 2024
·
2 revisions
How to use:
- run console command
tardis2_debug_pointer
in the console to spawn the pointer entity - move the pointer with a physgun to get it to the required position
- click the pointer with the "USE" key (default: E) to output its coordinates into the console
Options:
-
model
- sets the model of the pointer -
part
- sets the model of the pointer to the model of a specific part -
scale X
- sets the scale of the pointer to X -
pos X Y Z
- spawns the pointer at the specific coordinates related to the current interior (only works INSIDE the TARDIS) -
ang X Y Z
- sets the initial angle of the pointer
The options may follow each other. Examples:
tardis2_debug_pointer model models/hunter/plates/plate.mdl scale 0.5
tardis2_debug_pointer part tardis2010_wibblylever pos 20.4 100 0
tardis2_debug_pointer pos 0 0 100 ang 0 -90 180 scale 1.5
How to use:
- Toggled by a convar (console variable) called
tardis2_debug_lamps
- If set to 1 in the console (
tardis2_debug_lamps 1
), it will make existing TARDIS lamps appear as lamp entities - Respawning the TARDIS is required for it to take effect
- lamp entities can be moved around with a physgun, the "C" context menu and the color tool can help you set them up
- click the lamp with the "USE" key (default: E) to generate the code for adding this lamp into this current state into the TARDIS (the code will be printed into the console)
- to disable this, set the convar to 0 (
tardis2_debug_lamps 0
) -
NOTE: unlike projected lights, the lamp debug entities don't support the
shadows
parameter and will always have them enabled
Output example:
{
color = Color(255, 125, 35),
texture = "effects/flashlight/soft",
fov = 156.36363220215,
distance = 661.45452880859,
brightness = 0.75,
pos = Vector(6.7666015625, 42.2294921875, 164.078125),
ang = Angle(28.094324111938, 94.355094909668, -131.17744445801),
},
How to use:
- Toggled by a convar (console variable) called
tardis2_debug_textures
(1 to enable, 0 to disable) - If enabled, spawning the TARDIS will print to the console a list of all its submaterials in a TextureSet format
Output example:
Interior textures:
{"self", 0, "models/cem/toyota_smith/ceiling"},
{"self", 1, "models/cem/toyota_smith/ceilingmesh"},
{"self", 2, "models/cem/toyota_smith/ceilingl_a"},
{"self", 3, "models/cem/toyota_smith/ceilingl_b"},
...
Interior part textures:
{"door", 0, "models/doctorwho1200/toyota/2013/exterior"},
{"door", 1, "models/doctorwho1200/toyota/2013/stjohn"},
{"door", 2, "models/doctorwho1200/toyota/2013/windows"},
{"toyota_audio_system", 0, "models/cem/toyota_smith/details"},
{"toyota_balls", 0, "models/cem/toyota_smith/details"},
{"toyota_bouncy_lever", 0, "models/cem/toyota_smith/details"},
{"toyota_console_details", 0, "models/cem/toyota_smith/details"},
{"toyota_console_details", 1, "models/cem/toyota_smith/detailsm"},
{"toyota_console_scanner", 0, "models/cem/toyota_smith/screen"},
{"toyota_console_scanner", 1, "models/cem/toyota_smith/console"},
...
How to use:
- run console command
tardis2_debug_portals
in the console to open a menu - NOTE: this works both inside or outside the TARDIS
Options:
-
actions
- either print the portal to the console or reset the portal to its default values -
3D
- changes the thickness of the portal (can be inverted) -
size
- changes the height or the width of the portal -
pos X Y Z
- changes the position of portal -
ang pitch yaw roll
- changes the angle of the portal
How to use:
- to enable debug messages, set console variable
tardis2_debug
to 1 (0 to disable). - the messages appear in the console by default. To make them appear in chat, set convar
tardis2_debug_chat
to 1 (0 to disable) - while scripting any TARDIS behaviour, use
tardisdebug(...)
orTARDIS:Debug(...)
function to print absolutely ANYTHING - the function can have any number of arguments of any type, including tables:
tardisdebug(anything, anything, anything, ...)
- values will be printed for both SERVER and CLIENT separately
-
tardis2_debug_power
toggles the power in your TARDIS -
tardis2_debug_warning
switches the TARDIS between 10% and 100% of health
Both only work for server administrators We recommend using these only for debugging effects in different states, not for everyday gaming (since it might ruin the gameplay)