Cosmonautics: Warp Drive

# 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](https://www.curseforge.com/minecraft/mc-mods/create) - [Create Cosmonautics](https://cosmonauticsteam.github.io/) — provides the Moon dimension, Titanium items, and the Dimensional Sable support this mod's cross-dimension warp relies on - [Sable](https://modrinth.com/mod/sable) - [Dimensional Sable](https://modrinth.com/mod/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 | Option | Default | Description | | ----------------------- | --------- | ---------------------------------------------------------------------- | | `warpCostFE` | 2,000,000 | FE consumed per Warp Drive activation | | `warpChargeTicks` | 60 (3s) | Delay between pressing Warp and the actual jump | | `warpParticleCount` | 32 | Particles spawned around the ship while charging | | `warpDriveDisplayMode` | FE | What the console screen shows: FE, COUNTDOWN, COORDINATES, or POINT_NAME | | `memoryCardCapacity` | 5 | How many saved locations a Memory Card can hold (1–10) | ## 🤖 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](https://github.com/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](https://github.com/waco0311/cosmowarp)~~~~ If you have an suggestion/bug for the mod, you can let me know on the cosmonautics [Discord server](https://discord.com/invite/FTuSNWsyAj) and ping .waco__ in the dedicated channel!