AvalonEarth Player Guide

1. Companies - what they are

A company is your business. Found one, run it with friends, and either offer a service to the rest of the server or buy what you need from someone else's.

Starting a company

• Type /company create.
• You pay a creation fee from your personal balance.
• Pick a name within the configured min/max length.
• Names can use letters, numbers, spaces, underscores, and hyphens.
• Pick one type: Building, Mercenary, Trading, or Logistics.

Renaming

• The owner can rename the company from the company menu.
• The rename cost is paid from the company bank.

Quick access

2. The four company types

3. Contracts

Every cross-company sale uses a contract. Contracts can move through these states:

4. Roles and Promotion

Anyone in a company has one of three roles:

Promotion

• Use the Promote button in your company menu.
• It sends a server-wide promotion message for your company.
• The cost is paid from the company bank.
• Promotions have a cooldown between uses.

5. The Moon

The Moon is a separate world: dusty, hostile, low gravity, no breathable air, no rain, custom ores, special villages, meteorite strikes, and dangerous terrain.

5a. How to get there

To launch normally from Earth, you need:

• A Tier 1 Rocket.
• A placed Launch Pad.
• Clear weather.
• Open space above you.
• The Launch Pad must be idle, with no supply pod on it.

Stand on the Launch Pad, hold the Tier 1 Rocket, and right-click. The rocket is placed on the pad and the item is consumed. Then:

• Right-click the placed rocket to board. The countdown starts and launches you to a random Moon landing point.
• Left-click (attack) the placed rocket to pick it back up as an item.

5b. Surviving the atmosphere

There is no breathable air on the Moon. If your head is not covered by a working Astronaut Helmet or Lunarite Helmet, you take suffocation damage every couple of seconds - unless you are inside the bubble of an active Oxygen Distributor.

While on the Moon you also get Slow Falling and Jump Boost III.

5c. Astronaut Suit

The Astronaut Suit is your starter Moon survival set. Each piece has custom durability that drains while you're on the Moon - even standing still.

5d. Lunarite Armor

Lunarite Armor is the stronger Moon armor. Each piece has armor, armor toughness, and knockback resistance, plus a large custom durability pool that drains far slower than the Astronaut Suit - the preferred set for long expeditions.

Repairing:

• Repaired in an anvil using Lunarite Ingots.
• Each ingot restores 40 durability.
• The anvil cost is paid in player XP levels.
• Only Lunarite Ingots work - nothing else produces a result.

5e. Mining and Lunarite

The Moon has its own ores:

• Iron Ore - normal resource ore.
• Lunarite Ore - unique Moon resource.

Mining Lunarite Ore drops Lunarite Nuggets. Combine 9 nuggets in a crafting grid to get 1 Lunarite Ingot. Ingots are used for almost every tier-1 and tier-2 build:

• Lunarite Armor
• Lunarite Laser Crossbow
• Trade Servers
• Command Stations
• Oxygenator / Oxygen Tank / Oxygen Distributor
• Tier 2 rocket parts
• Supply Pod missions (9 ingots fuel the pod itself)

Player-placed iron ore is tracked separately so mining your own placed blocks will not drop the custom Moon iron variants.

5f. Mobs and the Laser Crossbow

Hostile mobs spawn around Moon players on a timer, even in daylight. Bring a weapon and armor.

The Lunarite Laser Crossbow is a custom crossbow that fires laser projectiles - no arrows needed. Crafted with Lunarite Ingots, a Crossbow, and Redstone.

5g. Meteorite impacts (on the Moon)

Meteorites can fall near Moon players in four sizes:

When one impacts:

• It explodes and carves a crater.
• The crater can contain lava, magma, and netherrack.
• A Blackstone core can contain coal, iron, gold, diamond, and rare full blocks.
• The crater cools over time: lava → magma → netherrack → moonstone.

Meteorites avoid repeatedly hitting the same chunk too quickly, and skip AFK players based on movement checks. These on-Moon impacts are separate from the Meteorite Shower destination world (section 11).

5h. Terrain features and radiation

Moon terrain can include:

• Small and large craters.
• Moon rock clusters.
• Frozen lunar ice lakes.
• Lunar crystal fields.
• Deep cracks and canyons, sometimes with caves below.

5i. Moon Villages

Moon villages generate as glass dome settlements connected by glass tunnels. They use deterministic world-seed placement, so the same seed places villages in the same regions.

Layout:

• A central plaza dome.
• 1 to 4 directional chains of extra domes.
• Dome sizes and interiors vary.

Dome themes: bedroom, library, kitchen, workshop, storage, observatory, lab, farm.

Every village is guaranteed at least one farm. Farms use cauldrons because there is no Moon rain. Moon villagers can be killed unless staff/config makes them invulnerable.

5j. What you can't do on the Moon

Most teleport-style or claim-style commands are blocked on the Moon.

Blocked examples: /tp, /tpa, /tphere, /tpahere, /tpaccept, /home, /warp, /back, /claim, /gp, /towny, /res.

6. Trade Servers

Trade Servers are how Trading companies make money. They're physical blocks - a Beacon server block with a custom head display. Craft one, place it, fuel it, cool it, repair it, and it produces money and XP over time.

Capacity

• You can run as many servers at once as your company's Trading level.
• Level 1 = 1 server, Level 10 = 10 servers.
• Each active server produces money every production cycle and gives company XP.
• Leveling up increases your concurrent-server cap.

The four things to manage

Tier 2 upgrade

Once your town has investigated Tier 2 Trading Server (see section 10), you can upgrade a tier-1 Trading Server into a Tier 2 server by shapeless-crafting it with a Meteorite Rock from the Meteorite Shower.

A Tier 2 server has roughly double the production rate, durability cap, and fuel buffer of a tier-1 server. Exact numbers are server-configurable.

7. Fuel & Biofuel

Anything that "runs" on this server - Trade Servers, rockets, Supply Pods, Command Stations - uses fuel buckets. There are two ways to make them: the Fuel Generator (tier 1) and the Biofuel Generator (tier 2).

Fuel Generator

The Fuel Generator turns Coal + Netherite into Fuel Buckets. Place it like a normal block and right-click to open the GUI:

Each cycle takes a short while (like a slow furnace).

Biofuel Generator tier-2 unlock

The Biofuel Generator (a smoker block) ferments organic matter + a catalyst into a Biofuel Bucket. Biofuel Buckets are interchangeable with Fuel Buckets - rockets, pods, trade servers, and command stations accept either.

Per cycle the generator consumes its configured amount of organic matter and catalyst (default 64 organic + 4 catalyst per bucket) and outputs one Biofuel Bucket. Closing the GUI returns any items left in the slots to your inventory.

8. Launch Pads, Command Stations & Supply Pods

Launch Pads are infrastructure for rockets and supply pods. Use one on Earth to launch a Tier 1 Rocket to the Moon, or one on the Moon with a Supply Pod and Command Station for pod missions.

Launch Pads

• Place a Launch Pad item to create a 3x3 Smooth Stone pad centered on the placed block.
• You need a clear 3x3 area at the same height.
• Breaking any pad block removes the whole pad and drops the Launch Pad item.
• If a pod is loaded or returned, the pod item and stored fuel drop too.
• If a pod is in flight when the pad is destroyed, the mission is lost.

Rockets: stand on an idle Launch Pad, hold a rocket item, right-click. The pad must not have a supply pod on it. Tier 2 Rockets are assembled piece by piece - see section 11.

Supply Pods

• Place a Supply Pod on the center of an idle Launch Pad.
• Right-click the pad while the pod is loaded to open the pod fuel GUI.
• Pod fuel is NOT Fuel buckets - it requires 9 Lunarite Ingots for one ready pod cargo.
• Only Lunarite Ingots can be stored in the pod fuel GUI.

Command Stations

A Command Station is a Lectern-style control block for a Launch Pad.

• Must be placed on the Moon.
• Must be next to a Launch Pad.
• Each Launch Pad can have only one Command Station.

Right-click to open the control GUI, which shows:

• A trajectory tracker / destination picker.
• Fuel button for station Fuel or Biofuel buckets.
• Launch button.
• Mission status and ETA.

Destination picker

Launching a Supply Pod mission

Requirements:

• A Supply Pod placed on the pad.
• 9 Lunarite Ingots loaded into the pod.
• At least 1 Fuel (or Biofuel) bucket stored in the Command Station.
• A clear launch/landing column above the pad.

When you click Launch:

1. You choose one of three rolled reward options.
2. Fuel is consumed only after you choose a reward.
3. The pod launches.
4. It returns after a long real-time delay.
5. If the landing column is blocked, clear it and use the Command Station to bring the pod home.
6. Claim the returned reward by right-clicking the pad.

Reward choices can include money, Lunarite items, Moonstone, and vanilla resources such as iron, gold, diamonds, emeralds, lapis, redstone, coal, and copper.

9. Oxygenator, Oxygen Tanks & Oxygen Distributor

The Moon's oxygen kit is a small chain of blocks. The Oxygenator is the crafting / recharge station, the Oxygen Tank stores breathable oxygen, and the Oxygen Distributor uses tanks to flood an area with a breathable atmosphere.

Oxygenator tier-2 unlock

A barrel-shaped utility block. Right-click to open its GUI. There are two input slots:

• Top slot: one Astronaut Suit piece or one Oxygen Tank.
• Bottom slot: any saplings.

Once both slots are filled, it processes automatically every couple of seconds, consuming one sapling per step.

• For an Astronaut Suit piece, each sapling restores +30 custom durability.
• For an Oxygen Tank, the configured number of saplings per level (default 4) fills the tank by one fill level. A full tank has 6 levels.
• Only one player can use a given Oxygenator at a time.
• Closing the GUI returns the armor / tank and any remaining saplings (overflow drops at your feet).
• The Oxygenator does not repair Lunarite armor - use an anvil + Lunarite Ingots for that.

Oxygen Tank tier-2 unlock

A craftable canister with six fill levels (1 = nearly empty, 6 = full). The item's head texture and tooltip change to reflect the fill level. A fresh-crafted tank is empty - drop it into an Oxygenator's top slot with saplings to fill it.

Tanks are the ammunition for the Oxygen Distributor - load them in and it will drain them over time to keep a breathable zone.

Oxygen Distributor tier-2 unlock

A placeable beacon-head block. It has five tank slots and, while it has at least one tank with oxygen left, projects a breathable zone around itself.

• Only Oxygen Tanks may be placed in the tank slots.
• An indicator pane reads "Providing oxygen" (green) when any tank still has oxygen, or "No oxygen - load a filled tank" (red) when empty.
• While a player stands within the configured radius (default 10 blocks) on the Moon, that player's atmosphere check passes - they will not suffocate even without a helmet.

Drain:

• The leftmost non-empty tank drains by one level after a fixed time.
• A full tank lasts about as long as the configured "tank-full-minutes" setting (default 300 minutes = 5 hours).
• Drain progresses while the chunk is loaded; if unloaded, runtime is saved and resumes from that timestamp on reload.
• The distributor only ticks on the Moon. Placing one elsewhere is inert.

Breaking the distributor drops the block plus every tank currently loaded (at whatever fill level it had reached).

Repair / refill summary

10. Investigation

The tier-2 tree gates everything Meteorite related and the oxygen kit. Research is paid with your town bank account.

Who can start an investigation

• The mayor of a Towny town, or a resident with the "assistant" town rank.
• Any other resident, cannot start research.
• You must be in a town. Townless players cannot use the system at all.

Open the menu

Funding and cost

• The investigation cost is withdrawn from the town's bank account. If the town can't cover it, the investigation won't start (duh).
• Some investigations also require materials from the actor's inventory (like Lunarite Ingots).

Active investigation

• A town can only run one investigation at a time.
• Investigations run on a real-time timer.

11. Tier 2: Rockets & the Meteorite Shower

The tier-2 endgame is a piece-by-piece rocket pointed at a second world: the Meteorite Shower. The whole feature is gated behind both the per-server toggle (set by staff) and the tier-2 investigation tree (set by your town).

Tier 2 Rocket assembly

Tier 2 rockets are not a single craftable item. They are built on a Launch Pad by placing five parts in sequence, each of which is its own crafted item:

1. Tier 2 Rocket - Lower
2. Tier 2 Rocket - Middle
3. Tier 2 Rocket - Upper
4. Tier 2 Rocket - Booster
5. Tier 2 Rocket - Booster

Place them in order on an idle Launch Pad. Each placement spawns the matching section of the rocket display model. Once both boosters are in place, the rocket is complete and you can board it like a tier-1 rocket.

The Meteorite Shower destination

The Meteorite Shower is a separate world. It is only reachable while its window is open.:

To go there:

• Have a fully assembled Tier 2 Rocket on a Launch Pad.
• Open the Command Station GUI, click Destination, and pick the Meteorite Shower icon while the window is open.
• Board and launch the rocket as usual.

The Meteorite Shower world

The meteorite world has no ground. It is a pure void scattered with floating "asteroid" islands:

Island contents:

• Body blocks (Like stone-family: stone, deepslate, blackstone, tuff).
• Embedded ore veins: iron, copper, gold, redstone, lapis, diamond, emerald, and sometimes ancient debris.
• You may find Meteorite Rocks, a special rock that, when mined, drops the Meteorite Rock item.

Meteorite Rocks are the ingredient for the Tier 2 Trade Server upgrade.

12. Items list

Moon utilities

Rocket parts

Tech components

Astronaut Suit

Moon mining

Lunarite endgame gear

Trade gear

Launch pad gear

Admin / special

13. Recipes

All recipes are 3x3 crafting grids unless stated otherwise. Custom items can't be substituted with vanilla versions.

Rocket parts

Cable Coils

• 6×Iron Ingot
• 3×Nether Quartz

Fan

• 4×Iron Ingot
• 3×Feather

Pipe

• 6×Iron Ingot

Engine

• 2×Cable Coils
• 1×Fuel
• 2×Pipe
• 1×Fan
• 2×Iron Block
• 1×Netherite Ingot

Tier 1 Rocket

• 3×Fuel
• 1×Engine
• 2×Iron Block
• 1×Netherite Ingot

Tech components

CPU

• 4×Nether Quartz
• 4×Redstone Dust
• 1×Lunarite Ingot

Battery

• 5×Copper Ingot
• 2×Redstone Dust

Fuel & Biofuel Generators

Fuel Generator

• 4×Netherite Ingot
• 4×Iron Block

Coal + Netherite → Fuel.

Biofuel Generator tier 2

• 4×Copper Ingot
• 2×Iron Block
• 2×Glass
• 1×Engine

Ferments organic matter + Bone Meal → Biofuel.

Oxygenator tier 2

• 4×Glass
• 4×Lunarite Ingot
• 1×Smooth Stone

Repairs Astronaut Suit pieces and fills Oxygen Tanks with saplings.

Oxygen Tank tier 2

GP

• 6×Iron Block
• 2×Pipe
• GP1×Glass Pane

Oxygen Distributor tier 2

• 4×Lunarite Ingot
• 1×Fan
• 2×Pipe
• 1×CPU
• 1×Battery

Astronaut Suit

Astronaut Helmet

• 5×Iron Block

Astronaut Chestplate

• 8×Iron Block

Astronaut Leggings

• 7×Iron Block

Astronaut Boots

• 4×Iron Block

Lunarite

Lunarite Ingot shapeless · 9 nuggets

• 9×Lunarite Nugget

9 × Lunarite Nugget → 1 × Lunarite Ingot

Lunarite Helmet

• 5×Lunarite Ingot

Lunarite Chestplate

• 8×Lunarite Ingot

Lunarite Leggings

• 7×Lunarite Ingot

Lunarite Boots

• 4×Lunarite Ingot

Lunarite Laser Crossbow

• 3×Lunarite Ingot
• 1×Crossbow
• 1×Redstone Dust

Trade

Trading Server

• 4×Lunarite Ingot
• 1×Fan
• 2×Cable Coils
• 1×CPU
• 1×Battery

Trading Server Tier 2 shapeless · tier 2

TS

MR

• TS1×Trading Server
• MR1×Meteorite Rock

~Double production rate, durability cap, and fuel buffer.

Server Repair Tool

• 1×Lunarite Ingot
• 2×Stick

Launch Pad & Supply Pod

Landing Gear

• 7×Iron Ingot

Parachute

• 6×String

Supply Pod shapeless

• 1×Landing Gear
• 1×Parachute
• 1×Fan
• 1×Engine
• 1×CPU
• 1×Battery

Launch Pad

DB

• 8×Smooth Stone
• DB1×Diamond Block

Command Station

• 6×Lunarite Ingot
• 1×Cable Coils
• 1×CPU
• 1×Battery

Tier 2 Rocket parts tier 2

Tier 2 Rocket - Lower

• 2×Fuel
• 1×Netherite Ingot
• 2×Engine
• 1×Pipe
• 2×Lunarite Ingot
• 1×Iron Block

Tier 2 Rocket - Middle

• 4×Lunarite Ingot
• 1×Cable Coils
• 2×Fan
• 1×Battery
• 1×Fuel

Tier 2 Rocket - Upper

GB

• GB1×Gold Block
• 4×Lunarite Ingot
• 1×CPU
• 1×Cable Coils

Tier 2 Rocket - Booster x2 used

• 1×Netherite Ingot
• 2×Fuel
• 1×Engine
• 2×Lunarite Ingot
• 1×Iron Block

Used twice (left + right side). Longer research time than the lower/middle/upper parts.

14. Commands you can use

Admin/staff commands such as /companyadmin and the full /moon tree are not part of normal player use.