Getting Started

Getting Started

This guide is for commanders installing RavenColonial EDMC for the first time.

What You Need

1. EDMarketConnector installed and working. RavenColonial EDMC is tested against EDMC 6.1.2 and newer.
2. A RavenColonial account and API key.
3. The latest RavenColonial EDMC release ZIP from GitHub.
4. Optional for the in-game HUD: EDMCModernOverlay. The Popout Tracker works without it.

Links:

• EDMC: https://github.com/EDCD/EDMarketConnector
• RavenColonial EDMC releases: https://github.com/Fenris159/ravencolonial_edmc/releases
• EDMCModernOverlay: https://github.com/SweetJonnySauce/EDMCModernOverlay

Install the Plugin

Download the release asset named like:

RavenColonial_EDMC-v1.8.1.zip

Extract the folder named RavenColonial_EDMC into EDMC's plugins folder, then restart EDMC.

Typical plugin folders:

Platform	Plugin folder
Windows	%LOCALAPPDATA%\EDMarketConnector\plugins\
Linux	~/.local/share/EDMarketConnector/plugins/
macOS	~/Library/Application Support/EDMarketConnector/plugins/

After restart, the EDMC plugin tab should show RavenColonialWeb and the settings page should report the current plugin version.

Add Your RavenColonial API Key

1. Open EDMC.
2. Open File -> Settings.
3. Select the RavenColonial_EDMC plugin tab.
4. Paste your RavenColonial API key.
5. Save settings.

The API key is required for authenticated writes such as creating or linking projects, reporting contributions, updating Fleet Carrier cargo, and repairing completed-site MarketID data.

First Launch Checklist

1. Start Elite Dangerous and load into the commander you want to use.
2. Start EDMC or press EDMC update after the game is loaded.
3. Confirm the plugin status line says Ravencolonial: Ready.
4. Dock at a colonization construction ship or completed site when you want to create, link, or update a project.
5. If using the in-game overlay, confirm EDMCModernOverlay is installed and enabled. If using Popout Tracker, no overlay dependency is required.

Basic Terms

Term	Meaning
Build project	An active RavenColonial construction project for a site.
Plan location	A planned site row from RavenColonial before it is linked to an in-game construction dock.
Link Build Location	Connects a planned RavenColonial location to the construction ship where you are docked.
Create Build Project	Creates a new project from the docked construction depot snapshot.
Track All	Tracker mode that aggregates all active build projects from the refreshed list.
Popout Tracker	EDMC-dark secondary window that shows the same build tracker table without EDMCModernOverlay.
FC cargo tracking	Optional overlay and cargo-sync behavior for linked Fleet Carriers.

Normal Daily Use

For construction work:

1. Dock at the construction ship.
2. Let the plugin read the ColonisationConstructionDepot journal data.
3. Use Open Build Page, Create Build Project, or Link Build Location depending on the current project state.
4. Deliver cargo normally.
5. The plugin reports construction contribution history and updates remaining project need from journal depot data.

For tracker work:

1. Check Enable Overlay for the in-game HUD, or Popout Tracker for the EDMC window.
2. Refresh build projects for the current system or searched system.
3. Select one project or Track All.
4. Optionally enable carrier tracking and select All or a callsign.
5. In the popout, use the copy button when you want Discord-friendly fixed-width text for squad coordination.