Table of Contents

LanteaCraft

LanteaCraft is a modern NeoForge rewrite of the classic Stargate-themed Minecraft mod. The current 0.1.x build targets Minecraft 1.21.1 and focuses on getting the core Stargate loop working again: build an assembled gate, discover its address, dial another gate, and travel through the event horizon.

This is still an early rewrite. The mod is playable enough to test the main systems, but several features are prototype-quality and the final balance, progression, visuals, and compatibility surface are still in progress.

Current Status

Implemented in the current source tree:

Not currently implemented or not considered complete:

Requirements

Building From Source

From the project root:

./gradlew build

On Windows:

gradlew.bat build

The built mod jar is written to:

build/libs/

Common development runs:

./gradlew runClient
./gradlew runServer
./gradlew runData

Stargates

A Stargate is a vertical 7×7 frame centered on a Stargate Base block at the bottom middle. All frame blocks must be from the same variant set. Mixed Milky Way/Nox/Wraith/Pegasus frames do not assemble.

Required blocks:

Frame layout:

Y=6   R C R C R C R
Y=5   R           R
Y=4   C           C
Y=3   R           R
Y=2   R           R
Y=1   C           C
Y=0   R C R B R C R

Legend:

When autoAssembleStargates is enabled, a complete frame assembles automatically after the final valid block is placed.

Stargate Interaction

With an empty hand:

With a block item:

Breaking an assembled Stargate block attempts to disassemble and unregister that gate from the saved network.

Addresses

Gate addresses are seven glyphs long.

The current address format is:

6 location glyphs + 1 dimension glyph

The glyph alphabet is:

ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890-+

Reserved dimension glyphs:

Other dimensions are assigned available glyphs and persisted in the Stargate network saved data.

Dial Home Devices

Place a DHD near an assembled Stargate and right-click it to open the dialing screen.

Current DHD behavior:

Dialing rules in the current implementation:

Stargate Travel

When a wormhole is open, entities entering the outgoing event horizon are teleported to the destination gate. Travel preserves relative position and attempts to transform facing/velocity to match the destination gate orientation.

The current handler affects non-passenger entities. Players, mobs, and other entities may be moved if they can be teleported by Minecraft's normal entity/dimension rules.

By default:

Transport Rings

Transport Rings are a separate prototype transport system.

Current behavior:

Current limitations:

Materials And Worldgen

LanteaCraft currently adds:

Naquadah and trinium ore generation is provided through worldgen JSON and a NeoForge biome modifier.

Recipes

The source includes vanilla crafting recipes for most current craftable items and blocks. Zero Point Modules intentionally do not have a default recipe; pack makers can add one with a datapack if they want craftable ZPMs.

Materials

Naquadah Ingot, shapeless:

Iron Ingot + Naquadah -> Naquadah Ingot

Trinium Ingot, shapeless:

Iron Ingot + Trinium -> Trinium Ingot

Naquadah Block:

NNN
NNN
NNN

N = Naquadah Ingot

The block can be crafted back into 9 Naquadah Ingots.

Trinium Block:

TTT
TTT
TTT

T = Trinium Ingot

The block can be crafted back into 9 Trinium Ingots.

Crystals

Blank Crystal:

GGG
GDG
GGG

Control Crystal:

RRR
RBR
RRR

Core Crystal:

LLL
LBL
LLL

Stargate Parts

Stargate Ring Segment:

ISI
NNN
III

Stargate Chevron:

SGS
NPN
IRI

Stargate Base:

SRS
NEN
ICI

Dial Home Device

DHD:

SRS
NCN
III

Variant Conversions

Variant Stargate parts and DHDs are shapeless dye conversions from the Milky Way versions:

Milky Way part + Green Dye  -> Nox part
Milky Way part + Blue Dye   -> Pegasus part
Milky Way part + Purple Dye -> Wraith part

This applies to:

Transport Ring

Transport Ring:

TGT
NCN
TET

Configuration

The common config currently exposes:

Option Default Description
debugLogging false Enables extra startup and system logging.
allowIncomingWormholeTravel false Allows entities to travel back through the incoming side of a wormhole.
kawooshDeath true Makes the opening kawoosh kill entities caught in front of an active gate.
autoAssembleStargates true Automatically assembles complete Stargate multiblocks.
gateTimeoutSeconds 60 How long an open wormhole remains active. Set to 0 to disable automatic timeout.
dhdSearchRadius 8 Maximum block radius a DHD searches for a nearby assembled Stargate.
gateTeleportCooldownTicks 40 Cooldown before the same entity can trigger Stargate travel again.
enableOreRetrogen false Generates LanteaCraft ores in already-existing chunks as they load.
oreRetrogenChunksPerTick 1 Maximum old chunks processed for ore retrogen per dimension tick.

Optional FE Power

Stargate bases can accept FE into an internal buffer when power.enableFePower=true. Classic gate behavior remains available by default: power.requirePowerToDial=false and power.requirePowerToMaintainWormhole=false mean dialing and active wormholes do not require FE unless a pack enables those rules.

Powered dialing charges the origin gate by default. Active wormholes can draw sustain power from ORIGIN_ONLY, DESTINATION_ONLY, BOTH_SIDES, PREFER_ORIGIN, or PREFER_DESTINATION, and can use configurable same-dimension distance scaling and cross-dimension multipliers. Ordinary cross-dimension dials such as Nether, End, and Abydos are intentionally modest by default. Atlantis has a separate long-range dial cost so a single Energy Crystal is not enough by default. Generated ancient gates provide a configurable per-operation ancient power allowance instead of infinite FE; ordinary cross-dimension dials fit inside that allowance, but very expensive dials need supplemental player-provided power. Energy irises consume FE while closed when enabled and can fail open if unpowered.

The Naquadah Generator is LanteaCraft's native FE source. It uses the legacy 1.7.10 generator model, burns Naquadah fuel, stores FE internally, and outputs to adjacent FE handlers.

Energy Crystals hold 1,000,000 FE by default. Zero Point Modules hold 1,000,000,000 FE and can be installed in a ZPM Hub, which exposes that stored power to nearby linked Stargates and adjacent FE consumers. Zero Point Modules intentionally have no default crafting recipe. A default Atlantis dial requires an instantaneous 75,000,000 FE burst from linked ZPM infrastructure, then consumes 50,000 FE/t from linked ZPM infrastructure while the wormhole remains open. It still requires an installed Eighth Chevron Crystal for extended-address dialing.

ZPM loot uses the custom lanteacraft:set_zpm_energy loot function, which accepts any vanilla number provider under energy. The built-in chest injections make ZPMs very rare and heavily weighted toward low remaining charge. Datapacks can use the same function, for example:

{
  "function": "lanteacraft:set_zpm_energy",
  "energy": {
    "type": "minecraft:uniform",
    "min": 5000000,
    "max": 25000000
  }
}

CC:Tweaked / ComputerCraft Support

If CC:Tweaked is present, assembled Stargate blocks expose a stargate peripheral.

Current Lua-facing functions include:

Attached computers receive stargate_event events for gate activity such as dialing, opening, closing, timeout, disconnects, and entity transit/local gate interactions.

Active Stargate wormholes also act as CC:Tweaked wireless repeaters. A wireless modem within range of one connected gate can transmit a modem_message through the wormhole; the packet is re-broadcast as a fresh wireless hop from the remote gate, allowing interdimensional links or long-distance same-dimension links between computers near each gate.

ComputerCraft support is optional. LanteaCraft compiles against the CC:Tweaked API and declares the mod dependency as optional.

Known Prototype Areas

The following areas are expected to change: