Mailbox writing and data sources reference
Mod version shipped with FlammiCraft: 1.13.0
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: