Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

104 Commits
 
 
 
 
 
 

Repository files navigation

Stellaris Map Editor

Official website: https://non-npc.github.io/Stellaris-Map-Editor/

Custom Galaxy Creation & Editing Toolkit for Stellaris 4.4.* Pegasus
Design, generate, edit, and export fully customized Stellaris galaxy maps with complete visual control.


Download

Latest Release (v1.0.5)

Exports target Stellaris 4.4.* and are tested against game version 4.4.1.

Download Stellaris Map Editor v1.0.5


Features

  • Interactive real-time galaxy editor
  • Procedural galaxy generation
  • Custom PNG galaxy shape masks
  • Hyperlane editing
  • Wormhole editing
  • Gateway editing
  • Nebula editing
  • Star system editing
  • Advanced galaxy generation settings
  • Real-time visual galaxy preview
  • Export directly into Stellaris 4.4-compatible mod format
  • Supports symbolic and geometric galaxy layouts
  • Automatic galaxy scaling based on star count and galaxy size

Table of Contents


Works On

  • Windows 10
  • Windows 11

Stellaris Version

  • Stellaris 4.4.* Pegasus (4.4.* export target)

Quick Start

1. Create a New Project

Launch the editor and create a new galaxy project. The project name is used as the mod name when exported.

2. Generate or Import a Galaxy Shape

You can either:

  • Generate a procedural galaxy
  • Import a custom PNG mask shape (1024x1024)

3. Edit the Galaxy

Modify:

  • Stars
  • Hyperlanes
  • Nebulas
  • Wormholes
  • Gateways
  • Clusters

4. Export the Galaxy

Export directly into a playable Stellaris mod format for version 4.4.*. In New Game setup, choose Galaxy Shape: Elliptical, then select your exported scenario.


Custom Galaxy Shapes

Stellaris Map Editor supports fully custom galaxy layouts using black-and-white PNG mask images.

You can create:

  • Symbols
  • Logos
  • Geometric patterns
  • Chokepoint maps
  • Artistic galaxy designs
  • Hand-drawn galaxy layouts

Creating a Custom Shape Mask

Creating a custom galaxy shape is simple:

  1. Create a 1024x1024 PNG image
  2. Use a transparent or white background
  3. Paint the desired galaxy area in black
  4. Save the PNG image
  5. Import it into the editor

Mask Rules

Color Result
Black Valid galaxy generation area
White / Transparent Empty space

Custom Shape Galaxy Tutorial

Step 1 — Import a Shape

  1. Open Stellaris Map Editor
  2. Open the Custom Shapes menu
  3. Click Add Custom Galaxy Shape
  4. Select your PNG mask image

The shape will appear in the custom shape list.


Step 2 — Generate the Galaxy

  1. Open the Generate menu
  2. Click Generate Custom Galaxy
  3. Select your imported shape
  4. Choose:
    • Galaxy size
    • Star count
    • Hyperlane density
    • Additional settings
  5. Click Generate Galaxy

The editor will automatically scale the shape based on the selected galaxy size and star count.


Step 3 — Export the Galaxy

  1. Review the generated galaxy
  2. Open the Export menu
  3. Click Export Mod

Your custom galaxy is now ready for Stellaris.


Screenshots

Create a New Project

Create Project


Import a Custom Shape

Import Shape


Generate a Galaxy from a Shape

Generate Shape


Load the Galaxy In-Game

In Game


Example Custom Galaxy

Custom Galaxy


Example Custom Mask Images

Triangle Shape

Triangle Shape

Abstract Shape

Abstract Shape

Liquid Shape

Liquid Shape


Editing a Star System

System Editing


Advanced Galaxy Generation Settings

Advanced Settings


Hyperlane Editing

To create a hyperlane:

  1. Select the first star
  2. Select the second star
  3. Click Add Hyperlane

Hyperlane Editing


Nebula Editing

Nebulas can be added and resized from the Nebula tab. Adding a nebula will position it at 0,0 then you can change its x/y and size.

Nebula Editing


Wormhole Editing

Select two stars (from drop downs) and create a wormhole pair.

Wormhole Editing


Gateway Editing

Select a star (from drop down) and add a gateway.

Gateway Editing


Large Galaxy Examples

2000 Star Galaxy

2000 Stars

1000 Star Chokepoint Galaxy

1000 Stars


Editing Features

Star Editing

  • Create stars
  • Move stars
  • Rename stars
  • Modify system data
  • Configure planets and moons

Hyperlane Editing

  • Create hyperlanes
  • Remove hyperlanes
  • Quickly search systems using keyboard shortcuts

Nebula Editing

  • Create nebulas
  • Resize nebulas
  • Reposition nebulas

Wormhole Editing

  • Create paired wormholes
  • Configure wormhole endpoints

Gateway Editing

  • Add gateways to systems
  • Configure gateway placement

Tips

Planet classes and initializer

You can find the list of valid planet classes and initializers and more at the official wiki https://productionwiki-stellaris.paradoxwikis.com/index.php?title=Empire_modding

Moving Objects

If objects are difficult to drag:

  • Zoom in using the mouse wheel
  • Fine placement becomes much easier when zoomed closer

Panning the Map (in star tab only)

Click and drag empty space to pan around the galaxy.


Searching for Systems

In dropdown fields you can repeatedly press a letter to quickly cycle through matching system names.

Example:

  • Press S repeatedly to quickly locate systems beginning with S

Known Limitations

  • Only stars can currently be moved directly on the canvas
  • Nebulas, wormholes, gateways, and hyperlanes are edited from their respective tabs
  • Very large galaxies may take longer to generate (2000 stars take about 45s-60s)
  • After editing an object, you need to reselect it to edit it again. This may be changed in the future.

Version History

v1.0.5

  • Stellaris 4.4.* Pegasus compatibility update
  • Default export target updated to 4.4.*
  • Fixed invalid core_cluster galaxy shape in exported scenarios
  • Fixed gateway spawn syntax for Stellaris 4.4 export
  • Fixed generated system initializers exceeding Stellaris system size limits
  • Removed Fallen Empires and Marauders from Project Settings (generator controls these)
  • Added validation warnings for nebulas, wormholes, and gateways

v1.0.4

Hyperlanes tab improvements

  • Selecting a second star now automatically fills the To field
  • Existing hyperlanes auto-select in the list
  • Delete Selected now removes the lane between From and To

v1.0.3

  • Fixed a y-axis bug when moving stars

v1.0.2

  • Added Move Selected Star button

v1.0.1

  • Selected objects now auto-center on the canvas
  • Improved visual highlights for selected objects

Credits

Created for the Stellaris modding community.


License

This project is provided as-is for personal and community use.