# 🛸 Aethelspace - Avorion Living Galaxy ## Complete Player Guide: 4X Macro Mechanics, In-Cockpit HUDs & UI Systems Welcome to **Aethelspace** on **Difficult Roosters**! Aethelspace is a persistent Living Galaxy beside vanilla Avorion. A PostgreSQL database and a Python simulation keep the sovereignty, economy, colonies, megastructures, and crew book. Avorion still builds the sector you fly into: the asteroids, the stations, and the ship under your hands. The crew book uses Avorion's seven jobs. Engineer, Mechanic, Gunner, Miner, Pilot, Security, and Boarder. One named specialist keeps all seven star tracks. Only the job they are working gains stars. --- ### 🌐 Server Connection Information - **Game:** Avorion (Latest Steam release) - **Direct Connect Address:** - **Public:** `difficultroosters.com:8310` - **At the house:** the galaxy card shows the local address after you log in with Discord - **Server Password:** shown on the galaxy card after Discord login - **Server Browser Filter:** Search `Difficult Roosters` in the multiplayer server browser. - **Voice & Community Discord:** [https://discord.gg/AMz3jAZ5Ax](https://discord.gg/AMz3jAZ5Ax) - **Hub script:** [aethelspace_hub_popup.lua](https://difficultroosters.com/static/downloads/aethelspace_hub_popup.lua) --- ### Install the hub before you join The dedicated server does not send this script to your game. Press `K` or type `/k` and the chat can say the hub is opening while no window appears. 1. Fully quit Avorion. Leaving the server is not enough. The game keeps scripts until the program exits. 2. Download [aethelspace_hub_popup.lua](https://difficultroosters.com/static/downloads/aethelspace_hub_popup.lua). The galaxy card has the same button: **Download Hub Script (.lua)**. 3. Put it here and do not rename it: ```text steamapps/common/Avorion/data/scripts/player/aethelspace_hub_popup.lua ``` A default Windows Steam install uses: ```text C:\Program Files (x86)\Steam\steamapps\common\Avorion\data\scripts\player\ ``` Create the `player` folder if it is missing. If Avorion is on another drive, use that library's `steamapps\common\Avorion\data\scripts\player\` folder. 4. Start Avorion, join, and press `K` in flight. 5. If this file is replaced later, fully quit Avorion again before you rejoin. --- ### 🎮 In-Game Cockpit Interface Two windows carry this galaxy. They are not the same file. | Window | How you open it | What it is for | | :--- | :--- | :--- | | **Aethelspace Hub** | `K` or `/k`, after the script above is installed | Personnel, Colony deliveries and the elevator, Megastructure commission and deposits, and Intel | | **Logistics & Assembly** | Target a station and press `F` | Deliver provisions, anchor an elevator, fill a megastructure, and supply a shipyard | The picture below is the layout. The Hub you install has **Personnel**, **Colony**, **Megastructures**, and **Intel**. The station `F` window still has the same delivery buttons. ``` ┌─────────────────────────────────────────────────────────────────────────────┐ │ 🪐 AETHELSPACE │ ├─────────────────┬───────────────────┬───────────────────┬───────────────────┤ │ 🌍 Colony │ 🏛️ Megastructures │ 🛡️ Intel │ 🧑‍✈️ Crew │ └─────────────────┴───────────────────┴───────────────────┴───────────────────┘ ``` ##### 🌍 Colony and the space elevator The ledger keeps a surface colony for a settled sector. What it produces follows the planet Avorion draws there. A green terrestrial world grows food, potato, rice, wood, water, cattle, coal, coffee, and spices. A red volcanic world grows ore, iron ore, titanium ore, coal, oil, raw oil, mineral, carbon, and bio gas. A rocky world and a moon grow ore, silicon, copper, and mineral. A gas giant grows hydrogen, helium, oxygen, and carbon. A smooth ice world grows oxygen, nitrogen, neon, and carbon. A sector the seed does not draw a planet for is left as it was. The Hub Colony line lists whatever that world is holding. You can still deliver food, medicine, and luxuries to a colony. Those shipments are supplies you bring. They are not the planet's own yield. The Hub's Colony tab has the same delivery buttons as the station window: - **Deliver 250 Food**, **Deliver 50 Meds**, **Deliver 10 Luxuries** from the ship you are flying. - **Anchor Space Elevator** when the sector has a colony and no tether yet. The price on the button is 5,000 Iron and 250,000 credits. One elevator is already anchored in the ledger, at sector (450, 0). ##### 🏛️ Alliance megastructures The simulation can register an Orbital Ring, a Dyson node, or a Hypergate, store Steel and Processors in its buffer, and remember construction progress. One Orbital Ring is in the ledger at 90 percent. The Hub's Megastructures tab commissions an Orbital Ring (5,000,000), a Dyson node (7,500,000), or a Hypergate (10,000,000). It also deposits **500 Steel**, **50 Processors**, or all matching cargo, and it can sell Hull Parts, Advanced Electronics, and Shield Components to a shipyard gate in the same sector. A sector can hold one project. The station `F` window can still deposit into a project that already exists. ##### 🛡️ Sovereignty and intel The Hub's Intel tab reads the sector sovereign, whether a megastructure or elevator is here, and the shipyard gate totals. Your vanilla standing, wanted level, and the faction that owns the sector are still Avorion's. The simulation also stores sector law and can paint a map node when a border changes. The galaxy map is not fully replaced by a custom political map. ##### 🧑‍✈️ Crew — seven native jobs This is the part the Hub is built for. - The vanilla captain stays in the chair until you remove them in the normal ship window. **Promote to captain** then seats the specialist you selected. Their seven tracks choose the class, the subclass, the perks, and the starting level. A random captain is not generated. - The book names specialists who are actually aboard the ship you are flying. Ordinary unassigned crew stay as anonymous stacks. The simulation does not invent a crew for you. - Hover a specialist. The tooltip lists seven tracks: Engineer, Mechanic, Gunner, Miner, Pilot, Security, and Boarder. - **Assign job** moves that person to another chair on this ship. Stars in the old job stay. The new job starts at the specialist level those stars have already earned. - **Move to selected ship** sends that named person to another ship. Someone online has to be flying the destination. --- #### Station Logistics & Assembly (Press `F`) Fly within interaction range of a station, target it, and press `F`. Choose **Aethelspace Logistics & Assembly**. This menu is part of the dedicated server. You do not download it. - **Surface Logistics:** deliver food, medicine, and luxuries, and anchor a space elevator. - **Megastructure Assembly:** deposit Steel and Processors into a project that is already registered. - **Shipyard supply:** unload Hull Parts, Advanced Electronics, and Shield Components into that station's build gate. The same window still has an old **Enlist Apprentice** button. That is not the crew book. Named specialists come from the ship you are flying. --- ### ⭐ Seven job tracks and Elite Crew Each named specialist is one person. They keep seven star tracks from 0.00 to 5.00. Only the job they are working gains stars. About 0.03 of a star arrives on that track every five minutes while they are aboard. | Job in the hub | Avorion profession | What changes on the ship | | :--- | :--- | :--- | | Engineer | Engine | Specialist level. Hull support once this track is at least 2.50. | | Mechanic | Repair | Specialist level. Hull support once this track is at least 2.50. | | Gunner | Gunner | Specialist level. Shield support once this track is at least 2.00. | | Miner | Miner | Specialist level. The mining bonus is that vanilla level. | | Pilot | Pilot | Specialist level. Shield support once this track is at least 2.00. | | Security | Security | Shield support once this track is at least 2.00. | | Boarder | Attacker | Specialist level. Shield support once this track is at least 2.00. | The specialist level is the bonus the ship already uses. It steps to 2 at 2.00 stars and to 3 at 4.00 stars. It stops at level 3. **Elite Crew** is all seven tracks at 5.00. Shield and hull support then both apply, whichever chair they sit. The galaxy announces that title once. There is no separate gold nameplate yet. Station officers are a different book. They are not these seven tracks, and Assign job does not move them. --- ### 🏭 Closed-loop shipyard economy NPC shipyards do not build a convoy out of nothing. The ledger has 36 shipyard gates. A convoy from a gate spends **250 Hull Parts** and **50 Advanced Electronics** before it can launch. If the gate is short, that build waits. The board prices in the simulation are: - Hull Parts: 1,200 credits - Advanced Electronics: 3,500 credits - Shield Components: 7,500 credits Mines dig ore. Factories smelt and build parts, then turn leftover Steel into Energy Cells. Freighters move the surplus. A destroyed freighter drops the cargo. It does not deliver it. --- ### 🗺️ Borders The simulation keeps a sovereign for each sector and can order the galaxy map to mark a faction, a blockade, or a crisis. Vanilla reputation tint is still what you see until that order is applied to the sector. Open the map with `M` for Avorion's own view. --- ### 📡 Commands that exist Day-to-day crew work is the Hub. Day-to-day delivery is the station window. These chat commands are also on the server: | Command | What it does | | :--- | :--- | | `/k` | Opens the Hub, once the script is installed. | | `/onboarding` | Re-opens the new-pilot briefing. | | `/movefleet ` | Asks the simulation to route that fleet id across the gates it knows. | | `/setsectorlaw [fine] [infamy]` | Writes a contraband law for the sector you are in. | --- ### 💡 Quick tips 1. Install `aethelspace_hub_popup.lua` once, or `K` has nothing to draw. 2. Read the captain before you promote. A seated captain is not replaced. 3. Leave a specialist in one job if you want that track to climb. Assign job is how the other six tracks get their time. 4. Use Colony and Megastructures on the Hub, or `F` on a station, to move food, parts, and elevator materials. See you in the stars, Commander.