Skip to content

Getting Started

sqersters edited this page Jun 30, 2026 · 1 revision

Getting Started

Getting Started is a guide to installing and playing Stellar Depths. As of version 0.2.2, the mod is creative-only — survival mechanics such as oxygen and radiation exist in the code, but no portal or rocket system has been implemented. Players reach the added dimensions through operator commands or the Space Navigation menu.

This page covers installation, reaching the dimensions, using the mod's items and blocks, and understanding the environmental mechanics.

Requirements

Requirement Version
Minecraft 1.21.1
Loader NeoForge 21.1.x
Java 21

The mod uses the NeoForge loader. It is not compatible with Fabric or Quilt.

Installation

  1. Install NeoForge 21.1.x for Minecraft 1.21.1.
  2. Place the Stellar Depths .jar file in the mods folder of your Minecraft installation.
  3. Launch the game with the NeoForge profile.

The mod adds a single creative mode tab titled "Stellar Depths" containing all items and blocks.

Reaching the dimensions

Stellar Depths adds two custom dimensions: Space and the Moon. There is no portal block in the current version. Two methods are available to travel there, both requiring operator permissions (permission level 2).

Space Navigation menu

Press the M key to open the Space Navigation menu. This menu displays the Solar System as a list of celestial bodies:

Body Accessible Gravity Notes
Sun No 28.0× Locked
Mercury No 0.38× Locked
Venus No 0.90× Locked
Earth Yes 1.0× (default) Returns to the Overworld
Moon Yes 0.166× Lunar dimension
Mars No 0.38× Locked

Selecting an accessible body teleports the player to that dimension. Selecting Earth while already in the Overworld does nothing.

/dtp command

The /dtp <dimension> command teleports the player to the specified dimension at the same X/Y/Z coordinates. This is useful for precise positioning. It requires operator permissions.

Example:

/dtp stellardepths:moon

/execute fallback

If the Space Navigation menu is unavailable, the vanilla /execute command can be used:

/execute in stellardepths:space run tp @s 0 100 0

Environmental mechanics

Oxygen

The oxygen system tracks a per-player oxygen level from 0 to 100. Oxygen depletes in non-breathable dimensions and regenerates in the Overworld.

Dimension Depletion rate Atmosphere
Space ~1.0/sec (0.05/tick) Vacuum
Moon ~0.3/sec (0.015/tick) Thin
Overworld Regenerates (+2/tick) Breathable

When oxygen reaches zero, progressive suffocation damage begins. Damage starts mild (0.5 hearts) and infrequent (every 6 seconds), then accelerates over approximately 50 seconds to severe (1.5 hearts) and frequent (every 1 second), mimicking real hypoxia.

Creative mode players are exempt from oxygen depletion and suffocation damage. Oxygen is kept at maximum at all times.

The LOX Bottle can be right-clicked to refill oxygen by 40. It consumes the bottle and returns an Empty Bottle.

Gravity

Each celestial body applies a gravity multiplier to the player via the NeoForge gravity attribute. The Moon's gravity is 0.166× that of Earth, meaning jumps are higher and falls are slower. Fall damage is scaled by the same multiplier, so low-gravity jumps do not cause damage even when they exceed the vanilla 3-block threshold. Only genuine long drops deal damage on the Moon.

Earth and other dimensions without a gravity override use the vanilla gravity value (0.08).

Radiation

Ambient radiation drifts on its own in space and on the Moon. It is a random walk bounded by per-dimension baselines:

Dimension Range Baseline
Space 0.60 – 1.00 0.85
Moon 0.10 – 0.20 0.15
Overworld None 0

Radiation produces a subtle screen effect: film grain, scanlines, and a faint green hum at the edges of the field of view. The intensity responds to the radiation level. Radiation deals no damage in the current version.

Items

All items are available in the Stellar Depths creative tab.

Empty Bottle

A basic container. Stacks to 16. Used as a crafting ingredient and as the return item when LOX Bottles or Liquid Hydrogen are consumed.

LOX Bottle

A bottle of liquid oxygen. Right-click to refill the player's oxygen by 40. The bottle is consumed and an Empty Bottle is returned to the inventory. Stacks to 16.

Crafting: surround an Empty Bottle with packed ice in a crafting table. This recipe is temporary and will be replaced by a Cryogenic Condenser block in a future version.

Liquid Hydrogen

A bottle of liquid hydrogen. Serves as a high-efficiency furnace fuel, burning for 6400 ticks (32 items) and returning an Empty Bottle in the fuel slot, similar to a lava bucket. Stacks to 16. Its intended future use is as rocket fuel for space travel.

Crafting: an Empty Bottle combined with redstone and iron nuggets in a crafting table. This recipe is temporary and will be replaced by a Cryogenic Condenser block in a future version.

Moon Dust

A material item obtained by mining Moon Stone. Each block of Moon Stone drops 0 to 6 Moon Dust. Moon Stone cannot be collected with Silk Touch. No crafting use exists yet.

Blocks

Moon Stone

The primary block of the Moon dimension. It has a hardness of 0.6 (similar to gravel) and breaks fastest with a shovel. No specific tool tier is required. Mining it yields 0 to 6 Moon Dust. It cannot be collected with Silk Touch. Moon Stone generates as the rolling lunar surface, with craters scattered across it.

Strange Block

A rare block found deep in Moon caves, between Y=−50 and Y=30. It emits a light level of 7 and has a purple map colour. What it does is left for players to discover.

Tips for creative play

  • Use the M menu to travel between Earth and the Moon. It is faster than typing commands.
  • In creative mode, oxygen and suffocation are disabled. Explore freely without managing oxygen.
  • The radiation screen effect still appears in creative mode. It is visual only and deals no damage.
  • Moon Stone is easy to break with a shovel. Bring one when exploring the Moon.
  • Moon Dust has no use yet. It can be safely discarded or stored.
  • Rare caves generate beneath the Moon surface between Y=−50 and Y=30. They are small and uncommon — worth exploring.
  • The Strange Block can be found in Moon caves. What happens when you interact with it is up to you to find out.