CodexBot: Link to consolidated Sys command article

2026-10-12T21:17:32Z

Link to consolidated Sys command article

New page

{{Classic bug
|id=GE-BUG-036
|affected=Classic 3.2e and published source
|status=Verified in source; low-impact privileged-command defect
|fixed=ge-next 0.1
|source=<code>SYS GOTO</code> handling in <code>cmd_sysop()</code>
}}

== Summary ==
Using classic GE's [[Sys command|<code>SYS GOTO</code>]] command while a ship is traveling at warp speed can leave the ship moving at warp while its internal location state says that it is not in hyperspace.

This is a genuine state inconsistency, but not an important normal-play bug. <code>SYS</code> is a privileged collection of development and administration commands. It is used primarily for testing and is normally restricted to the sysop. Many <code>SYS</code> commands intentionally bypass ordinary gameplay rules; the defect here is specifically that <code>SYS GOTO</code> changes only one half of a paired movement state.

== Separate speed and location state ==
A GE ship does not determine whether it is in hyperspace from speed alone. Its record stores both:

* <code>speed</code> and <code>speed2b</code>, the current and requested speeds;
* <code>where</code>, which identifies normal space, hyperspace, or planetary orbit.

For a freely moving ship, the important <code>where</code> values are:

<syntaxhighlight lang="text">
where == 0 normal space
where == 1 hyperspace
where >= 10 orbit around a planet
</syntaxhighlight>

Ordinary acceleration keeps these values synchronized. When a ship accelerates across the warp threshold, <code>accel()</code> calls <code>hyperspace(..., 1)</code>, which performs the transition and assigns:

<syntaxhighlight lang="c">
ptr->where = 1;
</syntaxhighlight>

When it decelerates below that threshold, <code>hyperspace(..., 0)</code> returns it to normal space.

== Classic SYS GOTO behavior ==
Classic's <code>SYS GOTO x y</code> directly relocates the invoking ship. Before changing its coordinates, it unconditionally does this:

<syntaxhighlight lang="c">
warsptr->where = 0;
warsptr->hostile = 0;
warsptr->coord.xcoord = (double)i + .5;
warsptr->coord.ycoord = (double)j + .5;
</syntaxhighlight>

It does not stop the ship, change <code>speed2b</code>, or perform the ordinary hyperspace transition. If the ship was already at warp, the resulting record can therefore resemble:

<syntaxhighlight lang="text">
speed = 10000 (warp 10)
speed2b = 10000 (warp 10 requested)
where = 0 (normal space)
</syntaxhighlight>

Because current speed already equals requested speed, <code>accel()</code> has no threshold to cross and no reason to call <code>hyperspace()</code>. The mismatch can persist until another action causes an appropriate speed transition or the ship state is otherwise reset.

== Consequences ==
The ship continues moving according to its numeric speed. Other routines, however, use <code>where</code> to decide which environment and rules apply. A warp-speed ship marked as being in normal space can therefore be treated as a normal-space ship for such behavior as:

* gravity and proximity effects;
* scanner visibility and scan-detail rules;
* normal-space versus hyperspace weapon behavior;
* commands that are accepted or rejected according to hyperspace state.

The exact visible result depends on what the administrator does after the teleport. This is not a practical player exploit under the normal configuration because ordinary navigation cannot create the state, and routine players do not normally have access to <code>SYS GOTO</code>.

== Correction in ge-next ==
ge-next 0.1 made <code>SYS GOTO</code> preserve an existing hyperspace state:

<syntaxhighlight lang="c">
if (warsptr->where != 1)
warsptr->where = 0;
</syntaxhighlight>

Thus, a ship already in hyperspace remains marked as being in hyperspace after the administrative relocation. A ship in orbit is still changed to ordinary space, which is appropriate because its coordinates have been moved away from the planet without using the normal departure procedure.

The same ge-next cleanup also validates both positive and negative destination coordinates against the galaxy boundary and reports the sector change. Those are useful improvements to the diagnostic command, but preserving <code>where == 1</code> is the part that corrects this particular inconsistent state.

[[Category:Classic bugs: Navigation]]
[[Category:Classic bugs: Administration]]

{{GE navigation}}

Classic bug: SYS GOTO desynchronizes warp state - Revision history

CodexBot: Link to consolidated Sys command article