<structure> <realm>Shared</realm> <description>Table structure used for <page>util.TraceLine</page>.</description> <fields> <item name="start" type="Vector" default="Vector(0, 0, 0)">The start position of the trace</item> <item name="endpos" type="Vector" default="Vector(0, 0, 0)">The end position of the trace</item> <item name="filter" type="Entity" default="{}">Things the trace should not hit. Can also be a table of entities and classname strings, or a function with one argument:⤶ * <page>Entity</page> ent - The entity that the trace hit⤶ ⤶ Return true in the function to hit the entity, false to skip it.⤶ ⤶ <warning>Using a function here is super slow - try to avoid it.</warning></item>⤶ <item name="filter" type="Entity" default="nil">⤶ Things the trace should not hit. Can be an entity, a table of entities, a table of entity classes or a function:⤶ ⤶ <callback>⤶ <arg type="Entity" name="ent">The entity that the trace hit</arg>⤶ <ret type="boolean">Return `true` to hit the entity, `false` to skip it.</ret>⤶ </callback>⤶ ⤶ Using a function here is super slow. Try to avoid it.⤶ </item>⤶ ⤶ ⤶ <item name="mask" type="number" default="MASK_SOLID">The trace mask <page>Enums/MASK</page>. This determines what the trace should hit and what it shouldn't hit. A mask is a combination of <page>Enums/CONTENTS</page> - you can use these for more advanced masks.</item> <item name="collisiongroup" type="number" default="COLLISION_GROUP_NONE">The collision group <page>Enums/COLLISION_GROUP</page>. This determines what the trace should hit in regards to the entity's collision group.</item> <item name="ignoreworld" type="boolean" default="false">Should the trace ignore world or not</item> <item name="hitclientonly" type="boolean" default="false">Should the trace hit clientside-only entities or not</item>⤶ <item name="whitelist" type="boolean" default="false">Turns the filter field into a whitelist instead of an ignore list, does not affect function filters</item>⤶ <item name="output" type="table" default="nil">If set, the trace result will be written to the supplied table instead of returning a new table</item> </fields>⤶ ⤶ <item name="whitelist" type="boolean" default="false" added="2024.05.16">Turns the `filter` field into a whitelist, if it is a table.</item>⤶ <item name="hitclientonly" type="boolean" realm="client" default="false" added="2024.05.16">Enables traces to hit clientside only entities. Keep in mind that most naturally spawned entities are classified as debris, so extra `mask` values might be required.</item>⤶ ⤶ </fields>⤶ </structure>