# \ud83d\udd0c Per-chunk redstone speed-up.<\/p>\n
> **Mark a chunk \u2192 it ticks 2-14\u00d7 faster. Leave the rest vanilla.**<\/p>\n
Server admins know the dilemma: globally enable Alternate Current and 1% of your machines break, OR keep vanilla everywhere and watch big redstone choke the server. **RedstoneRegions ends the dilemma.**<\/p>\n
Per-chunk choice. Four engines. Hot-swap. Folia-thread-safe.<\/p>\n
“`
\n\/redstone-region set alternate-current \u2190 this chunk only
\n\/redstone-region fill 8 alternate-current \u2190 17\u00d717 chunks around you
\n\/redstone-region selection eigencraft \u2190 your WorldEdit selection
\n\/redstone-region undo \u2190 oh wait, no
\n“`<\/p>\n
—<\/p>\n
## \u26a1 The four engines<\/p>\n
| Mode | Speed | Edge cases | Use for |
\n|—|—|—|—|
\n| **vanilla** | 1\u00d7 (baseline) | none | default; everything works |
\n| **alternate-current** | **2-14\u00d7 faster** | piston BUDs, observer-on-wire | dust-heavy mega-bases, sorters, salles des coffres |
\n| **eigencraft** | 3-5\u00d7 faster | very few | hot piston\/observer machines |
\n| **disabled** | n\/a (frozen) | wire never updates | archive zones, dead builds |<\/p>\n
## \ud83d\udcca Performance \u2014 32\u00d732 dust grid<\/p>\n
| Run | Vanilla | AC | Speedup |
\n|—|—|—|—|
\n| Cold | 234 ms | 22 ms | **10.6\u00d7** |
\n| Warm JIT | 41 ms | 14 ms | **2.9\u00d7** |
\n| Pre-warmed | 71 ms | 5 ms | **14.2\u00d7** |<\/p>\n
At **64\u00d764** chunks of dust, vanilla overshoots one tick by **6\u00d7**. AC keeps it under 2.<\/p>\n
Every wire update goes through a per-chunk dispatcher with **~50 ns** total overhead (`StampedLock` optimistic read + a switch). Tunable via `timing.mode: sample` for huge grids \u2014 drops to **~5 ns** at sample-rate 10. Or `off` for **0 ns**.<\/p>\n
## \ud83d\udee0 Features<\/p>\n
– \ud83c\udfaf **Per-chunk control** \u2014 `\/redstone-region set ac` only where you need it ## \ud83d\ude80 Quick install<\/p>\n 1. Drop `redstoneregions.jar` in `plugins\/` ## \u2705 Requirements<\/p>\n - **Folia 1.21.11** (build #6+) \u2014 Luminol and other Folia forks tested working ## \ud83e\uddea Validated<\/p>\n 14\/14 in-server harness cases green:<\/p>\n - byte-for-byte parity with vanilla on 8 contraptions over 60+ ticks each (dust line, 16\u00d716 grid, 4-tick repeater clock, AND gate, comparator-subtract, torch ladder, torch inverter, dust zigzag) ## \ud83c\udf93 How it works (TL;DR)<\/p>\n Mojang exposed a `RedstoneWireBlock.evaluator` field in 1.21.2. We swap it at boot with a `DispatchingEvaluator` that consults a per-chunk flag (PDC-stored) and routes each wire update to the right engine. The Alternate Current implementation is a port of Space Walker's algorithm with **per-thread WireHandlers** to avoid the latent race in Paper's bundled-AC under Folia.<\/p>\n Full architecture: docs\/ARCHITECTURE.md.<\/p>\n ## \u26a0\ufe0f Honest about edge cases<\/p>\n Two contraption patterns differ from vanilla under AC and may break:<\/p>\n 1. **Piston BUDs** that rely on the wire's self-shape-update at intermediate power levels Run `\/redstone-region check` first \u2192 it warns about risky patterns. Or just keep that chunk vanilla. **Eigencraft mode** has neither edge case while still being 3-5\u00d7 faster \u2014 use it for piston\/observer machines.<\/p>\n ## \ud83c\udf10 Links<\/p>\n - \ud83d\udc19 GitHub (mirror) ## \ud83d\udcdc License<\/p>\n MIT. Bundled Alternate Current engine: MIT (Space Walker \u2014 see plugin's `ac\/LICENSE`).<\/p>\n ---<\/p>\n *If you've ever typed `redstone-implementation: alternate-current` in `paper-world.yml` and held your breath, this plugin is for you.*<\/p>\n","protected":false},"excerpt":{"rendered":" Per-chunk redstone speed-up on Folia (2-14\u00d7 faster). Pick vanilla \/ Alternate Current \/ Eigencraft \/ Disabled per chunk. \/undo, sign opt-in, BlueMap, WorldEdit, PAPI, en+fr.<\/p>\n","protected":false},"featured_media":131024,"template":"","meta":{"_minecraft_slug":"redstoneregions","_minecraft_project_id":"3nrWCEFD","_minecraft_author":"modmass","_minecraft_license":"MIT","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"redstoneregions.zip","_minecraft_size_bytes":612394,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T23:16:38.299041Z","_minecraft_date_created":"2026-05-07T22:37:04.599857Z","_minecraft_date_modified":"2026-05-02T10:47:57.653971Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/redstoneregions","_minecraft_icon_attachment_id":131024,"_minecraft_imported_at":"2026-06-07T17:21:43+00:00","_minecraft_import_hash":"21e8bfd2f44aaf808e89ffc2f391ebc7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,90,127,128,92],"mod_loader":[131,132,133],"minecraft_version":[41,163],"class_list":["post-131023","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-11","minecraft_version-26-1-2"],"yoast_head":"\n
\n– \ud83d\udcbe **Persistent** \u2014 survives restarts, lives in chunk PDC
\n– \ud83e\uddf5 **Folia-thread-safe** \u2014 per-region WireHandlers, validated by 14\/14 cross-region stress tests
\n– \ud83d\uddfa\ufe0f **BlueMap overlay** \u2014 colored chunk rectangles, see your perf zones at a glance
\n– \u270f\ufe0f **WorldEdit selection** \u2014 `\/redstone-region selection ac` from your `\/\/pos1 \/\/pos2`
\n– \ud83e\udea7 **Sign opt-in** \u2014 players can place `[ac]` signs to flip their own chunks (perm-gated, radius-capped)
\n– \ud83e\udd16 **Auto-AC scanner** \u2014 hot vanilla chunks auto-flip, threshold configurable
\n– \ud83d\udcca **Live profiler** \u2014 `\/redstone-region profile` gives a 50ms-tick-budget readout per chunk
\n– \ud83d\udd0d **`\/redstone-region why x y z`** \u2014 explains a wire’s current power by enumerating its 6 neighbors’ contributions
\n– \u21b6 **`\/redstone-region undo`** \u2014 reverses the last batch (set \/ fill \/ selection \/ sign \/ auto-AC)
\n– \ud83c\udf0d **i18n** \u2014 English + French built-in, drop your own `lang\/.yml`
\n- \ud83d\udcdd **Audit log** \u2014 JSONL, daily-rolled, every flip with actor + UUID + reason
\n- \ud83d\udd14 **Discord webhook** \u2014 async notifications on flip, filterable
\n- \ud83d\udcc8 **PlaceholderAPI** \u2014 `%redstone-region_mode%`, count placeholders per mode
\n- \u26a1 **Click-to-tp** chunk coords in chat
\n- \ud83d\udd27 **Hot reload** \u2014 `\/redstone-region reload` for config + lang, no restart<\/p>\n
\n2. Restart server
\n3. Stand in a chunk, type `\/redstone-region set alternate-current`. Done.<\/p>\n
\n- **Java 21+**
\n- Optional: BlueMap 5.16+, PlaceholderAPI 2.11.7+, WorldEdit 7.3.19+ (Folia-patched preferred)<\/p>\n
\n- 596 toggles in 30s stress, **0 exceptions**
\n- 780 + 780 toggles in **two different Folia regions in parallel**, **0 races**, **0 thread-check failures**
\n- 655 AC dispatches verified by counter<\/p>\n
\n2. **Observers** that count power-level transitions on a wire<\/p>\n
\n- \ud83e\udd8a Forgejo (canonical)
\n- \ud83d\udcda Docs
\n- \ud83d\udcca bStats
\n- \ud83d\udc1b Issues<\/p>\n