RackWorks

## RackWorks 3.0.0

⚠️ Some gear has moved out of RackWorks ahead of an upcoming add-on. Back up your worlds before updating.

**New: Add-on API**
- Other mods can now add their own gear that works exactly like RackWorks' gear: the same cables, power, screens and Rig check.
- Add-ons can hook into the signal network, power outlets, powered blocks, the Rig check and how gear is drawn.
- Add-ons can test their gear with RackWorks' own game-test kit.
- There's a guide for add-on makers in the repo (`docs/ADDONS.md`).

**Improvements**
- Gear that keeps lots of saved values now loads faster.

**Under the hood**
- Saved settings are now looked up by name, which makes saves sturdier across updates.

Everything new since 2.15.0.

### New gear
**Speakers & rigging**
- **Rigging Wrench**: move, turn and tilt speakers, poles and line-array parts with live sliders. Set the splay of hanging line-array elements; the Arc compact and ultra pairs get separate top and bottom splay.
- **Arc line arrays** in four sizes, each with its own flying frame, plus two flown subs. **Active (self-powered) versions** of all six, with powerCON and XLR in and link.
- **Active point-source tops and subs**: compact, 12", 15", dual 15", single and dual 18".
- **Coaxial cabinets** (8"-15"), **low-profile coaxial wedges** (10"-15"), **single and dual 21" subs**, a **folded-horn 18" sub**, a **lip-fill**, a **column speaker** and a **wall-mount install speaker**.
- **Speaker Wall Bracket**: hang a speaker on a wall, then aim it with the wrench.
- **Studio monitors**: 5" and 8" near-fields and a three-way mid-field.
- **DJ booth**: active 10" and 12" booth monitors, and an active dual-18" booth sub that the monitors sit on.

**Consoles & studio**
- **Studio Recording Console** (24 channels), **Digital Rack Mixer** (3U, 16 channels), **DJ Mixer** (four stereo channels on RCA), **Mic Preamp** (1U) and **XLR Patchbay** (2U).
- **Linked digital desks**: desks with the same DESK LINK number share their mix.
- **Analogue desks**: channel EQ, inserts, aux sends and an OUT page for monitor mixes.
- Every output has its own fader and mute. Output patching now lives on **ROUTING > OUTPUT** (the console's own outputs and stage-box outputs).
- **1U Output Stage Box**. Stage boxes have an **OWNER** setting to pick which desk drives them.

**Music & DJ**
- **Media Player** (2U): plays your own .mp3, .ogg and .wav files from a `rackworks_music` folder. Tagged MP3s work.
- **DJ Player**, **Club Multi Player** (big touch screen and hot-cue pads), **DJ Controller** and **USB Audio Interface**.
- **RCA Cable**: a bonded pair that plugs and unplugs both leads together.

**Drums**
- **Electronic Drum Kit**: play it with clicks, or from a MIDI drum kit on your computer.

**Multicore & stage boxes**
- The **Multicore Drum** and **Stage Snake Box** now carry 12 inputs and 4 returns. New **Multicore Fan-Out** (2U) and **Multicore Cable** (50 m).
- **Stage Box Snake**: a 12-in / 4-return floor box that can be linked or used as the end of a snake.

**Power**
- **Trailer Generator 100 kVA** with a **Powerlock Feeder Cable**, and a **Portable Generator 3 kVA**.
- Generators **burn fuel** in survival (any furnace fuel).
- **Mains Supply (Creative)**: an endless supply that can be disguised as any block.
- **6-way powerCON Power Strip**.
- Active speakers draw far less mains and daisy-chain on powerCON.

**Building installation**
- **Wall trunking** and **ceiling cable trays** that carry cables inside them.
- **XLR, speakON and etherCON wall plates** and **floor boxes**, tie-lined through the walls.
- **Wall power outlets** on building circuits.

**Wireless**
- Frequency management for wireless mic receivers, in-ear transmitters and intercom bases: a screen, SCAN, automatic free frequencies, and clashes and intermod you can see.

### Learning
- **Tutorial course**: small rigs from easy to hard, a **RackWorks Tutorial** world type, and `/rackworks tutorial` commands.
- **Patch Sheet**:
  - Plan a rig on a **floor plan** and a **signal-flow diagram**.
  - **SET HERE** shows it in the world as outlines with the cables still to lay, and **COPY THE RIG HERE** draws up a rig already built.
  - **BUILD IT** builds the plan in creative.
  - **RIG CHECK** says what's stopping a rig from working.
- **Production Guide** item: read the setup guide in game.

### Sound
- Bigger cabinets and subs reach further, and the throw follows the level.
- Subs are heavier and reach further (`subBassDb` in the config).
- Speakers sound cleaner as you move.
- **Hear yourself through the PA**: F9 cycles OFF / DIRECT / PA.
- Any mic or output device works in any format, and you can pick the interface input your mic is on. Linux inputs are recognised, and device lists pick up newly plugged devices.
- PC Input music no longer cuts in and out.
- An on-screen line explains why you can't hear live speakers near you.

### Cables
- Cables stay plugged in when a Concert Stage Craft hoist lifts gear, and hoisted arrays keep their curve.
- Very long runs draw in full, and cable ramps carry a cable down the whole row.
- A laid cable can be dyed from either end.
- speakON linking goes from LINK out to IN, and a speaker's two speakON sockets are wired in parallel.

### Performance
- A big show's networks cost a fraction of what they did (about 50 ms down to about 1 ms per tick), and an idle rig isn't re-solved.
- The creative menu is much faster.
- Gear that keeps lots of saved values loads faster.

### For mod makers
- **Add-on API**: other mods can add gear that works just like RackWorks' own, with the same cables, power, screens and Rig check, and can hook into the networks and the game-test kit (`docs/ADDONS.md`).

### Other
- The creative tab is grouped by type.
- DJ units slide together in a row, and the whole DJ model is clickable.
- Handheld mics are held upright and at a sensible size.
- A short screen on first join shows the voice keys.
- The Mods list has a logo and links.
- Textures fit the block atlas on all graphics cards.
- Tested with Embeddium, Oculus and on dedicated servers.
- Optional PAcraft compatibility.
- Modpacks are allowed (see LICENSE).
- The client and server must run the same RackWorks version.