Cosmonautics: Warp Drive

Warp your Sable-physicalized ships and stations to any recorded location — in any dimension — using stored electrical power.

An addon for the Create + Cosmonautics ecosystem, built on Sable's physics/sub-level system.

✨ Features

• Warp Drive — insert a Warp Crystal (or Memory Card), register the drive's current location, pick a saved destination, and warp the entire physicalized structure it's attached to — including across dimensions. The console screen shows live info (FE, countdown, coordinates, or the selected point's name — configurable).
• Warp Crystal — the data core. Only a Warp Crystal can actually trigger a warp.
• Memory Card — a cheaper way to record locations without a trip to the Moon. Registers and stores points just like a Warp Crystal, but can't trigger a warp on its own — copy its points onto a Warp Crystal with a Crystal Driver first. Storage capacity is configurable.
• Crystal Driver — copy a saved location from one Warp Crystal or Memory Card onto another, or delete one you no longer need.
• Moon Crystal — a new resource found only in Cosmonautics' Moon dimension. Mine the ore, then refine it with Create's Sand Paper.
• Hyperspace jump effect — a short charge-up before each warp, with a screen-distortion effect (visible only to players actually riding the ship) and a converging particle effect (visible to everyone nearby).
• Fully configurable: FE cost per warp, charge-up time, particle count, console display mode, and Memory Card capacity.
• CC: Tweaked support — the Warp Drive works as a peripheral, so computers can read its status and drive it from Lua. Optional; the mod works fine without CC: Tweaked installed.

🚀 How to use it

1. Mine Moon Crystal Ore on the Moon (diamond pickaxe required) for Raw Moon Crystal.
2. Refine it into a Moon Crystal with Create's Sand Paper.
3. Craft a Warp Crystal — or a cheaper Memory Card if you don't want to make the trip yet — then a Warp Drive, and install the drive on a Sable-physicalized structure (e.g. a Create airship).
4. Insert the crystal/card and press Register Here to save that location.
5. Fly elsewhere, register another location on the same (or a different) crystal/card — rename entries from the Warp Drive's GUI to keep track of them.
6. Select a destination and press Warp. The drive spends FE, plays a short hyperspace sequence, and moves the whole structure there. (Using a Memory Card? Copy its points onto a Warp Crystal with a Crystal Driver first — Warp only works from a Warp Crystal.)

Use a Crystal Driver to duplicate a saved location across crystals/cards, or to delete one.

📦 Requirements

• NeoForge for 1.21.1
• Create
• Create Cosmonautics — provides the Moon dimension, Titanium items, and the Dimensional Sable support this mod's cross-dimension warp relies on
• Sable
• Dimensional Sable — usually already present via Create Cosmonautics' own bundled copy

This mod does not generate FE on its own — bring your own power source (Create generators, or any other FE-producing mod). Optional:

• CC: Tweaked — enables the Warp Drive's computer peripheral.

With CC: Tweaked installed, a Warp Drive can be used as a peripheral of type warp_drive — attach a computer directly or over a wired modem.

Available methods: getEnergy, getEnergyCapacity, getWarpCost, hasCrystal, getWarpPoints, getSelectedPoint, selectPoint, registerHere, renamePoint, warp, isCharging, getChargeSeconds.

warp() begins the charge-up rather than jumping instantly, exactly like pressing Warp in the GUI, and returns either true or false plus a reason string.

Two example programs are included in the GitHub repository: warp.lua prints the drive's status and warps to a chosen point, and warp_monitor.lua draws a touch-controlled interface on an Advanced Monitor. Both are starting points to edit rather than finished programs — the peripheral deliberately exposes data and controls only, so the interface is yours to design.

Full method reference is in the README on GitHub.

⚙️ Configuration

🤖 A note on development

Large parts of this mod's code were written with the help of AI (Claude). Design decisions, testing, and final calls are mine, but I wanted to be upfront about the tooling used.

🙏 Credits

• Sable & Sable Companion by ryanhcode — the physics/sub-level system this mod's warp mechanic is built on.
• Dimensional Sable by hollow_egg — cross-dimension sub-level support, used directly for the actual warp jump.
• Create Cosmonautics by the Cosmonautics Team.
• Create by the Create team.
• New Mod Icon
  Author: Devina_X
  Work: Create Cosmonautics Expansion

🐛 Known issues

• Block hitboxes for Warp Drive / Crystal Driver are still simplified placeholders.

Bug reports and feedback welcome — this is an early beta!

Source & issue tracker: GitHub~~~~

If you have an suggestion/bug for the mod, you can let me know on the cosmonautics Discord server and ping .waco__ in the dedicated channel!