Neoriris Cloudflared 1.12.2 Modpack
====================================

Purpose
-------

This is an importable Prism Launcher/MultiMC instance for connecting to the recovered Neoriris Forge 1.12.2 server through Cloudflare Tunnel.

Server Entry
------------

- Multiplayer name: Neoriris Cloudflare Tunnel
- Saved address: cloudflared://minecraft.system42.one
- Do not type minecraft.system42.one directly unless you are intentionally testing raw TCP.
- Launcher auto-join is disabled because Minecraft appends port 25565 before the Cloudflared address transformer runs.

Quick Start
-----------

1. Import this zip into Prism Launcher or MultiMC as an existing instance.
2. Sign in through the launcher with your own Microsoft/Minecraft account.
3. Launch "Neoriris Cloudflared 1.12.2".
4. Open Multiplayer.
5. Select "Neoriris Cloudflare Tunnel".

Automatic Helper Scripts
------------------------

If you extracted this zip instead of importing it manually, run the matching script from inside this folder:

- Linux: `./install-and-launch-linux.sh`
- macOS: `./install-and-launch-macos.command`
- Windows: right-click `install-and-launch-windows.ps1` and choose Run with PowerShell, or double-click `install-and-launch-windows.bat`

The helper scripts copy this instance into the local Prism Launcher instance directory, download Prism Launcher from the official GitHub release API if no compatible launcher is found, and then start the launcher. You still sign in with your own Microsoft/Minecraft account.

Current Pack Highlights
-----------------------

- Minecraft 1.12.2 with Forge 14.23.5.2860.
- PortalGun 7.1.0 with iChunUtil and HammerLib.
- Neoriris Portal Door 0.1.8, a companion mod for wall-mounted entangled PortalGun door spawners.
- SolBridge 0.3.11, the Sol entity, Syzygy Console, SolScript, Dynamic Sol Discs, SolNet GPIO, archive/books, and safe command bridge.
- Neoriris-patched CloudFlare Helper for `cloudflared://` server addresses.
- ForgeEssentials client addon, LagGoggles, UniversalTweaks, VintageFix, MixinBooter, TickCentral, and ConfigAnytime.
- Saved configs, server list, title screen assets, and optional cross-platform installer-launcher helpers.

What Is Not Included
--------------------

- Microsoft/Minecraft accounts, access tokens, or session data.
- Mojang/Microsoft game jars, assets, or launcher caches.
- Worlds, logs, screenshots, or local machine paths.
- David's local workstation cloudflared binary.

SolBridge Basics
----------------

SolBridge adds Sol, a dark floating orb familiar and safe bridge between Minecraft and the local Sol runtime. The mod is intentionally command- and permission-gated: risky actions are disabled or operator-restricted by default.

Useful commands:

- `/sol help`
- `/sol summon`
- `/sol follow`
- `/sol stay`
- `/sol status`
- `/sol say <message>`
- `/sol weather clear [seconds]`
- `/sol time status`
- `/sol mode creative`
- `/solbridge help`

Plain `/weather`, `/time`, and `/gamemode` are also restored by SolBridge in this pack because ForgeEssentials replaces the vanilla aliases during startup.

Syzygy Console
--------------

The Syzygy Console is a craftable block that acts as a jukebox, Sol terminal, redstone computer, celestial visualizer, and SolNet node.

Basic use:

- Right-click with a vanilla music disc or Dynamic Sol Disc to insert and play it.
- Empty-hand right-click opens the terminal GUI.
- Sneak-right-click ejects the disc.
- Adjacent jukeboxes can be read as external audio/redstone sources.
- Adjacent note blocks can be read or activated depending on GPIO mode.
- Nearby note blocks inside the observation radius can beat the sun/moon without needing to be directly adjacent.

Default redstone outputs while playing a disc or reading an external jukebox:

- North: amplitude
- South: beat pulse
- East: bass
- West: treble
- Top: visible celestial authority
- Bottom: terminal/program state

Note-only visualizer pulses are high-impedance by default so observing a note block does not accidentally hold nearby redstone powered.

GPIO and SolNet
---------------

Each Syzygy Console face can be:

- `auto`: normal audiovisual output plus input scan
- `read`: input-only; suppresses console output on that face
- `write`: output-only; suppresses input capture and lets the console drive redstone or activate attached note blocks

Every loaded Syzygy Console automatically registers as a SolNet node and reports connected face devices such as note blocks, jukeboxes, redstone dust, levers, buttons, lamps, pistons, and adjacent mod blocks.

Example terminal commands:

- `gpio status`
- `gpio mode east write`
- `gpio set north 15`
- `gpio set north auto`
- `gpio pulse south 15 2`
- `note read`
- `note play east 8 4`
- `net status`
- `net pulse east 15 4`

SolScript
---------

SolScript is the small in-game pseudo-language used by the Syzygy Console, books, Dynamic Sol Disc NBT, Sol entity commands, and the SolNet.

Statements may be separated by newlines or semicolons.

Common examples:

- `on note then target sun 20`
- `on note then visualize note`
- `on audio then set north amp`
- `if beat > 10 then pulse south 15 2`
- `gpio mode all read`
- `note play east 8 4`
- `net pulse east 15 4`

When a note block is attached or observed, the console auto-fills an editable default program:

`solscript; on note then target sun 20; on note then visualize note`

That means tapping the note block beats the sun by default. In write mode, `note play` activates the attached note block without retuning it. Retuning is only done by the explicit `note tune` command.

Portal Door Basics
------------------

Neoriris Portal Door adds wall-mounted Door A and Door B portal spawners. Matching entangled pair items share a hidden PairId, so lore labels are not the identity.

Behavior:

- Door A and Door B spawners create PortalGun endpoints on the wall cells below the controller.
- Each spawner observes/loads the surrounding portal area so active endpoints are less likely to disappear client-side.
- Powered pairs verify/refresh PortalGun tile state periodically.
- If a spawner item is removed or destroyed, the mod avoids leaving permanent ghost portal ownership behind.
- The spawners render like upside-down redstone torches with animated emissive tips.

Custom Discs
------------

SolBridge supports Dynamic Sol Discs generated from server-side custom audio imports. The server owns the catalog. Clients need matching local processed audio files for full custom-track playback unless a future sync mode is enabled. Visualizer metadata can still operate when provided by the server.

Cloudflared Note
----------------

The Cloudflared mod downloads the correct cloudflared executable for the player's operating system into `.minecraft/asm/Cloudflared` on first launch if it is missing. If the mod reports that cloudflared is missing, open any world or server long enough to access chat and run:

`/cloudflared install`

Troubleshooting
---------------

- If the server entry does not connect, confirm you selected the saved `cloudflared://` entry.
- If Cloudflared reports a missing executable, run `/cloudflared install` and restart the instance.
- If the first server-list ping is slow, wait a few seconds; Cloudflared may still be opening the local access tunnel.
- If a record or visualizer seems stale, stop/eject from the Syzygy Console and reconnect only if the client sound engine remains stuck.
- If a note block is observed but terminal `note play` makes no sound, set the relevant face to `auto` or `write`; `read` mode is intentionally input-only.
- If commands appear unknown, try the SolBridge forms: `/solweather`, `/soltime`, `/solmode`, or `/solbridge help`.

More Details
------------

- `MODS.txt` lists every included client mod and SHA256.
- `INSTALLER-README.txt` explains the optional helper scripts.
- Public docs and downloads live on the Neoriris Clock Tower recovery page.
