Skip to main content

Mailbox writing and data sources reference

Mod version shipped with FlammiCraft: 1.13.0

Overview · Main instructions

Detailed reference retained from the original AFN help. Integration-specific entries apply only when the corresponding mod is installed. Examples describe mod behavior; pack recipes and settings may differ.

{"Current":"0su","Total":"262,144su"}

With Automatic Read enabled, check the attached block's readings and modes in the dropdown. You can select all; at least one stays selected. The list below names each block and the data it provides.

Multi-selection results exceeding the server channel-text allowance produce {"error":"content_limit"}, without truncating JSON.

One selection keeps the original text; multiple selections produce JSON. Keys use field names where possible, such as Total, read with ${$.Total}. Duplicate names gain a source prefix; spaces and punctuation become underscores. Numbers, booleans and valid JSON objects or arrays keep their types; other content becomes a string.

Automatic Read and Automatic Output are exclusive; the output direction is described on the Output devices page.

Progress bars become copyable 20-cell text bars with a percentage, for example [#####---------------] 25%. Select a numerical or percentage reading for calculations.

Automatic read

Aeronautics devices

AFN mailboxes

Create Big Cannons devices

CC:Tweaked Computers

Create blocks

Create: Connected devices

Create Crafts & Additions devices

Diesel Generators devices

Electro Energetics devices

Flight Control devices

NetMusic

Create: Radar

Vanilla blocks

Andesite/Brass Tunnel → accumulated item count or throughput

Accumulator → stored energy, capacity, remaining capacity (FE), percentage or progress bar

Altitude Sensor → world height or air pressure

Auger Cog/Shaft → item throughput

Fluid Tank in a boiler structure → boiler status

Horizontal Fluid Vessel in a boiler structure → boiler status

Cannon Mount → cannon assembled, true or false

Cannon Mount → actual decimal pitch; positive raises the barrel

Cannon Mount → actual yaw, 0–360 degrees; 0 south, 90 west, 180 north, 270 east in the mount structure coordinate frame

CC:Tweaked computer → screen text

Smart Observer → amount or list of matching items or fluids

Elevator Contact → current elevator floor

Respawn Anchor → each player’s death count

Burner → valve opening (burn rate 0–1), heat, output strength (0–15) and fluid readings; heat may be -1 when unlit

Diesel / Modular Diesel / Huge Diesel Engine → actual speed, direction (0 clockwise / 1 counterclockwise), running and stress capacity

All three Diesel Engine types → fuel amount, tank capacity, fluid name and ID; modular members read the controller

Powered Engine Shaft → actual speed, running and stress capacity; Huge Engines read speed and capacity from their shared shaft

Pumpjack Hole → oil reserves, retaining the original integer B reading (1 B=1000 mB)

Chemical Turret → current/target yaw and pitch, spraying state, fluid amount, tank capacity, name and ID

Docking Connector → connected vehicle

Accumulator → Total charge, nominal capacity and per-cell charge (C), plus state of charge (0–100%). Double-cell totals include both cells; cell 2 is 0 on single-cell devices. Charge is not FE or Wh.

Resistor / Potentiometers / Capacitor / Inductor → Configured resistance (ohms), capacitance (F, including High Voltage Capacitors) or inductance (H). Potentiometers also expose opening percentage; their resistance reading is the configured maximum, not instantaneous equivalent resistance.

Voltmeter / Ammeter / Frequency Meter / Synchroscope → Voltage magnitude (V), current magnitude (A) or frequency (Hz). The synchroscope exposes native phase offset (degrees) and phase-order match (true/false).

Alternator Brushes / Three-phase Alternator Brushes → actual speed (RPM) and the native measured voltage magnitude (V). Reuses published readings without scanning the generator structure.

Energy Meter / Tri-polar Energy Meter → Active power (W), total energy (kWh) and disconnected state (true/false). Read-only; billing totals and ownership are unchanged.

Electric Motor → Actual and target speed (RPM), unlocked mode, load percentage and voltage (V). Target speed is empty in unlocked mode; internal codes are not RPM.

High-voltage Switch / Fuse → The switch exposes connected and arcing states; the fuse exposes rated current (A). AFN does not override switch mechanics or repair a broken fuse.

Electric Pump → Voltage magnitude (V) and actual speed (RPM). Speed follows native electrical supply; AFN does not fake power or target speed.

Transformer / Transformer Core / Variacs → Transformers expose configured ratio, primary/secondary voltage (V) and active power (W). Cores expose local winding turns, voltages and power. Both variacs expose maximum ratio and opening percentage.

Creative Battery / Voltage Regulator / Converter → Target voltage (V). The regulator also exposes input/output voltage (V) and active power (W); the converter also exposes active power (W), preserving its native sign.

Enchanting Table → maximum enchantment cost

Portable Engine → remaining or total burn time

Seat → passenger name

Threshold Switch → container fill level

Fixed Cannon Mount → integer pitch setting, −45 to 45 degrees

Fixed Cannon Mount → integer yaw setting, −45 to 45 degrees

Hot Air Burner/Steam Vent → balloon fill volume or total lift

Factory Gauge (using its linked Factory Panels) → item stock, item name and request status

Gimbal Sensor → pitch and roll angles

Belt, Depot or Weighted Ejector → current item name

Kinetic Battery → charge, percentage or progress bar

Speedometer → rotation speed (RPM)

Stressometer → stress reading

Laser Sensor → hit distance

Mailbox, Directional Mailbox, Modulating Mailbox → current channel information after output syntax

Megaphone → stream address, name, range and playback state

Read playback state, title, artists, translated title, duration, elapsed time, remaining time, progress, current lyric, full lyrics, song source, looping, redstone state, VIP status, read-only status and disc presence.

Navigation Table → target distance or estimated arrival time

Navigation Table → own world coordinates, following its moving structure

Navigation Table → target world coordinates; empty when no target is set

Navigation Terminal → every configured route waypoint as an ordered coordinate array

Navigation Terminal → current leg completion percentage (0–100)

Navigation Terminal → current target world coordinates (x,y,z)

Navigation Terminal → current waypoint number (starting at 1)

Nixie Tube → displayed text

Note Block → pitch

Track Observer → detected train name

Optical Sensor → detected block or distance to target

Auto Yaw, Auto Pitch, T-Pitch and Fire Controllers → applicable angles, limits, alignment or firing states

Directional Jammer → enabled/discharging states, current and target orientation, selected emitter and jamming status

Monitor → displayed merged contacts, selected target, connection state and radar count; joined monitors resolve their controller

Network Controller → reported contacts, selected target, automatic selection and linked device counts

Radar Warning Receiver → warning strength, threat count and detailed warnings; these are not ordinary entity coordinates

Radar Bearing, Plane Radar, Sky Radar and Sonar Bearing → coordinate arrays, map JSON, detailed contacts, counts and device-specific operating readings

Identification Transponder → name and registration state of its structure; the identification code is not exposed

Content Observer → package destination address

Target Block → redstone strength

Command Block (selected objective) → player scores

Train Station → station summary or train status

Stock Link → its logistics network name

Stock Ticker → its logistics network name

Cuckoo Clock → current time or elapsed time

Linked Typewriter → entered text

Velocity Sensor → relative speed and direction

Connect the Mailbox to one of these Aeronautics devices to read its data. Balloon readings require a balloon working with a Hot Air Burner or Steam Vent.

Attach the reading Mailbox to another Mailbox, enable Automatic Read, and select Channel information. Text, line breaks and JSON are preserved in full. An empty source or an output rule without a valid result reads as empty text.

Attach a Mailbox to a Cannon Mount or Fixed Cannon Mount and select the readings. Ordinary mounts report actual local heading and elevation; fixed mounts report integer settings within ±45 degrees. Local readings on moving structures are not world orientation.

With CC:Tweaked installed, connect the Mailbox to a computer to read its screen text.

With Create: Connected installed, connect the Mailbox to one of these blocks to read its data:

Connect the Mailbox to one of these Create blocks to read its data. A Stressometer offers several reading formats; a Factory Gauge can read the stock, item name and request status shown by its linked Factory Panels.

Attach a mailbox to an Accumulator and select the readings you need. Stored FE, capacity and remaining FE are exact integers without units or K/M abbreviations. One selection remains text: calculate with ${add(number($[0]),1)}. Multiple selections form JSON with numerical fields: calculate with ${add($.Total_Capacity,1)}.

Attach a mailbox to the device and select its readings. New numerical readings have no units: speed is RPM, stress capacity is SU, fluid amounts/capacities are mB, and angles are degrees. Running/spraying states are true/false. One selection remains text, convertible with ${number($[0])}; multiple selections form JSON using field names. Only selected fields are sampled; unloaded controllers are not force-loaded.

Attach a mailbox to a device below and select the readings you need. Numbers have no unit suffix and can be used directly in expressions; multi-select uses JSON. Only selected fields are sampled; AFN neither scans circuits nor force-loads chunks. Electrical charge is not FE energy. Choose readings labelled “numeric” when a native formatted display source is also available.

Connect the Mailbox to a Navigation Terminal and check the required readings; multiple readings can be selected. All waypoints reads the coordinates stored in the configured route even while stopped, or returns empty if no route is present. Current target coordinates are empty when there is no valid target. Follow, indefinite orbit and other states without a defined leg completion rate return no progress value.

Mailboxes can automatically read Music Players and Megaphones. Select readings individually: one keeps its original output, several produce JSON. Unselected readings are not sampled and do not request lyrics.

Megaphone: automatic reading

Music Player: automatic reading

{"Title":"Example Track","Artists":"Example Artist","Playing":true,"Progress":25}

Lyrics apply only to supported NetEase Cloud Music tracks. Selecting a lyric reading starts asynchronous retrieval and caching; unavailable or missing lyrics produce an empty value. Full lyrics exceeding the server channel-text allowance return “Lyrics exceed the channel length limit” instead of truncated lyrics.

Times are in seconds; progress is a percentage from 0 to 100. Elapsed time, remaining time and progress are estimated from the server countdown, not precise audio playback time.

Requires Create: Radar 5.0.0 or newer. Attach a Mailbox to the desired block and select fields under automatic reading. One selection preserves its content; multiple selections use the normal JSON wrapper. Monitors read their display cache; radars and network controllers read reported contacts, preserving jamming effects, false contacts and offsets.

Select Coordinate Array for direct use in a Bridge map or AFN Radar module. Map JSON returns a points object, suitable for those maps or Pager map messages. Select Detailed Contacts separately for IDs, positions, velocities and available category data; use a returned ID to select a remote target.

Show radar contacts on a map

Only selected fields are sampled, with snapshots shared per device. Contact snapshots refresh at most once per 5 ticks without rescanning the world or forcing structures to load. Oversized data is reduced by whole contacts: Map JSON and Detailed Contacts include total_count, returned_count and truncated. Standalone Returned Point Count and Points Truncated describe the Coordinate Array format.

Connect the Mailbox to one of these vanilla blocks to read its data: