wiremod/wire
1
0
Fork 0
mirror of https://github.com/wiremod/wire.git synced 2025-03-04 03:03:04 -05:00
Code Issues Packages Projects Releases Wiki Activity
Page: Expression 2 Directives
Pages
Creating an E2 Core Developer Style Guide Developer: E2 Checklist E2 Guide: EGP Basics E2 Guide: File Extension E2 Guide: Lambda Timers E2 Guide: Lambdas E2 Guide: Ops E2: Chat Commands E2: EGP Objects E2: EGP E2: Find Functions E2: Learning and getting help E2: Physics E2: Tips and Tricks E2: Triggers Expression 2 Core Expression 2 Directives Expression 2 Editor Expression 2 Events Expression 2 Self Aware Expression 2 Syntax Expression 2 Gates Angle Gates Arithmetic Gates Array Gates Bitwise Gates Comparison Gates Entity Gates Logic Gates Memory Home Legacy Guides & Expression 2 Tooling Misc: Wiki Contribution Guide Prop core Quaternions Guide by Fizyk Tool: Cam Controller Tool: Freezer Tool: Gates Tool: Prop Spawner Tool: Turret Tool: User Tool: Wiring Tool: ZCPU Tool: ZGPU Tools Wire Map Interface Wiremod Folder Structure e2 docs angle e2 docs array e2 docs bitwise e2 docs bone e2 docs chat e2 docs color e2 docs compat e2 docs complex e2 docs console e2 docs constraint e2 docs core e2 docs custom camera e2 docs custom constraintcore e2 docs custom effects e2 docs custom ftrace e2 docs custom holoanim e2 docs custom light e2 docs custom prop e2 docs custom remoteupload e2 docs custom stcontrol e2 docs custom tracesystem e2 docs custom wiring e2 docs datasignal e2 docs debug e2 docs egpfunctions e2 docs entity e2 docs files e2 docs find e2 docs globalvars e2 docs hologram e2 docs http e2 docs matrix e2 docs npc e2 docs number e2 docs player e2 docs quaternion e2 docs ranger e2 docs selfaware e2 docs serialization e2 docs serverinfo e2 docs signal e2 docs sound e2 docs string e2 docs table e2 docs timer e2 docs toc e2 docs unitconv e2 docs vector e2 docs vector2 e2 docs weapon e2 docs wirelink
8 Expression 2 Directives
deltamolfar edited this page 2025-01-06 12:07:07 +02:00
Table of Contents

Directives

Directives allow you to control important properties about E2 chips, such as their name, inputs, outputs, and more.

@name

Define the name of the E2 chip to show when hovering over it.

Example

@name My E2 Chip

@inputs

Define inputs to use with the wire system alongside their types.

Example

@inputs X Y:string [Z W]:number

@outputs

Define outputs to use with the wire system alongside their types.

Example

@outputs X Y:string [Z W]:number

@persist

Define a variable to persist across multiple executions.
Otherwise variables will reset to their default values.

Example

@persist X Y:string [Z W]:number

@trigger

The trigger directive can selectively enable or disable inputs from triggering executions. Possible values are all/none, but also a list of inputs. You usually will not need to worry about this.

Example

@trigger all
# or
@trigger X Y

@model

Sets the model of the E2 chip. Example

@model path/to/prop/model.mdl

@autoupdate

Using the autoupdate directive will enable auto updating. What this means is that whenever you paste a duplication of an E2 with autoupdate enabled, the E2 will check your files for a new version of that E2 and upload it. Note:

  • Only works on saved E2s.
  • To disable autoupdate, simply don't write @autoupdate
  • If you for some reason need to get an old version of your E2 from a dupe, you will have to temporarily change the name of your E2 so that the autoupdate feature doesn't find the file. Then it'll silently fail and leave you with the old code.

@strict

Note

It is STRONGLY suggested to always leave the strict directive in your e2. At this point, some compiler features are only available with strict mode, thus non-strict mode is only left to support backwards compability.

This makes E2 throw runtime errors on edge cases, unsafe practices, and other things that might be the source of bugs. (But also brings a lot of new features and optimizations)

Take this example for instance:

E = propSpawn("some/custom/model.mdl", entity():pos(), 1)
E:applyForce( vec(10000, 0, 0) )

If the server doesn't have "some/custom/model.mdl", you'll end up with an invalid entity stored in E.

Without @strict, this silently fails and tries to carry on like nothing happened.
However, WITH @strict, it will throw a hard error and shut down the E2 if not handled in a try/catch block.

Expression 2 ⚙️

Getting Started 🕊

Guides (In learning order) 🎓

Tools 🛠️

Click To Expand

Advanced

Beacon 💡

Control 🎛️

Data 💿

Detection 👀

Display 💻

Render 🖌

I/O 🔌

Physics 🚀

Utilities 🛠️

RFID 💳

Wireless 🛜

Gates 🚥

Click To Expand

TBD

Extras 🔭

Please do not alter the e2 docs ... pages manually.
They are autogenerated from the E2Helper. In the future, this will hopefully be its own dedicated website or tool.

Default Extensions

Basic Features: core, debug, number, selfaware, string, timer
🌎 World: angle, color, find, ranger, sound,
🔣 Math: bitwise, complex, matrix, quaternion, vector, vector2/4
📦 Entities: bone, constraint, egp, entity, hologram, npc
👨 Players: chat, console, player, weapon
📊 Data storage: array, files, globalvars, serialization, table
💬 Communication: datasignal, http, signal, wirelink,
❓ Informational: gametick, serverinfo, steamidconv, unitconv

Additional Extensions

Disabled by default: constraintcore, effects, propcore, remoteupload, wiring
Wire-Extras (repo): camera, ftrace, holoanim, light, stcontrol, tracesystem

Developer resources