OpenFront Wiki Project - User contributions [en-gb]

Unofficial Projects

2025-12-24T07:08:11Z

Tidwell: add official api information

Unofficial community projects utilize Openfront data or interact with the Openfront systems.

The [https://github.com/openfrontio/OpenFrontIO/blob/main/docs/API.md Openfront Api] provides endpoints to query game, player, and clan data: you can list game metadata within a two-day window, fetch full game details, and retrieve player info and session lists by player ID; clan endpoints include a top-100 leaderboard (weighted wins with a 30-day half-life) and detailed clan stats and sessions over optional time ranges

For Software and Tools related to maps, see [[Map Making]].

''Note that some of these projects may be work in progress, incomplete, or abandoned.''

= Web Apps =

== OpenFront.io Replay Analyzer ==
A Web Application to analyze OF games
* [https://ofra.vimacs.workers.dev/ ofra.vimacs.workers.dev]
* Author: scamiv
* Version: v28

== FrontPlus.io ==
FrontPlus.io is a companion web platform for OpenFront.io players.

* https://frontplus.io/

= Software =
{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

== OpenfrontIO Api Client (JS/TS) ==

An unofficial, robust JavaScript/TypeScript client for the OpenFront API.

* [https://github.com/Tidwell/openfrontio-api-client Github]
* Author: Tidwell
* Version: v28

== Openfront Utility ==

This project is a tool for generating and previewing Openfront.io patterns in Base64 format.

* [https://github.com/Aotumuri/openfront-utility Github]
* Author: Aotumuri
* Version: v28

== Openfront Tactical Suitcase ==

Monorepo for the Openfront Tactical Suitcase project, including the web UI, shared game logic, and a browser userscript HUD.

* [https://github.com/docteurzoidberg/openfront-tactical-suitcase Github]
* Author: DrZoid
* Version: v28

== OpenFront Replay Analyzer ==

This repository runs OpenFront replays against the exact game engine version recorded in each replay’s gitCommit, without embedding the analyzer inside the main OpenFront repo.

* [https://github.com/scamiv/ofra Github]
* Author: scamiv
* Version: v28

== OpenFront.io Reinforcement Learning Agent ==
Academic Research project for a sophisticated deep reinforcement learning system for training AI agents to play OpenFront.io.

* [https://github.com/Alexis-CAPON/Reinforcement-Learning-Agent-OpenFront.io Github]
* Author: Terry, Jordan K and Black, Benjamin and Jayakumar, Mario
* Version: v27

== OpenFront Watcher Chrome Extension ==
A Chrome extension that monitors openfront.io for "Free for All" in the online mode rotation and sends desktop notifications.

* [https://github.com/PeanutButte7/openfront-watcher/tree/main Github]
* Author: PeanutButte7
* Version: v28

''Tools related to automating/cheating, gameplay modification, or forks of the Official OpenfrontIO game are not to be included here. Inactive software/tools will be flagged as inactive when they cease to function. If you verify software working on a more recent version than listed here, please contribute an update!''

Unofficial Projects

2025-12-24T06:55:49Z

Tidwell: add academic research project

Unofficial community projects utilize Openfront data or interact with the Openfront systems.

''Note that some of these projects may be work in progress, incomplete, or abandoned.''

For Software and Tools related to maps, see [[Map Making]].

= Web Apps =

== OpenFront.io Replay Analyzer ==
A Web Application to analyze OF games
* [https://ofra.vimacs.workers.dev/ ofra.vimacs.workers.dev]
* Author: scamiv
* Version: v28

== FrontPlus.io ==
FrontPlus.io is a companion web platform for OpenFront.io players.

* https://frontplus.io/

= Software =
{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

== OpenfrontIO Api Client (JS/TS) ==

An unofficial, robust JavaScript/TypeScript client for the OpenFront API.

* [https://github.com/Tidwell/openfrontio-api-client Github]
* Author: Tidwell
* Version: v28

== Openfront Utility ==

This project is a tool for generating and previewing Openfront.io patterns in Base64 format.

* [https://github.com/Aotumuri/openfront-utility Github]
* Author: Aotumuri
* Version: v28

== Openfront Tactical Suitcase ==

Monorepo for the Openfront Tactical Suitcase project, including the web UI, shared game logic, and a browser userscript HUD.

* [https://github.com/docteurzoidberg/openfront-tactical-suitcase Github]
* Author: DrZoid
* Version: v28

== OpenFront Replay Analyzer ==

This repository runs OpenFront replays against the exact game engine version recorded in each replay’s gitCommit, without embedding the analyzer inside the main OpenFront repo.

* [https://github.com/scamiv/ofra Github]
* Author: scamiv
* Version: v28

== OpenFront.io Reinforcement Learning Agent ==
Academic Research project for a sophisticated deep reinforcement learning system for training AI agents to play OpenFront.io.

* [https://github.com/Alexis-CAPON/Reinforcement-Learning-Agent-OpenFront.io Github]
* Author: Terry, Jordan K and Black, Benjamin and Jayakumar, Mario
* Version: v27

== OpenFront Watcher Chrome Extension ==
A Chrome extension that monitors openfront.io for "Free for All" in the online mode rotation and sends desktop notifications.

* [https://github.com/PeanutButte7/openfront-watcher/tree/main Github]
* Author: PeanutButte7
* Version: v28

''Tools related to automating/cheating, gameplay modification, or forks of the Official OpenfrontIO game are not to be included here. Inactive software/tools will be flagged as inactive when they cease to function. If you verify software working on a more recent version than listed here, please contribute an update!''

Unofficial Projects

2025-12-24T06:43:47Z

Tidwell: add notification chrome extention, add disclaimer, shuffle map link

Unofficial community projects utilize Openfront data or interact with the Openfront systems.

''Note that some of these projects may be work in progress, incomplete, or abandoned.''

For Software and Tools related to maps, see [[Map Making]].

= Web Apps =

== OpenFront.io Replay Analyzer ==
A Web Application to analyze OF games
* [https://ofra.vimacs.workers.dev/ ofra.vimacs.workers.dev]
* Author: scamiv
* Version: v28

== FrontPlus.io ==
FrontPlus.io is a companion web platform for OpenFront.io players.

* https://frontplus.io/

= Software =
{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

== OpenfrontIO Api Client (JS/TS) ==

An unofficial, robust JavaScript/TypeScript client for the OpenFront API.

* [https://github.com/Tidwell/openfrontio-api-client Github]
* Author: Tidwell
* Version: v28

== Openfront Utility ==

This project is a tool for generating and previewing Openfront.io patterns in Base64 format.

* [https://github.com/Aotumuri/openfront-utility Github]
* Author: Aotumuri
* Version: v28

== Openfront Tactical Suitcase ==

Monorepo for the Openfront Tactical Suitcase project, including the web UI, shared game logic, and a browser userscript HUD.

* [https://github.com/docteurzoidberg/openfront-tactical-suitcase Github]
* Author: DrZoid
* Version: v28

== OpenFront Replay Analyzer ==

This repository runs OpenFront replays against the exact game engine version recorded in each replay’s gitCommit, without embedding the analyzer inside the main OpenFront repo.

* [https://github.com/scamiv/ofra Github]
* Author: scamiv
* Version: v28

== OpenFront Watcher Chrome Extension ==
A Chrome extension that monitors openfront.io for "Free for All" in the online mode rotation and sends desktop notifications.

* [https://github.com/PeanutButte7/openfront-watcher/tree/main Github]
* Author: PeanutButte7
* Version: v28

''Tools related to automating/cheating, gameplay modification, or forks of the Official OpenfrontIO game are not to be included here. Inactive software/tools will be flagged as inactive when they cease to function. If you verify software working on a more recent version than listed here, please contribute an update!''

Unofficial Projects

2025-12-24T06:27:08Z

Tidwell: add projects disclaimer

Unofficial community projects utilize Openfront data or interact with the Openfront systems.

''Note that some of these projects may be work in progress, incomplete, or abandoned.''

= Web Apps =

== OpenFront.io Replay Analyzer ==
A Web Application to analyze OF games
* [https://ofra.vimacs.workers.dev/ ofra.vimacs.workers.dev]
* Author: scamiv
* Version: v28

== FrontPlus.io ==
FrontPlus.io is a companion web platform for OpenFront.io players.

* https://frontplus.io/

= Software =
For Software and Tools related to maps, see [[Map Making]]

{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

== OpenfrontIO Api Client (JS/TS) ==

An unofficial, robust JavaScript/TypeScript client for the OpenFront API.

* [https://github.com/Tidwell/openfrontio-api-client Github]
* Author: Tidwell
* Version: v28

== Openfront Utility ==

This project is a tool for generating and previewing Openfront.io patterns in Base64 format.

* [https://github.com/Aotumuri/openfront-utility Github]
* Author: Aotumuri
* Version: v28

== Openfront Tactical Suitcase ==

Monorepo for the Openfront Tactical Suitcase project, including the web UI, shared game logic, and a browser userscript HUD.

* [https://github.com/docteurzoidberg/openfront-tactical-suitcase Github]
* Author: DrZoid
* Version: v28

== OpenFront Replay Analyzer ==

This repository runs OpenFront replays against the exact game engine version recorded in each replay’s gitCommit, without embedding the analyzer inside the main OpenFront repo.

* [https://github.com/scamiv/ofra Github]
* Author: scamiv
* Version: v28

Unofficial Projects

2025-12-24T06:24:21Z

Tidwell:

Unofficial community projects utilize Openfront data or interact with the Openfront systems.

= Web Apps =

== OpenFront.io Replay Analyzer ==
A Web Application to analyze OF games
* [https://ofra.vimacs.workers.dev/ ofra.vimacs.workers.dev]
* Author: scamiv
* Version: v28

== FrontPlus.io ==
FrontPlus.io is a companion web platform for OpenFront.io players.

* https://frontplus.io/

= Software =
For Software and Tools related to maps, see [[Map Making]]

{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

== OpenfrontIO Api Client (JS/TS) ==

An unofficial, robust JavaScript/TypeScript client for the OpenFront API.

* [https://github.com/Tidwell/openfrontio-api-client Github]
* Author: Tidwell
* Version: v28

== Openfront Utility ==

This project is a tool for generating and previewing Openfront.io patterns in Base64 format.

* [https://github.com/Aotumuri/openfront-utility Github]
* Author: Aotumuri
* Version: v28

== Openfront Tactical Suitcase ==

Monorepo for the Openfront Tactical Suitcase project, including the web UI, shared game logic, and a browser userscript HUD.

* [https://github.com/docteurzoidberg/openfront-tactical-suitcase Github]
* Author: DrZoid
* Version: v28

== OpenFront Replay Analyzer ==

This repository runs OpenFront replays against the exact game engine version recorded in each replay’s gitCommit, without embedding the analyzer inside the main OpenFront repo.

* [https://github.com/scamiv/ofra Github]
* Author: scamiv
* Version: v28

Map Making

2025-12-24T06:17:50Z

Tidwell: Add procedural map generator app

= Map Making =

Openfront maps are contributed by the community in the same way other source code contributions are made. If you are looking to suggest a possible map, but do not wish to implement it yourself, see [https://discord.com/channels/1284581928254701718/1293201128858587207 the relevant discord channels]

[https://github.com/openfrontio/OpenFrontIO OpenfrontIO on Github]

{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

= Workflow & Tutorials =

Due to the game’s open-source nature, Map Making for OpenfrontIO is a low-barrier-of-entry way of contributing to the game in an impactful way. However, taking a map from concept to full release requires a number of steps, skills, and support from the development team.

To take a map concept from start to finish requires basic familiarity with the following tools, though none require extensive experience and can be learned as part of the process.

* Navigating and running applications from the command line.
* Graphics editing software
* Basic code-editing skills for modifying config files & adding license attribution
* GIT version control (this can be via command line, or any of the many GIT GUI tools)
* github pull request process

If you are already familiar with software development workflows, [https://github.com/openfrontio/OpenFrontIO/tree/main/map-generator The map-generator readme is a good starting point]

For a broader understanding of the specific workflow, the following guides summarize the process well:

* [https://discord.com/channels/1359946986937258015/1361003022074904743/1361003022074904743 aPuddle (public, updated v25)]
* [https://www.youtube.com/watch?v=Z5CqjsW5OIA Evan Video (youtube, updated v22?)]
* [https://discord.com/channels/1359946986937258015/1435011107461927046/1435011107461927046 Nikola123 (dev discord, updated v26)]
= Gameplay Impact from Map Design =

* In-game, [[Terrain]] affects '''Pathfinding''' (where units go) and '''[[Combat]] Resolution''' (how fast they conquer and how many die). Attacks naturally flow around mountains through plains unless forced otherwise.
* Oceans, Rivers, and Lakes can impact [[Annexation]] requirements.
* [[Nations]] placement impacts overall spawn position and early / mid-game gameplay.
* '''As of v28 nation strength is no longer included in map files and nation balance is not part of the map making process'''
= Color Tools =

== Color Palette XLS ==
A spreadsheet of the input -> output color mapping ranges for terrain (color)
* [https://cdn.discordapp.com/attachments/1435011107461927046/1435011247769915393/OpenFront_Map_Color_Palette_Explained.xlsx?ex=6948605e&is=69470ede&hm=0981f00062017860a8fb0d33e87ac3a5239ebb5c5e8139d25e22ab2db48105c4& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for GIMP ==
A GIMP color palette of the terrain colors from the previous XLS (.gpl)
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004028779167925/OpenFront_Terrain_Indexed.gpl?ex=694815c6&is=6946c446&hm=003a82c8e37f398a88e91e937463e62d9fba83a88c22bd56891e26b7d2f8a031& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for Photoshop ==
The same color palette as an Adobe Color Swatch file (.aco)
* [https://drive.google.com/file/d/1I7ZbDDjs_x5oy5-8ZorX_6rhgSSkfgaK Google Drive]
* Author: Unknown
* Version: v28

== Windows Powershell (B&W -> Colorize) ==
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004182290698260/coloriseMap.ps1?ex=694815eb&is=6946c46b&hm=70931a860b282a235966c109f882d776c2e1c8c4662ae143ffcdb41b81156a00& Discord CDN]
* Author: aPuddle
* Version: Unknown

= Unofficial Applications =

'''Note that some of these projects may be work in progress, incomplete, or abandoned. '''

== OpenFrontMapGenerator ==
A complete automated workflow for generating game-ready terrain maps from real-world data using QGIS and Python.

* [https://github.com/TsProphet94/OpenFrontMapGenerator Github]
* Author: TsProphet94
* Version: v28

== TheFiraffe3 Map Editor ==
* [https://thegiraffe3.github.io/OFmapeditor/ GitHub Pages]
* Author: TheGiraffe3
* Version: Unknown
* Source: [https://github.com/TheGiraffe3/OFmapeditor GitHub]

== Map Editor ==
Map editor that can be used to adjust nation placement. Note that you have to re-download the json after, and then remove the additional data that the map editor added (alongside regular formatting). There are also quite a few bugs, and it can mangle Nation flags. Always back up your files when using.

* [https://openfront-map-editor.netlify.app/ Netlify]
* Author: Unknown
* Version: Unknown

== Openfront Map Generator ==
Web Application for procedurally generating openfront maps. Docs & App are in Japanese, using browser translate works fine.

* [https://github.com/Aotumuri/OpenfrontMapGenerator Github]
* Author: Aotumuri
* Version: Unknown

== Flag Standardizer ==
* [https://openfront-flag-standardizer.netlify.app/ Netlify]
* Author: N0ur (?)
* Version: Unknown
= Map Sources =

The [https://github.com/openfrontio/OpenFrontIO/blob/main/CREDITS.md CREDITS.md file in the Openfront Repo] shows all the existing sources that have been used for the game. Many of these data sources provide other maps with the same licenses.

== World Map ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: Openfront
* Version: v28

== World Map Recolor tiff ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: aPuddle
* Version: v28

Unofficial Projects

2025-12-24T06:03:15Z

Tidwell: Created page with "Unofficial community projects utilize Openfront data or interact with the Openfront systems. For Software and Tools related to maps, see Map Making {{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}} == OpenfrontIO Api Client (JS/TS) == An unofficial, robust JavaScript/TypeScript client for the OpenFront API. * [https://github.com/Tidwell/openfro..."

Unofficial community projects utilize Openfront data or interact with the Openfront systems.

For Software and Tools related to maps, see [[Map Making]]

{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

== OpenfrontIO Api Client (JS/TS) ==

An unofficial, robust JavaScript/TypeScript client for the OpenFront API.

* [https://github.com/Tidwell/openfrontio-api-client Github]
* Author: Tidwell
* Version: v28

== Openfront Utility ==

This project is a tool for generating and previewing Openfront.io patterns in Base64 format.

* [https://github.com/Aotumuri/openfront-utility Github]
* Author: Aotumuri
* Version: v28

== Openfront Tactical Suitcase ==

Monorepo for the Openfront Tactical Suitcase project, including the web UI, shared game logic, and a browser userscript HUD.

* [https://github.com/docteurzoidberg/openfront-tactical-suitcase Github]
* Author: DrZoid
* Version: v28

== OpenFront Replay Analyzer ==

This repository runs OpenFront replays against the exact game engine version recorded in each replay’s gitCommit, without embedding the analyzer inside the main OpenFront repo.

* [https://github.com/scamiv/ofra Github]
* Author: scamiv
* Version: v28

== OpenFront.io Replay Analyzer - Web Version ==

A Web Application to analyze OF games
* [https://ofra.vimacs.workers.dev/ ofra.vimacs.workers.dev]
* Author: scamiv
* Version: v28

Map Making

2025-12-23T01:48:47Z

Tidwell: update map making disclaimer to use warning template

= Map Making =

Openfront maps are contributed by the community in the same way other source code contributions are made. If you are looking to suggest a possible map, but do not wish to implement it yourself, see [https://discord.com/channels/1284581928254701718/1293201128858587207 the relevant discord channels]

[https://github.com/openfrontio/OpenFrontIO OpenfrontIO on Github]

{{Warning|All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.}}

= Workflow & Tutorials =

Due to the game’s open-source nature, Map Making for OpenfrontIO is a low-barrier-of-entry way of contributing to the game in an impactful way. However, taking a map from concept to full release requires a number of steps, skills, and support from the development team.

To take a map concept from start to finish requires basic familiarity with the following tools, though none require extensive experience and can be learned as part of the process.

* Navigating and running applications from the command line.
* Graphics editing software
* Basic code-editing skills for modifying config files & adding license attribution
* GIT version control (this can be via command line, or any of the many GIT GUI tools)
* github pull request process

If you are already familiar with software development workflows, [https://github.com/openfrontio/OpenFrontIO/tree/main/map-generator The map-generator readme is a good starting point]

For a broader understanding of the specific workflow, the following guides summarize the process well:

* [https://discord.com/channels/1359946986937258015/1361003022074904743/1361003022074904743 aPuddle (public, updated v25)]
* [https://www.youtube.com/watch?v=Z5CqjsW5OIA Evan Video (youtube, updated v22?)]
* [https://discord.com/channels/1359946986937258015/1435011107461927046/1435011107461927046 Nikola123 (dev discord, updated v26)]
= Gameplay Impact from Map Design =

* In-game, [[Terrain]] affects '''Pathfinding''' (where units go) and '''[[Combat]] Resolution''' (how fast they conquer and how many die). Attacks naturally flow around mountains through plains unless forced otherwise.
* Oceans, Rivers, and Lakes can impact [[Annexation]] requirements.
* [[Nations]] placement impacts overall spawn position and early / mid-game gameplay.
* '''As of v28 nation strength is no longer included in map files and nation balance is not part of the map making process'''
= Color Tools =

== Color Palette XLS ==
A spreadsheet of the input -> output color mapping ranges for terrain (color)
* [https://cdn.discordapp.com/attachments/1435011107461927046/1435011247769915393/OpenFront_Map_Color_Palette_Explained.xlsx?ex=6948605e&is=69470ede&hm=0981f00062017860a8fb0d33e87ac3a5239ebb5c5e8139d25e22ab2db48105c4& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for GIMP ==
A GIMP color palette of the terrain colors from the previous XLS (.gpl)
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004028779167925/OpenFront_Terrain_Indexed.gpl?ex=694815c6&is=6946c446&hm=003a82c8e37f398a88e91e937463e62d9fba83a88c22bd56891e26b7d2f8a031& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for Photoshop ==
The same color palette as an Adobe Color Swatch file (.aco)
* [https://drive.google.com/file/d/1I7ZbDDjs_x5oy5-8ZorX_6rhgSSkfgaK Google Drive]
* Author: Unknown
* Version: v28

== Windows Powershell (B&W -> Colorize) ==
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004182290698260/coloriseMap.ps1?ex=694815eb&is=6946c46b&hm=70931a860b282a235966c109f882d776c2e1c8c4662ae143ffcdb41b81156a00& Discord CDN]
* Author: aPuddle
* Version: Unknown

= Unofficial Applications =

'''Note that some of these projects may be work in progress, incomplete, or abandoned. '''

== OpenFrontMapGenerator ==
A complete automated workflow for generating game-ready terrain maps from real-world data using QGIS and Python.

* [https://github.com/TsProphet94/OpenFrontMapGenerator Github]
* Author: TsProphet94
* Version: v28

== TheFiraffe3 Map Editor ==
* [https://thegiraffe3.github.io/OFmapeditor/ GitHub Pages]
* Author: TheGiraffe3
* Version: Unknown
* Source: [https://github.com/TheGiraffe3/OFmapeditor GitHub]

== Map Editor ==
Map editor that can be used to adjust nation placement. Note that you have to re-download the json after, and then remove the additional data that the map editor added (alongside regular formatting). There are also quite a few bugs, and it can mangle Nation flags. Always back up your files when using.

* [https://openfront-map-editor.netlify.app/ Netlify]
* Author: Unknown
* Version: Unknown
== Flag Standardizer ==
* [https://openfront-flag-standardizer.netlify.app/ Netlify]
* Author: N0ur (?)
* Version: Unknown
= Map Sources =

The [https://github.com/openfrontio/OpenFrontIO/blob/main/CREDITS.md CREDITS.md file in the Openfront Repo] shows all the existing sources that have been used for the game. Many of these data sources provide other maps with the same licenses.

== World Map ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: Openfront
* Version: v28

== World Map Recolor tiff ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: aPuddle
* Version: v28

Port

2025-12-23T01:41:14Z

Tidwell: Update how level interacts with Trade Ship Spawning and Partner Selection.

[[File:PortIcon.svg|thumb|200x200px|The port's icon]]
The '''Port''' is a [[Buildings|Building]] that spawns [[Trade Ship|Trade Ships]] and allows you to build [[Warship]]s.

== Cost ==
Ports scale in price based on number of owned '''ports AND factories'''.
{| class="wikitable"
|+City cost
!Port/factory number
![[Gold]] cost
|-
|1st
|125,000
|-
|2nd
|250,000
|-
|3rd
|500,000
|-
|4th+
|1,000,000
|}

== Mechanics ==

=== Warship spawning ===
[[Warship|Warships]] can only be bought if a player owns a port. The game will try to spawn the warship from the closest fort to where the warship is being deployed.

=== Trade Ship Spawning ===
[[Port|Ports]] check every 10 ticks if they should spawn a [[Trade Ship]]. Ports higher than Level 1 "roll the dice" once for each level (the same as if they were separate entities).

Spawn chance is calculated based on number of owned [[Port|ports]], number of owned trade ships, and number of trade ships on the map.

<math>\text{spawnChance} = \frac{1}{\left\lfloor \frac{25}{\sqrt{\text{baseChance} * \text{portMultiplier}}} \right\rfloor}</math>

Where baseChance is equal to 1 when you own less than 3 trade ships (exclusive), otherwise it is:

<math>\text{baseChance} = 1 - \frac{1}{1 + e^{\left(-\frac{\ln(2)}{10} * (\text{numOfShips} - 55)\right)}}</math>
[[File:Desmos port baseChance v26.png|alt=A graph|thumb|The relationship between the total number of ships and baseChance]]
In short, this means that the more ships there are on the map, the less likely more ships are to spawn, with a small number having only a very small effect. At 25 ships, the chance is 88%, at 55 it's 50%, at 100, it's just 4%.

<math>\text{portMultiplier} = \frac{1}{1 + \frac{\text{portsOwned}}{10}}</math>

More [[Port|ports]] = lower spawn rate '''per port''', but higher spawn rate '''overall'''.

There is no spawn cap.

=== Trade Route Selection ===
[[Port|Ports]] will only trade with other players (not their own [[Port|ports]]). Trade partners are prioritized in this order:
* Closer [[Port|ports]] get double chance of being selected (proximity bonus)
* Allied [[Port|ports]] get double chance of being selected
* A port's <code>level</code> determines how many times it is added to the pool of destinations.

[[Trade Ship|Trade ships]] are automatic, free to build, and don't count against unit limits.

=== [[Gold]] Generation ===
[[Gold]] earned is based on ''Manhattan distance'' (which means the sum of the absolute differences in x and y coordinates) between [[Port|ports]] and the number of ports you own:

<math>\text{tradeShipGold} =
\left\lfloor
baseGold
*
bonus
\right\rfloor</math>

BaseGold scales with Manhattan distance. There is also a debuff for small distances, less than around 400 [[Tile|Tiles]], this means that short trade routes are extremely unprofitable, and should be avoided. See the graph for details.
[[File:Desmos port baseGold v26.png|alt=A graph|thumb|The relationship between Manhattan distance in tiles and baseGold]]<math>\text{baseGold} = \frac{100,000}{1 + e^{-0.03 * (\text{distance} - 300)}} + 100 * \text{distance} </math>

Bonus is a value which is dependent on the number of ports you own. The more ports you own, the smaller the increase; the medium point is at 4 ports with a bonus of approx. 1.9. The bonus is an example of [[wikipedia:Hyperbolic_growth|hyperbolic decay]].

<math>\text{bonus} = 1 + 2 * \frac{\text{portsOwned} - 1}{\text{portsOwned} + 4}</math>

Both the source and destination [[port]] owners receive the full amount.

Longer trade routes are more profitable (linear scaling with distance).

== See also ==
* [[Buildings]]
* [[Warship]]
* [[Trade Ship]]
* [[Transport Ship]]
[[Category:Buildings]]
[[Category:Economy]]

Map Making

2025-12-22T20:35:40Z

Tidwell: Add TsProphet94 OpenFrontMapGenerator

= Map Making =

Openfront maps are contributed by the community in the same way other source code contributions are made. If you are looking to suggest a possible map, but do not wish to implement it yourself, see [https://discord.com/channels/1284581928254701718/1293201128858587207 the relevant discord channels]

[https://github.com/openfrontio/OpenFrontIO OpenfrontIO on Github]

<blockquote>

⚠️ All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.
</blockquote>
= Workflow & Tutorials =

Due to the game’s open-source nature, Map Making for OpenfrontIO is a low-barrier-of-entry way of contributing to the game in an impactful way. However, taking a map from concept to full release requires a number of steps, skills, and support from the development team.

To take a map concept from start to finish requires basic familiarity with the following tools, though none require extensive experience and can be learned as part of the process.

* Navigating and running applications from the command line.
* Graphics editing software
* Basic code-editing skills for modifying config files & adding license attribution
* GIT version control (this can be via command line, or any of the many GIT GUI tools)
* github pull request process

If you are already familiar with software development workflows, [https://github.com/openfrontio/OpenFrontIO/tree/main/map-generator The map-generator readme is a good starting point]

For a broader understanding of the specific workflow, the following guides summarize the process well:

* [https://discord.com/channels/1359946986937258015/1361003022074904743/1361003022074904743 aPuddle (public, updated v25)]
* [https://www.youtube.com/watch?v=Z5CqjsW5OIA Evan Video (youtube, updated v22?)]
* [https://discord.com/channels/1359946986937258015/1435011107461927046/1435011107461927046 Nikola123 (dev discord, updated v26)]
= Gameplay Impact from Map Design =

* In-game, [[Terrain]] affects '''Pathfinding''' (where units go) and '''[[Combat]] Resolution''' (how fast they conquer and how many die). Attacks naturally flow around mountains through plains unless forced otherwise.
* Oceans, Rivers, and Lakes can impact [[Annexation]] requirements.
* [[Nations]] placement impacts overall spawn position and early / mid-game gameplay.
* '''As of v28 nation strength is no longer included in map files and nation balance is not part of the map making process'''
= Color Tools =

== Color Palette XLS ==
A spreadsheet of the input -> output color mapping ranges for terrain (color)
* [https://cdn.discordapp.com/attachments/1435011107461927046/1435011247769915393/OpenFront_Map_Color_Palette_Explained.xlsx?ex=6948605e&is=69470ede&hm=0981f00062017860a8fb0d33e87ac3a5239ebb5c5e8139d25e22ab2db48105c4& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for GIMP ==
A GIMP color palette of the terrain colors from the previous XLS (.gpl)
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004028779167925/OpenFront_Terrain_Indexed.gpl?ex=694815c6&is=6946c446&hm=003a82c8e37f398a88e91e937463e62d9fba83a88c22bd56891e26b7d2f8a031& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for Photoshop ==
The same color palette as an Adobe Color Swatch file (.aco)
* [https://drive.google.com/file/d/1I7ZbDDjs_x5oy5-8ZorX_6rhgSSkfgaK Google Drive]
* Author: Unknown
* Version: v28

== Windows Powershell (B&W -> Colorize) ==
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004182290698260/coloriseMap.ps1?ex=694815eb&is=6946c46b&hm=70931a860b282a235966c109f882d776c2e1c8c4662ae143ffcdb41b81156a00& Discord CDN]
* Author: aPuddle
* Version: Unknown

= Unofficial Applications =

'''Note that some of these projects may be work in progress, incomplete, or abandoned. '''

== OpenFrontMapGenerator ==
A complete automated workflow for generating game-ready terrain maps from real-world data using QGIS and Python.

* [https://github.com/TsProphet94/OpenFrontMapGenerator Github]
* Author: TsProphet94
* Version: v28

== TheFiraffe3 Map Editor ==
* [https://thegiraffe3.github.io/OFmapeditor/ GitHub Pages]
* Author: TheGiraffe3
* Version: Unknown
* Source: [https://github.com/TheGiraffe3/OFmapeditor GitHub]

== Map Editor ==
Map editor that can be used to adjust nation placement. Note that you have to re-download the json after, and then remove the additional data that the map editor added (alongside regular formatting). There are also quite a few bugs, and it can mangle Nation flags. Always back up your files when using.

* [https://openfront-map-editor.netlify.app/ Netlify]
* Author: Unknown
* Version: Unknown
== Flag Standardizer ==
* [https://openfront-flag-standardizer.netlify.app/ Netlify]
* Author: N0ur (?)
* Version: Unknown
= Map Sources =

The [https://github.com/openfrontio/OpenFrontIO/blob/main/CREDITS.md CREDITS.md file in the Openfront Repo] shows all the existing sources that have been used for the game. Many of these data sources provide other maps with the same licenses.

== World Map ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: Openfront
* Version: v28

== World Map Recolor tiff ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: aPuddle
* Version: v28

Map Making

2025-12-21T02:21:00Z

Tidwell: formatting and typos

= Map Making =

Openfront maps are contributed by the community in the same way other source code contributions are made. If you are looking to suggest a possible map, but do not wish to implement it yourself, see [https://discord.com/channels/1284581928254701718/1293201128858587207 the relevant discord channels]

[https://github.com/openfrontio/OpenFrontIO OpenfrontIO on Github]

<blockquote>

⚠️ All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.
</blockquote>
= Workflow & Tutorials =

Due to the game’s open-source nature, Map Making for OpenfrontIO is a low-barrier-of-entry way of contributing to the game in an impactful way. However, taking a map from concept to full release requires a number of steps, skills, and support from the development team.

To take a map concept from start to finish requires basic familiarity with the following tools, though none require extensive experience and can be learned as part of the process.

* Navigating and running applications from the command line.
* Graphics editing software
* Basic code-editing skills for modifying config files & adding license attribution
* GIT version control (this can be via command line, or any of the many GIT GUI tools)
* github pull request process

If you are already familiar with software development workflows, [https://github.com/openfrontio/OpenFrontIO/tree/main/map-generator The map-generator readme is a good starting point]

For a broader understanding of the specific workflow, the following guides summarize the process well:

* [https://discord.com/channels/1359946986937258015/1361003022074904743/1361003022074904743 aPuddle (public, updated v25)]
* [https://www.youtube.com/watch?v=Z5CqjsW5OIA Evan Video (youtube, updated v22?)]
* [https://discord.com/channels/1359946986937258015/1435011107461927046/1435011107461927046 Nikola123 (dev discord, updated v26)]
= Gameplay Impact from Map Design =

* In-game, [[Terrain]] affects '''Pathfinding''' (where units go) and '''[[Combat]] Resolution''' (how fast they conquer and how many die). Attacks naturally flow around mountains through plains unless forced otherwise.
* Oceans, Rivers, and Lakes can impact [[Annexation]] requirements.
* [[Nations]] placement impacts overall spawn position and early / mid-game gameplay.
* '''As of v28 nation strength is no longer included in map files and nation balance is not part of the map making process'''
= Color Tools =

== Color Palette XLS ==
A spreadsheet of the input -> output color mapping ranges for terrain (color)
* [https://cdn.discordapp.com/attachments/1435011107461927046/1435011247769915393/OpenFront_Map_Color_Palette_Explained.xlsx?ex=6948605e&is=69470ede&hm=0981f00062017860a8fb0d33e87ac3a5239ebb5c5e8139d25e22ab2db48105c4& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for GIMP ==
A GIMP color palette of the terrain colors from the previous XLS (.gpl)
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004028779167925/OpenFront_Terrain_Indexed.gpl?ex=694815c6&is=6946c446&hm=003a82c8e37f398a88e91e937463e62d9fba83a88c22bd56891e26b7d2f8a031& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for Photoshop ==
The same color palette as an Adobe Color Swatch file (.aco)
* [https://drive.google.com/file/d/1I7ZbDDjs_x5oy5-8ZorX_6rhgSSkfgaK Google Drive]
* Author: Unknown
* Version: v28

== Windows Powershell (B&W -> Colorize) ==
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004182290698260/coloriseMap.ps1?ex=694815eb&is=6946c46b&hm=70931a860b282a235966c109f882d776c2e1c8c4662ae143ffcdb41b81156a00& Discord CDN]
* Author: aPuddle
* Version: Unknown
= Unofficial Applications =

'''Note that some of these projects may be work in progress, incomplete, or abandoned. '''

== TheFiraffe3 Map Editor ==
* [https://thegiraffe3.github.io/OFmapeditor/ GitHub Pages]
* Author: TheGiraffe3
* Version: Unknown
* Source: [https://github.com/TheGiraffe3/OFmapeditor GitHub]

== Map Editor ==
Map editor that can be used to adjust nation placement. Note that you have to re-download the json after, and then remove the additional data that the map editor added (alongside regular formatting). There are also quite a few bugs, and it can mangle Nation flags. Always back up your files when using.

* [https://openfront-map-editor.netlify.app/ Netlify]
* Author: Unknown
* Version: Unknown
== Flag Standardizer ==
* [https://openfront-flag-standardizer.netlify.app/ Netlify]
* Author: N0ur (?)
* Version: Unknown
= Map Sources =

The [https://github.com/openfrontio/OpenFrontIO/blob/main/CREDITS.md CREDITS.md file in the Openfront Repo] shows all the existing sources that have been used for the game. Many of these data sources provide other maps with the same licenses.

== World Map ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: Openfront
* Version: v28

== World Map Recolor tiff ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: aPuddle
* Version: v28

Map Making

2025-12-21T02:16:10Z

Tidwell: Created page with " = Map Making = Openfront maps are contributed by the community in the same way other source code contrbutations are made. If you are looking to suggest a possible map, but do not wish to implement it yourself, see [https://discord.com/channels/1284581928254701718/1293201128858587207 the relevant discord channels] [https://github.com/openfrontio/OpenFrontIO OpenfrontIO on Github] <blockquote> ⚠️ All software linked below is community-created and not official in a..."

= Map Making =

Openfront maps are contributed by the community in the same way other source code contrbutations are made. If you are looking to suggest a possible map, but do not wish to implement it yourself, see [https://discord.com/channels/1284581928254701718/1293201128858587207 the relevant discord channels]

[https://github.com/openfrontio/OpenFrontIO OpenfrontIO on Github]

<blockquote>
⚠️ All software linked below is community-created and not official in any capacity. Use at your own risk. Always review any code you download before running it.
</blockquote>

= Workflow & Tutorials =

Due to the game’s open-source nature, Map Making for OpenfrontIO is a low-barrier-of-entry way of contributing to the game in an impactful way. However, taking a map from concept to full release requires a number of steps, skills, and support from the development team.

To take a map concept from start to finish requires basic familiarity with the following tools, though none require extensive experience and can be learned as part of the process.

* Navigating and running applications from the command line.
* Graphics editing software
* Basic code-editing skills for modifying config files & adding license attribution
* GIT version control (this can be via command line, or any of the many GIT GUI tools)
* github pull request process

If you are already familiar with software development workflows, [https://github.com/openfrontio/OpenFrontIO/tree/main/map-generator The map-generator readme is a good starting point]

For a broader understanding of the specific workflow, the following guides summarize the process well:

* [https://discord.com/channels/1359946986937258015/1361003022074904743/1361003022074904743 aPuddle (public, updated v25)]
* [https://www.youtube.com/watch?v=Z5CqjsW5OIA Evan Video (youtube, updated v22?)]
* [https://discord.com/channels/1359946986937258015/1435011107461927046/1435011107461927046 Nikola123 (dev discord, updated v26)]

= Gameplay Impact from Map Design =

* In-game, [[Terrain]] affects '''Pathfinding''' (where units go) and '''[[Combat]] Resolution''' (how fast they conquer and how many die). Attacks naturally flow around mountains through plains unless forced otherwise.
* Oceans, Rivers, and Lakes can impact [[Annexation]] requirements.
* [[Nations]] placement impacts overall spawn position and early / mid-game gameplay.
* '''As of v28 nation strength is no longer included in map files and nation balance is not part of the map making process'''

= Color Tools =

== Color Palette XLS ==
A spreadsheet of the input -> output color mapping ranges for terrain (color)
* [https://cdn.discordapp.com/attachments/1435011107461927046/1435011247769915393/OpenFront_Map_Color_Palette_Explained.xlsx?ex=6948605e&is=69470ede&hm=0981f00062017860a8fb0d33e87ac3a5239ebb5c5e8139d25e22ab2db48105c4& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for GIMP ==
A GIMP color palette of the terrain colors from the previous XLS (.gpl)
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004028779167925/OpenFront_Terrain_Indexed.gpl?ex=694815c6&is=6946c446&hm=003a82c8e37f398a88e91e937463e62d9fba83a88c22bd56891e26b7d2f8a031& Discord CDN]
* Author: aPuddle
* Version: v28

== Color Palette file for Photoshop ==
The same color palette as an Adobe Color Swatch file (.aco)
* [https://drive.google.com/file/d/1I7ZbDDjs_x5oy5-8ZorX_6rhgSSkfgaK Google Drive]
* Author: Unknown
* Version: v28

== Windows Powershell (B&W -> Colorize) ==
* [https://cdn.discordapp.com/attachments/1361003022074904743/1361004182290698260/coloriseMap.ps1?ex=694815eb&is=6946c46b&hm=70931a860b282a235966c109f882d776c2e1c8c4662ae143ffcdb41b81156a00& Discord CDN]
* Author: aPuddle
* Version: Unknown

= Unofficial Applications =

'''Note that some of these projects may be work in progress, incomplete, or abandoned. '''

== TheFiraffe3 Map Editor ==
* [https://thegiraffe3.github.io/OFmapeditor/ GitHub Pages]
* Author: TheGiraffe3
* Version: Unknown
* Source: [https://github.com/TheGiraffe3/OFmapeditor GitHub]

== Map Editor ==
Map editor that can be used to adjust nation placement. Note that you have to re-download the json after, and then remove the additional data that the map editor added (alongside regular formatting). There are also quite a few bugs, and it can mangle Nation flags. Always back up your files when using.

* [https://openfront-map-editor.netlify.app/ Netlify]
* Author: Unknown
* Version: Unknown

== Flag Standardizer ==
* [https://openfront-flag-standardizer.netlify.app/ Netlify]
* Author: N0ur (?)
* Version: Unknown

= Map Sources =

The [https://github.com/openfrontio/OpenFrontIO/blob/main/CREDITS.md CREDITS.md file in the Openfront Repo] shows all the existing sources that have been used for the game. Many of these data sources provide other maps with the same licenses.

== World Map ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: Openfront
* Version: v28

== World Map Recolor tiff ==
* [https://drive.google.com/file/d/1W2oMPj1L5zWRyPhh8LfmnY3_kve-FBR2/view?usp=sharing Google Drive]
* Author: aPuddle
* Version: v28