GlymeraMaglev

GlymeraMaglev

A magnetic levitation line built from blocks. Lay Maglev Track across your world, put a Maglev Station wherever a ride should start or stop, press use on a station and pick where to go. You float a hand's width above the track and glide there - around corners, up and down ramps, through other stations - as one smooth physical ride. No teleporting, no mount, no cart.

---

What it does

GlymeraMaglev turns a line of blocks into a transit line. Lay Maglev Track pieces on the ground: corners are fine, the next piece may also sit one block higher or lower, and the piece in front of such a step turns into a sloped Maglev Ramp by itself. Put a Maglev Station (the orange pad) wherever rides should start and stop. Press use (F) on a station:

• One other station on the line: you ride there right away.
• Several: a menu lists every station you can reach over the track, nearest first, and you ride to the one you pick - over the shortest route, straight through crossings and other stations.

The ride is physical: the station pulls you onto the track, you float a little above it and travel at 15 blocks per second (slower on ramps), brake before the station and stop on its pad. Your own movement keys are paused while you ride so you stay centred; they come back the moment you arrive. Several players can ride the same line at the same time without getting in each other's way.

Any length. The plugin keeps its own map of every track piece, so a station 5000 blocks away shows up in the menu at once, even if that part of the world is not loaded. The world loads under you as you travel, like it does when you fly.

Features

• Three blocks - Maglev Track for the line, Maglev Station for the stops; the Ramp appears by itself in front of a one-block step
• Station menu - up to 20 stations per menu, nearest first, each button shows the station's name (or its distance and compass direction until it has one)
• Named stations - the builder (or an OP) names a station in the menu or with /gmaglev name <name> while standing on it
• Shortest route - the ride follows the shortest way over the whole network, through crossings and intermediate stations
• Lines of any length - the menu needs no loaded chunks; tested with a 5000 x 5000 block cross and 10,000 pieces
• Owner protection - a piece can only be broken by the player who placed it or by an OP; nobody can hook their line into yours unless you allow it
• Smooth, physical transport - velocity-driven, no teleport, no mount; you stay standing
• Idle cost zero - track pieces are plain blocks, nothing ticks; a ride costs two block reads every 50 ms

How to build a line

1. Lay Maglev Track from one place to the next. Turn corners whenever you like. To go up or down, continue one block higher or lower: the piece before the step becomes a ramp pointing up to the higher piece.
2. Put a Maglev Station at every stop, as a piece of the line (at an end or in the middle of it). Stations are the entrances: pressing use on a plain piece does nothing.
3. Stand on a station, press use (F), pick a station, enjoy the ride. /gmaglev stop ends a ride early.

Rules of thumb: pieces connect to their four horizontal neighbours, same height or one block up or down; a ride never goes backwards; where a line forks without a chosen destination it goes straight on.

Recipes

At the Workbench: 2 iron bars make 8 Maglev Track, 3 iron bars make 1 Maglev Station. Both are in the creative tab under decoration blocks.

For Server Owners

mods/Glymera_GlymeraMaglev/config.json is written on the first start; every key has a _key line above it that explains it. OPs can change any value in-game with /gmaglev set <key> <value> (saved, applies to the next ride).

Key	Default	Meaning
speed	15	Cruise speed in blocks per second
accel / decel	8	How fast a ride speeds up and brakes, blocks per second squared
rampSpeed	5	Speed limit while the track goes up or down
hover	0.3	How high above the track the rider floats
lookahead	1.5	How far ahead the rider steers; larger = wider corners
hoverGain / hoverBias	4 / 0.5	Height regulation; raise hoverBias if riders sink, lower it if they drift up
latency	0.1	Network delay the steering compensates; too high = corners cut, too low = corners overshoot
enterSpeed	3	Speed with which a station pulls a rider onto the track
stuckSeconds	2	A ride that makes no progress for this long ends
maxRideSeconds	600	Emergency brake for runaway rides
protectBreaking	true	Only the builder of a piece (and OPs) may break it
everyoneMayRide	true	false = only the builder of the station you press (and OPs) may ride from it
allowConnectingToOthers	false	true = anyone may connect their track to anyone's
rampRotationOffset	0	Calibration 0-3, only if ramps ever point the wrong way
testCommands	false	Enables /gmaglev test for headless checks and test tracks (OP/console only) - leave it off

Data lives next to the config: owners.json (every piece and who placed it) and stations.json (every station and its name). Both are written in one piece a second after the last change. No database, no dependencies, server-side only: players need nothing but the server's asset pack.

Installation

1. Put the latest GlymeraMaglev-<version>.jar in your server's mods/ folder.
2. Start the server. The blocks are craftable at the Workbench and in the creative tab.