From cb5a754a61fbf9be2ca90d0ddd9a81b04cdeb619 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 12 May 2024 18:59:36 +0200
Subject: [PATCH 01/68] gamestate: Map class to store terrain and pathfinder.

---
 libopenage/gamestate/CMakeLists.txt |  1 +
 libopenage/gamestate/map.cpp        | 35 ++++++++++++++
 libopenage/gamestate/map.h          | 74 +++++++++++++++++++++++++++++
 3 files changed, 110 insertions(+)
 create mode 100644 libopenage/gamestate/map.cpp
 create mode 100644 libopenage/gamestate/map.h

diff --git a/libopenage/gamestate/CMakeLists.txt b/libopenage/gamestate/CMakeLists.txt
index a94cd93514..3f0b57bf6b 100644
--- a/libopenage/gamestate/CMakeLists.txt
+++ b/libopenage/gamestate/CMakeLists.txt
@@ -5,6 +5,7 @@ add_sources(libopenage
     game_state.cpp
 	game.cpp
 	manager.cpp
+    map.cpp
 	player.cpp
     simulation.cpp
 	terrain_chunk.cpp
diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
new file mode 100644
index 0000000000..9561e599ac
--- /dev/null
+++ b/libopenage/gamestate/map.cpp
@@ -0,0 +1,35 @@
+// Copyright 2024-2024 the openage authors. See copying.md for legal info.
+
+#include "map.h"
+
+#include "gamestate/terrain.h"
+#include "pathfinding/pathfinder.h"
+
+
+namespace openage::gamestate {
+Map::Map(const std::shared_ptr<Terrain> &terrain) :
+	terrain{terrain},
+	pathfinder{std::make_shared<path::Pathfinder>()} {
+	// TODO: Initialize pathfinder with terrain path costs
+}
+
+Map::Map(const std::shared_ptr<Terrain> &terrain,
+         const std::shared_ptr<path::Pathfinder> &pathfinder) :
+	terrain{terrain},
+	pathfinder{pathfinder} {
+	// TODO: Initialize pathfinder with terrain path costs
+}
+
+const util::Vector2s &Map::get_size() const {
+	return this->terrain->get_size();
+}
+
+const std::shared_ptr<Terrain> &Map::get_terrain() const {
+	return this->terrain;
+}
+
+const std::shared_ptr<path::Pathfinder> &Map::get_pathfinder() const {
+	return this->pathfinder;
+}
+
+} // namespace openage::gamestate
diff --git a/libopenage/gamestate/map.h b/libopenage/gamestate/map.h
new file mode 100644
index 0000000000..78a79e9d67
--- /dev/null
+++ b/libopenage/gamestate/map.h
@@ -0,0 +1,74 @@
+// Copyright 2024-2024 the openage authors. See copying.md for legal info.
+
+#pragma once
+
+#include <memory>
+
+#include "util/vector.h"
+
+
+namespace openage {
+namespace path {
+class Pathfinder;
+} // namespace path
+
+namespace gamestate {
+class Terrain;
+
+class Map {
+public:
+	/**
+	 * Create a new map from existing terrain.
+	 *
+	 * Initializes the pathfinder with the terrain path costs.
+	 *
+	 * @param terrain Terrain object.
+	 */
+	Map(const std::shared_ptr<Terrain> &terrain);
+
+	/**
+	 * Create a new map from existing terrain and pathfinder.
+	 *
+	 * @param terrain Terrain.
+	 * @param pathfinder Pathfinder.
+	 */
+	Map(const std::shared_ptr<Terrain> &terrain,
+	    const std::shared_ptr<path::Pathfinder> &pathfinder);
+
+	~Map() = default;
+
+	/**
+	 * Get the size of the map.
+	 *
+	 * @return Map size (width x height).
+	 */
+	const util::Vector2s &get_size() const;
+
+	/**
+	 * Get the terrain of the map.
+	 *
+	 * @return Terrain.
+	 */
+	const std::shared_ptr<Terrain> &get_terrain() const;
+
+	/**
+	 * Get the pathfinder for the map.
+	 *
+	 * @return Pathfinder.
+	 */
+	const std::shared_ptr<path::Pathfinder> &get_pathfinder() const;
+
+private:
+	/**
+	 * Terrain.
+	 */
+	std::shared_ptr<Terrain> terrain;
+
+	/**
+	 * Pathfinder.
+	 */
+	std::shared_ptr<path::Pathfinder> pathfinder;
+};
+
+} // namespace gamestate
+} // namespace openage

From 7584db49829b4a2f4b8195f676c3b0c88804c8ed Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 12 May 2024 19:00:16 +0200
Subject: [PATCH 02/68] gamestate: Verify terrain chunk size.

---
 libopenage/gamestate/terrain.cpp | 67 +++++++++++++++++++++++++++++++-
 libopenage/gamestate/terrain.h   | 50 ++++++++++++++++++++++--
 2 files changed, 113 insertions(+), 4 deletions(-)

diff --git a/libopenage/gamestate/terrain.cpp b/libopenage/gamestate/terrain.cpp
index 9e40230ffe..b29a2fe541 100644
--- a/libopenage/gamestate/terrain.cpp
+++ b/libopenage/gamestate/terrain.cpp
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 the openage authors. See copying.md for legal info.
+// Copyright 2018-2024 the openage authors. See copying.md for legal info.
 
 #include "terrain.h"
 
@@ -6,6 +6,8 @@
 #include <array>
 #include <cstddef>
 
+#include "error/error.h"
+
 #include "gamestate/terrain_chunk.h"
 #include "renderer/render_factory.h"
 
@@ -18,6 +20,59 @@ Terrain::Terrain() :
 	// TODO: Get actual size of terrain.
 }
 
+Terrain::Terrain(const util::Vector2s &size,
+                 const std::vector<std::shared_ptr<TerrainChunk>> &&chunks) :
+	size{size},
+	chunks{std::move(chunks)} {
+	// Check if chunk is correct
+	coord::tile_delta current_offset{0, 0};
+	util::Vector2s all_chunks_size{0, 0};
+	if (this->chunks.size() > 0) {
+		all_chunks_size = this->chunks[0]->get_size();
+	}
+
+	for (const auto &chunk : this->chunks) {
+		auto chunk_size = chunk->get_size();
+		current_offset.ne += chunk_size[0];
+
+		// Wrap around to the next row
+		if (current_offset.ne == size[0]) {
+			current_offset.ne = 0;
+			current_offset.se += chunk_size[1];
+		}
+
+		// Check terrain boundaries
+		if (current_offset.ne > size[0]) {
+			throw error::Error{ERR << "Width of chunk " << chunk->get_offset()
+			                       << " exceeds terrain width: " << chunk_size[0]
+			                       << " (max width: " << size[0] << ")"};
+		}
+		else if (current_offset.se > size[1]) {
+			throw error::Error{ERR << "Height of chunk " << chunk->get_offset()
+			                       << " exceeds terrain height: " << chunk_size[1]
+			                       << " (max height: " << size[1] << ")"};
+		}
+		// Check if chunk size is correct
+		else if (chunk_size != chunk_size) [[unlikely]] {
+			throw error::Error{ERR << "Chunk size of chunk " << chunk->get_offset()
+			                       << " is not equal to the first chunk size: " << chunk_size
+			                       << " (expected: " << all_chunks_size << ")"};
+		}
+
+		// Check chunk delta
+		auto chunk_offset = chunk->get_offset();
+		if (current_offset != chunk_offset) [[unlikely]] {
+			throw error::Error{ERR << "Chunk offset of chunk " << chunk->get_offset()
+			                       << " does not match position in vector: " << chunk_offset
+			                       << " (expected: " << current_offset << ")"};
+		}
+	}
+}
+
+const util::Vector2s &Terrain::get_size() const {
+	return this->size;
+}
+
 void Terrain::add_chunk(const std::shared_ptr<TerrainChunk> &chunk) {
 	this->chunks.push_back(chunk);
 }
@@ -26,6 +81,16 @@ const std::vector<std::shared_ptr<TerrainChunk>> &Terrain::get_chunks() const {
 	return this->chunks;
 }
 
+const std::shared_ptr<TerrainChunk> &Terrain::get_chunk(size_t idx) const {
+	return this->chunks.at(idx);
+}
+
+const std::shared_ptr<TerrainChunk> &Terrain::get_chunk(const coord::chunk &pos) const {
+	size_t index = pos.ne + pos.se * this->size[0];
+
+	return this->get_chunk(index);
+}
+
 void Terrain::attach_renderer(const std::shared_ptr<renderer::RenderFactory> &render_factory) {
 	for (auto &chunk : this->get_chunks()) {
 		auto render_entity = render_factory->add_terrain_render_entity(chunk->get_size(),
diff --git a/libopenage/gamestate/terrain.h b/libopenage/gamestate/terrain.h
index 97ffcbdffd..0dbf6ba7dd 100644
--- a/libopenage/gamestate/terrain.h
+++ b/libopenage/gamestate/terrain.h
@@ -6,8 +6,10 @@
 #include <string>
 #include <vector>
 
+#include "coord/chunk.h"
 #include "util/vector.h"
 
+
 namespace openage {
 namespace renderer {
 class RenderFactory;
@@ -27,6 +29,13 @@ class Terrain {
 	Terrain();
 	~Terrain() = default;
 
+	/**
+	 * Get the size of the terrain (in tiles).
+	 *
+	 * @return Terrain tile size (width x height).
+	 */
+	const util::Vector2s &get_size() const;
+
 	/**
 	 * Add a chunk to the terrain.
 	 *
@@ -41,6 +50,24 @@ class Terrain {
 	 */
 	const std::vector<std::shared_ptr<TerrainChunk>> &get_chunks() const;
 
+	/**
+	 * Get a specific chunk of the terrain.
+	 *
+	 * @param idx Index of the chunk.
+	 *
+	 * @return Terrain chunk.
+	 */
+	const std::shared_ptr<TerrainChunk> &get_chunk(size_t idx) const;
+
+	/**
+	 * Get a specific chunk of the terrain.
+	 *
+	 * @param pos Position of the chunk in the terrain.
+	 *
+	 * @return Terrain chunk.
+	 */
+	const std::shared_ptr<TerrainChunk> &get_chunk(const coord::chunk &pos) const;
+
 	/**
 	 * Attach a renderer which enables graphical display.
 	 *
@@ -54,16 +81,33 @@ class Terrain {
 	 */
 	void attach_renderer(const std::shared_ptr<renderer::RenderFactory> &render_factory);
 
+protected:
+	/**
+	 * Create a new terrain.
+	 *
+	 * Chunks must conform to these constraints:
+	 *  - All chunks that are not last in a row OR columns must have the same size (width x height).
+	 *  - The last chunk in a row may have a different width.
+	 *  - The last chunk in a column may have a different height.
+	 *
+	 * @param size Total size of the terrain in tiles (width x height).
+	 * @param chunks Terrain chunks.
+	 */
+	Terrain(const util::Vector2s &size,
+	        const std::vector<std::shared_ptr<TerrainChunk>> &&chunks);
+
 private:
 	/**
-	 * Total size of the map
-	 * origin is the left corner
-	 * x = top left edge; y = top right edge
+	 * Total size of the terrain in tiles (width x height).
+	 *
+	 * Origin is the top left corner (left corner with camera projection).
 	 */
 	util::Vector2s size;
 
 	/**
 	 * Subdivision of the main terrain entity.
+	 *
+	 * Ordered in rows from left to right, top to bottom.
 	 */
 	std::vector<std::shared_ptr<TerrainChunk>> chunks;
 };

From 1ddc053ff716813ef9e8788f3607efe34b7123c3 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 12 May 2024 19:13:04 +0200
Subject: [PATCH 03/68] gamestate: Get path costs from nyan API.

---
 libopenage/gamestate/api/terrain.cpp | 16 +++++++++++++++-
 libopenage/gamestate/api/terrain.h   |  9 +++++++++
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/libopenage/gamestate/api/terrain.cpp b/libopenage/gamestate/api/terrain.cpp
index e69edee5fc..180d82425f 100644
--- a/libopenage/gamestate/api/terrain.cpp
+++ b/libopenage/gamestate/api/terrain.cpp
@@ -1,4 +1,4 @@
-// Copyright 2023-2023 the openage authors. See copying.md for legal info.
+// Copyright 2023-2024 the openage authors. See copying.md for legal info.
 
 #include "terrain.h"
 
@@ -21,4 +21,18 @@ const std::string APITerrain::get_terrain_path(const nyan::Object &terrain) {
 	return resolve_file_path(terrain, terrain_path);
 }
 
+const std::unordered_map<nyan::fqon_t, int> APITerrain::get_path_costs(const nyan::Object &terrain) {
+	std::unordered_map<nyan::fqon_t, int> result;
+
+	nyan::dict_t path_costs = terrain.get_dict("Terrain.path_costs");
+	for (const auto &pair : path_costs) {
+		auto key = std::dynamic_pointer_cast<nyan::Object>(pair.first.get_ptr());
+		auto value = std::dynamic_pointer_cast<nyan::Int>(pair.second.get_ptr());
+
+		result.emplace(key->get_name(), value->get());
+	}
+
+	return result;
+}
+
 } // namespace openage::gamestate::api
diff --git a/libopenage/gamestate/api/terrain.h b/libopenage/gamestate/api/terrain.h
index 0046a47bdc..d049bce279 100644
--- a/libopenage/gamestate/api/terrain.h
+++ b/libopenage/gamestate/api/terrain.h
@@ -30,6 +30,15 @@ class APITerrain {
 	 * @return Relative path to the terrain file.
 	 */
 	static const std::string get_terrain_path(const nyan::Object &terrain);
+
+	/**
+	 * Get the path costs of a terrain.
+	 *
+	 * @param terrain \p Terrain nyan object (type == \p engine.util.terrain.Terrain).
+	 *
+	 * @return Path costs for the cost fields of the pathfinder.
+	 */
+	static const std::unordered_map<nyan::fqon_t, int> get_path_costs(const nyan::Object &terrain);
 };
 
 } // namespace openage::gamestate::api

From c6e6c8bedf65b3e36847cb6903685d2fd51e5296 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 12 May 2024 23:50:10 +0200
Subject: [PATCH 04/68] gamestate: Generate pathfinding grids from nyan terrain
 defs.

---
 libopenage/gamestate/map.cpp           | 58 ++++++++++++++++++++++----
 libopenage/gamestate/map.h             |  9 ----
 libopenage/gamestate/terrain.cpp       | 26 +++++++++---
 libopenage/gamestate/terrain.h         | 15 +++++++
 libopenage/gamestate/terrain_chunk.cpp | 12 ++++++
 libopenage/gamestate/terrain_chunk.h   | 25 +++++++++++
 6 files changed, 123 insertions(+), 22 deletions(-)

diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
index 9561e599ac..b7a9fa6bb5 100644
--- a/libopenage/gamestate/map.cpp
+++ b/libopenage/gamestate/map.cpp
@@ -2,22 +2,66 @@
 
 #include "map.h"
 
+#include <set>
+
+#include "gamestate/api/terrain.h"
 #include "gamestate/terrain.h"
+#include "gamestate/terrain_chunk.h"
+#include "pathfinding/cost_field.h"
+#include "pathfinding/grid.h"
 #include "pathfinding/pathfinder.h"
+#include "pathfinding/sector.h"
 
 
 namespace openage::gamestate {
 Map::Map(const std::shared_ptr<Terrain> &terrain) :
 	terrain{terrain},
 	pathfinder{std::make_shared<path::Pathfinder>()} {
-	// TODO: Initialize pathfinder with terrain path costs
-}
+	// Get grid types
+	// TODO: This should probably not be dependent on the existing tiles, but
+	//       on all defined nyan PathType objects
+	std::unordered_map<nyan::fqon_t, size_t> path_types;
+	size_t grid_idx = 0;
+	auto chunk_size = this->terrain->get_chunk(0)->get_size();
+	auto side_length = std::max(chunk_size[0], chunk_size[0]);
+	util::Vector2s grid_size{this->terrain->get_row_size(), this->terrain->get_column_size()};
+	for (const auto &chunk : this->terrain->get_chunks()) {
+		for (const auto &tile : chunk->get_tiles()) {
+			if (tile.terrain != std::nullopt) {
+				auto path_costs = api::APITerrain::get_path_costs(*tile.terrain);
 
-Map::Map(const std::shared_ptr<Terrain> &terrain,
-         const std::shared_ptr<path::Pathfinder> &pathfinder) :
-	terrain{terrain},
-	pathfinder{pathfinder} {
-	// TODO: Initialize pathfinder with terrain path costs
+				for (const auto &path_cost : path_costs) {
+					if (not path_types.contains(path_cost.first)) {
+						auto grid = std::make_shared<path::Grid>(grid_idx, grid_size, side_length);
+						this->pathfinder->add_grid(grid);
+
+						path_types.emplace(path_cost.first, grid_idx);
+						grid_idx += 1;
+					}
+				}
+			}
+		}
+	}
+
+	// Set path costs
+	for (size_t chunk_idx = 0; chunk_idx < this->terrain->get_chunks().size(); ++chunk_idx) {
+		auto chunk_terrain = this->terrain->get_chunk(chunk_idx);
+		for (size_t tile_idx = 0; tile_idx < chunk_terrain->get_tiles().size(); ++tile_idx) {
+			auto tile = chunk_terrain->get_tile(tile_idx);
+			if (tile.terrain != std::nullopt) {
+				auto path_costs = api::APITerrain::get_path_costs(*tile.terrain);
+
+				for (const auto &path_cost : path_costs) {
+					auto grid_id = path_types.at(path_cost.first);
+					auto grid = this->pathfinder->get_grid(grid_id);
+
+					auto sector = grid->get_sector(chunk_idx);
+					auto cost_field = sector->get_cost_field();
+					cost_field->set_cost(tile_idx, path_cost.second);
+				}
+			}
+		}
+	}
 }
 
 const util::Vector2s &Map::get_size() const {
diff --git a/libopenage/gamestate/map.h b/libopenage/gamestate/map.h
index 78a79e9d67..b8037c13d5 100644
--- a/libopenage/gamestate/map.h
+++ b/libopenage/gamestate/map.h
@@ -26,15 +26,6 @@ class Map {
 	 */
 	Map(const std::shared_ptr<Terrain> &terrain);
 
-	/**
-	 * Create a new map from existing terrain and pathfinder.
-	 *
-	 * @param terrain Terrain.
-	 * @param pathfinder Pathfinder.
-	 */
-	Map(const std::shared_ptr<Terrain> &terrain,
-	    const std::shared_ptr<path::Pathfinder> &pathfinder);
-
 	~Map() = default;
 
 	/**
diff --git a/libopenage/gamestate/terrain.cpp b/libopenage/gamestate/terrain.cpp
index b29a2fe541..8e52aad2c5 100644
--- a/libopenage/gamestate/terrain.cpp
+++ b/libopenage/gamestate/terrain.cpp
@@ -40,6 +40,16 @@ Terrain::Terrain(const util::Vector2s &size,
 			current_offset.ne = 0;
 			current_offset.se += chunk_size[1];
 		}
+		// Check if chunk size is correct
+		else if (chunk_size != chunk_size) [[unlikely]] {
+			throw error::Error{ERR << "Chunk size of chunk " << chunk->get_offset()
+			                       << " is not equal to the first chunk size: " << chunk_size
+			                       << " (expected: " << all_chunks_size << ")"};
+		}
+		else if (chunk_size[0] != chunk_size[1]) {
+			throw error::Error{ERR << "Chunk size of chunk " << chunk->get_offset()
+			                       << " is not square: " << chunk_size};
+		}
 
 		// Check terrain boundaries
 		if (current_offset.ne > size[0]) {
@@ -52,12 +62,6 @@ Terrain::Terrain(const util::Vector2s &size,
 			                       << " exceeds terrain height: " << chunk_size[1]
 			                       << " (max height: " << size[1] << ")"};
 		}
-		// Check if chunk size is correct
-		else if (chunk_size != chunk_size) [[unlikely]] {
-			throw error::Error{ERR << "Chunk size of chunk " << chunk->get_offset()
-			                       << " is not equal to the first chunk size: " << chunk_size
-			                       << " (expected: " << all_chunks_size << ")"};
-		}
 
 		// Check chunk delta
 		auto chunk_offset = chunk->get_offset();
@@ -73,6 +77,16 @@ const util::Vector2s &Terrain::get_size() const {
 	return this->size;
 }
 
+size_t Terrain::get_row_size() const {
+	auto chunk_size = this->chunks[0]->get_size();
+	return this->size[0] / chunk_size[0];
+}
+
+size_t Terrain::get_column_size() const {
+	auto chunk_size = this->chunks[0]->get_size();
+	return this->size[1] / chunk_size[1];
+}
+
 void Terrain::add_chunk(const std::shared_ptr<TerrainChunk> &chunk) {
 	this->chunks.push_back(chunk);
 }
diff --git a/libopenage/gamestate/terrain.h b/libopenage/gamestate/terrain.h
index 0dbf6ba7dd..8e5b03159c 100644
--- a/libopenage/gamestate/terrain.h
+++ b/libopenage/gamestate/terrain.h
@@ -36,6 +36,20 @@ class Terrain {
 	 */
 	const util::Vector2s &get_size() const;
 
+	/**
+	 * Get the size of a row in the terrain.
+	 *
+	 * @return Row size (width).
+	 */
+	size_t get_row_size() const;
+
+	/**
+	 * Get the size of a column in the terrain.
+	 *
+	 * @return Column size (height).
+	 */
+	size_t get_column_size() const;
+
 	/**
 	 * Add a chunk to the terrain.
 	 *
@@ -87,6 +101,7 @@ class Terrain {
 	 *
 	 * Chunks must conform to these constraints:
 	 *  - All chunks that are not last in a row OR columns must have the same size (width x height).
+	 *  - All chunks that are not last in a row OR columns must be square (width == height).
 	 *  - The last chunk in a row may have a different width.
 	 *  - The last chunk in a column may have a different height.
 	 *
diff --git a/libopenage/gamestate/terrain_chunk.cpp b/libopenage/gamestate/terrain_chunk.cpp
index e988260333..d863db9f67 100644
--- a/libopenage/gamestate/terrain_chunk.cpp
+++ b/libopenage/gamestate/terrain_chunk.cpp
@@ -30,6 +30,18 @@ const coord::tile_delta &TerrainChunk::get_offset() const {
 	return this->offset;
 }
 
+const std::vector<TerrainTile> &TerrainChunk::get_tiles() const {
+	return this->tiles;
+}
+
+const TerrainTile &TerrainChunk::get_tile(size_t idx) const {
+	return this->tiles.at(idx);
+}
+
+const TerrainTile &TerrainChunk::get_tile(const coord::tile &pos) const {
+	return this->tiles.at(pos.ne + pos.se * this->size[0]);
+}
+
 void TerrainChunk::render_update(const time::time_t &time) {
 	if (this->render_entity != nullptr) {
 		// TODO: Update individual tiles instead of the whole chunk
diff --git a/libopenage/gamestate/terrain_chunk.h b/libopenage/gamestate/terrain_chunk.h
index 684d3af357..574e63da4d 100644
--- a/libopenage/gamestate/terrain_chunk.h
+++ b/libopenage/gamestate/terrain_chunk.h
@@ -48,6 +48,31 @@ class TerrainChunk {
 	 */
 	const coord::tile_delta &get_offset() const;
 
+	/**
+	 * Get the tiles of this terrain chunk.
+	 *
+	 * @return Terrain tiles.
+	 */
+	const std::vector<TerrainTile> &get_tiles() const;
+
+	/**
+	 * Get the tile at the given index.
+	 *
+	 * @param idx Index of the tile.
+	 *
+	 * @return Terrain tile.
+	 */
+	const TerrainTile &get_tile(size_t idx) const;
+
+	/**
+	 * Get the tile at the given position.
+	 *
+	 * @param pos Position of the tile.
+	 *
+	 * @return Terrain tile.
+	 */
+	const TerrainTile &get_tile(const coord::tile &pos) const;
+
 	/**
 	 * Update the render entity.
 	 *

From 3d24ca4e1ab071c21c93d45562f99564ac487fa9 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 13 May 2024 00:45:27 +0200
Subject: [PATCH 05/68] gamestate: Fix nyan object value pointer cast.

---
 libopenage/gamestate/api/terrain.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libopenage/gamestate/api/terrain.cpp b/libopenage/gamestate/api/terrain.cpp
index 180d82425f..ad5e300b47 100644
--- a/libopenage/gamestate/api/terrain.cpp
+++ b/libopenage/gamestate/api/terrain.cpp
@@ -26,7 +26,7 @@ const std::unordered_map<nyan::fqon_t, int> APITerrain::get_path_costs(const nya
 
 	nyan::dict_t path_costs = terrain.get_dict("Terrain.path_costs");
 	for (const auto &pair : path_costs) {
-		auto key = std::dynamic_pointer_cast<nyan::Object>(pair.first.get_ptr());
+		auto key = std::dynamic_pointer_cast<nyan::ObjectValue>(pair.first.get_ptr());
 		auto value = std::dynamic_pointer_cast<nyan::Int>(pair.second.get_ptr());
 
 		result.emplace(key->get_name(), value->get());

From cdf83d848dba0006e523be2e5735244124bb4d28 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 13 May 2024 00:46:12 +0200
Subject: [PATCH 06/68] gamestate: Add map to state.

---
 libopenage/gamestate/game.cpp            | 16 +++++++---------
 libopenage/gamestate/game_state.cpp      | 10 +++++-----
 libopenage/gamestate/game_state.h        | 18 +++++++++---------
 libopenage/gamestate/terrain_factory.cpp |  5 +++--
 libopenage/gamestate/terrain_factory.h   |  3 ++-
 5 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/libopenage/gamestate/game.cpp b/libopenage/gamestate/game.cpp
index 8e3497bfbc..db50f8cc72 100644
--- a/libopenage/gamestate/game.cpp
+++ b/libopenage/gamestate/game.cpp
@@ -1,4 +1,4 @@
-// Copyright 2018-2023 the openage authors. See copying.md for legal info.
+// Copyright 2018-2024 the openage authors. See copying.md for legal info.
 
 #include "game.h"
 
@@ -13,6 +13,7 @@
 #include "assets/modpack.h"
 #include "gamestate/entity_factory.h"
 #include "gamestate/game_state.h"
+#include "gamestate/map.h"
 #include "gamestate/terrain.h"
 #include "gamestate/terrain_factory.h"
 #include "gamestate/universe.h"
@@ -53,7 +54,7 @@ const std::shared_ptr<GameState> &Game::get_state() const {
 
 void Game::attach_renderer(const std::shared_ptr<renderer::RenderFactory> &render_factory) {
 	this->universe->attach_renderer(render_factory);
-	this->state->get_terrain()->attach_renderer(render_factory);
+	this->state->get_map()->get_terrain()->attach_renderer(render_factory);
 }
 
 void Game::load_data(const std::shared_ptr<assets::ModManager> &mod_manager) {
@@ -127,8 +128,6 @@ void Game::load_path(const util::Path &base_dir,
 }
 
 void Game::generate_terrain(const std::shared_ptr<TerrainFactory> &terrain_factory) {
-	auto terrain = terrain_factory->add_terrain();
-
 	auto chunk0 = terrain_factory->add_chunk(this->state,
 	                                         util::Vector2s{10, 10},
 	                                         coord::tile_delta{0, 0});
@@ -141,12 +140,11 @@ void Game::generate_terrain(const std::shared_ptr<TerrainFactory> &terrain_facto
 	auto chunk3 = terrain_factory->add_chunk(this->state,
 	                                         util::Vector2s{10, 10},
 	                                         coord::tile_delta{10, 10});
-	terrain->add_chunk(chunk0);
-	terrain->add_chunk(chunk1);
-	terrain->add_chunk(chunk2);
-	terrain->add_chunk(chunk3);
 
-	this->state->set_terrain(terrain);
+	auto terrain = terrain_factory->add_terrain({20, 20}, {chunk0, chunk1, chunk2, chunk3});
+
+	auto map = std::make_shared<Map>(terrain);
+	this->state->set_map(map);
 }
 
 } // namespace openage::gamestate
diff --git a/libopenage/gamestate/game_state.cpp b/libopenage/gamestate/game_state.cpp
index 9de7c69bff..4bf0aaa348 100644
--- a/libopenage/gamestate/game_state.cpp
+++ b/libopenage/gamestate/game_state.cpp
@@ -1,4 +1,4 @@
-// Copyright 2023-2023 the openage authors. See copying.md for legal info.
+// Copyright 2023-2024 the openage authors. See copying.md for legal info.
 
 #include "game_state.h"
 
@@ -37,8 +37,8 @@ void GameState::add_player(const std::shared_ptr<Player> &player) {
 	this->players[player->get_id()] = player;
 }
 
-void GameState::set_terrain(const std::shared_ptr<Terrain> &terrain) {
-	this->terrain = terrain;
+void GameState::set_map(const std::shared_ptr<Map> &map) {
+	this->map = map;
 }
 
 const std::shared_ptr<GameEntity> &GameState::get_game_entity(entity_id_t id) const {
@@ -59,8 +59,8 @@ const std::shared_ptr<Player> &GameState::get_player(player_id_t id) const {
 	return this->players.at(id);
 }
 
-const std::shared_ptr<Terrain> &GameState::get_terrain() const {
-	return this->terrain;
+const std::shared_ptr<Map> &GameState::get_map() const {
+	return this->map;
 }
 
 const std::shared_ptr<assets::ModManager> &GameState::get_mod_manager() const {
diff --git a/libopenage/gamestate/game_state.h b/libopenage/gamestate/game_state.h
index bf1531bd55..98cdbc187a 100644
--- a/libopenage/gamestate/game_state.h
+++ b/libopenage/gamestate/game_state.h
@@ -26,8 +26,8 @@ class EventLoop;
 
 namespace gamestate {
 class GameEntity;
+class Map;
 class Player;
-class Terrain;
 
 /**
  * State of the game.
@@ -70,11 +70,11 @@ class GameState : public openage::event::State {
 	void add_player(const std::shared_ptr<Player> &player);
 
 	/**
-	 * Set the terrain of the current game.
+	 * Set the map of the current game.
 	 *
-	 * @param terrain Terrain object.
+	 * @param terrain Map object.
 	 */
-	void set_terrain(const std::shared_ptr<Terrain> &terrain);
+	void set_map(const std::shared_ptr<Map> &map);
 
 	/**
 	 * Get a game entity by its ID.
@@ -102,11 +102,11 @@ class GameState : public openage::event::State {
 	const std::shared_ptr<Player> &get_player(player_id_t id) const;
 
 	/**
-	 * Get the terrain of the current game.
+	 * Get the map of the current game.
 	 *
-	 * @return Terrain object.
+	 * @return Map object.
 	 */
-	const std::shared_ptr<Terrain> &get_terrain() const;
+	const std::shared_ptr<Map> &get_map() const;
 
 	/**
 	 * TODO: Only for testing.
@@ -131,9 +131,9 @@ class GameState : public openage::event::State {
 	std::unordered_map<player_id_t, std::shared_ptr<Player>> players;
 
 	/**
-	 * Terrain of the current game.
+	 * Map of the current game.
 	 */
-	std::shared_ptr<Terrain> terrain;
+	std::shared_ptr<Map> map;
 
 	/**
 	 * TODO: Only for testing
diff --git a/libopenage/gamestate/terrain_factory.cpp b/libopenage/gamestate/terrain_factory.cpp
index 17b5d452cb..55c70b34cf 100644
--- a/libopenage/gamestate/terrain_factory.cpp
+++ b/libopenage/gamestate/terrain_factory.cpp
@@ -170,9 +170,10 @@ static const std::vector<std::array<size_t, 100>> layout_chunks{
 };
 
 
-std::shared_ptr<Terrain> TerrainFactory::add_terrain() {
+std::shared_ptr<Terrain> TerrainFactory::add_terrain(const util::Vector2s &size,
+                                                     std::vector<std::shared_ptr<TerrainChunk>> &&chunks) {
 	// TODO: Replace this with a proper terrain generator.
-	auto terrain = std::make_shared<Terrain>();
+	auto terrain = std::make_shared<Terrain>(size, std::move(chunks));
 
 	return terrain;
 }
diff --git a/libopenage/gamestate/terrain_factory.h b/libopenage/gamestate/terrain_factory.h
index ab419acc30..f5ce40b283 100644
--- a/libopenage/gamestate/terrain_factory.h
+++ b/libopenage/gamestate/terrain_factory.h
@@ -36,7 +36,8 @@ class TerrainFactory {
 	 *
 	 * @return New terrain object.
 	 */
-	std::shared_ptr<Terrain> add_terrain();
+	std::shared_ptr<Terrain> add_terrain(const util::Vector2s &size,
+	                                     std::vector<std::shared_ptr<TerrainChunk>> &&chunks);
 
 	/**
 	 * Create a new empty terrain chunk.

From 94e1afb2c799873b9827f21bbc3db99f351ad27d Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 13 May 2024 00:46:33 +0200
Subject: [PATCH 07/68] gamestate: Fix access of Terrain constructor.

---
 libopenage/gamestate/terrain.cpp | 19 ++++++++++---------
 libopenage/gamestate/terrain.h   | 31 +++++++++++++++----------------
 2 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/libopenage/gamestate/terrain.cpp b/libopenage/gamestate/terrain.cpp
index 8e52aad2c5..8625c0b727 100644
--- a/libopenage/gamestate/terrain.cpp
+++ b/libopenage/gamestate/terrain.cpp
@@ -21,7 +21,7 @@ Terrain::Terrain() :
 }
 
 Terrain::Terrain(const util::Vector2s &size,
-                 const std::vector<std::shared_ptr<TerrainChunk>> &&chunks) :
+                 std::vector<std::shared_ptr<TerrainChunk>> &&chunks) :
 	size{size},
 	chunks{std::move(chunks)} {
 	// Check if chunk is correct
@@ -33,6 +33,15 @@ Terrain::Terrain(const util::Vector2s &size,
 
 	for (const auto &chunk : this->chunks) {
 		auto chunk_size = chunk->get_size();
+
+		// Check chunk delta
+		auto chunk_offset = chunk->get_offset();
+		if (current_offset != chunk_offset) [[unlikely]] {
+			throw error::Error{ERR << "Chunk offset of chunk " << chunk->get_offset()
+			                       << " does not match position in vector: " << chunk_offset
+			                       << " (expected: " << current_offset << ")"};
+		}
+
 		current_offset.ne += chunk_size[0];
 
 		// Wrap around to the next row
@@ -62,14 +71,6 @@ Terrain::Terrain(const util::Vector2s &size,
 			                       << " exceeds terrain height: " << chunk_size[1]
 			                       << " (max height: " << size[1] << ")"};
 		}
-
-		// Check chunk delta
-		auto chunk_offset = chunk->get_offset();
-		if (current_offset != chunk_offset) [[unlikely]] {
-			throw error::Error{ERR << "Chunk offset of chunk " << chunk->get_offset()
-			                       << " does not match position in vector: " << chunk_offset
-			                       << " (expected: " << current_offset << ")"};
-		}
 	}
 }
 
diff --git a/libopenage/gamestate/terrain.h b/libopenage/gamestate/terrain.h
index 8e5b03159c..1a5db1bf95 100644
--- a/libopenage/gamestate/terrain.h
+++ b/libopenage/gamestate/terrain.h
@@ -29,6 +29,21 @@ class Terrain {
 	Terrain();
 	~Terrain() = default;
 
+	/**
+	 * Create a new terrain.
+	 *
+	 * Chunks must conform to these constraints:
+	 *  - All chunks that are not last in a row OR columns must have the same size (width x height).
+	 *  - All chunks that are not last in a row OR columns must be square (width == height).
+	 *  - The last chunk in a row may have a different width.
+	 *  - The last chunk in a column may have a different height.
+	 *
+	 * @param size Total size of the terrain in tiles (width x height).
+	 * @param chunks Terrain chunks.
+	 */
+	Terrain(const util::Vector2s &size,
+	        std::vector<std::shared_ptr<TerrainChunk>> &&chunks);
+
 	/**
 	 * Get the size of the terrain (in tiles).
 	 *
@@ -95,22 +110,6 @@ class Terrain {
 	 */
 	void attach_renderer(const std::shared_ptr<renderer::RenderFactory> &render_factory);
 
-protected:
-	/**
-	 * Create a new terrain.
-	 *
-	 * Chunks must conform to these constraints:
-	 *  - All chunks that are not last in a row OR columns must have the same size (width x height).
-	 *  - All chunks that are not last in a row OR columns must be square (width == height).
-	 *  - The last chunk in a row may have a different width.
-	 *  - The last chunk in a column may have a different height.
-	 *
-	 * @param size Total size of the terrain in tiles (width x height).
-	 * @param chunks Terrain chunks.
-	 */
-	Terrain(const util::Vector2s &size,
-	        const std::vector<std::shared_ptr<TerrainChunk>> &&chunks);
-
 private:
 	/**
 	 * Total size of the terrain in tiles (width x height).

From 6d2a2006e7d97279eb28a12f9f5024a8d1f42e9b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 20 May 2024 03:44:59 +0200
Subject: [PATCH 08/68] gamestate: Connect portals in pathfinder grid.

---
 libopenage/gamestate/map.cpp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
index b7a9fa6bb5..a21a96a01f 100644
--- a/libopenage/gamestate/map.cpp
+++ b/libopenage/gamestate/map.cpp
@@ -62,6 +62,12 @@ Map::Map(const std::shared_ptr<Terrain> &terrain) :
 			}
 		}
 	}
+
+	// Connect sectors with portals
+	for (const auto &path_type : path_types) {
+		auto grid = this->pathfinder->get_grid(path_type.second);
+		grid->init_portals();
+	}
 }
 
 const util::Vector2s &Map::get_size() const {

From ae363878fbf669f9b98c6be423865e2d62de190f Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 20 May 2024 04:38:24 +0200
Subject: [PATCH 09/68] gamestate: Record mapping of nyan path grid -> grid ID.

---
 libopenage/gamestate/map.cpp | 18 +++++++++++-------
 libopenage/gamestate/map.h   | 18 ++++++++++++++++++
 2 files changed, 29 insertions(+), 7 deletions(-)

diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
index a21a96a01f..dbe460ca36 100644
--- a/libopenage/gamestate/map.cpp
+++ b/libopenage/gamestate/map.cpp
@@ -2,7 +2,7 @@
 
 #include "map.h"
 
-#include <set>
+#include <nyan/nyan.h>
 
 #include "gamestate/api/terrain.h"
 #include "gamestate/terrain.h"
@@ -16,11 +16,11 @@
 namespace openage::gamestate {
 Map::Map(const std::shared_ptr<Terrain> &terrain) :
 	terrain{terrain},
-	pathfinder{std::make_shared<path::Pathfinder>()} {
+	pathfinder{std::make_shared<path::Pathfinder>()},
+	grid_lookup{} {
 	// Get grid types
 	// TODO: This should probably not be dependent on the existing tiles, but
 	//       on all defined nyan PathType objects
-	std::unordered_map<nyan::fqon_t, size_t> path_types;
 	size_t grid_idx = 0;
 	auto chunk_size = this->terrain->get_chunk(0)->get_size();
 	auto side_length = std::max(chunk_size[0], chunk_size[0]);
@@ -31,11 +31,11 @@ Map::Map(const std::shared_ptr<Terrain> &terrain) :
 				auto path_costs = api::APITerrain::get_path_costs(*tile.terrain);
 
 				for (const auto &path_cost : path_costs) {
-					if (not path_types.contains(path_cost.first)) {
+					if (not this->grid_lookup.contains(path_cost.first)) {
 						auto grid = std::make_shared<path::Grid>(grid_idx, grid_size, side_length);
 						this->pathfinder->add_grid(grid);
 
-						path_types.emplace(path_cost.first, grid_idx);
+						this->grid_lookup.emplace(path_cost.first, grid_idx);
 						grid_idx += 1;
 					}
 				}
@@ -52,7 +52,7 @@ Map::Map(const std::shared_ptr<Terrain> &terrain) :
 				auto path_costs = api::APITerrain::get_path_costs(*tile.terrain);
 
 				for (const auto &path_cost : path_costs) {
-					auto grid_id = path_types.at(path_cost.first);
+					auto grid_id = this->grid_lookup.at(path_cost.first);
 					auto grid = this->pathfinder->get_grid(grid_id);
 
 					auto sector = grid->get_sector(chunk_idx);
@@ -64,7 +64,7 @@ Map::Map(const std::shared_ptr<Terrain> &terrain) :
 	}
 
 	// Connect sectors with portals
-	for (const auto &path_type : path_types) {
+	for (const auto &path_type : this->grid_lookup) {
 		auto grid = this->pathfinder->get_grid(path_type.second);
 		grid->init_portals();
 	}
@@ -82,4 +82,8 @@ const std::shared_ptr<path::Pathfinder> &Map::get_pathfinder() const {
 	return this->pathfinder;
 }
 
+path::grid_id_t Map::get_grid_id(const nyan::Object &path_grid) const {
+	return this->grid_lookup.at(path_grid.get_name());
+}
+
 } // namespace openage::gamestate
diff --git a/libopenage/gamestate/map.h b/libopenage/gamestate/map.h
index b8037c13d5..d6ac1188c1 100644
--- a/libopenage/gamestate/map.h
+++ b/libopenage/gamestate/map.h
@@ -3,7 +3,11 @@
 #pragma once
 
 #include <memory>
+#include <unordered_map>
 
+#include <nyan/nyan.h>
+
+#include "pathfinding/types.h"
 #include "util/vector.h"
 
 
@@ -49,6 +53,15 @@ class Map {
 	 */
 	const std::shared_ptr<path::Pathfinder> &get_pathfinder() const;
 
+	/**
+	 * Get the grid ID associated with a nyan path grid object.
+	 *
+	 * @param path_grid Path grid object.
+	 *
+	 * @return Grid ID.
+	 */
+	path::grid_id_t get_grid_id(const nyan::Object &path_grid) const;
+
 private:
 	/**
 	 * Terrain.
@@ -59,6 +72,11 @@ class Map {
 	 * Pathfinder.
 	 */
 	std::shared_ptr<path::Pathfinder> pathfinder;
+
+	/**
+	 * Lookup table for mapping path grid objects in nyan to grid indices.
+	 */
+	std::unordered_map<nyan::fqon_t, path::grid_id_t> grid_lookup;
 };
 
 } // namespace gamestate

From 672efb1a4a4ea1b4370cf9dd1ad08f147891f1d4 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 20 May 2024 17:51:33 +0200
Subject: [PATCH 10/68] gamestate: Use pathfinder in Move system.

---
 libopenage/gamestate/map.cpp             |   4 +-
 libopenage/gamestate/map.h               |   4 +-
 libopenage/gamestate/system/activity.cpp |  14 +--
 libopenage/gamestate/system/activity.h   |   8 +-
 libopenage/gamestate/system/move.cpp     | 121 +++++++++++++++++------
 libopenage/gamestate/system/move.h       |   5 +
 6 files changed, 113 insertions(+), 43 deletions(-)

diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
index dbe460ca36..beb02b5e8a 100644
--- a/libopenage/gamestate/map.cpp
+++ b/libopenage/gamestate/map.cpp
@@ -82,8 +82,8 @@ const std::shared_ptr<path::Pathfinder> &Map::get_pathfinder() const {
 	return this->pathfinder;
 }
 
-path::grid_id_t Map::get_grid_id(const nyan::Object &path_grid) const {
-	return this->grid_lookup.at(path_grid.get_name());
+path::grid_id_t Map::get_grid_id(const nyan::fqon_t &path_grid) const {
+	return this->grid_lookup.at(path_grid);
 }
 
 } // namespace openage::gamestate
diff --git a/libopenage/gamestate/map.h b/libopenage/gamestate/map.h
index d6ac1188c1..4033373023 100644
--- a/libopenage/gamestate/map.h
+++ b/libopenage/gamestate/map.h
@@ -56,11 +56,11 @@ class Map {
 	/**
 	 * Get the grid ID associated with a nyan path grid object.
 	 *
-	 * @param path_grid Path grid object.
+	 * @param path_grid Path grid object fqon.
 	 *
 	 * @return Grid ID.
 	 */
-	path::grid_id_t get_grid_id(const nyan::Object &path_grid) const;
+	path::grid_id_t get_grid_id(const nyan::fqon_t &path_grid) const;
 
 private:
 	/**
diff --git a/libopenage/gamestate/system/activity.cpp b/libopenage/gamestate/system/activity.cpp
index 49371fba30..7ef1d574b4 100644
--- a/libopenage/gamestate/system/activity.cpp
+++ b/libopenage/gamestate/system/activity.cpp
@@ -1,4 +1,4 @@
-// Copyright 2023-2023 the openage authors. See copying.md for legal info.
+// Copyright 2023-2024 the openage authors. See copying.md for legal info.
 
 #include "activity.h"
 
@@ -79,7 +79,7 @@ void Activity::advance(const time::time_t &start_time,
 		case activity::node_t::TASK_SYSTEM: {
 			auto node = std::static_pointer_cast<activity::TaskSystemNode>(current_node);
 			auto task = node->get_system_id();
-			event_wait_time = Activity::handle_subsystem(entity, start_time, task);
+			event_wait_time = Activity::handle_subsystem(start_time, entity, state, task);
 			auto next_id = node->get_next();
 			current_node = node->next(next_id);
 		} break;
@@ -120,18 +120,20 @@ void Activity::advance(const time::time_t &start_time,
 	activity_component->set_node(start_time, current_node);
 }
 
-const time::time_t Activity::handle_subsystem(const std::shared_ptr<gamestate::GameEntity> &entity,
-                                              const time::time_t &start_time,
+const time::time_t Activity::handle_subsystem(const time::time_t &start_time,
+                                              const std::shared_ptr<gamestate::GameEntity> &entity,
+                                              const std::shared_ptr<openage::gamestate::GameState> &state,
                                               system_id_t system_id) {
 	switch (system_id) {
 	case system_id_t::IDLE:
 		return Idle::idle(entity, start_time);
 		break;
 	case system_id_t::MOVE_COMMAND:
-		return Move::move_command(entity, start_time);
+		return Move::move_command(entity, state, start_time);
 		break;
 	case system_id_t::MOVE_DEFAULT:
-		return Move::move_default(entity, {1, 1, 1}, start_time);
+		// TODO: replace destination value with a parameter
+		return Move::move_default(entity, state, {1, 1, 1}, start_time);
 		break;
 	default:
 		throw Error{ERR << "Unhandled subsystem " << static_cast<int>(system_id)};
diff --git a/libopenage/gamestate/system/activity.h b/libopenage/gamestate/system/activity.h
index a5c38e6f49..11dcce68ca 100644
--- a/libopenage/gamestate/system/activity.h
+++ b/libopenage/gamestate/system/activity.h
@@ -40,14 +40,16 @@ class Activity {
 	/**
 	 * Run a built-in engine subsystem.
 	 *
-	 * @param entity Game entity.
 	 * @param start_time Start time of change.
+	 * @param entity Game entity.
+	 * @param state Game state.
 	 * @param system_id ID of the subsystem to run.
 	 *
 	 * @return Runtime of the change in simulation time.
 	 */
-	static const time::time_t handle_subsystem(const std::shared_ptr<gamestate::GameEntity> &entity,
-	                                           const time::time_t &start_time,
+	static const time::time_t handle_subsystem(const time::time_t &start_time,
+	                                           const std::shared_ptr<gamestate::GameEntity> &entity,
+	                                           const std::shared_ptr<openage::gamestate::GameState> &state,
 	                                           system_id_t system_id);
 };
 
diff --git a/libopenage/gamestate/system/move.cpp b/libopenage/gamestate/system/move.cpp
index 3ebd02085b..9607658ca2 100644
--- a/libopenage/gamestate/system/move.cpp
+++ b/libopenage/gamestate/system/move.cpp
@@ -1,4 +1,4 @@
-// Copyright 2023-2023 the openage authors. See copying.md for legal info.
+// Copyright 2023-2024 the openage authors. See copying.md for legal info.
 
 #include "move.h"
 
@@ -24,11 +24,52 @@
 #include "gamestate/component/internal/position.h"
 #include "gamestate/component/types.h"
 #include "gamestate/game_entity.h"
+#include "gamestate/game_state.h"
+#include "gamestate/map.h"
+#include "pathfinding/path.h"
+#include "pathfinding/pathfinder.h"
 #include "util/fixed_point.h"
 
 
 namespace openage::gamestate::system {
+
+
+std::vector<coord::phys3> find_path(const std::shared_ptr<path::Pathfinder> &pathfinder,
+                                    path::grid_id_t grid_id,
+                                    const coord::phys3 &start,
+                                    const coord::phys3 &end) {
+	auto start_tile = start.to_tile();
+	auto end_tile = end.to_tile();
+
+	// Search for a path between the start and end tiles
+	path::PathRequest request{
+		grid_id,
+		start_tile,
+		end_tile,
+	};
+	auto tile_path = pathfinder->get_path(request);
+
+	// Get the waypoints of the path
+	std::vector<coord::phys3> path;
+	path.reserve(tile_path.waypoints.size());
+
+	// Start poition is first waypoint
+	path.push_back(start);
+
+	// Pathfinder waypoints contain start and end tile; we can ignore them
+	for (size_t i = 1; i < tile_path.waypoints.size() - 1; ++i) {
+		auto tile = tile_path.waypoints.at(i);
+		path.push_back(tile.to_phys3());
+	}
+
+	// End position is last waypoint
+	path.push_back(end);
+
+	return path;
+}
+
 const time::time_t Move::move_command(const std::shared_ptr<gamestate::GameEntity> &entity,
+                                      const std::shared_ptr<openage::gamestate::GameState> &state,
                                       const time::time_t &start_time) {
 	auto command_queue = std::dynamic_pointer_cast<component::CommandQueue>(
 		entity->get_component(component::component_t::COMMANDQUEUE));
@@ -40,11 +81,12 @@ const time::time_t Move::move_command(const std::shared_ptr<gamestate::GameEntit
 		return time::time_t::from_int(0);
 	}
 
-	return Move::move_default(entity, command->get_target(), start_time);
+	return Move::move_default(entity, state, command->get_target(), start_time);
 }
 
 
 const time::time_t Move::move_default(const std::shared_ptr<gamestate::GameEntity> &entity,
+                                      const std::shared_ptr<openage::gamestate::GameState> &state,
                                       const coord::phys3 &destination,
                                       const time::time_t &start_time) {
 	if (not entity->has_component(component::component_t::MOVE)) [[unlikely]] {
@@ -61,6 +103,7 @@ const time::time_t Move::move_default(const std::shared_ptr<gamestate::GameEntit
 		entity->get_component(component::component_t::MOVE));
 	auto move_ability = move_component->get_ability();
 	auto move_speed = move_ability.get<nyan::Float>("Move.speed");
+	auto move_path_grid = move_ability.get<nyan::ObjectValue>("Move.path_type");
 
 	auto pos_component = std::dynamic_pointer_cast<component::Position>(
 		entity->get_component(component::component_t::POSITION));
@@ -70,38 +113,56 @@ const time::time_t Move::move_default(const std::shared_ptr<gamestate::GameEntit
 	auto current_pos = positions.get(start_time);
 	auto current_angle = angles.get(start_time);
 
-	// TODO: pathfinder
-	auto path = destination.to_phys2() - current_pos.to_phys2();
-	auto new_angle = path.to_angle();
-
-	// rotation
-	double turn_time = 0;
-	if (not turn_speed->is_infinite_positive()) {
-		auto angle_diff = new_angle - current_angle;
-		if (angle_diff < 0) {
-			// get the positive difference
-			angle_diff = angle_diff * -1;
-		}
-		if (angle_diff > 180) {
-			// always use the smaller angle
-			angle_diff = angle_diff - 360;
-			angle_diff = angle_diff * -1;
+	// Find path
+	auto map = state->get_map();
+	auto pathfinder = map->get_pathfinder();
+	auto grid_id = map->get_grid_id(move_path_grid->get_name());
+	auto waypoints = find_path(pathfinder, grid_id, current_pos, destination);
+
+	// use waypoints for movement
+	double total_time = 0;
+	pos_component->set_position(start_time, current_pos);
+	auto prev_angle = current_angle;
+	for (size_t i = 1; i < waypoints.size(); ++i) {
+		auto prev_waypoint = waypoints[i - 1];
+		auto cur_waypoint = waypoints[i];
+
+		auto path_vector = cur_waypoint - prev_waypoint;
+		auto path_angle = path_vector.to_angle();
+
+		// rotation
+		if (not turn_speed->is_infinite_positive()) {
+			auto angle_diff = path_angle - current_angle;
+			if (angle_diff < 0) {
+				// get the positive difference
+				angle_diff = angle_diff * -1;
+			}
+			if (angle_diff > 180) {
+				// always use the smaller angle
+				angle_diff = angle_diff - 360;
+				angle_diff = angle_diff * -1;
+			}
+
+			// Set an intermediate position keyframe to halt the game entity
+			// until the rotation is done
+			double turn_time = angle_diff.to_double() / turn_speed->get();
+			total_time += turn_time;
+			pos_component->set_position(start_time + total_time, prev_waypoint);
 		}
+		pos_component->set_angle(start_time + total_time, path_angle);
 
-		turn_time = angle_diff.to_double() / turn_speed->get();
-	}
-	pos_component->set_angle(start_time + turn_time, new_angle);
+		// movement
+		double move_time = 0;
+		if (not move_speed->is_infinite_positive()) {
+			auto distance = path_vector.length();
+			move_time = distance / move_speed->get();
+		}
+		total_time += move_time;
 
-	// movement
-	double move_time = 0;
-	if (not move_speed->is_infinite_positive()) {
-		auto distance = path.length();
-		move_time = distance / move_speed->get();
+		pos_component->set_position(start_time + total_time, cur_waypoint);
 	}
 
-	pos_component->set_position(start_time, current_pos);
-	pos_component->set_position(start_time + turn_time + move_time, destination);
-
+	// properties
 	auto ability = move_component->get_ability();
 	if (api::APIAbility::check_property(ability, api::ability_property_t::ANIMATED)) {
 		auto property = api::APIAbility::get_property(ability, api::ability_property_t::ANIMATED);
@@ -113,7 +174,7 @@ const time::time_t Move::move_default(const std::shared_ptr<gamestate::GameEntit
 		}
 	}
 
-	return turn_time + move_time;
+	return total_time;
 }
 
 } // namespace openage::gamestate::system
diff --git a/libopenage/gamestate/system/move.h b/libopenage/gamestate/system/move.h
index 7ca2dbae75..346c1c0aa6 100644
--- a/libopenage/gamestate/system/move.h
+++ b/libopenage/gamestate/system/move.h
@@ -10,6 +10,7 @@
 
 namespace openage::gamestate {
 class GameEntity;
+class GameState;
 
 namespace system {
 
@@ -19,23 +20,27 @@ class Move {
 	 * Move a game entity to a destination from a move command.
 	 *
 	 * @param entity Game entity.
+	 * @param state Game state.
 	 * @param start_time Start time of change.
 	 *
 	 * @return Runtime of the change in simulation time.
 	 */
 	static const time::time_t move_command(const std::shared_ptr<gamestate::GameEntity> &entity,
+	                                       const std::shared_ptr<openage::gamestate::GameState> &state,
 	                                       const time::time_t &start_time);
 
 	/**
 	 * Move a game entity to a destination.
 	 *
 	 * @param entity Game entity.
+	 * @param state Game state.
 	 * @param destination Destination coordinates.
 	 * @param start_time Start time of change.
 	 *
 	 * @return Runtime of the change in simulation time.
 	 */
 	static const time::time_t move_default(const std::shared_ptr<gamestate::GameEntity> &entity,
+	                                       const std::shared_ptr<openage::gamestate::GameState> &state,
 	                                       const coord::phys3 &destination,
 	                                       const time::time_t &start_time);
 };

From a2ed206989f14e88d9c204a2350daf70dfc7a26d Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Mon, 20 May 2024 22:59:56 +0200
Subject: [PATCH 11/68] path: Block diagonal flow direction if adjactent
 horizontal/vertical cells are blocked.

---
 libopenage/pathfinding/flow_field.cpp | 70 +++++++++++++++++----------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 0aa8daf84b..d8674a87f4 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -2,6 +2,8 @@
 
 #include "flow_field.h"
 
+#include <bitset>
+
 #include "error/error.h"
 #include "log/log.h"
 
@@ -76,61 +78,77 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				this->cells[idx] = this->cells[idx] | FLOW_WAVEFRONT_BLOCKED_MASK;
 			}
 
+			// Store which of the non-diagonal directions are unreachable.
+			std::bitset<4> directions_unreachable;
+
 			// Find the neighbor with the smallest cost.
 			flow_dir_t direction = static_cast<flow_dir_t>(this->cells[idx] & FLOW_DIR_MASK);
 			auto smallest_cost = INTEGRATED_COST_UNREACHABLE;
 			if (y > 0) {
 				auto cost = integrate_cells[idx - this->size].cost;
-				if (cost < smallest_cost) {
-					smallest_cost = cost;
-					direction = flow_dir_t::NORTH;
+				if (cost == INTEGRATED_COST_UNREACHABLE) {
+					directions_unreachable[0] = true;
 				}
-			}
-			if (x < this->size - 1 && y > 0) {
-				auto cost = integrate_cells[idx - this->size + 1].cost;
-				if (cost < smallest_cost) {
+				else if (cost < smallest_cost) {
 					smallest_cost = cost;
-					direction = flow_dir_t::NORTH_EAST;
+					direction = flow_dir_t::NORTH;
 				}
 			}
 			if (x < this->size - 1) {
 				auto cost = integrate_cells[idx + 1].cost;
-				if (cost < smallest_cost) {
-					smallest_cost = cost;
-					direction = flow_dir_t::EAST;
+				if (cost == INTEGRATED_COST_UNREACHABLE) {
+					directions_unreachable[1] = true;
 				}
-			}
-			if (x < this->size - 1 && y < this->size - 1) {
-				auto cost = integrate_cells[idx + this->size + 1].cost;
-				if (cost < smallest_cost) {
+				else if (cost < smallest_cost) {
 					smallest_cost = cost;
-					direction = flow_dir_t::SOUTH_EAST;
+					direction = flow_dir_t::EAST;
 				}
 			}
 			if (y < this->size - 1) {
 				auto cost = integrate_cells[idx + this->size].cost;
-				if (cost < smallest_cost) {
-					smallest_cost = cost;
-					direction = flow_dir_t::SOUTH;
+				if (cost == INTEGRATED_COST_UNREACHABLE) {
+					directions_unreachable[2] = true;
 				}
-			}
-			if (x > 0 && y < this->size - 1) {
-				auto cost = integrate_cells[idx + this->size - 1].cost;
-				if (cost < smallest_cost) {
+				else if (cost < smallest_cost) {
 					smallest_cost = cost;
-					direction = flow_dir_t::SOUTH_WEST;
+					direction = flow_dir_t::SOUTH;
 				}
 			}
 			if (x > 0) {
 				auto cost = integrate_cells[idx - 1].cost;
-				if (cost < smallest_cost) {
+				if (cost == INTEGRATED_COST_UNREACHABLE) {
+					directions_unreachable[3] = true;
+				}
+				else if (cost < smallest_cost) {
 					smallest_cost = cost;
 					direction = flow_dir_t::WEST;
 				}
 			}
+
+			if (x < this->size - 1 && y > 0) {
+				auto cost = integrate_cells[idx - this->size + 1].cost;
+				if (cost < smallest_cost and not(directions_unreachable[0] and directions_unreachable[1])) {
+					smallest_cost = cost;
+					direction = flow_dir_t::NORTH_EAST;
+				}
+			}
+			if (x < this->size - 1 && y < this->size - 1) {
+				auto cost = integrate_cells[idx + this->size + 1].cost;
+				if (cost < smallest_cost and not(directions_unreachable[1] and directions_unreachable[2])) {
+					smallest_cost = cost;
+					direction = flow_dir_t::SOUTH_EAST;
+				}
+			}
+			if (x > 0 && y < this->size - 1) {
+				auto cost = integrate_cells[idx + this->size - 1].cost;
+				if (cost < smallest_cost and not(directions_unreachable[2] and directions_unreachable[3])) {
+					smallest_cost = cost;
+					direction = flow_dir_t::SOUTH_WEST;
+				}
+			}
 			if (x > 0 && y > 0) {
 				auto cost = integrate_cells[idx - this->size - 1].cost;
-				if (cost < smallest_cost) {
+				if (cost < smallest_cost and not(directions_unreachable[3] and directions_unreachable[0])) {
 					smallest_cost = cost;
 					direction = flow_dir_t::NORTH_WEST;
 				}

From 68443c66ac52b6ad6b5be800b7e3c15b92948c37 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 00:46:12 +0200
Subject: [PATCH 12/68] path: Only use reachable start/target portal nodes for
 high-level path.

---
 libopenage/pathfinding/flow_field.cpp | 20 +++---
 libopenage/pathfinding/pathfinder.cpp | 98 +++++++++++++++++++++------
 libopenage/pathfinding/pathfinder.h   |  7 +-
 3 files changed, 94 insertions(+), 31 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index d8674a87f4..7198ae5fbe 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -125,30 +125,34 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				}
 			}
 
-			if (x < this->size - 1 && y > 0) {
+			if (x < this->size - 1 and y > 0
+			    and not(directions_unreachable[0] and directions_unreachable[1])) {
 				auto cost = integrate_cells[idx - this->size + 1].cost;
-				if (cost < smallest_cost and not(directions_unreachable[0] and directions_unreachable[1])) {
+				if (cost < smallest_cost) {
 					smallest_cost = cost;
 					direction = flow_dir_t::NORTH_EAST;
 				}
 			}
-			if (x < this->size - 1 && y < this->size - 1) {
+			if (x < this->size - 1 and y < this->size - 1
+			    and not(directions_unreachable[1] and directions_unreachable[2])) {
 				auto cost = integrate_cells[idx + this->size + 1].cost;
-				if (cost < smallest_cost and not(directions_unreachable[1] and directions_unreachable[2])) {
+				if (cost < smallest_cost) {
 					smallest_cost = cost;
 					direction = flow_dir_t::SOUTH_EAST;
 				}
 			}
-			if (x > 0 && y < this->size - 1) {
+			if (x > 0 and y < this->size - 1
+			    and not(directions_unreachable[2] and directions_unreachable[3])) {
 				auto cost = integrate_cells[idx + this->size - 1].cost;
-				if (cost < smallest_cost and not(directions_unreachable[2] and directions_unreachable[3])) {
+				if (cost < smallest_cost) {
 					smallest_cost = cost;
 					direction = flow_dir_t::SOUTH_WEST;
 				}
 			}
-			if (x > 0 && y > 0) {
+			if (x > 0 and y > 0
+			    and not(directions_unreachable[3] and directions_unreachable[0])) {
 				auto cost = integrate_cells[idx - this->size - 1].cost;
-				if (cost < smallest_cost and not(directions_unreachable[3] and directions_unreachable[0])) {
+				if (cost < smallest_cost) {
 					smallest_cost = cost;
 					direction = flow_dir_t::NORTH_WEST;
 				}
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 7e09278f7c..ca830ca075 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -5,6 +5,7 @@
 #include "coord/phys.h"
 #include "pathfinding/flow_field.h"
 #include "pathfinding/grid.h"
+#include "pathfinding/integration_field.h"
 #include "pathfinding/integrator.h"
 #include "pathfinding/portal.h"
 #include "pathfinding/sector.h"
@@ -18,31 +19,84 @@ Pathfinder::Pathfinder() :
 }
 
 const Path Pathfinder::get_path(const PathRequest &request) {
-	// High-level pathfinding
-	// Find the portals to use to get from the start to the target
-	auto portal_path = this->portal_a_star(request);
-
-	// Low-level pathfinding
-	// Find the path within the sectors
 	auto grid = this->grids.at(request.grid_id);
 	auto sector_size = grid->get_sector_size();
 
+	auto start_sector_x = request.start.ne / sector_size;
+	auto start_sector_y = request.start.se / sector_size;
+	auto start_sector = grid->get_sector(start_sector_x, start_sector_y);
+
 	auto target_sector_x = request.target.ne / sector_size;
 	auto target_sector_y = request.target.se / sector_size;
 	auto target_sector = grid->get_sector(target_sector_x, target_sector_y);
 
+	// Integrate the target field
 	coord::tile_t target_x = request.target.ne % sector_size;
 	coord::tile_t target_y = request.target.se % sector_size;
 	auto target = coord::tile{target_x, target_y};
+	auto target_integration_field = this->integrator->integrate(target_sector->get_cost_field(), target);
+
+	if (target_sector == start_sector) {
+		auto start_x = request.start.ne % sector_size;
+		auto start_y = request.start.se % sector_size;
+
+		if (target_integration_field->get_cell(coord::tile{start_x, start_y}).cost != INTEGRATED_COST_UNREACHABLE) {
+			// Exit early if the start and target are in the same sector
+			// and are reachable from within the same sector
+			auto flow_field = this->integrator->build(target_integration_field);
+			auto flow_field_waypoints = this->get_waypoints({std::make_pair(target_sector->get_id(), flow_field)}, request);
+
+			std::vector<coord::tile> waypoints{request.start};
+			waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
+			return Path{request.grid_id, waypoints};
+		}
+	}
+
+	// Check which portals are reachable from the target field
+	std::unordered_set<portal_id_t> target_portal_ids;
+	for (auto &portal : target_sector->get_portals()) {
+		auto center_cell = portal->get_entry_center(target_sector->get_id());
+
+		if (target_integration_field->get_cell(center_cell).cost != INTEGRATED_COST_UNREACHABLE) {
+			target_portal_ids.insert(portal->get_id());
+		}
+	}
+
+	// Check which portals are reachable from the start field
+	coord::tile_t start_x = request.start.ne % sector_size;
+	coord::tile_t start_y = request.start.se % sector_size;
+	auto start = coord::tile{start_x, start_y};
+	auto start_integration_field = this->integrator->integrate(start_sector->get_cost_field(), start);
+
+	std::unordered_set<portal_id_t> start_portal_ids;
+	for (auto &portal : start_sector->get_portals()) {
+		auto center_cell = portal->get_entry_center(start_sector->get_id());
+
+		if (start_integration_field->get_cell(center_cell).cost != INTEGRATED_COST_UNREACHABLE) {
+			start_portal_ids.insert(portal->get_id());
+		}
+	}
+
+	// ASDF
+
+	// High-level pathfinding
+	// Find the portals to use to get from the start to the target
+	auto portal_path = this->portal_a_star(request, target_portal_ids, start_portal_ids);
+
+	// Low-level pathfinding
+	// Find the path within the sectors
 
-	auto sector_fields = this->integrator->build(target_sector->get_cost_field(), target);
-	auto prev_integration_field = sector_fields.first;
+	// Build flow field for the target sector
+	auto prev_integration_field = target_integration_field;
+	auto prev_flow_field = this->integrator->build(prev_integration_field);
 	auto prev_sector_id = target_sector->get_id();
 
+	Integrator::build_return_t sector_fields{prev_integration_field, prev_flow_field};
+
 	std::vector<std::pair<sector_id_t, std::shared_ptr<FlowField>>> flow_fields;
 	flow_fields.reserve(portal_path.size() + 1);
-
 	flow_fields.push_back(std::make_pair(target_sector->get_id(), sector_fields.second));
+
 	for (auto &portal : portal_path) {
 		auto prev_sector = grid->get_sector(prev_sector_id);
 		auto next_sector_id = portal->get_exit_sector(prev_sector_id);
@@ -77,7 +131,9 @@ void Pathfinder::add_grid(const std::shared_ptr<Grid> &grid) {
 	this->grids[grid->get_id()] = grid;
 }
 
-const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathRequest &request) const {
+const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathRequest &request,
+                                                                     const std::unordered_set<portal_id_t> &target_portal_ids,
+                                                                     const std::unordered_set<portal_id_t> &start_portal_ids) const {
 	std::vector<std::shared_ptr<Portal>> result;
 
 	auto grid = this->grids.at(request.grid_id);
@@ -87,15 +143,6 @@ const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathR
 	auto start_sector_y = request.start.se / sector_size;
 	auto start_sector = grid->get_sector(start_sector_x, start_sector_y);
 
-	auto target_sector_x = request.target.ne / sector_size;
-	auto target_sector_y = request.target.se / sector_size;
-	auto target_sector = grid->get_sector(target_sector_x, target_sector_y);
-
-	if (start_sector == target_sector) {
-		// exit early if the start and target are in the same sector
-		return result;
-	}
-
 	// path node storage, always provides cheapest next node.
 	heap_t node_candidates;
 
@@ -106,8 +153,13 @@ const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathR
 	// TODO: Determine this cost for each portal
 	// const int distance_cost = 1;
 
-	// start nodes: all portals in the start sector
+	// create start nodes
 	for (auto &portal : start_sector->get_portals()) {
+		if (not start_portal_ids.contains(portal->get_id())) {
+			// only consider portals that are reachable from the start cell
+			continue;
+		}
+
 		auto portal_node = std::make_shared<PortalNode>(portal, start_sector->get_id(), nullptr);
 
 		auto sector_pos = grid->get_sector(portal->get_exit_sector(start_sector->get_id()))->get_position();
@@ -133,8 +185,10 @@ const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathR
 
 		current_node->was_best = true;
 
-		// check if the current node is the target
-		if (current_node->portal->get_exit_sector(current_node->entry_sector) == target_sector->get_id()) {
+		// check if the current node is a portal in the target sector that can
+		// be reached from the target cell
+		auto exit_portal_id = current_node->portal->get_id();
+		if (target_portal_ids.contains(exit_portal_id)) {
 			auto backtrace = current_node->generate_backtrace();
 			for (auto &node : backtrace) {
 				result.push_back(node->portal);
diff --git a/libopenage/pathfinding/pathfinder.h b/libopenage/pathfinding/pathfinder.h
index a4df0350d8..0d4d3dfa7c 100644
--- a/libopenage/pathfinding/pathfinder.h
+++ b/libopenage/pathfinding/pathfinder.h
@@ -4,6 +4,7 @@
 
 #include <memory>
 #include <unordered_map>
+#include <unordered_set>
 
 #include "coord/tile.h"
 #include "datastructure/pairing_heap.h"
@@ -66,10 +67,14 @@ class Pathfinder {
 	 * High-level pathfinder. Uses A* to find the path through the portals of sectors.
 	 *
 	 * @param request Pathfinding request.
+	 * @param target_portal_ids IDs of portals that can be reached from the target cell.
+	 * @param start_portal_ids IDs of portals that can be reached from the start cell.
 	 *
 	 * @return Portals to traverse in order to reach the target.
 	 */
-	const std::vector<std::shared_ptr<Portal>> portal_a_star(const PathRequest &request) const;
+	const std::vector<std::shared_ptr<Portal>> portal_a_star(const PathRequest &request,
+	                                                         const std::unordered_set<portal_id_t> &target_portal_ids,
+	                                                         const std::unordered_set<portal_id_t> &start_portal_ids) const;
 
 	/**
 	 * Low-level pathfinder. Uses flow fields to find the path through the sectors.

From 596aecb831c4250718ce695525af0b21f1efb581 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 01:56:31 +0200
Subject: [PATCH 13/68] path: Store whether a path has been found.

---
 libopenage/gamestate/system/move.cpp  |  5 ++++
 libopenage/pathfinding/path.h         | 17 +++++++-----
 libopenage/pathfinding/pathfinder.cpp | 37 ++++++++++++++++++++-------
 libopenage/pathfinding/pathfinder.h   |  8 +++---
 libopenage/pathfinding/types.h        | 10 ++++++++
 5 files changed, 58 insertions(+), 19 deletions(-)

diff --git a/libopenage/gamestate/system/move.cpp b/libopenage/gamestate/system/move.cpp
index 9607658ca2..158beea6ac 100644
--- a/libopenage/gamestate/system/move.cpp
+++ b/libopenage/gamestate/system/move.cpp
@@ -49,6 +49,11 @@ std::vector<coord::phys3> find_path(const std::shared_ptr<path::Pathfinder> &pat
 	};
 	auto tile_path = pathfinder->get_path(request);
 
+	if (tile_path.status != path::PathResult::FOUND) {
+		// No path found
+		return {};
+	}
+
 	// Get the waypoints of the path
 	std::vector<coord::phys3> path;
 	path.reserve(tile_path.waypoints.size());
diff --git a/libopenage/pathfinding/path.h b/libopenage/pathfinding/path.h
index 8d64f5914f..d1c61ac325 100644
--- a/libopenage/pathfinding/path.h
+++ b/libopenage/pathfinding/path.h
@@ -5,6 +5,7 @@
 #include <vector>
 
 #include "coord/tile.h"
+#include "pathfinding/types.h"
 
 
 namespace openage::path {
@@ -13,11 +14,11 @@ namespace openage::path {
  * Path request for the pathfinder.
  */
 struct PathRequest {
-	// ID of the grid to use for pathfinding.
+	/// ID of the grid to use for pathfinding.
 	size_t grid_id;
-	// Start position of the path.
+	/// Start position of the path.
 	coord::tile start;
-	// Target position of the path.
+	/// Target position of the path.
 	coord::tile target;
 };
 
@@ -25,11 +26,13 @@ struct PathRequest {
  * Path found by the pathfinder.
  */
 struct Path {
-	// ID of the grid to used for pathfinding.
+	/// ID of the grid to used for pathfinding.
 	size_t grid_id;
-	// Waypoints of the path.
-	// First waypoint is the start position of the path request.
-	// Last waypoint is the target position of the path request.
+	/// Status
+	PathResult status;
+	/// Waypoints of the path.
+	/// First waypoint is the start position of the path request.
+	/// Last waypoint is the target position of the path request.
 	std::vector<coord::tile> waypoints;
 };
 
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index ca830ca075..e16528afcf 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -48,7 +48,10 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 
 			std::vector<coord::tile> waypoints{request.start};
 			waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
-			return Path{request.grid_id, waypoints};
+
+			log::log(INFO << "Path found (start = " << request.start << "; target = " << request.target << ")");
+			log::log(DBG << "Path is within the same sector.");
+			return Path{request.grid_id, PathResult::FOUND, waypoints};
 		}
 	}
 
@@ -77,11 +80,18 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 		}
 	}
 
-	// ASDF
+	if (target_portal_ids.empty() or start_portal_ids.empty()) {
+		// Exit early if no portals are reachable from the start or target
+		log::log(INFO << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "No portals are reachable from the start or target.");
+		return Path{request.grid_id, PathResult::NOT_FOUND, {}};
+	}
 
 	// High-level pathfinding
 	// Find the portals to use to get from the start to the target
-	auto portal_path = this->portal_a_star(request, target_portal_ids, start_portal_ids);
+	auto portal_result = this->portal_a_star(request, target_portal_ids, start_portal_ids);
+	auto portal_status = portal_result.first;
+	auto portal_path = portal_result.second;
 
 	// Low-level pathfinding
 	// Find the path within the sectors
@@ -120,7 +130,13 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	auto flow_field_waypoints = this->get_waypoints(flow_fields, request);
 	waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
-	return Path{request.grid_id, waypoints};
+	if (portal_status == PathResult::NOT_FOUND) {
+		log::log(INFO << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+	}
+	else {
+		log::log(INFO << "Path found (start = " << request.start << "; target = " << request.target << ")");
+	}
+	return Path{request.grid_id, portal_status, waypoints};
 }
 
 const std::shared_ptr<Grid> &Pathfinder::get_grid(grid_id_t id) const {
@@ -131,9 +147,9 @@ void Pathfinder::add_grid(const std::shared_ptr<Grid> &grid) {
 	this->grids[grid->get_id()] = grid;
 }
 
-const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathRequest &request,
-                                                                     const std::unordered_set<portal_id_t> &target_portal_ids,
-                                                                     const std::unordered_set<portal_id_t> &start_portal_ids) const {
+const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &request,
+                                                          const std::unordered_set<portal_id_t> &target_portal_ids,
+                                                          const std::unordered_set<portal_id_t> &start_portal_ids) const {
 	std::vector<std::shared_ptr<Portal>> result;
 
 	auto grid = this->grids.at(request.grid_id);
@@ -193,7 +209,8 @@ const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathR
 			for (auto &node : backtrace) {
 				result.push_back(node->portal);
 			}
-			return result;
+			log::log(INFO << "Portal path found with " << result.size() << " portal traversals.");
+			return std::make_pair(PathResult::FOUND, result);
 		}
 
 		// check if the current node is the closest to the target
@@ -248,7 +265,9 @@ const std::vector<std::shared_ptr<Portal>> Pathfinder::portal_a_star(const PathR
 		result.push_back(node->portal);
 	}
 
-	return result;
+	log::log(INFO << "Portal path not found.");
+	log::log(DBG << "Closest portal: " << closest_node->portal->get_id());
+	return std::make_pair(PathResult::NOT_FOUND, result);
 }
 
 const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::pair<sector_id_t, std::shared_ptr<FlowField>>> &flow_fields,
diff --git a/libopenage/pathfinding/pathfinder.h b/libopenage/pathfinding/pathfinder.h
index 0d4d3dfa7c..706e222318 100644
--- a/libopenage/pathfinding/pathfinder.h
+++ b/libopenage/pathfinding/pathfinder.h
@@ -63,6 +63,8 @@ class Pathfinder {
 	const Path get_path(const PathRequest &request);
 
 private:
+	using portal_star_t = std::pair<PathResult, std::vector<std::shared_ptr<Portal>>>;
+
 	/**
 	 * High-level pathfinder. Uses A* to find the path through the portals of sectors.
 	 *
@@ -72,9 +74,9 @@ class Pathfinder {
 	 *
 	 * @return Portals to traverse in order to reach the target.
 	 */
-	const std::vector<std::shared_ptr<Portal>> portal_a_star(const PathRequest &request,
-	                                                         const std::unordered_set<portal_id_t> &target_portal_ids,
-	                                                         const std::unordered_set<portal_id_t> &start_portal_ids) const;
+	const portal_star_t portal_a_star(const PathRequest &request,
+	                                  const std::unordered_set<portal_id_t> &target_portal_ids,
+	                                  const std::unordered_set<portal_id_t> &start_portal_ids) const;
 
 	/**
 	 * Low-level pathfinder. Uses flow fields to find the path through the sectors.
diff --git a/libopenage/pathfinding/types.h b/libopenage/pathfinding/types.h
index 11190f6551..b90e932323 100644
--- a/libopenage/pathfinding/types.h
+++ b/libopenage/pathfinding/types.h
@@ -8,6 +8,16 @@
 
 namespace openage::path {
 
+/**
+ * Path result type.
+ */
+enum class PathResult {
+	/// Path was found.
+	FOUND,
+	/// Path was not found.
+	NOT_FOUND,
+};
+
 /**
  * Movement cost in the cost field.
  *

From 564497e9e28f4067f4129955dec549e16df2a67c Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 02:12:49 +0200
Subject: [PATCH 14/68] path: Prevent duplicate waypoints at beginning of path.

---
 libopenage/pathfinding/pathfinder.cpp | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index e16528afcf..48eeb7d83e 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -46,7 +46,10 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 			auto flow_field = this->integrator->build(target_integration_field);
 			auto flow_field_waypoints = this->get_waypoints({std::make_pair(target_sector->get_id(), flow_field)}, request);
 
-			std::vector<coord::tile> waypoints{request.start};
+			std::vector<coord::tile> waypoints{};
+			if (flow_field_waypoints.at(0) != request.start) {
+				waypoints.push_back(request.start);
+			}
 			waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
 			log::log(INFO << "Path found (start = " << request.start << "; target = " << request.target << ")");
@@ -126,8 +129,11 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	std::reverse(flow_fields.begin(), flow_fields.end());
 
 	// traverse the flow fields to get the waypoints
-	std::vector<coord::tile> waypoints{request.start};
 	auto flow_field_waypoints = this->get_waypoints(flow_fields, request);
+	std::vector<coord::tile> waypoints{};
+	if (flow_field_waypoints.at(0) != request.start) {
+		waypoints.push_back(request.start);
+	}
 	waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
 	if (portal_status == PathResult::NOT_FOUND) {

From f239a6f9950b17db6630757ba6eb420a02329316 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 22:32:23 +0200
Subject: [PATCH 15/68] path: LOS integration with portal.

---
 libopenage/pathfinding/integration_field.cpp | 37 ++++++++++++++++++++
 libopenage/pathfinding/integration_field.h   | 17 +++++++++
 2 files changed, 54 insertions(+)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index bc2745879f..ff10e0e507 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -33,6 +33,43 @@ const integrated_t &IntegrationField::get_cell(size_t idx) const {
 	return this->cells.at(idx);
 }
 
+std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
+                                                    sector_id_t other_sector_id,
+                                                    const std::shared_ptr<Portal> &portal) {
+	ENSURE(cost_field->get_size() == this->get_size(),
+	       "cost field size "
+	           << cost_field->get_size() << "x" << cost_field->get_size()
+	           << " does not match integration field size "
+	           << this->get_size() << "x" << this->get_size());
+
+	// Integrate the cost of the cells on the exit side (this) of the portal
+	std::vector<size_t> start_cells;
+	auto exit_start = portal->get_exit_start(other_sector_id);
+	auto exit_end = portal->get_exit_end(other_sector_id);
+	auto entry_start = portal->get_entry_start(other_sector_id);
+	auto entry_end = portal->get_entry_end(other_sector_id);
+
+	auto x_diff = exit_start.ne - entry_start.ne;
+	auto y_diff = exit_start.se - entry_start.se;
+
+	for (auto y = exit_start.se; y <= exit_end.se; ++y) {
+		for (auto x = exit_start.ne; x <= exit_end.ne; ++x) {
+			// every portal cell is a target cell
+			auto target_idx = x + y * this->size;
+
+			auto source_idx = x - x_diff + (y - y_diff) * this->size;
+
+			// Set the cost of all target cells to the start value
+			this->cells[target_idx].cost = INTEGRATED_COST_START;
+			this->cells[target_idx].flags = this->cells[source_idx].flags;
+
+			start_cells.push_back(target_idx);
+		}
+	}
+
+	// TODO: Call main LOS integration function
+}
+
 std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
                                                     const coord::tile &target) {
 	ENSURE(cost_field->get_size() == this->get_size(),
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index 183fb9cff6..c7c2bf5283 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -69,6 +69,23 @@ class IntegrationField {
 	std::vector<size_t> integrate_los(const std::shared_ptr<CostField> &cost_field,
 	                                  const coord::tile &target);
 
+	/**
+	 * Calculate the line-of-sight integration flags starting from a portal to another
+	 * integration field.
+	 *
+	 * Returns a list of cells that are flagged as "wavefront blocked". These cells
+	 * can be used as a starting point for the cost integration.
+	 *
+	 * @param cost_field Cost field to integrate.
+	 * @param other_sector_id Sector ID of the other integration field.
+	 * @param portal Portal connecting the two fields.
+	 *
+	 * @return Cells flagged as "wavefront blocked".
+	 */
+	std::vector<size_t> integrate_los(const std::shared_ptr<CostField> &cost_field,
+	                                  sector_id_t other_sector_id,
+	                                  const std::shared_ptr<Portal> &portal);
+
 	/**
 	 * Calculate the cost integration field starting from a target cell.
 	 *

From 0763deb77f279e3b1cdab428f26920f35a635273 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 23:21:21 +0200
Subject: [PATCH 16/68] path: Change all relative coordinates to delta types.

Prevents accidental confusion between relative and absolute coordinates on grid.
---
 libopenage/coord/chunk.cpp                   | 16 +++++-
 libopenage/coord/chunk.h                     |  4 ++
 libopenage/pathfinding/cost_field.cpp        |  4 +-
 libopenage/pathfinding/cost_field.h          | 10 ++--
 libopenage/pathfinding/demo/demo_0.cpp       | 49 ++++++++--------
 libopenage/pathfinding/demo/demo_1.cpp       |  2 +-
 libopenage/pathfinding/flow_field.cpp        |  4 +-
 libopenage/pathfinding/flow_field.h          | 10 ++--
 libopenage/pathfinding/integration_field.cpp | 22 +++----
 libopenage/pathfinding/integration_field.h   | 24 ++++----
 libopenage/pathfinding/integrator.cpp        |  4 +-
 libopenage/pathfinding/integrator.h          |  6 +-
 libopenage/pathfinding/pathfinder.cpp        | 30 +++++-----
 libopenage/pathfinding/pathfinder.h          | 11 ++--
 libopenage/pathfinding/portal.cpp            | 24 ++++----
 libopenage/pathfinding/portal.h              | 60 +++++++++++---------
 libopenage/pathfinding/sector.cpp            | 24 ++++----
 libopenage/pathfinding/sector.h              |  4 +-
 libopenage/pathfinding/tests.cpp             |  4 +-
 19 files changed, 169 insertions(+), 143 deletions(-)

diff --git a/libopenage/coord/chunk.cpp b/libopenage/coord/chunk.cpp
index fd061586b7..19cb606295 100644
--- a/libopenage/coord/chunk.cpp
+++ b/libopenage/coord/chunk.cpp
@@ -1,8 +1,20 @@
-// Copyright 2016-2018 the openage authors. See copying.md for legal info.
+// Copyright 2016-2024 the openage authors. See copying.md for legal info.
 
 #include "chunk.h"
 
+#include "coord/tile.h"
+
+
 namespace openage {
 namespace coord {
 
-}} // namespace openage::coord
+tile_delta chunk_delta::to_tile(size_t tiles_per_chunk) const {
+	return tile_delta{this->ne * tiles_per_chunk, this->se * tiles_per_chunk};
+}
+
+tile chunk::to_tile(size_t tiles_per_chunk) const {
+	return tile{this->ne * tiles_per_chunk, this->se * tiles_per_chunk};
+}
+
+} // namespace coord
+} // namespace openage
diff --git a/libopenage/coord/chunk.h b/libopenage/coord/chunk.h
index a894cc56c1..0b5a1d50c0 100644
--- a/libopenage/coord/chunk.h
+++ b/libopenage/coord/chunk.h
@@ -12,10 +12,14 @@ namespace coord {
 
 struct chunk_delta : CoordNeSeRelative<chunk_t, chunk, chunk_delta> {
 	using CoordNeSeRelative<chunk_t, chunk, chunk_delta>::CoordNeSeRelative;
+
+	tile_delta to_tile(size_t tiles_per_chunk) const;
 };
 
 struct chunk : CoordNeSeAbsolute<chunk_t, chunk, chunk_delta> {
 	using CoordNeSeAbsolute<chunk_t, chunk, chunk_delta>::CoordNeSeAbsolute;
+
+	tile to_tile(size_t tiles_per_chunk) const;
 };
 
 struct chunk3_delta : CoordNeSeUpRelative<chunk_t, chunk3, chunk3_delta> {
diff --git a/libopenage/pathfinding/cost_field.cpp b/libopenage/pathfinding/cost_field.cpp
index 248a260d8e..e85fecc3ed 100644
--- a/libopenage/pathfinding/cost_field.cpp
+++ b/libopenage/pathfinding/cost_field.cpp
@@ -21,7 +21,7 @@ size_t CostField::get_size() const {
 	return this->size;
 }
 
-cost_t CostField::get_cost(const coord::tile &pos) const {
+cost_t CostField::get_cost(const coord::tile_delta &pos) const {
 	return this->cells.at(pos.ne + pos.se * this->size);
 }
 
@@ -29,7 +29,7 @@ cost_t CostField::get_cost(size_t idx) const {
 	return this->cells.at(idx);
 }
 
-void CostField::set_cost(const coord::tile &pos, cost_t cost) {
+void CostField::set_cost(const coord::tile_delta &pos, cost_t cost) {
 	this->cells[pos.ne + pos.se * this->size] = cost;
 }
 
diff --git a/libopenage/pathfinding/cost_field.h b/libopenage/pathfinding/cost_field.h
index ffb27bdec8..8b805c524a 100644
--- a/libopenage/pathfinding/cost_field.h
+++ b/libopenage/pathfinding/cost_field.h
@@ -10,7 +10,7 @@
 
 namespace openage {
 namespace coord {
-struct tile;
+struct tile_delta;
 } // namespace coord
 
 namespace path {
@@ -37,10 +37,10 @@ class CostField {
 	/**
 	 * Get the cost at a specified position.
 	 *
-	 * @param pos Coordinates of the cell.
+	 * @param pos Coordinates of the cell (relative to field origin).
 	 * @return Cost at the specified position.
 	 */
-	cost_t get_cost(const coord::tile &pos) const;
+	cost_t get_cost(const coord::tile_delta &pos) const;
 
 	/**
 	 * Get the cost at a specified position.
@@ -53,10 +53,10 @@ class CostField {
 	/**
 	 * Set the cost at a specified position.
 	 *
-	 * @param pos Coordinates of the cell.
+	 * @param pos Coordinates of the cell (relative to field origin).
 	 * @param cost Cost to set.
 	 */
-	void set_cost(const coord::tile &pos, cost_t cost);
+	void set_cost(const coord::tile_delta &pos, cost_t cost);
 
 	/**
 	 * Set the cost at a specified position.
diff --git a/libopenage/pathfinding/demo/demo_0.cpp b/libopenage/pathfinding/demo/demo_0.cpp
index bcf4cca945..d90d5ef39d 100644
--- a/libopenage/pathfinding/demo/demo_0.cpp
+++ b/libopenage/pathfinding/demo/demo_0.cpp
@@ -33,15 +33,15 @@ void path_demo_0(const util::Path &path) {
 
 	// Cost field with some obstacles
 	auto cost_field = std::make_shared<CostField>(field_length);
-	cost_field->set_cost(coord::tile{0, 0}, COST_IMPASSABLE);
-	cost_field->set_cost(coord::tile{1, 0}, 254);
-	cost_field->set_cost(coord::tile{4, 3}, 128);
-	cost_field->set_cost(coord::tile{5, 3}, 128);
-	cost_field->set_cost(coord::tile{6, 3}, 128);
-	cost_field->set_cost(coord::tile{4, 4}, 128);
-	cost_field->set_cost(coord::tile{5, 4}, 128);
-	cost_field->set_cost(coord::tile{6, 4}, 128);
-	cost_field->set_cost(coord::tile{1, 7}, COST_IMPASSABLE);
+	cost_field->set_cost(coord::tile_delta{0, 0}, COST_IMPASSABLE);
+	cost_field->set_cost(coord::tile_delta{1, 0}, 254);
+	cost_field->set_cost(coord::tile_delta{4, 3}, 128);
+	cost_field->set_cost(coord::tile_delta{5, 3}, 128);
+	cost_field->set_cost(coord::tile_delta{6, 3}, 128);
+	cost_field->set_cost(coord::tile_delta{4, 4}, 128);
+	cost_field->set_cost(coord::tile_delta{5, 4}, 128);
+	cost_field->set_cost(coord::tile_delta{6, 4}, 128);
+	cost_field->set_cost(coord::tile_delta{1, 7}, COST_IMPASSABLE);
 	log::log(INFO << "Created cost field");
 
 	// Create an integration field from the cost field
@@ -49,7 +49,7 @@ void path_demo_0(const util::Path &path) {
 	log::log(INFO << "Created integration field");
 
 	// Set cell (7, 7) to be the initial target cell
-	auto wavefront_blocked = integration_field->integrate_los(cost_field, coord::tile{7, 7});
+	auto wavefront_blocked = integration_field->integrate_los(cost_field, coord::tile_delta{7, 7});
 	integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
 	log::log(INFO << "Calculated integration field for target cell (7, 7)");
 
@@ -92,7 +92,8 @@ void path_demo_0(const util::Path &path) {
 
 					// Recalculate the integration field and the flow field
 					integration_field->reset();
-					auto wavefront_blocked = integration_field->integrate_los(cost_field, coord::tile{grid_x, grid_y});
+					auto wavefront_blocked = integration_field->integrate_los(cost_field,
+					                                                          coord::tile_delta{grid_x, grid_y});
 					integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
 					log::log(INFO << "Calculated integration field for target cell ("
 					              << grid_x << ", " << grid_y << ")");
@@ -275,7 +276,7 @@ void RenderManager0::show_vectors(const std::shared_ptr<path::FlowField> &field)
 	this->vector_pass->clear_renderables();
 	for (size_t y = 0; y < field->get_size(); ++y) {
 		for (size_t x = 0; x < field->get_size(); ++x) {
-			auto cell = field->get_cell(coord::tile(x, y));
+			auto cell = field->get_cell(coord::tile_delta(x, y));
 			if (cell & FLOW_PATHABLE_MASK and not(cell & FLOW_LOS_MASK)) {
 				Eigen::Affine3f arrow_model = Eigen::Affine3f::Identity();
 				arrow_model.translate(Eigen::Vector3f(y + 0.5, 0, -1.0f * x - 0.5));
@@ -566,19 +567,19 @@ renderer::resources::MeshData RenderManager0::get_cost_field_mesh(const std::sha
 			// for each vertex, compare the surrounding tiles
 			std::vector<float> surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
-				auto cost = field->get_cost(coord::tile((i - 1) / resolution, (j - 1) / resolution));
+				auto cost = field->get_cost(coord::tile_delta((i - 1) / resolution, (j - 1) / resolution));
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i - 1 >= 0) {
-				auto cost = field->get_cost(coord::tile((i - 1) / resolution, j / resolution));
+				auto cost = field->get_cost(coord::tile_delta((i - 1) / resolution, j / resolution));
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cost(coord::tile(i / resolution, j / resolution));
+				auto cost = field->get_cost(coord::tile_delta(i / resolution, j / resolution));
 				surround.push_back(cost);
 			}
 			if (j - 1 >= 0 and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cost(coord::tile(i / resolution, (j - 1) / resolution));
+				auto cost = field->get_cost(coord::tile_delta(i / resolution, (j - 1) / resolution));
 				surround.push_back(cost);
 			}
 			// use the cost of the most expensive surrounding tile
@@ -652,19 +653,19 @@ renderer::resources::MeshData RenderManager0::get_integration_field_mesh(const s
 			// for each vertex, compare the surrounding tiles
 			std::vector<float> surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile((i - 1) / resolution, (j - 1) / resolution)).cost;
+				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, (j - 1) / resolution)).cost;
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile((i - 1) / resolution, j / resolution)).cost;
+				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, j / resolution)).cost;
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile(i / resolution, j / resolution)).cost;
+				auto cost = field->get_cell(coord::tile_delta(i / resolution, j / resolution)).cost;
 				surround.push_back(cost);
 			}
 			if (j - 1 >= 0 and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile(i / resolution, (j - 1) / resolution)).cost;
+				auto cost = field->get_cell(coord::tile_delta(i / resolution, (j - 1) / resolution)).cost;
 				surround.push_back(cost);
 			}
 			// use the cost of the most expensive surrounding tile
@@ -738,19 +739,19 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 			// for each vertex, compare the surrounding tiles
 			std::vector<float> surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile((i - 1) / resolution, (j - 1) / resolution));
+				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, (j - 1) / resolution));
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile((i - 1) / resolution, j / resolution));
+				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, j / resolution));
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile(i / resolution, j / resolution));
+				auto cost = field->get_cell(coord::tile_delta(i / resolution, j / resolution));
 				surround.push_back(cost);
 			}
 			if (j - 1 >= 0 and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile(i / resolution, (j - 1) / resolution));
+				auto cost = field->get_cell(coord::tile_delta(i / resolution, (j - 1) / resolution));
 				surround.push_back(cost);
 			}
 			// use the cost of the most expensive surrounding tile
diff --git a/libopenage/pathfinding/demo/demo_1.cpp b/libopenage/pathfinding/demo/demo_1.cpp
index 21aaa2c9d8..907caeb3d5 100644
--- a/libopenage/pathfinding/demo/demo_1.cpp
+++ b/libopenage/pathfinding/demo/demo_1.cpp
@@ -449,7 +449,7 @@ void RenderManager1::create_impassible_tiles(const std::shared_ptr<path::Grid> &
 			auto cost_field = sector->get_cost_field();
 			for (size_t y = 0; y < sector_size; y++) {
 				for (size_t x = 0; x < sector_size; x++) {
-					auto cost = cost_field->get_cost(coord::tile(x, y));
+					auto cost = cost_field->get_cost(coord::tile_delta(x, y));
 					if (cost == COST_IMPASSABLE) {
 						std::array<float, 8> tile_data{
 							-1.0f + x * tile_offset_width + sector_size * sector_x * tile_offset_width,
diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 7198ae5fbe..56fccc155c 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -30,11 +30,11 @@ size_t FlowField::get_size() const {
 	return this->size;
 }
 
-flow_t FlowField::get_cell(const coord::tile &pos) const {
+flow_t FlowField::get_cell(const coord::tile_delta &pos) const {
 	return this->cells.at(pos.ne + pos.se * this->size);
 }
 
-flow_dir_t FlowField::get_dir(const coord::tile &pos) const {
+flow_dir_t FlowField::get_dir(const coord::tile_delta &pos) const {
 	return static_cast<flow_dir_t>(this->get_cell(pos) & FLOW_DIR_MASK);
 }
 
diff --git a/libopenage/pathfinding/flow_field.h b/libopenage/pathfinding/flow_field.h
index 1c1adcfe33..6ae3882c5d 100644
--- a/libopenage/pathfinding/flow_field.h
+++ b/libopenage/pathfinding/flow_field.h
@@ -13,7 +13,7 @@
 
 namespace openage {
 namespace coord {
-struct tile;
+struct tile_delta;
 } // namespace coord
 
 namespace path {
@@ -46,20 +46,20 @@ class FlowField {
 	/**
 	 * Get the flow field value at a specified position.
 	 *
-	 * @param pos Coordinates of the cell.
+	 * @param pos Coordinates of the cell (relative to field origin).
 	 *
 	 * @return Flowfield value at the specified position.
 	 */
-	flow_t get_cell(const coord::tile &pos) const;
+	flow_t get_cell(const coord::tile_delta &pos) const;
 
 	/**
 	 * Get the flow field direction at a specified position.
 	 *
-	 * @param pos Coordinates of the cell.
+	 * @param pos Coordinates of the cell (relative to field origin).
 	 *
 	 * @return Flowfield direction at the specified position.
 	 */
-	flow_dir_t get_dir(const coord::tile &pos) const;
+	flow_dir_t get_dir(const coord::tile_delta &pos) const;
 
 	/**
 	 * Build the flow field.
diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index ff10e0e507..2a7fe7df7d 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -25,7 +25,7 @@ size_t IntegrationField::get_size() const {
 	return this->size;
 }
 
-const integrated_t &IntegrationField::get_cell(const coord::tile &pos) const {
+const integrated_t &IntegrationField::get_cell(const coord::tile_delta &pos) const {
 	return this->cells.at(pos.ne + pos.se * this->size);
 }
 
@@ -71,7 +71,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 }
 
 std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
-                                                    const coord::tile &target) {
+                                                    const coord::tile_delta &target) {
 	ENSURE(cost_field->get_size() == this->get_size(),
 	       "cost field size "
 	           << cost_field->get_size() << "x" << cost_field->get_size()
@@ -135,7 +135,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 				}
 
 				// check each neighbor for a corner
-				auto corners = this->get_los_corners(cost_field, target, coord::tile(x, y));
+				auto corners = this->get_los_corners(cost_field, target, coord::tile_delta(x, y));
 				for (auto &corner : corners) {
 					// draw a line from the corner to the edge of the field
 					// to get the cells blocked by the corner
@@ -186,7 +186,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 }
 
 void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_field,
-                                      const coord::tile &target) {
+                                      const coord::tile_delta &target) {
 	ENSURE(cost_field->get_size() == this->get_size(),
 	       "cost field size "
 	           << cost_field->get_size() << "x" << cost_field->get_size()
@@ -326,8 +326,8 @@ void IntegrationField::update_neighbor(size_t idx,
 }
 
 std::vector<std::pair<int, int>> IntegrationField::get_los_corners(const std::shared_ptr<CostField> &cost_field,
-                                                                   const coord::tile &target,
-                                                                   const coord::tile &blocker) {
+                                                                   const coord::tile_delta &target,
+                                                                   const coord::tile_delta &blocker) {
 	std::vector<std::pair<int, int>> corners;
 
 	// Get the cost of the blocking cell's neighbors
@@ -345,16 +345,16 @@ std::vector<std::pair<int, int>> IntegrationField::get_los_corners(const std::sh
 
 	// Get neighbor costs (if they exist)
 	if (blocker.se > 0) {
-		top_cost = cost_field->get_cost(coord::tile{blocker.ne, blocker.se - 1});
+		top_cost = cost_field->get_cost(coord::tile_delta{blocker.ne, blocker.se - 1});
 	}
 	if (blocker.ne > 0) {
-		left_cost = cost_field->get_cost(coord::tile{blocker.ne - 1, blocker.se});
+		left_cost = cost_field->get_cost(coord::tile_delta{blocker.ne - 1, blocker.se});
 	}
 	if (static_cast<size_t>(blocker.se) < this->size - 1) {
-		bottom_cost = cost_field->get_cost(coord::tile{blocker.ne, blocker.se + 1});
+		bottom_cost = cost_field->get_cost(coord::tile_delta{blocker.ne, blocker.se + 1});
 	}
 	if (static_cast<size_t>(blocker.ne) < this->size - 1) {
-		right_cost = cost_field->get_cost(coord::tile{blocker.ne + 1, blocker.se});
+		right_cost = cost_field->get_cost(coord::tile_delta{blocker.ne + 1, blocker.se});
 	}
 
 	// Check which corners are blocking LOS
@@ -460,7 +460,7 @@ std::vector<std::pair<int, int>> IntegrationField::get_los_corners(const std::sh
 	return corners;
 }
 
-std::vector<size_t> IntegrationField::bresenhams_line(const coord::tile &target,
+std::vector<size_t> IntegrationField::bresenhams_line(const coord::tile_delta &target,
                                                       int corner_x,
                                                       int corner_y) {
 	std::vector<size_t> cells;
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index c7c2bf5283..fc5f087404 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -13,7 +13,7 @@
 
 namespace openage {
 namespace coord {
-struct tile;
+struct tile_delta;
 } // namespace coord
 
 namespace path {
@@ -42,10 +42,10 @@ class IntegrationField {
 	/**
 	 * Get the integration value at a specified position.
 	 *
-	 * @param pos Coordinates of the cell.
+	 * @param pos Coordinates of the cell (relative to field origin).
 	 * @return Integration value at the specified position.
 	 */
-	const integrated_t &get_cell(const coord::tile &pos) const;
+	const integrated_t &get_cell(const coord::tile_delta &pos) const;
 
 	/**
 	 * Get the integration value at a specified position.
@@ -62,12 +62,12 @@ class IntegrationField {
 	 * can be used as a starting point for the cost integration.
 	 *
 	 * @param cost_field Cost field to integrate.
-	 * @param target Coordinates of the target cell.
+	 * @param target Coordinates of the target cell (relative to field origin).
 	 *
 	 * @return Cells flagged as "wavefront blocked".
 	 */
 	std::vector<size_t> integrate_los(const std::shared_ptr<CostField> &cost_field,
-	                                  const coord::tile &target);
+	                                  const coord::tile_delta &target);
 
 	/**
 	 * Calculate the line-of-sight integration flags starting from a portal to another
@@ -93,7 +93,7 @@ class IntegrationField {
 	 * @param target Coordinates of the target cell.
 	 */
 	void integrate_cost(const std::shared_ptr<CostField> &cost_field,
-	                    const coord::tile &target);
+	                    const coord::tile_delta &target);
 
 	/**
 	 * Calculate the cost integration field starting from a portal to another
@@ -150,14 +150,14 @@ class IntegrationField {
 	 * Get the LOS corners around a cell.
 	 *
 	 * @param cost_field Cost field to integrate.
-	 * @param target Cell coordinates of the target.
-	 * @param blocker Cell coordinates of the cell blocking LOS.
+	 * @param target Cell coordinates of the target (relative to field origin).
+	 * @param blocker Cell coordinates of the cell blocking LOS (relative to field origin).
 	 *
 	 * @return Field coordinates of the LOS corners.
 	 */
 	std::vector<std::pair<int, int>> get_los_corners(const std::shared_ptr<CostField> &cost_field,
-	                                                 const coord::tile &target,
-	                                                 const coord::tile &blocker);
+	                                                 const coord::tile_delta &target,
+	                                                 const coord::tile_delta &blocker);
 
 	/**
 	 * Get the cells in a bresenham's line between the corner cell and the field edge.
@@ -167,13 +167,13 @@ class IntegrationField {
 	 * the cells between two arbitrary points. We do this because the intersection
 	 * point with the field edge is unknown.
 	 *
-	 * @param target Cell coordinates of the target.
+	 * @param target Cell coordinates of the target (relative to field origin).
 	 * @param corner_x X field coordinate edge of the LOS corner.
 	 * @param corner_y Y field coordinate edge of the LOS corner.
 	 *
 	 * @return Cell indices of the LOS line.
 	 */
-	std::vector<size_t> bresenhams_line(const coord::tile &target,
+	std::vector<size_t> bresenhams_line(const coord::tile_delta &target,
 	                                    int corner_x,
 	                                    int corner_y);
 
diff --git a/libopenage/pathfinding/integrator.cpp b/libopenage/pathfinding/integrator.cpp
index 28f8a829ca..4ffdedff15 100644
--- a/libopenage/pathfinding/integrator.cpp
+++ b/libopenage/pathfinding/integrator.cpp
@@ -10,7 +10,7 @@
 namespace openage::path {
 
 std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<CostField> &cost_field,
-                                                        const coord::tile &target) {
+                                                        const coord::tile_delta &target) {
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
 
 	auto wavefront_blocked = integration_field->integrate_los(cost_field, target);
@@ -46,7 +46,7 @@ std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationFi
 }
 
 Integrator::build_return_t Integrator::build(const std::shared_ptr<CostField> &cost_field,
-                                             const coord::tile &target) {
+                                             const coord::tile_delta &target) {
 	auto integration_field = this->integrate(cost_field, target);
 	auto flow_field = this->build(integration_field);
 
diff --git a/libopenage/pathfinding/integrator.h b/libopenage/pathfinding/integrator.h
index 027f627274..ef9c2780cd 100644
--- a/libopenage/pathfinding/integrator.h
+++ b/libopenage/pathfinding/integrator.h
@@ -10,7 +10,7 @@
 
 namespace openage {
 namespace coord {
-struct tile;
+struct tile_delta;
 } // namespace coord
 
 namespace path {
@@ -36,7 +36,7 @@ class Integrator {
 	 * @return Integration field.
 	 */
 	std::shared_ptr<IntegrationField> integrate(const std::shared_ptr<CostField> &cost_field,
-	                                            const coord::tile &target);
+	                                            const coord::tile_delta &target);
 
 	/**
 	 * Integrate the cost field from a portal.
@@ -86,7 +86,7 @@ class Integrator {
 	 * @return Flow field.
 	 */
 	build_return_t build(const std::shared_ptr<CostField> &cost_field,
-	                     const coord::tile &target);
+	                     const coord::tile_delta &target);
 
 	/**
 	 * Build the integration field and flow field from a portal.
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 48eeb7d83e..300bc7d92d 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -2,6 +2,7 @@
 
 #include "pathfinder.h"
 
+#include "coord/chunk.h"
 #include "coord/phys.h"
 #include "pathfinding/flow_field.h"
 #include "pathfinding/grid.h"
@@ -33,14 +34,14 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	// Integrate the target field
 	coord::tile_t target_x = request.target.ne % sector_size;
 	coord::tile_t target_y = request.target.se % sector_size;
-	auto target = coord::tile{target_x, target_y};
+	auto target = coord::tile_delta{target_x, target_y};
 	auto target_integration_field = this->integrator->integrate(target_sector->get_cost_field(), target);
 
 	if (target_sector == start_sector) {
 		auto start_x = request.start.ne % sector_size;
 		auto start_y = request.start.se % sector_size;
 
-		if (target_integration_field->get_cell(coord::tile{start_x, start_y}).cost != INTEGRATED_COST_UNREACHABLE) {
+		if (target_integration_field->get_cell(coord::tile_delta{start_x, start_y}).cost != INTEGRATED_COST_UNREACHABLE) {
 			// Exit early if the start and target are in the same sector
 			// and are reachable from within the same sector
 			auto flow_field = this->integrator->build(target_integration_field);
@@ -71,7 +72,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	// Check which portals are reachable from the start field
 	coord::tile_t start_x = request.start.ne % sector_size;
 	coord::tile_t start_y = request.start.se % sector_size;
-	auto start = coord::tile{start_x, start_y};
+	auto start = coord::tile_delta{start_x, start_y};
 	auto start_integration_field = this->integrator->integrate(start_sector->get_cost_field(), start);
 
 	std::unordered_set<portal_id_t> start_portal_ids;
@@ -184,9 +185,9 @@ const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &req
 
 		auto portal_node = std::make_shared<PortalNode>(portal, start_sector->get_id(), nullptr);
 
-		auto sector_pos = grid->get_sector(portal->get_exit_sector(start_sector->get_id()))->get_position();
+		auto sector_pos = grid->get_sector(portal->get_exit_sector(start_sector->get_id()))->get_position().to_tile(sector_size);
 		auto portal_pos = portal->get_exit_center(start_sector->get_id());
-		auto portal_abs_pos = portal_pos + coord::tile_delta(sector_pos.ne * sector_size, sector_pos.se * sector_size);
+		auto portal_abs_pos = sector_pos + portal_pos;
 		auto heuristic_cost = Pathfinder::heuristic_cost(portal_abs_pos, request.target);
 
 		portal_node->current_cost = 0;
@@ -233,7 +234,7 @@ const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &req
 				continue;
 			}
 
-			// Get distance cost from current node to exit
+			// Get distance cost (from current node to exit node)
 			auto distance_cost = Pathfinder::distance_cost(
 				current_node->portal->get_exit_center(current_node->entry_sector),
 				exit->portal->get_entry_center(exit->entry_sector));
@@ -243,9 +244,12 @@ const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &req
 
 			if (not_visited or tentative_cost < exit->current_cost) {
 				if (not_visited) {
-					// calculate the heuristic cost
+					// Get heuristic cost (from exit node to target cell)
+					auto exit_sector = grid->get_sector(exit->portal->get_exit_sector(exit->entry_sector));
+					auto exit_sector_pos = exit_sector->get_position().to_tile(sector_size);
+					auto exit_portal_pos = exit->portal->get_exit_center(exit->entry_sector);
 					exit->heuristic_cost = Pathfinder::heuristic_cost(
-						exit->portal->get_exit_center(exit->entry_sector),
+						exit_sector_pos + exit_portal_pos,
 						request.target);
 				}
 
@@ -291,7 +295,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 
 	coord::tile_t current_x = start_x;
 	coord::tile_t current_y = start_y;
-	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(coord::tile{current_x, current_y});
+	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(coord::tile_delta{current_x, current_y});
 	for (size_t i = 0; i < flow_fields.size(); ++i) {
 		auto sector = grid->get_sector(flow_fields.at(i).first);
 		auto flow_field = flow_fields.at(i).second;
@@ -301,7 +305,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 		       and current_y < static_cast<coord::tile_t>(sector_size)
 		       and current_x >= 0
 		       and current_y >= 0) {
-			auto cell = flow_field->get_cell(coord::tile{current_x, current_y});
+			auto cell = flow_field->get_cell(coord::tile_delta{current_x, current_y});
 			if (cell & FLOW_LOS_MASK) {
 				// check if we reached an LOS cell
 				auto sector_pos = sector->get_position();
@@ -313,7 +317,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			}
 
 			// check if we need to change direction
-			auto cell_direction = flow_field->get_dir(coord::tile(current_x, current_y));
+			auto cell_direction = flow_field->get_dir(coord::tile_delta(current_x, current_y));
 			if (cell_direction != current_direction) {
 				// add the current cell as a waypoint
 				auto sector_pos = sector->get_position();
@@ -412,8 +416,8 @@ int Pathfinder::heuristic_cost(const coord::tile &portal_pos,
 	return delta.length();
 }
 
-int Pathfinder::distance_cost(const coord::tile &portal1_pos,
-                              const coord::tile &portal2_pos) {
+int Pathfinder::distance_cost(const coord::tile_delta &portal1_pos,
+                              const coord::tile_delta &portal2_pos) {
 	auto delta = portal2_pos.to_phys2() - portal1_pos.to_phys2();
 
 	return delta.length();
diff --git a/libopenage/pathfinding/pathfinder.h b/libopenage/pathfinding/pathfinder.h
index 706e222318..1809b7524d 100644
--- a/libopenage/pathfinding/pathfinder.h
+++ b/libopenage/pathfinding/pathfinder.h
@@ -92,8 +92,9 @@ class Pathfinder {
 	/**
 	 * Calculate the heuristic cost between a portal and a target cell.
 	 *
-	 * @param portal_pos Position of the portal. This should be the center of the portal exit.
-	 * @param target_pos Position of the target cell.
+	 * @param portal_pos Position of the portal (absolute on the grid).
+	 *                   This should be the center of the portal exit.
+	 * @param target_pos Position of the target cell (absolute on the grid).
 	 *
 	 * @return Heuristic cost between the cells.
 	 */
@@ -102,12 +103,12 @@ class Pathfinder {
 	/**
 	 * Calculate the distance cost between two portals.
 	 *
-	 * @param portal1_pos Center of the first portal.
-	 * @param portal2_pos Center of the second portal.
+	 * @param portal1_pos Center of the first portal (relative to sector origin).
+	 * @param portal2_pos Center of the second portal (relative to sector origin).
 	 *
 	 * @return Distance cost between the portal centers.
 	 */
-	static int distance_cost(const coord::tile &portal1_pos, const coord::tile &portal2_pos);
+	static int distance_cost(const coord::tile_delta &portal1_pos, const coord::tile_delta &portal2_pos);
 
 	/**
 	 * Grids managed by this pathfinder.
diff --git a/libopenage/pathfinding/portal.cpp b/libopenage/pathfinding/portal.cpp
index da3581047f..9b8f64cd51 100644
--- a/libopenage/pathfinding/portal.cpp
+++ b/libopenage/pathfinding/portal.cpp
@@ -11,8 +11,8 @@ Portal::Portal(portal_id_t id,
                sector_id_t sector0,
                sector_id_t sector1,
                PortalDirection direction,
-               const coord::tile &cell_start,
-               const coord::tile &cell_end) :
+               const coord::tile_delta &cell_start,
+               const coord::tile_delta &cell_end) :
 	id{id},
 	sector0{sector0},
 	sector1{sector1},
@@ -65,7 +65,7 @@ sector_id_t Portal::get_exit_sector(sector_id_t entry_sector) const {
 	return this->sector0;
 }
 
-const coord::tile Portal::get_entry_start(sector_id_t entry_sector) const {
+const coord::tile_delta Portal::get_entry_start(sector_id_t entry_sector) const {
 	ENSURE(entry_sector == this->sector0 || entry_sector == this->sector1, "Invalid entry sector");
 
 	if (entry_sector == this->sector0) {
@@ -75,7 +75,7 @@ const coord::tile Portal::get_entry_start(sector_id_t entry_sector) const {
 	return this->get_sector1_start();
 }
 
-const coord::tile Portal::get_entry_center(sector_id_t entry_sector) const {
+const coord::tile_delta Portal::get_entry_center(sector_id_t entry_sector) const {
 	ENSURE(entry_sector == this->sector0 || entry_sector == this->sector1, "Invalid entry sector");
 
 	if (entry_sector == this->sector0) {
@@ -89,7 +89,7 @@ const coord::tile Portal::get_entry_center(sector_id_t entry_sector) const {
 	return {(start.ne + end.ne) / 2, (start.se + end.se) / 2};
 }
 
-const coord::tile Portal::get_entry_end(sector_id_t entry_sector) const {
+const coord::tile_delta Portal::get_entry_end(sector_id_t entry_sector) const {
 	ENSURE(entry_sector == this->sector0 || entry_sector == this->sector1, "Invalid entry sector");
 
 	if (entry_sector == this->sector0) {
@@ -99,7 +99,7 @@ const coord::tile Portal::get_entry_end(sector_id_t entry_sector) const {
 	return this->get_sector1_end();
 }
 
-const coord::tile Portal::get_exit_start(sector_id_t entry_sector) const {
+const coord::tile_delta Portal::get_exit_start(sector_id_t entry_sector) const {
 	ENSURE(entry_sector == this->sector0 || entry_sector == this->sector1, "Invalid entry sector");
 
 	if (entry_sector == this->sector0) {
@@ -109,7 +109,7 @@ const coord::tile Portal::get_exit_start(sector_id_t entry_sector) const {
 	return this->get_sector0_start();
 }
 
-const coord::tile Portal::get_exit_center(sector_id_t entry_sector) const {
+const coord::tile_delta Portal::get_exit_center(sector_id_t entry_sector) const {
 	ENSURE(entry_sector == this->sector0 || entry_sector == this->sector1, "Invalid entry sector");
 
 	if (entry_sector == this->sector0) {
@@ -123,7 +123,7 @@ const coord::tile Portal::get_exit_center(sector_id_t entry_sector) const {
 	return {(start.ne + end.ne) / 2, (start.se + end.se) / 2};
 }
 
-const coord::tile Portal::get_exit_end(sector_id_t entry_sector) const {
+const coord::tile_delta Portal::get_exit_end(sector_id_t entry_sector) const {
 	ENSURE(entry_sector == this->sector0 || entry_sector == this->sector1, "Invalid entry sector");
 
 	if (entry_sector == this->sector0) {
@@ -137,22 +137,22 @@ PortalDirection Portal::get_direction() const {
 	return this->direction;
 }
 
-const coord::tile &Portal::get_sector0_start() const {
+const coord::tile_delta &Portal::get_sector0_start() const {
 	return this->cell_start;
 }
 
-const coord::tile &Portal::get_sector0_end() const {
+const coord::tile_delta &Portal::get_sector0_end() const {
 	return this->cell_end;
 }
 
-const coord::tile Portal::get_sector1_start() const {
+const coord::tile_delta Portal::get_sector1_start() const {
 	if (this->direction == PortalDirection::NORTH_SOUTH) {
 		return {this->cell_start.ne, 0};
 	}
 	return {0, this->cell_start.se};
 }
 
-const coord::tile Portal::get_sector1_end() const {
+const coord::tile_delta Portal::get_sector1_end() const {
 	if (this->direction == PortalDirection::NORTH_SOUTH) {
 		return {this->cell_end.ne, 0};
 	}
diff --git a/libopenage/pathfinding/portal.h b/libopenage/pathfinding/portal.h
index 2487e449c7..6593eea852 100644
--- a/libopenage/pathfinding/portal.h
+++ b/libopenage/pathfinding/portal.h
@@ -49,15 +49,15 @@ class Portal {
 	 * @param sector1 Second sector connected by the portal.
 	 *                Must be south or west on the grid in relation to sector 0.
 	 * @param direction Direction of the portal from sector 0 to sector 1.
-	 * @param cell_start Start cell coordinate in sector 0.
-	 * @param cell_end End cell coordinate in sector 0.
+	 * @param cell_start Start cell coordinate in sector 0 (relative to sector origin).
+	 * @param cell_end End cell coordinate in sector 0 (relative to sector origin).
 	 */
 	Portal(portal_id_t id,
 	       sector_id_t sector0,
 	       sector_id_t sector1,
 	       PortalDirection direction,
-	       const coord::tile &cell_start,
-	       const coord::tile &cell_end);
+	       const coord::tile_delta &cell_start,
+	       const coord::tile_delta &cell_end);
 
 	~Portal() = default;
 
@@ -110,54 +110,54 @@ class Portal {
 	 *
 	 * @param entry_sector Sector from which the portal is entered.
 	 *
-	 * @return Cell coordinates of the start of the portal in the entry sector.
+	 * @return Cell coordinates of the start of the portal in the entry sector (relative to sector origin).
 	 */
-	const coord::tile get_entry_start(sector_id_t entry_sector) const;
+	const coord::tile_delta get_entry_start(sector_id_t entry_sector) const;
 
 	/**
 	 * Get the cell coordinates of the center of the portal in the entry sector.
 	 *
 	 * @param entry_sector Sector from which the portal is entered.
 	 *
-	 * @return Cell coordinates of the center of the portal in the entry sector.
+	 * @return Cell coordinates of the center of the portal in the entry sector (relative to sector origin).
 	 */
-	const coord::tile get_entry_center(sector_id_t entry_sector) const;
+	const coord::tile_delta get_entry_center(sector_id_t entry_sector) const;
 
 	/**
 	 * Get the cell coordinates of the start of the portal in the entry sector.
 	 *
 	 * @param entry_sector Sector from which the portal is entered.
 	 *
-	 * @return Cell coordinates of the start of the portal in the entry sector.
+	 * @return Cell coordinates of the start of the portal in the entry sector (relative to sector origin).
 	 */
-	const coord::tile get_entry_end(sector_id_t entry_sector) const;
+	const coord::tile_delta get_entry_end(sector_id_t entry_sector) const;
 
 	/**
 	 * Get the cell coordinates of the start of the portal in the exit sector.
 	 *
 	 * @param entry_sector Sector from which the portal is entered.
 	 *
-	 * @return Cell coordinates of the start of the portal in the exit sector.
+	 * @return Cell coordinates of the start of the portal in the exit sector (relative to sector origin).
 	 */
-	const coord::tile get_exit_start(sector_id_t entry_sector) const;
+	const coord::tile_delta get_exit_start(sector_id_t entry_sector) const;
 
 	/**
 	 * Get the cell coordinates of the center of the portal in the exit sector.
 	 *
 	 * @param entry_sector Sector from which the portal is entered.
 	 *
-	 * @return Cell coordinates of the center of the portal in the exit sector.
+	 * @return Cell coordinates of the center of the portal in the exit sector (relative to sector origin).
 	 */
-	const coord::tile get_exit_center(sector_id_t entry_sector) const;
+	const coord::tile_delta get_exit_center(sector_id_t entry_sector) const;
 
 	/**
 	 * Get the cell coordinates of the end of the portal in the exit sector.
 	 *
 	 * @param entry_sector Sector from which the portal is entered.
 	 *
-	 * @return Cell coordinates of the end of the portal in the exit sector.
+	 * @return Cell coordinates of the end of the portal in the exit sector (relative to sector origin).
 	 */
-	const coord::tile get_exit_end(sector_id_t entry_sector) const;
+	const coord::tile_delta get_exit_end(sector_id_t entry_sector) const;
 
 	/**
 	 * Get the direction of the portal from sector 0 to sector 1.
@@ -170,30 +170,30 @@ class Portal {
 	/**
 	 * Get the start cell coordinates of the portal.
 	 *
-	 * @return Start cell coordinates of the portal.
+	 * @return Start cell coordinates of the portal (relative to sector origin).
 	 */
-	const coord::tile &get_sector0_start() const;
+	const coord::tile_delta &get_sector0_start() const;
 
 	/**
 	 * Get the end cell coordinates of the portal.
 	 *
-	 * @return End cell coordinates of the portal.
+	 * @return End cell coordinates of the portal (relative to sector origin).
 	 */
-	const coord::tile &get_sector0_end() const;
+	const coord::tile_delta &get_sector0_end() const;
 
 	/**
 	 * Get the start cell coordinates of the portal.
 	 *
-	 * @return Start cell coordinates of the portal.
+	 * @return Start cell coordinates of the portal (relative to sector origin).
 	 */
-	const coord::tile get_sector1_start() const;
+	const coord::tile_delta get_sector1_start() const;
 
 	/**
 	 * Get the end cell coordinates of the portal.
 	 *
-	 * @return End cell coordinates of the portal.
+	 * @return End cell coordinates of the portal (relative to sector origin).
 	 */
-	const coord::tile get_sector1_end() const;
+	const coord::tile_delta get_sector1_end() const;
 
 	/**
 	 * ID of the portal.
@@ -230,13 +230,17 @@ class Portal {
 	PortalDirection direction;
 
 	/**
-	 * Start cell coordinate.
+	 * Start cell coordinate in sector 0 (relative to sector origin).
+	 *
+	 * Coordinates for sector 1 are calculated on-the-fly using the direction.
 	 */
-	coord::tile cell_start;
+	coord::tile_delta cell_start;
 
 	/**
-	 * End cell coordinate.
+	 * End cell coordinate in sector 0 (relative to sector origin).
+	 *
+	 * Coordinates for sector 1 are calculated on-the-fly using the direction.
 	 */
-	coord::tile cell_end;
+	coord::tile_delta cell_end;
 };
 } // namespace openage::path
diff --git a/libopenage/pathfinding/sector.cpp b/libopenage/pathfinding/sector.cpp
index cf6ffaa755..f50dc209bf 100644
--- a/libopenage/pathfinding/sector.cpp
+++ b/libopenage/pathfinding/sector.cpp
@@ -61,17 +61,17 @@ std::vector<std::shared_ptr<Portal>> Sector::find_portals(const std::shared_ptr<
 	size_t end = 0;
 	bool passable_edge = false;
 	for (size_t i = 0; i < this->cost_field->get_size(); ++i) {
-		auto coord_this = coord::tile{0, 0};
-		auto coord_other = coord::tile{0, 0};
+		auto coord_this = coord::tile_delta{0, 0};
+		auto coord_other = coord::tile_delta{0, 0};
 		if (direction == PortalDirection::NORTH_SOUTH) {
 			// right edge; top to bottom
-			coord_this = coord::tile(i, this->cost_field->get_size() - 1);
-			coord_other = coord::tile(i, 0);
+			coord_this = coord::tile_delta(i, this->cost_field->get_size() - 1);
+			coord_other = coord::tile_delta(i, 0);
 		}
 		else if (direction == PortalDirection::EAST_WEST) {
 			// bottom edge; east to west
-			coord_this = coord::tile(this->cost_field->get_size() - 1, i);
-			coord_other = coord::tile(0, i);
+			coord_this = coord::tile_delta(this->cost_field->get_size() - 1, i);
+			coord_other = coord::tile_delta(0, i);
 		}
 
 		if (this->cost_field->get_cost(coord_this) != COST_IMPASSABLE
@@ -94,17 +94,17 @@ std::vector<std::shared_ptr<Portal>> Sector::find_portals(const std::shared_ptr<
 
 		if (passable_edge) {
 			// create a new portal
-			auto coord_start = coord::tile{0, 0};
-			auto coord_end = coord::tile{0, 0};
+			auto coord_start = coord::tile_delta{0, 0};
+			auto coord_end = coord::tile_delta{0, 0};
 			if (direction == PortalDirection::NORTH_SOUTH) {
 				// right edge; top to bottom
-				coord_start = coord::tile(start, this->cost_field->get_size() - 1);
-				coord_end = coord::tile(end, this->cost_field->get_size() - 1);
+				coord_start = coord::tile_delta(start, this->cost_field->get_size() - 1);
+				coord_end = coord::tile_delta(end, this->cost_field->get_size() - 1);
 			}
 			else if (direction == PortalDirection::EAST_WEST) {
 				// bottom edge; east to west
-				coord_start = coord::tile(this->cost_field->get_size() - 1, start);
-				coord_end = coord::tile(this->cost_field->get_size() - 1, end);
+				coord_start = coord::tile_delta(this->cost_field->get_size() - 1, start);
+				coord_end = coord::tile_delta(this->cost_field->get_size() - 1, end);
 			}
 
 			result.push_back(
diff --git a/libopenage/pathfinding/sector.h b/libopenage/pathfinding/sector.h
index f39f1904a9..a4ba94fa52 100644
--- a/libopenage/pathfinding/sector.h
+++ b/libopenage/pathfinding/sector.h
@@ -57,7 +57,7 @@ class Sector {
 	/**
 	 * Get the position of this sector in the grid.
 	 *
-	 * @return Position of the sector.
+	 * @return Position of the sector (absolute on the grid).
 	 */
 	const coord::chunk &get_position() const;
 
@@ -110,7 +110,7 @@ class Sector {
 	sector_id_t id;
 
 	/**
-	 * Position of the sector in the grid.
+	 * Position of the sector (absolute on the grid).
 	 */
 	coord::chunk position;
 
diff --git a/libopenage/pathfinding/tests.cpp b/libopenage/pathfinding/tests.cpp
index 2c9775ca36..12c96cc30e 100644
--- a/libopenage/pathfinding/tests.cpp
+++ b/libopenage/pathfinding/tests.cpp
@@ -28,7 +28,7 @@ void flow_field() {
 	// Test the different field types
 	{
 		auto integration_field = std::make_shared<IntegrationField>(3);
-		integration_field->integrate_cost(cost_field, coord::tile{2, 2});
+		integration_field->integrate_cost(cost_field, coord::tile_delta{2, 2});
 		auto int_cells = integration_field->get_cells();
 
 		// The integration field should look like:
@@ -85,7 +85,7 @@ void flow_field() {
 		auto integrator = std::make_shared<Integrator>();
 
 		// Build the flow field
-		auto flow_field = integrator->build(cost_field, coord::tile{2, 2}).second;
+		auto flow_field = integrator->build(cost_field, coord::tile_delta{2, 2}).second;
 		auto ff_cells = flow_field->get_cells();
 
 		// The flow field for targeting (2, 2) hould look like this:

From 258c5922d135ae30ab07cbef5b58ba3b1068f7d5 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 23:49:49 +0200
Subject: [PATCH 17/68] path: Use x,y cell position instead of coord types for
 most operations.

---
 libopenage/pathfinding/cost_field.cpp        |  8 +++++
 libopenage/pathfinding/cost_field.h          | 18 ++++++++++
 libopenage/pathfinding/demo/demo_0.cpp       | 16 ++++-----
 libopenage/pathfinding/demo/demo_1.cpp       |  2 +-
 libopenage/pathfinding/flow_field.cpp        | 16 +++++++++
 libopenage/pathfinding/flow_field.h          | 38 ++++++++++++++++++++
 libopenage/pathfinding/integration_field.cpp | 12 ++++---
 libopenage/pathfinding/integration_field.h   |  9 +++++
 libopenage/pathfinding/pathfinder.cpp        |  6 ++--
 9 files changed, 109 insertions(+), 16 deletions(-)

diff --git a/libopenage/pathfinding/cost_field.cpp b/libopenage/pathfinding/cost_field.cpp
index e85fecc3ed..3299084548 100644
--- a/libopenage/pathfinding/cost_field.cpp
+++ b/libopenage/pathfinding/cost_field.cpp
@@ -25,6 +25,10 @@ cost_t CostField::get_cost(const coord::tile_delta &pos) const {
 	return this->cells.at(pos.ne + pos.se * this->size);
 }
 
+cost_t CostField::get_cost(size_t x, size_t y) const {
+	return this->cells.at(x + y * this->size);
+}
+
 cost_t CostField::get_cost(size_t idx) const {
 	return this->cells.at(idx);
 }
@@ -33,6 +37,10 @@ void CostField::set_cost(const coord::tile_delta &pos, cost_t cost) {
 	this->cells[pos.ne + pos.se * this->size] = cost;
 }
 
+void CostField::set_cost(size_t x, size_t y, cost_t cost) {
+	this->cells[x + y * this->size] = cost;
+}
+
 void CostField::set_cost(size_t idx, cost_t cost) {
 	this->cells[idx] = cost;
 }
diff --git a/libopenage/pathfinding/cost_field.h b/libopenage/pathfinding/cost_field.h
index 8b805c524a..a1fc87b046 100644
--- a/libopenage/pathfinding/cost_field.h
+++ b/libopenage/pathfinding/cost_field.h
@@ -42,6 +42,15 @@ class CostField {
 	 */
 	cost_t get_cost(const coord::tile_delta &pos) const;
 
+	/**
+	 * Get the cost at a specified position.
+	 *
+	 * @param x X-coordinate of the cell.
+	 * @param y Y-coordinate of the cell.
+	 * @return Cost at the specified position.
+	 */
+	cost_t get_cost(size_t x, size_t y) const;
+
 	/**
 	 * Get the cost at a specified position.
 	 *
@@ -58,6 +67,15 @@ class CostField {
 	 */
 	void set_cost(const coord::tile_delta &pos, cost_t cost);
 
+	/**
+	 * Set the cost at a specified position.
+	 *
+	 * @param x X-coordinate of the cell.
+	 * @param y Y-coordinate of the cell.
+	 * @param cost Cost to set.
+	 */
+	void set_cost(size_t x, size_t y, cost_t cost);
+
 	/**
 	 * Set the cost at a specified position.
 	 *
diff --git a/libopenage/pathfinding/demo/demo_0.cpp b/libopenage/pathfinding/demo/demo_0.cpp
index d90d5ef39d..8e844d942d 100644
--- a/libopenage/pathfinding/demo/demo_0.cpp
+++ b/libopenage/pathfinding/demo/demo_0.cpp
@@ -567,19 +567,19 @@ renderer::resources::MeshData RenderManager0::get_cost_field_mesh(const std::sha
 			// for each vertex, compare the surrounding tiles
 			std::vector<float> surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
-				auto cost = field->get_cost(coord::tile_delta((i - 1) / resolution, (j - 1) / resolution));
+				auto cost = field->get_cost((i - 1) / resolution, (j - 1) / resolution);
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i - 1 >= 0) {
-				auto cost = field->get_cost(coord::tile_delta((i - 1) / resolution, j / resolution));
+				auto cost = field->get_cost((i - 1) / resolution, j / resolution);
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cost(coord::tile_delta(i / resolution, j / resolution));
+				auto cost = field->get_cost(i / resolution, j / resolution);
 				surround.push_back(cost);
 			}
 			if (j - 1 >= 0 and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cost(coord::tile_delta(i / resolution, (j - 1) / resolution));
+				auto cost = field->get_cost(i / resolution, (j - 1) / resolution);
 				surround.push_back(cost);
 			}
 			// use the cost of the most expensive surrounding tile
@@ -653,19 +653,19 @@ renderer::resources::MeshData RenderManager0::get_integration_field_mesh(const s
 			// for each vertex, compare the surrounding tiles
 			std::vector<float> surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, (j - 1) / resolution)).cost;
+				auto cost = field->get_cell((i - 1) / resolution, (j - 1) / resolution).cost;
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, j / resolution)).cost;
+				auto cost = field->get_cell((i - 1) / resolution, j / resolution).cost;
 				surround.push_back(cost);
 			}
 			if (j < static_cast<int>(field->get_size()) and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile_delta(i / resolution, j / resolution)).cost;
+				auto cost = field->get_cell(i / resolution, j / resolution).cost;
 				surround.push_back(cost);
 			}
 			if (j - 1 >= 0 and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile_delta(i / resolution, (j - 1) / resolution)).cost;
+				auto cost = field->get_cell(i / resolution, (j - 1) / resolution).cost;
 				surround.push_back(cost);
 			}
 			// use the cost of the most expensive surrounding tile
diff --git a/libopenage/pathfinding/demo/demo_1.cpp b/libopenage/pathfinding/demo/demo_1.cpp
index 907caeb3d5..d7daaf4675 100644
--- a/libopenage/pathfinding/demo/demo_1.cpp
+++ b/libopenage/pathfinding/demo/demo_1.cpp
@@ -449,7 +449,7 @@ void RenderManager1::create_impassible_tiles(const std::shared_ptr<path::Grid> &
 			auto cost_field = sector->get_cost_field();
 			for (size_t y = 0; y < sector_size; y++) {
 				for (size_t x = 0; x < sector_size; x++) {
-					auto cost = cost_field->get_cost(coord::tile_delta(x, y));
+					auto cost = cost_field->get_cost(x, y);
 					if (cost == COST_IMPASSABLE) {
 						std::array<float, 8> tile_data{
 							-1.0f + x * tile_offset_width + sector_size * sector_x * tile_offset_width,
diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 56fccc155c..bb6c2d6b6e 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -34,10 +34,26 @@ flow_t FlowField::get_cell(const coord::tile_delta &pos) const {
 	return this->cells.at(pos.ne + pos.se * this->size);
 }
 
+flow_t FlowField::get_cell(size_t x, size_t y) const {
+	return this->cells.at(x + y * this->size);
+}
+
+flow_t FlowField::get_cell(size_t idx) const {
+	return this->cells.at(idx);
+}
+
 flow_dir_t FlowField::get_dir(const coord::tile_delta &pos) const {
 	return static_cast<flow_dir_t>(this->get_cell(pos) & FLOW_DIR_MASK);
 }
 
+flow_dir_t FlowField::get_dir(size_t x, size_t y) const {
+	return static_cast<flow_dir_t>(this->get_cell(x, y) & FLOW_DIR_MASK);
+}
+
+flow_dir_t FlowField::get_dir(size_t idx) const {
+	return static_cast<flow_dir_t>(this->get_cell(idx) & FLOW_DIR_MASK);
+}
+
 void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field,
                       const std::unordered_set<size_t> &target_cells) {
 	ENSURE(integration_field->get_size() == this->get_size(),
diff --git a/libopenage/pathfinding/flow_field.h b/libopenage/pathfinding/flow_field.h
index 6ae3882c5d..4a055d3cb1 100644
--- a/libopenage/pathfinding/flow_field.h
+++ b/libopenage/pathfinding/flow_field.h
@@ -52,6 +52,25 @@ class FlowField {
 	 */
 	flow_t get_cell(const coord::tile_delta &pos) const;
 
+	/**
+	 * Get the flow field value at a specified position.
+	 *
+	 * @param x X-coordinate of the cell.
+	 * @param y Y-coordinate of the cell.
+	 *
+	 * @return Flowfield value at the specified position.
+	 */
+	flow_t get_cell(size_t x, size_t y) const;
+
+	/**
+	 * Get the flow field direction at a specified position.
+	 *
+	 * @param idx Index of the cell.
+	 *
+	 * @return Flowfield value at the specified position.
+	 */
+	flow_t get_cell(size_t idx) const;
+
 	/**
 	 * Get the flow field direction at a specified position.
 	 *
@@ -61,6 +80,25 @@ class FlowField {
 	 */
 	flow_dir_t get_dir(const coord::tile_delta &pos) const;
 
+	/**
+	 * Get the flow field direction at a specified position.
+	 *
+	 * @param x X-coordinate of the cell.
+	 * @param y Y-coordinate of the cell.
+	 *
+	 * @return Flowfield direction at the specified position.
+	 */
+	flow_dir_t get_dir(size_t x, size_t y) const;
+
+	/**
+	 * Get the flow field direction at a specified position.
+	 *
+	 * @param idx Index of the cell.
+	 *
+	 * @return Flowfield direction at the specified position.
+	 */
+	flow_dir_t get_dir(size_t idx) const;
+
 	/**
 	 * Build the flow field.
 	 *
diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 2a7fe7df7d..0219dd17f3 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -29,6 +29,10 @@ const integrated_t &IntegrationField::get_cell(const coord::tile_delta &pos) con
 	return this->cells.at(pos.ne + pos.se * this->size);
 }
 
+const integrated_t &IntegrationField::get_cell(size_t x, size_t y) const {
+	return this->cells.at(x + y * this->size);
+}
+
 const integrated_t &IntegrationField::get_cell(size_t idx) const {
 	return this->cells.at(idx);
 }
@@ -345,16 +349,16 @@ std::vector<std::pair<int, int>> IntegrationField::get_los_corners(const std::sh
 
 	// Get neighbor costs (if they exist)
 	if (blocker.se > 0) {
-		top_cost = cost_field->get_cost(coord::tile_delta{blocker.ne, blocker.se - 1});
+		top_cost = cost_field->get_cost(blocker.ne, blocker.se - 1);
 	}
 	if (blocker.ne > 0) {
-		left_cost = cost_field->get_cost(coord::tile_delta{blocker.ne - 1, blocker.se});
+		left_cost = cost_field->get_cost(blocker.ne - 1, blocker.se);
 	}
 	if (static_cast<size_t>(blocker.se) < this->size - 1) {
-		bottom_cost = cost_field->get_cost(coord::tile_delta{blocker.ne, blocker.se + 1});
+		bottom_cost = cost_field->get_cost(blocker.ne, blocker.se + 1);
 	}
 	if (static_cast<size_t>(blocker.ne) < this->size - 1) {
-		right_cost = cost_field->get_cost(coord::tile_delta{blocker.ne + 1, blocker.se});
+		right_cost = cost_field->get_cost(blocker.ne + 1, blocker.se);
 	}
 
 	// Check which corners are blocking LOS
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index fc5f087404..40e6780c8f 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -47,6 +47,15 @@ class IntegrationField {
 	 */
 	const integrated_t &get_cell(const coord::tile_delta &pos) const;
 
+	/**
+	 * Get the integration value at a specified position.
+	 *
+	 * @param x X-coordinate of the cell.
+	 * @param y Y-coordinate of the cell.
+	 * @return Integration value at the specified position.
+	 */
+	const integrated_t &get_cell(size_t x, size_t y) const;
+
 	/**
 	 * Get the integration value at a specified position.
 	 *
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 300bc7d92d..22662c9e9d 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -41,7 +41,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 		auto start_x = request.start.ne % sector_size;
 		auto start_y = request.start.se % sector_size;
 
-		if (target_integration_field->get_cell(coord::tile_delta{start_x, start_y}).cost != INTEGRATED_COST_UNREACHABLE) {
+		if (target_integration_field->get_cell(start_x, start_y).cost != INTEGRATED_COST_UNREACHABLE) {
 			// Exit early if the start and target are in the same sector
 			// and are reachable from within the same sector
 			auto flow_field = this->integrator->build(target_integration_field);
@@ -295,7 +295,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 
 	coord::tile_t current_x = start_x;
 	coord::tile_t current_y = start_y;
-	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(coord::tile_delta{current_x, current_y});
+	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(current_x, current_y);
 	for (size_t i = 0; i < flow_fields.size(); ++i) {
 		auto sector = grid->get_sector(flow_fields.at(i).first);
 		auto flow_field = flow_fields.at(i).second;
@@ -305,7 +305,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 		       and current_y < static_cast<coord::tile_t>(sector_size)
 		       and current_x >= 0
 		       and current_y >= 0) {
-			auto cell = flow_field->get_cell(coord::tile_delta{current_x, current_y});
+			auto cell = flow_field->get_cell(current_x, current_y);
 			if (cell & FLOW_LOS_MASK) {
 				// check if we reached an LOS cell
 				auto sector_pos = sector->get_position();

From 66709b4f913735e09a4ac3c4049967d2770bdef7 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Tue, 21 May 2024 23:55:18 +0200
Subject: [PATCH 18/68] path: Fix crash in demo 1 when path is not found.

---
 libopenage/pathfinding/demo/demo_1.cpp | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/libopenage/pathfinding/demo/demo_1.cpp b/libopenage/pathfinding/demo/demo_1.cpp
index d7daaf4675..801eea045d 100644
--- a/libopenage/pathfinding/demo/demo_1.cpp
+++ b/libopenage/pathfinding/demo/demo_1.cpp
@@ -135,8 +135,10 @@ void path_demo_1(const util::Path &path) {
 
 				log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " ps");
 
-				// Create renderables for the waypoints of the path
-				render_manager->create_waypoint_tiles(path_result);
+				if (path_result.status == PathResult::FOUND) {
+					// Create renderables for the waypoints of the path
+					render_manager->create_waypoint_tiles(path_result);
+				}
 			}
 			else if (ev.button() == Qt::LeftButton) { // Set start cell
 				start = coord::tile{grid_x, grid_y};
@@ -153,8 +155,10 @@ void path_demo_1(const util::Path &path) {
 
 				log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " ps");
 
-				// Create renderables for the waypoints of the path
-				render_manager->create_waypoint_tiles(path_result);
+				if (path_result.status == PathResult::FOUND) {
+					// Create renderables for the waypoints of the path
+					render_manager->create_waypoint_tiles(path_result);
+				}
 			}
 		}
 	});

From d26915041abd837200b7acfe32046a2408dddb99 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Wed, 22 May 2024 01:08:23 +0200
Subject: [PATCH 19/68] path: Flag in integration field.

Speeds up flow field creation by ~30%.
---
 libopenage/pathfinding/definitions.h         |  7 +++++++
 libopenage/pathfinding/flow_field.cpp        | 14 +++-----------
 libopenage/pathfinding/flow_field.h          |  5 +----
 libopenage/pathfinding/integration_field.cpp |  2 ++
 4 files changed, 13 insertions(+), 15 deletions(-)

diff --git a/libopenage/pathfinding/definitions.h b/libopenage/pathfinding/definitions.h
index d61c5fe43c..4e184406cd 100644
--- a/libopenage/pathfinding/definitions.h
+++ b/libopenage/pathfinding/definitions.h
@@ -52,6 +52,11 @@ constexpr integrated_flags_t INTEGRATE_LOS_MASK = 0x01;
  */
 constexpr integrated_flags_t INTEGRATE_WAVEFRONT_BLOCKED_MASK = 0x02;
 
+/**
+ * Target flag in an integrated_flags_t value.
+ */
+constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x40;
+
 /**
  * Initial value for a cell in the integration grid.
  */
@@ -80,6 +85,8 @@ constexpr flow_t FLOW_LOS_MASK = 0x20;
 
 /**
  * Wavefront blocked flag in a flow_t value.
+ *
+ * TODO: This flag is only used in demo 0 and can be removed.
  */
 constexpr flow_t FLOW_WAVEFRONT_BLOCKED_MASK = 0x40;
 
diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index bb6c2d6b6e..c005e6cf05 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -54,8 +54,7 @@ flow_dir_t FlowField::get_dir(size_t idx) const {
 	return static_cast<flow_dir_t>(this->get_cell(idx) & FLOW_DIR_MASK);
 }
 
-void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field,
-                      const std::unordered_set<size_t> &target_cells) {
+void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field) {
 	ENSURE(integration_field->get_size() == this->get_size(),
 	       "integration field size "
 	           << integration_field->get_size() << "x" << integration_field->get_size()
@@ -69,7 +68,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 		for (size_t x = 0; x < this->size; ++x) {
 			size_t idx = y * this->size + x;
 
-			if (target_cells.contains(idx)) {
+			if (integrate_cells[idx].flags & INTEGRATE_TARGET_MASK) {
 				// Ignore target cells
 				continue;
 			}
@@ -204,9 +203,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 	// TODO: Compare integration values from other side of portal
 	// auto &integrate_cells = integration_field->get_cells();
 
-	// cells that are part of the portal
-	std::unordered_set<size_t> portal_cells;
-
 	// set the direction for the flow field cells that are part of the portal
 	if (direction == PortalDirection::NORTH_SOUTH) {
 		bool other_is_north = entry_start.se > exit_start.se;
@@ -216,7 +212,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				auto idx = y * this->size + x;
 				flow_cells[idx] = flow_cells[idx] | FLOW_PATHABLE_MASK;
 				flow_cells[idx] = flow_cells[idx] | static_cast<uint8_t>(flow_dir_t::NORTH);
-				portal_cells.insert(idx);
 			}
 		}
 		else {
@@ -225,7 +220,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				auto idx = y * this->size + x;
 				flow_cells[idx] = flow_cells[idx] | FLOW_PATHABLE_MASK;
 				flow_cells[idx] = flow_cells[idx] | static_cast<uint8_t>(flow_dir_t::SOUTH);
-				portal_cells.insert(idx);
 			}
 		}
 	}
@@ -237,7 +231,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				auto idx = y * this->size + x;
 				flow_cells[idx] = flow_cells[idx] | FLOW_PATHABLE_MASK;
 				flow_cells[idx] = flow_cells[idx] | static_cast<uint8_t>(flow_dir_t::EAST);
-				portal_cells.insert(idx);
 			}
 		}
 		else {
@@ -246,7 +239,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				auto idx = y * this->size + x;
 				flow_cells[idx] = flow_cells[idx] | FLOW_PATHABLE_MASK;
 				flow_cells[idx] = flow_cells[idx] | static_cast<uint8_t>(flow_dir_t::WEST);
-				portal_cells.insert(idx);
 			}
 		}
 	}
@@ -254,7 +246,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 		throw Error(ERR << "Invalid portal direction: " << static_cast<int>(direction));
 	}
 
-	this->build(integration_field, portal_cells);
+	this->build(integration_field);
 }
 
 const std::vector<flow_t> &FlowField::get_cells() const {
diff --git a/libopenage/pathfinding/flow_field.h b/libopenage/pathfinding/flow_field.h
index 4a055d3cb1..51a7d9a90d 100644
--- a/libopenage/pathfinding/flow_field.h
+++ b/libopenage/pathfinding/flow_field.h
@@ -103,11 +103,8 @@ class FlowField {
 	 * Build the flow field.
 	 *
 	 * @param integration_field Integration field.
-	 * @param target_cells Target cells of the flow field. These cells are ignored
-	 *                     when building the field.
 	 */
-	void build(const std::shared_ptr<IntegrationField> &integration_field,
-	           const std::unordered_set<size_t> &target_cells = {});
+	void build(const std::shared_ptr<IntegrationField> &integration_field);
 
 	/**
 	 * Build the flow field for a portal.
diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 0219dd17f3..1d95c9225a 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -202,6 +202,7 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 
 	// Move outwards from the target cell, updating the integration field
 	this->cells[target_idx].cost = INTEGRATED_COST_START;
+	this->cells[target_idx].flags |= INTEGRATE_TARGET_MASK;
 	this->integrate_cost(cost_field, {target_idx});
 }
 
@@ -225,6 +226,7 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 
 			// Set the cost of all target cells to the start value
 			this->cells[target_idx].cost = INTEGRATED_COST_START;
+			this->cells[target_idx].flags |= INTEGRATE_TARGET_MASK;
 			start_cells.push_back(target_idx);
 
 			// TODO: Transfer flags and cost from the other integration field

From 60cf82a0f454233c2ace88ecb4acf8bde202d22b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Wed, 22 May 2024 01:10:42 +0200
Subject: [PATCH 20/68] path: Fix time unit log (microseconds instead of
 picoseconds).

---
 libopenage/pathfinding/demo/demo_1.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libopenage/pathfinding/demo/demo_1.cpp b/libopenage/pathfinding/demo/demo_1.cpp
index 801eea045d..3d00d31b0c 100644
--- a/libopenage/pathfinding/demo/demo_1.cpp
+++ b/libopenage/pathfinding/demo/demo_1.cpp
@@ -133,7 +133,7 @@ void path_demo_1(const util::Path &path) {
 				path_result = pathfinder->get_path(new_path_request);
 				timer.stop();
 
-				log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " ps");
+				log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " us");
 
 				if (path_result.status == PathResult::FOUND) {
 					// Create renderables for the waypoints of the path
@@ -153,7 +153,7 @@ void path_demo_1(const util::Path &path) {
 				path_result = pathfinder->get_path(new_path_request);
 				timer.stop();
 
-				log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " ps");
+				log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " us");
 
 				if (path_result.status == PathResult::FOUND) {
 					// Create renderables for the waypoints of the path

From 6c7a471ba71e532073325df81ff3d0716e8a201b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 25 May 2024 06:30:02 +0200
Subject: [PATCH 21/68] coord: Make tile_per_chunk type-compatible with tile_t.

---
 libopenage/coord/chunk.cpp | 4 ++--
 libopenage/coord/chunk.h   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/libopenage/coord/chunk.cpp b/libopenage/coord/chunk.cpp
index 19cb606295..62ab65be32 100644
--- a/libopenage/coord/chunk.cpp
+++ b/libopenage/coord/chunk.cpp
@@ -8,11 +8,11 @@
 namespace openage {
 namespace coord {
 
-tile_delta chunk_delta::to_tile(size_t tiles_per_chunk) const {
+tile_delta chunk_delta::to_tile(tile_t tiles_per_chunk) const {
 	return tile_delta{this->ne * tiles_per_chunk, this->se * tiles_per_chunk};
 }
 
-tile chunk::to_tile(size_t tiles_per_chunk) const {
+tile chunk::to_tile(tile_t tiles_per_chunk) const {
 	return tile{this->ne * tiles_per_chunk, this->se * tiles_per_chunk};
 }
 
diff --git a/libopenage/coord/chunk.h b/libopenage/coord/chunk.h
index 0b5a1d50c0..158888c9a1 100644
--- a/libopenage/coord/chunk.h
+++ b/libopenage/coord/chunk.h
@@ -13,13 +13,13 @@ namespace coord {
 struct chunk_delta : CoordNeSeRelative<chunk_t, chunk, chunk_delta> {
 	using CoordNeSeRelative<chunk_t, chunk, chunk_delta>::CoordNeSeRelative;
 
-	tile_delta to_tile(size_t tiles_per_chunk) const;
+	tile_delta to_tile(tile_t tiles_per_chunk) const;
 };
 
 struct chunk : CoordNeSeAbsolute<chunk_t, chunk, chunk_delta> {
 	using CoordNeSeAbsolute<chunk_t, chunk, chunk_delta>::CoordNeSeAbsolute;
 
-	tile to_tile(size_t tiles_per_chunk) const;
+	tile to_tile(tile_t tiles_per_chunk) const;
 };
 
 struct chunk3_delta : CoordNeSeUpRelative<chunk_t, chunk3, chunk3_delta> {

From 308c913aaae67301b65e013d11e37b03664efc25 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 25 May 2024 12:26:58 +0200
Subject: [PATCH 22/68] gamestate: Fix setting recent angle position.

---
 libopenage/gamestate/component/internal/position.cpp | 4 ++--
 libopenage/gamestate/system/move.cpp                 | 4 +++-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/libopenage/gamestate/component/internal/position.cpp b/libopenage/gamestate/component/internal/position.cpp
index 61611382cf..7c4b7bbb83 100644
--- a/libopenage/gamestate/component/internal/position.cpp
+++ b/libopenage/gamestate/component/internal/position.cpp
@@ -1,4 +1,4 @@
-// Copyright 2021-2023 the openage authors. See copying.md for legal info.
+// Copyright 2021-2024 the openage authors. See copying.md for legal info.
 
 #include "position.h"
 
@@ -60,7 +60,7 @@ const curve::Segmented<coord::phys_angle_t> &Position::get_angles() const {
 
 void Position::set_angle(const time::time_t &time, const coord::phys_angle_t &angle) {
 	auto old_angle = this->angle.get(time);
-	this->angle.set_insert_jump(time, old_angle, angle);
+	this->angle.set_last_jump(time, old_angle, angle);
 }
 
 } // namespace openage::gamestate::component
diff --git a/libopenage/gamestate/system/move.cpp b/libopenage/gamestate/system/move.cpp
index 158beea6ac..0031a2624d 100644
--- a/libopenage/gamestate/system/move.cpp
+++ b/libopenage/gamestate/system/move.cpp
@@ -127,7 +127,6 @@ const time::time_t Move::move_default(const std::shared_ptr<gamestate::GameEntit
 	// use waypoints for movement
 	double total_time = 0;
 	pos_component->set_position(start_time, current_pos);
-	auto prev_angle = current_angle;
 	for (size_t i = 1; i < waypoints.size(); ++i) {
 		auto prev_waypoint = waypoints[i - 1];
 		auto cur_waypoint = waypoints[i];
@@ -153,6 +152,9 @@ const time::time_t Move::move_default(const std::shared_ptr<gamestate::GameEntit
 			double turn_time = angle_diff.to_double() / turn_speed->get();
 			total_time += turn_time;
 			pos_component->set_position(start_time + total_time, prev_waypoint);
+
+			// update current angle for next waypoint
+			current_angle = path_angle;
 		}
 		pos_component->set_angle(start_time + total_time, path_angle);
 

From e7f7ed98be5473d7a3695ea4b132dcb923bbd137 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 25 May 2024 12:52:48 +0200
Subject: [PATCH 23/68] coord: Reorder tiles and fix missing conversions.

---
 libopenage/coord/tile.cpp | 47 +++++++++++++++++++++++----------------
 libopenage/coord/tile.h   |  9 +++-----
 2 files changed, 31 insertions(+), 25 deletions(-)

diff --git a/libopenage/coord/tile.cpp b/libopenage/coord/tile.cpp
index e20868ff98..b1eb9593a4 100644
--- a/libopenage/coord/tile.cpp
+++ b/libopenage/coord/tile.cpp
@@ -8,55 +8,64 @@
 
 namespace openage::coord {
 
+phys2_delta tile_delta::to_phys2() const {
+	return phys2_delta{phys2::elem_t::from_int(this->ne),
+	                   phys2::elem_t::from_int(this->se)};
+}
 
-tile3 tile::to_tile3(tile_t up) const {
-	return tile3(this->ne, this->se, up);
+phys3_delta tile_delta::to_phys3(tile_t up) const {
+	return phys3_delta{phys3::elem_t::from_int(this->ne),
+	                   phys3::elem_t::from_int(this->se),
+	                   phys3::elem_t::from_int(up)};
 }
 
+tile3 tile::to_tile3(tile_t up) const {
+	return tile3{this->ne, this->se, up};
+}
 
 phys2 tile::to_phys2() const {
-	return phys2{phys3::elem_t::from_int(this->ne), phys3::elem_t::from_int(this->se)};
+	return phys2{phys3::elem_t::from_int(this->ne),
+	             phys3::elem_t::from_int(this->se)};
 }
 
-
 phys3 tile::to_phys3(tile_t up) const {
 	return this->to_tile3(up).to_phys3();
 }
 
-
 chunk tile::to_chunk() const {
 	return chunk{
 		static_cast<chunk::elem_t>(util::div(this->ne, tiles_per_chunk)),
 		static_cast<chunk::elem_t>(util::div(this->se, tiles_per_chunk))};
 }
 
-
 tile_delta tile::get_pos_on_chunk() const {
 	return tile_delta{
 		util::mod(this->ne, tiles_per_chunk),
 		util::mod(this->se, tiles_per_chunk)};
 }
 
-
-phys2 tile3::to_phys2() const {
-	return this->to_tile().to_phys2();
+tile_delta tile3_delta::to_tile() const {
+	return tile_delta{this->ne, this->se};
 }
 
-
-phys3 tile3::to_phys3() const {
-	return phys3{
-		phys3::elem_t::from_int(this->ne),
-		phys3::elem_t::from_int(this->se),
-		phys3::elem_t::from_int(this->up)};
+phys3_delta tile3_delta::to_phys3() const {
+	return phys3_delta{phys3::elem_t::from_int(this->ne),
+	                   phys3::elem_t::from_int(this->se),
+	                   phys3::elem_t::from_int(up)};
 }
 
+tile tile3::to_tile() const {
+	return tile{this->ne, this->se};
+}
 
-phys2_delta tile_delta::to_phys2() const {
-	return phys2_delta(this->ne, this->se);
+phys2 tile3::to_phys2() const {
+	return this->to_tile().to_phys2();
 }
 
-phys3_delta tile_delta::to_phys3(tile_t up) const {
-	return phys3_delta(this->ne, this->se, up);
+phys3 tile3::to_phys3() const {
+	return phys3{phys3::elem_t::from_int(this->ne),
+	             phys3::elem_t::from_int(this->se),
+	             phys3::elem_t::from_int(this->up)};
 }
 
 } // namespace openage::coord
diff --git a/libopenage/coord/tile.h b/libopenage/coord/tile.h
index e8e61a09c2..1fff2efa21 100644
--- a/libopenage/coord/tile.h
+++ b/libopenage/coord/tile.h
@@ -20,6 +20,7 @@ namespace coord {
 struct tile_delta : CoordNeSeRelative<tile_t, tile, tile_delta> {
 	using CoordNeSeRelative<tile_t, tile, tile_delta>::CoordNeSeRelative;
 
+	// coordinate conversions
 	phys2_delta to_phys2() const;
 	phys3_delta to_phys3(tile_t up = 0) const;
 };
@@ -45,9 +46,7 @@ struct tile3_delta : CoordNeSeUpRelative<tile_t, tile3, tile3_delta> {
 
 	// coordinate conversions
 	// simply discards the UP component of the coordinate delta.
-	constexpr tile_delta to_tile() const {
-		return tile_delta{this->ne, this->se};
-	}
+	tile_delta to_tile() const;
 	phys3_delta to_phys3() const;
 };
 
@@ -56,9 +55,7 @@ struct tile3 : CoordNeSeUpAbsolute<tile_t, tile3, tile3_delta> {
 
 	// coordinate conversions
 	// simply discards the UP component of the coordinate.
-	constexpr tile to_tile() const {
-		return tile{this->ne, this->se};
-	}
+	tile to_tile() const;
 	phys2 to_phys2() const;
 	phys3 to_phys3() const;
 };

From 58281773e4913792b75c19ec6f553193ef416e4d Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 25 May 2024 12:58:39 +0200
Subject: [PATCH 24/68] gamestate: Use tile center for waypoints in path.

---
 libopenage/coord/tile.cpp            | 24 +++++++++++++++++++++++-
 libopenage/coord/tile.h              |  7 +++++++
 libopenage/gamestate/system/move.cpp |  2 +-
 3 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/libopenage/coord/tile.cpp b/libopenage/coord/tile.cpp
index b1eb9593a4..e447819799 100644
--- a/libopenage/coord/tile.cpp
+++ b/libopenage/coord/tile.cpp
@@ -1,4 +1,4 @@
-// Copyright 2016-2023 the openage authors. See copying.md for legal info.
+// Copyright 2016-2024 the openage authors. See copying.md for legal info.
 
 #include "tile.h"
 
@@ -32,6 +32,17 @@ phys3 tile::to_phys3(tile_t up) const {
 	return this->to_tile3(up).to_phys3();
 }
 
+phys2 tile::to_phys2_center() const {
+	return phys2{phys3::elem_t::from_int(this->ne) + 0.5,
+	             phys3::elem_t::from_int(this->se) + 0.5};
+}
+
+phys3 tile::to_phys3_center(tile_t up) const {
+	return phys3{phys3::elem_t::from_int(this->ne) + 0.5,
+	             phys3::elem_t::from_int(this->se) + 0.5,
+	             phys3::elem_t::from_int(up)};
+}
+
 chunk tile::to_chunk() const {
 	return chunk{
 		static_cast<chunk::elem_t>(util::div(this->ne, tiles_per_chunk)),
@@ -68,4 +79,15 @@ phys3 tile3::to_phys3() const {
 	             phys3::elem_t::from_int(this->up)};
 }
 
+phys2 tile3::to_phys2_center() const {
+	return phys2{phys3::elem_t::from_int(this->ne) + 0.5,
+	             phys3::elem_t::from_int(this->se) + 0.5};
+}
+
+phys3 tile3::to_phys3_center() const {
+	return phys3{phys3::elem_t::from_int(this->ne) + 0.5,
+	             phys3::elem_t::from_int(this->se) + 0.5,
+	             phys3::elem_t::from_int(this->up)};
+}
+
 } // namespace openage::coord
diff --git a/libopenage/coord/tile.h b/libopenage/coord/tile.h
index 1fff2efa21..ec685b8002 100644
--- a/libopenage/coord/tile.h
+++ b/libopenage/coord/tile.h
@@ -35,8 +35,12 @@ struct tile : CoordNeSeAbsolute<tile_t, tile, tile_delta> {
 	 * elevation.
 	 */
 	tile3 to_tile3(tile_t up = 0) const;
+
 	phys2 to_phys2() const;
 	phys3 to_phys3(tile_t up = 0) const;
+	phys2 to_phys2_center() const;
+	phys3 to_phys3_center(tile_t up = 0) const;
+
 	chunk to_chunk() const;
 	tile_delta get_pos_on_chunk() const;
 };
@@ -56,8 +60,11 @@ struct tile3 : CoordNeSeUpAbsolute<tile_t, tile3, tile3_delta> {
 	// coordinate conversions
 	// simply discards the UP component of the coordinate.
 	tile to_tile() const;
+
 	phys2 to_phys2() const;
 	phys3 to_phys3() const;
+	phys2 to_phys2_center() const;
+	phys3 to_phys3_center() const;
 };
 
 
diff --git a/libopenage/gamestate/system/move.cpp b/libopenage/gamestate/system/move.cpp
index 0031a2624d..3da45ceab3 100644
--- a/libopenage/gamestate/system/move.cpp
+++ b/libopenage/gamestate/system/move.cpp
@@ -64,7 +64,7 @@ std::vector<coord::phys3> find_path(const std::shared_ptr<path::Pathfinder> &pat
 	// Pathfinder waypoints contain start and end tile; we can ignore them
 	for (size_t i = 1; i < tile_path.waypoints.size() - 1; ++i) {
 		auto tile = tile_path.waypoints.at(i);
-		path.push_back(tile.to_phys3());
+		path.push_back(tile.to_phys3_center());
 	}
 
 	// End position is last waypoint

From d5d437239c38dd2d653b93011ad9529be15ccb66 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 25 May 2024 22:14:14 +0200
Subject: [PATCH 25/68] path: Reset with std::fill.

---
 libopenage/pathfinding/flow_field.cpp        | 13 ++++++++++---
 libopenage/pathfinding/flow_field.h          | 11 +++++++++++
 libopenage/pathfinding/integration_field.cpp | 14 +++++++++++---
 libopenage/pathfinding/integration_field.h   | 11 +++++++++++
 4 files changed, 43 insertions(+), 6 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index c005e6cf05..3b52aeedcf 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -254,11 +254,18 @@ const std::vector<flow_t> &FlowField::get_cells() const {
 }
 
 void FlowField::reset() {
-	for (auto &cell : this->cells) {
-		cell = FLOW_INIT;
-	}
+	std::fill(this->cells.begin(), this->cells.end(), FLOW_INIT);
 
 	log::log(DBG << "Flow field has been reset");
 }
 
+void FlowField::reset_dynamic_flags() {
+	flow_t mask = 0xFF & ~(FLOW_LOS_MASK | FLOW_WAVEFRONT_BLOCKED_MASK);
+	for (flow_t &cell : this->cells) {
+		cell = cell & mask;
+	}
+
+	log::log(DBG << "Flow field dynamic flags have been reset");
+}
+
 } // namespace openage::path
diff --git a/libopenage/pathfinding/flow_field.h b/libopenage/pathfinding/flow_field.h
index 51a7d9a90d..6d9aeaeb63 100644
--- a/libopenage/pathfinding/flow_field.h
+++ b/libopenage/pathfinding/flow_field.h
@@ -131,6 +131,17 @@ class FlowField {
 	 */
 	void reset();
 
+	/**
+	 * Reset all flags that are dependent on the path target location. These
+	 * flags should be removed when the field is cached and reused for
+	 * other targets.
+	 *
+	 * Relevant flags are:
+	 * - FLOW_LOS_MASK
+	 * - FLOW_WAVEFRONT_BLOCKED_MASK
+	 */
+	void reset_dynamic_flags();
+
 private:
 	/**
 	 * Side length of the field.
diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 1d95c9225a..0271f32f37 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -299,12 +299,20 @@ const std::vector<integrated_t> &IntegrationField::get_cells() const {
 }
 
 void IntegrationField::reset() {
-	for (auto &cell : this->cells) {
-		cell = INTEGRATE_INIT;
-	}
+	std::fill(this->cells.begin(), this->cells.end(), INTEGRATE_INIT);
+
 	log::log(DBG << "Integration field has been reset");
 }
 
+void IntegrationField::reset_dynamic_flags() {
+	integrated_flags_t mask = 0xFF & ~(INTEGRATE_LOS_MASK | INTEGRATE_WAVEFRONT_BLOCKED_MASK);
+	for (integrated_t &cell : this->cells) {
+		cell.flags = cell.flags & mask;
+	}
+
+	log::log(DBG << "Integration field dynamic flags have been reset");
+}
+
 void IntegrationField::update_neighbor(size_t idx,
                                        cost_t cell_cost,
                                        integrated_cost_t integrated_cost,
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index 40e6780c8f..7cce6d2529 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -137,6 +137,17 @@ class IntegrationField {
 	 */
 	void reset();
 
+	/**
+	 * Reset all flags that are dependent on the path target location. These
+	 * flags should be removed when the field is cached and reused for
+	 * other targets.
+	 *
+	 * Relevant flags are:
+	 * - INTEGRATE_LOS_MASK
+	 * - INTEGRATE_WAVEFRONT_BLOCKED_MASK
+	 */
+	void reset_dynamic_flags();
+
 private:
 	/**
 	 * Update a neigbor cell during the cost integration process.

From d51ebba060888034bedb4f3d158d1ddb4cd4452d Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 25 May 2024 23:46:56 +0200
Subject: [PATCH 26/68] patg: Cache fields during pathing.

---
 libopenage/pathfinding/integrator.cpp | 26 ++++++++++++++++++++++++++
 libopenage/pathfinding/integrator.h   | 25 ++++++++++++++++++++++++-
 2 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/libopenage/pathfinding/integrator.cpp b/libopenage/pathfinding/integrator.cpp
index 4ffdedff15..0802f00ee5 100644
--- a/libopenage/pathfinding/integrator.cpp
+++ b/libopenage/pathfinding/integrator.cpp
@@ -5,6 +5,7 @@
 #include "pathfinding/cost_field.h"
 #include "pathfinding/flow_field.h"
 #include "pathfinding/integration_field.h"
+#include "pathfinding/portal.h"
 
 
 namespace openage::path {
@@ -22,6 +23,12 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
 std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<CostField> &cost_field,
                                                         sector_id_t other_sector_id,
                                                         const std::shared_ptr<Portal> &portal) {
+	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
+	auto cached = this->field_cache.find(cache_key);
+	if (cached != this->field_cache.end()) {
+		return cached->second.first;
+	}
+
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
 	integration_field->integrate_cost(cost_field, other_sector_id, portal);
 
@@ -39,6 +46,12 @@ std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationFi
                                              const std::shared_ptr<IntegrationField> &other,
                                              sector_id_t other_sector_id,
                                              const std::shared_ptr<Portal> &portal) {
+	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
+	auto cached = this->field_cache.find(cache_key);
+	if (cached != this->field_cache.end()) {
+		return cached->second.second;
+	}
+
 	auto flow_field = std::make_shared<FlowField>(integration_field->get_size());
 	flow_field->build(integration_field, other, other_sector_id, portal);
 
@@ -57,9 +70,22 @@ Integrator::build_return_t Integrator::build(const std::shared_ptr<CostField> &c
                                              const std::shared_ptr<IntegrationField> &other_integration_field,
                                              sector_id_t other_sector_id,
                                              const std::shared_ptr<Portal> &portal) {
+	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
+	auto cached = this->field_cache.find(cache_key);
+	if (cached != this->field_cache.end()) {
+		return cached->second;
+	}
+
 	auto integration_field = this->integrate(cost_field, other_sector_id, portal);
 	auto flow_field = this->build(integration_field, other_integration_field, other_sector_id, portal);
 
+	// Copy the fields to the cache.
+	std::shared_ptr<IntegrationField> cached_integration_field = std::make_shared<IntegrationField>(*integration_field);
+	cached_integration_field->reset_dynamic_flags();
+	std::shared_ptr<FlowField> cached_flow_field = std::make_shared<FlowField>(*flow_field);
+	cached_flow_field->reset_dynamic_flags();
+	this->field_cache[cache_key] = std::make_pair(cached_integration_field, cached_flow_field);
+
 	return std::make_pair(integration_field, flow_field);
 }
 
diff --git a/libopenage/pathfinding/integrator.h b/libopenage/pathfinding/integrator.h
index ef9c2780cd..660f8cbb7c 100644
--- a/libopenage/pathfinding/integrator.h
+++ b/libopenage/pathfinding/integrator.h
@@ -4,8 +4,10 @@
 
 #include <cstddef>
 #include <memory>
+#include <unordered_map>
 
 #include "pathfinding/types.h"
+#include "util/hash.h"
 
 
 namespace openage {
@@ -102,7 +104,28 @@ class Integrator {
 	                     const std::shared_ptr<Portal> &portal);
 
 private:
-	// TODO: Cache created flow fields.
+	/**
+	 * Hash function for the field cache.
+	 */
+	struct pair_hash {
+		template <class T1, class T2>
+		std::size_t operator()(const std::pair<T1, T2> &pair) const {
+			return util::hash_combine(std::hash<T1>{}(pair.first), std::hash<T2>{}(pair.second));
+		}
+	};
+
+	/**
+	 * Cache for already computed fields.
+	 *
+	 * Key is the portal ID and the sector ID from which the field was entered. Fields that are cached are
+	 * cleared of dynamic flags, i.e. wavefront or LOS flags. These have to be recalculated
+	 * when the field is reused.
+	 */
+	std::unordered_map<std::pair<portal_id_t, sector_id_t>,
+	                   std::pair<std::shared_ptr<IntegrationField>,
+	                             std::shared_ptr<FlowField>>,
+	                   pair_hash>
+		field_cache;
 };
 
 } // namespace path

From e849754d33d6be80ba8f2cc8104f77f71320c81a Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 26 May 2024 00:31:52 +0200
Subject: [PATCH 27/68] path: Clear LOS next wave list before next loop
 iteration.

---
 libopenage/pathfinding/integration_field.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 0271f32f37..ce98114de2 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -183,6 +183,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 		// increment the cost and advance the wavefront outwards
 		cost += 1;
 		current_wave.swap(next_wave);
+		next_wave.clear();
 	}
 	while (!current_wave.empty());
 

From ebc05926d9782e7c4e037c9a3dff17c859fab311 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 26 May 2024 00:56:33 +0200
Subject: [PATCH 28/68] path: Only add cells with blocked flag to wavefront
 list.

---
 libopenage/pathfinding/integration_field.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index ce98114de2..1b42de0ef2 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -136,6 +136,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 					// Add the current cell to the blocked wavefront if it's not a wall
 					wavefront_blocked.push_back(idx);
 					this->cells[idx].cost = cost - 1 + cost_field->get_cost(idx);
+					// TODO: this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
 				}
 
 				// check each neighbor for a corner
@@ -154,8 +155,9 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 
 						// clear los flag if it was set
 						this->cells[blocked_idx].flags &= ~INTEGRATE_LOS_MASK;
+
+						wavefront_blocked.push_back(blocked_idx);
 					}
-					wavefront_blocked.insert(wavefront_blocked.end(), blocked_cells.begin(), blocked_cells.end());
 				}
 				continue;
 			}

From 805148cc76df3f5927c2bc1f7befd0d16bbbe192 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 26 May 2024 02:37:40 +0200
Subject: [PATCH 29/68] path: Add flag for found LOS cells instead of lookup
 set.

---
 libopenage/pathfinding/definitions.h         |  7 ++++++-
 libopenage/pathfinding/integration_field.cpp | 12 ++++--------
 libopenage/pathfinding/types.h               |  2 ++
 3 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/libopenage/pathfinding/definitions.h b/libopenage/pathfinding/definitions.h
index 4e184406cd..a54dff576a 100644
--- a/libopenage/pathfinding/definitions.h
+++ b/libopenage/pathfinding/definitions.h
@@ -55,7 +55,12 @@ constexpr integrated_flags_t INTEGRATE_WAVEFRONT_BLOCKED_MASK = 0x02;
 /**
  * Target flag in an integrated_flags_t value.
  */
-constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x40;
+constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x04;
+
+/**
+ * Found flag in an integrated_flags_t value.
+ */
+constexpr integrated_flags_t INTEGRATE_FOUND_MASK = 0x80;
 
 /**
  * Initial value for a cell in the integration grid.
diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 1b42de0ef2..3916c40120 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -88,10 +88,6 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	// Target cell index
 	auto target_idx = target.ne + target.se * this->size;
 
-	// Lookup table for cells that have been found
-	std::unordered_set<size_t> found;
-	found.reserve(this->size * this->size);
-
 	// Cells that still have to be visited by the current wave
 	std::deque<size_t> current_wave;
 
@@ -108,19 +104,19 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 			auto idx = current_wave.front();
 			current_wave.pop_front();
 
-			if (found.contains(idx)) {
-				// Skip cells that have already been found
+			if (this->cells[idx].flags & INTEGRATE_FOUND_MASK) {
+				// Skip cells that are already in the line of sight
 				continue;
 			}
 			else if (this->cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
 				// Stop at cells that are blocked by a LOS corner
 				this->cells[idx].cost = cost - 1 + cost_field->get_cost(idx);
-				found.insert(idx);
+				this->cells[idx].flags |= INTEGRATE_FOUND_MASK;
 				continue;
 			}
 
 			// Add the current cell to the found cells
-			found.insert(idx);
+			this->cells[idx].flags |= INTEGRATE_FOUND_MASK;
 
 			// Get the x and y coordinates of the current cell
 			auto x = idx % this->size;
diff --git a/libopenage/pathfinding/types.h b/libopenage/pathfinding/types.h
index b90e932323..bf5a7de473 100644
--- a/libopenage/pathfinding/types.h
+++ b/libopenage/pathfinding/types.h
@@ -51,6 +51,8 @@ struct integrated_t {
 	/**
 	 * Flags.
 	 *
+	 * Bit 0: Found flag.
+	 * Bit 5: Target flag.
 	 * Bit 6: Wave front blocked flag.
 	 * Bit 7: Line of sight flag.
 	 */

From b48c68a23b01d82527dfdd6e7b099c722bd2be1b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 26 May 2024 03:25:05 +0200
Subject: [PATCH 30/68] path: Remove lookup set from cost integration pass.

---
 libopenage/pathfinding/integration_field.cpp | 20 ++++----------------
 libopenage/pathfinding/integration_field.h   |  4 +---
 2 files changed, 5 insertions(+), 19 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 3916c40120..38639b89fe 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -238,10 +238,6 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 
 void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_field,
                                       std::vector<size_t> &&start_cells) {
-	// Lookup table for cells that are in the open list
-	std::unordered_set<size_t> in_list;
-	in_list.reserve(this->size * this->size);
-
 	// Cells that still have to be visited
 	// they may be visited multiple times
 	std::deque<size_t> open_list;
@@ -281,15 +277,11 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 			this->update_neighbor(neighbor_idx,
 			                      cost_field->get_cost(neighbor_idx),
 			                      integrated_current,
-			                      open_list,
-			                      in_list);
+			                      open_list);
 		}
 
 		// Clear the neighbors vector
 		neighbors.clear();
-
-		// Remove the current cell from the open list lookup table
-		in_list.erase(idx);
 	}
 }
 
@@ -315,8 +307,7 @@ void IntegrationField::reset_dynamic_flags() {
 void IntegrationField::update_neighbor(size_t idx,
                                        cost_t cell_cost,
                                        integrated_cost_t integrated_cost,
-                                       std::deque<size_t> &open_list,
-                                       std::unordered_set<size_t> &in_list) {
+                                       std::deque<size_t> &open_list) {
 	ENSURE(cell_cost > COST_INIT, "cost field cell value must be non-zero");
 
 	// Check if the cell is impassable
@@ -326,15 +317,12 @@ void IntegrationField::update_neighbor(size_t idx,
 	}
 
 	auto cost = integrated_cost + cell_cost;
-	if (cost < this->cells.at(idx).cost) {
+	if (cost < this->cells[idx].cost) {
 		// If the new integration value is smaller than the current one,
 		// update the cell and add it to the open list
 		this->cells[idx].cost = cost;
 
-		if (not in_list.contains(idx)) {
-			in_list.insert(idx);
-			open_list.push_back(idx);
-		}
+		open_list.push_back(idx);
 	}
 }
 
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index 7cce6d2529..ad0b879b83 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -156,15 +156,13 @@ class IntegrationField {
 	 * @param cell_cost Cost of the neighbor cell from the cost field.
 	 * @param integrated_cost Current integrated cost of the updating cell in the integration field.
 	 * @param open_list List of cells to be updated.
-	 * @param in_list Set of cells that have been updated.
 	 *
 	 * @return New integration value of the cell.
 	 */
 	void update_neighbor(size_t idx,
 	                     cost_t cell_cost,
 	                     integrated_cost_t integrated_cost,
-	                     std::deque<size_t> &open_list,
-	                     std::unordered_set<size_t> &in_list);
+	                     std::deque<size_t> &open_list);
 
 	/**
 	 * Get the LOS corners around a cell.

From 352996fe3fdc30cb0dc035dd8bddb03b10a74470 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Thu, 30 May 2024 14:02:45 +0200
Subject: [PATCH 31/68] path: Check if target cell is out of bounds for grid.

---
 libopenage/pathfinding/grid.h         |  8 ++++----
 libopenage/pathfinding/pathfinder.cpp | 13 +++++++++++++
 libopenage/pathfinding/types.h        |  2 ++
 3 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/libopenage/pathfinding/grid.h b/libopenage/pathfinding/grid.h
index 83b4c2b721..8f34a7643c 100644
--- a/libopenage/pathfinding/grid.h
+++ b/libopenage/pathfinding/grid.h
@@ -49,16 +49,16 @@ class Grid {
 	grid_id_t get_id() const;
 
 	/**
-	 * Get the size of the grid.
+	 * Get the size of the grid (in number of sectors).
 	 *
-	 * @return Size of the grid (width x height).
+	 * @return Size of the grid (in number of sectors) (width x height).
 	 */
 	const util::Vector2s &get_size() const;
 
 	/**
-	 * Get the side length of the sectors on the grid.
+	 * Get the side length of the sectors on the grid (in number of cells).
 	 *
-	 * @return Sector side length.
+	 * @return Sector side length (in number of cells).
 	 */
 	size_t get_sector_size() const;
 
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 22662c9e9d..9da9b4a1c9 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -23,6 +23,19 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	auto grid = this->grids.at(request.grid_id);
 	auto sector_size = grid->get_sector_size();
 
+	// Check if the target is within the grid
+	auto grid_size = grid->get_size();
+	auto grid_width = grid_size[0] * sector_size;
+	auto grid_height = grid_size[1] * sector_size;
+	if (request.target.ne < 0
+	    or request.target.se < 0
+	    or request.target.ne >= grid_width
+	    or request.target.se >= grid_height) {
+		log::log(INFO << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Target is out of bounds.");
+		return Path{request.grid_id, PathResult::OUT_OF_BOUNDS, {}};
+	}
+
 	auto start_sector_x = request.start.ne / sector_size;
 	auto start_sector_y = request.start.se / sector_size;
 	auto start_sector = grid->get_sector(start_sector_x, start_sector_y);
diff --git a/libopenage/pathfinding/types.h b/libopenage/pathfinding/types.h
index bf5a7de473..3285d9d170 100644
--- a/libopenage/pathfinding/types.h
+++ b/libopenage/pathfinding/types.h
@@ -16,6 +16,8 @@ enum class PathResult {
 	FOUND,
 	/// Path was not found.
 	NOT_FOUND,
+	/// Target is not on grid.
+	OUT_OF_BOUNDS,
 };
 
 /**

From 906e47a7bb64f63ab8d42c11017a23d8a6769a74 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Fri, 31 May 2024 13:51:04 +0200
Subject: [PATCH 32/68] path: Set PATHABLE and LOS flags for target cells in
 flow field.

---
 libopenage/pathfinding/flow_field.cpp | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 3b52aeedcf..2641b343fb 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -68,11 +68,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 		for (size_t x = 0; x < this->size; ++x) {
 			size_t idx = y * this->size + x;
 
-			if (integrate_cells[idx].flags & INTEGRATE_TARGET_MASK) {
-				// Ignore target cells
-				continue;
-			}
-
 			if (integrate_cells[idx].cost == INTEGRATED_COST_UNREACHABLE) {
 				// Cell cannot be used as path
 				continue;
@@ -80,24 +75,32 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 
 			if (integrate_cells[idx].flags & INTEGRATE_LOS_MASK) {
 				// Cell is in line of sight
-				this->cells[idx] = this->cells[idx] | FLOW_LOS_MASK;
+				flow_cells[idx] |= FLOW_LOS_MASK;
 
 				// we can skip calculating the flow direction as we can
 				// move straight to the target from this cell
-				this->cells[idx] = this->cells[idx] | FLOW_PATHABLE_MASK;
+				flow_cells[idx] |= FLOW_PATHABLE_MASK;
 				continue;
 			}
 
 			if (integrate_cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
 				// Cell is blocked by a line-of-sight corner
-				this->cells[idx] = this->cells[idx] | FLOW_WAVEFRONT_BLOCKED_MASK;
+				flow_cells[idx] |= FLOW_WAVEFRONT_BLOCKED_MASK;
+			}
+
+			if (integrate_cells[idx].flags & INTEGRATE_TARGET_MASK) {
+				// target cells are pathable
+				flow_cells[idx] |= FLOW_PATHABLE_MASK;
+
+				// they also have a preset flow direction so we can skip here
+				continue;
 			}
 
 			// Store which of the non-diagonal directions are unreachable.
 			std::bitset<4> directions_unreachable;
 
 			// Find the neighbor with the smallest cost.
-			flow_dir_t direction = static_cast<flow_dir_t>(this->cells[idx] & FLOW_DIR_MASK);
+			flow_dir_t direction = static_cast<flow_dir_t>(flow_cells[idx] & FLOW_DIR_MASK);
 			auto smallest_cost = INTEGRATED_COST_UNREACHABLE;
 			if (y > 0) {
 				auto cost = integrate_cells[idx - this->size].cost;
@@ -174,10 +177,10 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			}
 
 			// Set the flow field cell to pathable.
-			flow_cells[idx] = flow_cells[idx] | FLOW_PATHABLE_MASK;
+			flow_cells[idx] |= FLOW_PATHABLE_MASK;
 
 			// Set the flow field cell to the direction of the smallest cost.
-			flow_cells[idx] = flow_cells[idx] | static_cast<uint8_t>(direction);
+			flow_cells[idx] |= static_cast<uint8_t>(direction);
 		}
 	}
 }

From 4029276f196bbd49297817cf3fc9529b229229d2 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Fri, 31 May 2024 14:23:45 +0200
Subject: [PATCH 33/68] path: Smooth LOS integration for target cells with cost
 > MIN_COST.

---
 libopenage/pathfinding/integration_field.cpp | 42 ++++++++++++++++++--
 1 file changed, 38 insertions(+), 4 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 38639b89fe..6b88380929 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -97,10 +97,44 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	// Cost of the current wave
 	integrated_cost_t cost = INTEGRATED_COST_START;
 
-	// Move outwards from the target cell, updating the integration field
-	current_wave.push_back(target_idx);
+	if (cost_field->get_cost(target_idx) > COST_MIN) {
+		// Do a preliminary LOS integration wave for targets that have cost > min cost
+		// This avoids the bresenham's line algorithm calculations
+		// (which wouldn't return accurate results for blocker == target)
+		// and makes sure that sorrounding cells that are min cost are considered
+		// in line-of-sight.
+
+		this->cells[target_idx].cost = cost;
+		this->cells[target_idx].flags |= INTEGRATE_FOUND_MASK;
+		// ASDF: Fix display in demo 0
+		// this->cells[target_idx].flags |= INTEGRATE_LOS_MASK;
+
+		// Add neighbors to current wave
+		if (target.se > 0) {
+			current_wave.push_back(target_idx - this->size);
+		}
+		if (target.ne > 0) {
+			current_wave.push_back(target_idx - 1);
+		}
+		if (target.se < static_cast<coord::tile_t>(this->size - 1)) {
+			current_wave.push_back(target_idx + this->size);
+		}
+		if (target.ne < static_cast<coord::tile_t>(this->size - 1)) {
+			current_wave.push_back(target_idx + 1);
+		}
+
+		// Increment wave cost as we technically handled the first wave in this block
+		cost += 1;
+	}
+	else {
+		// Move outwards from the target cell, updating the integration field
+		current_wave.push_back(target_idx);
+	}
+
 	do {
-		while (!current_wave.empty()) {
+		while (not current_wave.empty()) {
+			// inner loop: handle a wave
+
 			auto idx = current_wave.front();
 			current_wave.pop_front();
 
@@ -183,7 +217,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 		current_wave.swap(next_wave);
 		next_wave.clear();
 	}
-	while (!current_wave.empty());
+	while (not current_wave.empty());
 
 	return wavefront_blocked;
 }

From 7471b43595bbd7c9251601ff6b8deda34c6f49c9 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 04:09:56 +0200
Subject: [PATCH 34/68] path: Start LOS pass from configurable start cells.

---
 libopenage/pathfinding/integration_field.cpp | 201 ++++++++++++++-----
 libopenage/pathfinding/integration_field.h   |  25 ++-
 2 files changed, 174 insertions(+), 52 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 6b88380929..ab1dbb3c0b 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -37,45 +37,178 @@ const integrated_t &IntegrationField::get_cell(size_t idx) const {
 	return this->cells.at(idx);
 }
 
+std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
+                                                    const coord::tile_delta &target) {
+	ENSURE(cost_field->get_size() == this->get_size(),
+	       "cost field size "
+	           << cost_field->get_size() << "x" << cost_field->get_size()
+	           << " does not match integration field size "
+	           << this->get_size() << "x" << this->get_size());
+
+	ENSURE(target.ne >= 0
+	           and target.se >= 0
+	           and target.ne < static_cast<coord::tile_t>(this->size)
+	           and target.se < static_cast<coord::tile_t>(this->size),
+	       "target cell (" << target.ne << ", " << target.se << ") "
+	                       << "is out of bounds for integration field of size "
+	                       << this->size << "x" << this->size);
+
+	std::vector<size_t> start_cells;
+	integrated_cost_t start_cost = INTEGRATED_COST_START;
+
+	// Target cell index
+	auto target_idx = target.ne + target.se * this->size;
+
+	this->cells[target_idx].cost = start_cost;
+	this->cells[target_idx].flags |= INTEGRATE_TARGET_MASK;
+
+	if (cost_field->get_cost(target_idx) > COST_MIN) {
+		// Do a preliminary LOS integration wave for targets that have cost > min cost
+		// This avoids the bresenham's line algorithm calculations
+		// (which wouldn't return accurate results for blocker == target)
+		// and makes sure that sorrounding cells that are min cost are considered
+		// in line-of-sight.
+
+		this->cells[target_idx].flags |= INTEGRATE_FOUND_MASK;
+		// ASDF: Fix display in demo 0
+		// this->cells[target_idx].flags |= INTEGRATE_LOS_MASK;
+
+		// Add neighbors to current wave
+		if (target.se > 0) {
+			start_cells.push_back(target_idx - this->size);
+		}
+		if (target.ne > 0) {
+			start_cells.push_back(target_idx - 1);
+		}
+		if (target.se < static_cast<coord::tile_t>(this->size - 1)) {
+			start_cells.push_back(target_idx + this->size);
+		}
+		if (target.ne < static_cast<coord::tile_t>(this->size - 1)) {
+			start_cells.push_back(target_idx + 1);
+		}
+
+		// Increment wave cost as we technically handled the first wave in this block
+		start_cost += 1;
+	}
+	else {
+		// Move outwards from the target cell, updating the integration field
+		start_cells.push_back(target_idx);
+	}
+
+	return this->integrate_los(cost_field, target, start_cost, std::move(start_cells));
+}
+
 std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
                                                     sector_id_t other_sector_id,
-                                                    const std::shared_ptr<Portal> &portal) {
+                                                    const std::shared_ptr<Portal> &portal,
+                                                    const coord::tile_delta &target) {
 	ENSURE(cost_field->get_size() == this->get_size(),
 	       "cost field size "
 	           << cost_field->get_size() << "x" << cost_field->get_size()
 	           << " does not match integration field size "
 	           << this->get_size() << "x" << this->get_size());
 
-	// Integrate the cost of the cells on the exit side (this) of the portal
+	std::vector<size_t> wavefront_blocked_portal;
+
 	std::vector<size_t> start_cells;
+
 	auto exit_start = portal->get_exit_start(other_sector_id);
 	auto exit_end = portal->get_exit_end(other_sector_id);
 	auto entry_start = portal->get_entry_start(other_sector_id);
-	auto entry_end = portal->get_entry_end(other_sector_id);
 
 	auto x_diff = exit_start.ne - entry_start.ne;
 	auto y_diff = exit_start.se - entry_start.se;
 
+	// transfer masks for flags from the other side of the portal
+	// only LOS and wavefront blocked flags are relevant
+	integrated_flags_t transfer_mask = INTEGRATE_LOS_MASK | INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+
+	// every portal cell is a target cell
 	for (auto y = exit_start.se; y <= exit_end.se; ++y) {
 		for (auto x = exit_start.ne; x <= exit_end.ne; ++x) {
-			// every portal cell is a target cell
+			// cell index on the exit side of the portal
 			auto target_idx = x + y * this->size;
 
-			auto source_idx = x - x_diff + (y - y_diff) * this->size;
+			// cell index on the entry side of the portal
+			auto entry_idx = x - x_diff + (y - y_diff) * this->size;
 
 			// Set the cost of all target cells to the start value
 			this->cells[target_idx].cost = INTEGRATED_COST_START;
-			this->cells[target_idx].flags = this->cells[source_idx].flags;
+			this->cells[target_idx].flags = this->cells[entry_idx].flags & transfer_mask;
+
+			this->cells[target_idx].flags |= INTEGRATE_TARGET_MASK;
+
+			if (not(this->cells[target_idx].flags & transfer_mask)) {
+				// If neither LOS nor wavefront blocked flags are set for the portal entry,
+				// the portal exit cell doesn't affect the LOS and we can skip further checks
+				continue;
+			}
+
+			// Get the cost of the current cell
+			auto cell_cost = cost_field->get_cost(target_idx);
 
+			if (cell_cost > COST_MIN or this->cells[target_idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
+				// cell blocks line of sight
+
+				// set the blocked flag for the cell if it wasn't set already
+				this->cells[target_idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+				wavefront_blocked_portal.push_back(target_idx);
+
+				// set the found flag for the cell, so that the start costs
+				// are not changed in the main LOS integration
+				this->cells[target_idx].flags |= INTEGRATE_FOUND_MASK;
+
+				// check each neighbor for a corner
+				auto corners = this->get_los_corners(cost_field, target, coord::tile_delta(x, y));
+				for (auto &corner : corners) {
+					// draw a line from the corner to the edge of the field
+					// to get the cells blocked by the corner
+					auto blocked_cells = this->bresenhams_line(target, corner.first, corner.second);
+					for (auto &blocked_idx : blocked_cells) {
+						if (cost_field->get_cost(blocked_idx) > COST_MIN) {
+							// stop if blocked_idx is not min cost
+							// because this idx may create a new corner
+							break;
+						}
+						// set the blocked flag for the cell
+						this->cells[blocked_idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+
+						// clear los flag if it was set
+						this->cells[blocked_idx].flags &= ~INTEGRATE_LOS_MASK;
+
+						wavefront_blocked_portal.push_back(blocked_idx);
+					}
+				}
+				continue;
+			}
+
+			// the cell has the LOS flag and is added to the start cells
 			start_cells.push_back(target_idx);
 		}
 	}
 
-	// TODO: Call main LOS integration function
+	if (start_cells.empty()) {
+		// Main LOS integration will not enter its loop
+		// so we can take a shortcut and just return the
+		// wavefront blocked cells we already found
+		return wavefront_blocked_portal;
+	}
+
+	// Call main LOS integration function
+	auto wavefront_blocked_main = this->integrate_los(cost_field,
+	                                                  target,
+	                                                  INTEGRATED_COST_START,
+	                                                  std::move(start_cells));
+	wavefront_blocked_main.insert(wavefront_blocked_main.end(),
+	                              wavefront_blocked_portal.begin(),
+	                              wavefront_blocked_portal.end());
+	return wavefront_blocked_main;
 }
 
 std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
-                                                    const coord::tile_delta &target) {
+                                                    const coord::tile_delta &target,
+                                                    integrated_cost_t start_cost,
+                                                    std::vector<size_t> &&start_wave) {
 	ENSURE(cost_field->get_size() == this->get_size(),
 	       "cost field size "
 	           << cost_field->get_size() << "x" << cost_field->get_size()
@@ -85,9 +218,6 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	// Store the wavefront_blocked cells
 	std::vector<size_t> wavefront_blocked;
 
-	// Target cell index
-	auto target_idx = target.ne + target.se * this->size;
-
 	// Cells that still have to be visited by the current wave
 	std::deque<size_t> current_wave;
 
@@ -95,42 +225,10 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	std::deque<size_t> next_wave;
 
 	// Cost of the current wave
-	integrated_cost_t cost = INTEGRATED_COST_START;
-
-	if (cost_field->get_cost(target_idx) > COST_MIN) {
-		// Do a preliminary LOS integration wave for targets that have cost > min cost
-		// This avoids the bresenham's line algorithm calculations
-		// (which wouldn't return accurate results for blocker == target)
-		// and makes sure that sorrounding cells that are min cost are considered
-		// in line-of-sight.
-
-		this->cells[target_idx].cost = cost;
-		this->cells[target_idx].flags |= INTEGRATE_FOUND_MASK;
-		// ASDF: Fix display in demo 0
-		// this->cells[target_idx].flags |= INTEGRATE_LOS_MASK;
-
-		// Add neighbors to current wave
-		if (target.se > 0) {
-			current_wave.push_back(target_idx - this->size);
-		}
-		if (target.ne > 0) {
-			current_wave.push_back(target_idx - 1);
-		}
-		if (target.se < static_cast<coord::tile_t>(this->size - 1)) {
-			current_wave.push_back(target_idx + this->size);
-		}
-		if (target.ne < static_cast<coord::tile_t>(this->size - 1)) {
-			current_wave.push_back(target_idx + 1);
-		}
-
-		// Increment wave cost as we technically handled the first wave in this block
-		cost += 1;
-	}
-	else {
-		// Move outwards from the target cell, updating the integration field
-		current_wave.push_back(target_idx);
-	}
+	integrated_cost_t wave_cost = start_cost;
 
+	// Add the start wave to the current wave
+	current_wave.insert(current_wave.end(), start_wave.begin(), start_wave.end());
 	do {
 		while (not current_wave.empty()) {
 			// inner loop: handle a wave
@@ -144,7 +242,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 			}
 			else if (this->cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
 				// Stop at cells that are blocked by a LOS corner
-				this->cells[idx].cost = cost - 1 + cost_field->get_cost(idx);
+				this->cells[idx].cost = wave_cost - 1 + cost_field->get_cost(idx);
 				this->cells[idx].flags |= INTEGRATE_FOUND_MASK;
 				continue;
 			}
@@ -165,8 +263,9 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 				if (cell_cost != COST_IMPASSABLE) {
 					// Add the current cell to the blocked wavefront if it's not a wall
 					wavefront_blocked.push_back(idx);
-					this->cells[idx].cost = cost - 1 + cost_field->get_cost(idx);
-					// TODO: this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+					this->cells[idx].cost = wave_cost - 1 + cost_field->get_cost(idx);
+					// ASDF: Fix display in demo 0
+					// this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
 				}
 
 				// check each neighbor for a corner
@@ -194,7 +293,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 
 			// The cell is in the line of sight at min cost
 			// Set the LOS flag and cost
-			this->cells[idx].cost = cost;
+			this->cells[idx].cost = wave_cost;
 			this->cells[idx].flags |= INTEGRATE_LOS_MASK;
 
 			// Search the neighbors of the current cell
@@ -213,7 +312,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 		}
 
 		// increment the cost and advance the wavefront outwards
-		cost += 1;
+		wave_cost += 1;
 		current_wave.swap(next_wave);
 		next_wave.clear();
 	}
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index ad0b879b83..fa9e910613 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -67,6 +67,8 @@ class IntegrationField {
 	/**
 	 * Calculate the line-of-sight integration flags for a target cell.
 	 *
+	 * The target cell coordinates must lie within the field.
+	 *
 	 * Returns a list of cells that are flagged as "wavefront blocked". These cells
 	 * can be used as a starting point for the cost integration.
 	 *
@@ -88,12 +90,33 @@ class IntegrationField {
 	 * @param cost_field Cost field to integrate.
 	 * @param other_sector_id Sector ID of the other integration field.
 	 * @param portal Portal connecting the two fields.
+	 * @param target Coordinates of the target cell (relative to field origin).
 	 *
 	 * @return Cells flagged as "wavefront blocked".
 	 */
 	std::vector<size_t> integrate_los(const std::shared_ptr<CostField> &cost_field,
 	                                  sector_id_t other_sector_id,
-	                                  const std::shared_ptr<Portal> &portal);
+	                                  const std::shared_ptr<Portal> &portal,
+	                                  const coord::tile_delta &target);
+
+	/**
+	 * Calculate the line-of-sight integration flags for a target cell.
+	 *
+	 * Returns a list of cells that are flagged as "wavefront blocked". These cells
+	 * can be used as a starting point for the cost integration.
+	 *
+	 * @param cost_field Cost field to integrate.
+	 * @param target Coordinates of the target cell (relative to field origin).
+	 * @param start_cost Integration cost for the start wave.
+	 * @param start_wave Cells used for the first LOS integration wave. The wavefront
+	 * 					 expands outwards from these cells.
+	 *
+	 * @return Cells flagged as "wavefront blocked".
+	 */
+	std::vector<size_t> integrate_los(const std::shared_ptr<CostField> &cost_field,
+	                                  const coord::tile_delta &target,
+	                                  integrated_cost_t start_cost,
+	                                  std::vector<size_t> &&start_wave);
 
 	/**
 	 * Calculate the cost integration field starting from a target cell.

From 52a6e862f2e8ad053ee4e1c2b27e0c3cb1025a3c Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 04:47:21 +0200
Subject: [PATCH 35/68] path: Make LOS pass optional.

---
 libopenage/pathfinding/integrator.cpp | 39 ++++++++++++++++++++++-----
 libopenage/pathfinding/integrator.h   | 29 +++++++++++++++-----
 libopenage/pathfinding/pathfinder.cpp |  5 +++-
 3 files changed, 59 insertions(+), 14 deletions(-)

diff --git a/libopenage/pathfinding/integrator.cpp b/libopenage/pathfinding/integrator.cpp
index 0802f00ee5..ac551957ce 100644
--- a/libopenage/pathfinding/integrator.cpp
+++ b/libopenage/pathfinding/integrator.cpp
@@ -11,26 +11,47 @@
 namespace openage::path {
 
 std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<CostField> &cost_field,
-                                                        const coord::tile_delta &target) {
+                                                        const coord::tile_delta &target,
+                                                        bool with_los) {
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
 
-	auto wavefront_blocked = integration_field->integrate_los(cost_field, target);
-	integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
+	if (with_los) {
+		auto wavefront_blocked = integration_field->integrate_los(cost_field, target);
+		integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
+	}
+	else {
+		integration_field->integrate_cost(cost_field, target);
+	}
 
 	return integration_field;
 }
 
 std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<CostField> &cost_field,
                                                         sector_id_t other_sector_id,
-                                                        const std::shared_ptr<Portal> &portal) {
+                                                        const std::shared_ptr<Portal> &portal,
+                                                        const coord::tile_delta &target,
+                                                        bool with_los) {
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
+		// TODO: LOS pass?
+
 		return cached->second.first;
 	}
 
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
-	integration_field->integrate_cost(cost_field, other_sector_id, portal);
+
+	std::vector<size_t> wavefront_blocked;
+	if (with_los) {
+		wavefront_blocked = integration_field->integrate_los(cost_field, other_sector_id, portal, target);
+	}
+
+	if (wavefront_blocked.empty()) {
+		integration_field->integrate_cost(cost_field, other_sector_id, portal);
+	}
+	else {
+		integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
+	}
 
 	return integration_field;
 }
@@ -69,14 +90,18 @@ Integrator::build_return_t Integrator::build(const std::shared_ptr<CostField> &c
 Integrator::build_return_t Integrator::build(const std::shared_ptr<CostField> &cost_field,
                                              const std::shared_ptr<IntegrationField> &other_integration_field,
                                              sector_id_t other_sector_id,
-                                             const std::shared_ptr<Portal> &portal) {
+                                             const std::shared_ptr<Portal> &portal,
+                                             const coord::tile_delta &target,
+                                             bool with_los) {
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
+		// TODO: LOS pass?
+
 		return cached->second;
 	}
 
-	auto integration_field = this->integrate(cost_field, other_sector_id, portal);
+	auto integration_field = this->integrate(cost_field, other_sector_id, portal, target, with_los);
 	auto flow_field = this->build(integration_field, other_integration_field, other_sector_id, portal);
 
 	// Copy the fields to the cache.
diff --git a/libopenage/pathfinding/integrator.h b/libopenage/pathfinding/integrator.h
index 660f8cbb7c..995c451aba 100644
--- a/libopenage/pathfinding/integrator.h
+++ b/libopenage/pathfinding/integrator.h
@@ -32,26 +32,38 @@ class Integrator {
 	/**
 	 * Integrate the cost field for a target.
 	 *
+	 * This should be used for the field containing the target cell.
+	 * The target coordinates must lie within the boundaries of the cost field.
+	 *
 	 * @param cost_field Cost field.
 	 * @param target Coordinates of the target cell.
+	 * @param with_los true if an LOS pass should be performed, else false.
 	 *
 	 * @return Integration field.
 	 */
 	std::shared_ptr<IntegrationField> integrate(const std::shared_ptr<CostField> &cost_field,
-	                                            const coord::tile_delta &target);
+	                                            const coord::tile_delta &target,
+	                                            bool with_los = true);
 
 	/**
 	 * Integrate the cost field from a portal.
 	 *
+	 * This should be used for the fields on the portal path that are not the target field.
+	 * The target coordinates must be relative to the origin of the sector the cost field belongs to.
+	 *
 	 * @param cost_field Cost field.
 	 * @param other_sector_id Sector ID of the other side of the portal.
 	 * @param portal Portal.
+	 * @param target Coordinates of the target cell, relative to the integration field origin.
+	 * @param with_los true if an LOS pass should be performed, else false.
 	 *
 	 * @return Integration field.
 	 */
 	std::shared_ptr<IntegrationField> integrate(const std::shared_ptr<CostField> &cost_field,
 	                                            sector_id_t other_sector_id,
-	                                            const std::shared_ptr<Portal> &portal);
+	                                            const std::shared_ptr<Portal> &portal,
+	                                            const coord::tile_delta &target,
+	                                            bool with_los = true);
 
 	/**
 	 * Build the flow field from an integration field.
@@ -85,7 +97,7 @@ class Integrator {
 	 * @param cost_field Cost field.
 	 * @param target Coordinates of the target cell.
 	 *
-	 * @return Flow field.
+	 * @return Integration field and flow field.
 	 */
 	build_return_t build(const std::shared_ptr<CostField> &cost_field,
 	                     const coord::tile_delta &target);
@@ -97,11 +109,17 @@ class Integrator {
 	 * @param other_integration_field Integration field of the other side of the portal.
 	 * @param other_sector_id Sector ID of the other side of the portal.
 	 * @param portal Portal.
+	 * @param target Coordinates of the target cell, relative to the integration field origin.
+	 * @param with_los true if an LOS pass should be performed, else false.
+	 *
+	 * @return Integration field and flow field.
 	 */
 	build_return_t build(const std::shared_ptr<CostField> &cost_field,
 	                     const std::shared_ptr<IntegrationField> &other_integration_field,
 	                     sector_id_t other_sector_id,
-	                     const std::shared_ptr<Portal> &portal);
+	                     const std::shared_ptr<Portal> &portal,
+	                     const coord::tile_delta &target,
+	                     bool with_los = false);
 
 private:
 	/**
@@ -122,8 +140,7 @@ class Integrator {
 	 * when the field is reused.
 	 */
 	std::unordered_map<std::pair<portal_id_t, sector_id_t>,
-	                   std::pair<std::shared_ptr<IntegrationField>,
-	                             std::shared_ptr<FlowField>>,
+	                   build_return_t,
 	                   pair_hash>
 		field_cache;
 };
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 9da9b4a1c9..e35d7719ae 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -129,10 +129,13 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 		auto next_sector_id = portal->get_exit_sector(prev_sector_id);
 		auto next_sector = grid->get_sector(next_sector_id);
 
+		coord::tile_delta target_delta = request.target - next_sector->get_position().to_tile(sector_size);
+
 		sector_fields = this->integrator->build(next_sector->get_cost_field(),
 		                                        prev_integration_field,
 		                                        prev_sector_id,
-		                                        portal);
+		                                        portal,
+		                                        target_delta);
 		flow_fields.push_back(std::make_pair(next_sector_id, sector_fields.second));
 
 		prev_integration_field = sector_fields.first;

From 7d8025c6e18f0ae080a68a5e3577cf5297f20d9c Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 04:53:51 +0200
Subject: [PATCH 36/68] path: Simplify calculations for start/target coordinate
 deltas.

---
 libopenage/pathfinding/pathfinder.cpp | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index e35d7719ae..75b2591436 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -45,16 +45,14 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	auto target_sector = grid->get_sector(target_sector_x, target_sector_y);
 
 	// Integrate the target field
-	coord::tile_t target_x = request.target.ne % sector_size;
-	coord::tile_t target_y = request.target.se % sector_size;
-	auto target = coord::tile_delta{target_x, target_y};
-	auto target_integration_field = this->integrator->integrate(target_sector->get_cost_field(), target);
+	coord::tile_delta target_delta = request.target - target_sector->get_position().to_tile(sector_size);
+	auto target_integration_field = this->integrator->integrate(target_sector->get_cost_field(),
+	                                                            target_delta);
 
 	if (target_sector == start_sector) {
-		auto start_x = request.start.ne % sector_size;
-		auto start_y = request.start.se % sector_size;
+		auto start = request.start - start_sector->get_position().to_tile(sector_size);
 
-		if (target_integration_field->get_cell(start_x, start_y).cost != INTEGRATED_COST_UNREACHABLE) {
+		if (target_integration_field->get_cell(start.ne, start.se).cost != INTEGRATED_COST_UNREACHABLE) {
 			// Exit early if the start and target are in the same sector
 			// and are reachable from within the same sector
 			auto flow_field = this->integrator->build(target_integration_field);
@@ -83,10 +81,9 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	}
 
 	// Check which portals are reachable from the start field
-	coord::tile_t start_x = request.start.ne % sector_size;
-	coord::tile_t start_y = request.start.se % sector_size;
-	auto start = coord::tile_delta{start_x, start_y};
-	auto start_integration_field = this->integrator->integrate(start_sector->get_cost_field(), start);
+	coord::tile_delta start = request.start - start_sector->get_position().to_tile(sector_size);
+	auto start_integration_field = this->integrator->integrate(start_sector->get_cost_field(),
+	                                                           start);
 
 	std::unordered_set<portal_id_t> start_portal_ids;
 	for (auto &portal : start_sector->get_portals()) {
@@ -129,7 +126,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 		auto next_sector_id = portal->get_exit_sector(prev_sector_id);
 		auto next_sector = grid->get_sector(next_sector_id);
 
-		coord::tile_delta target_delta = request.target - next_sector->get_position().to_tile(sector_size);
+		target_delta = request.target - next_sector->get_position().to_tile(sector_size);
 
 		sector_fields = this->integrator->build(next_sector->get_cost_field(),
 		                                        prev_integration_field,

From 36eafc475005a9c9b55f9e327e4844b871cca7fd Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 04:54:37 +0200
Subject: [PATCH 37/68] path: Skip LOS pass when checking start sector for exit
 portals.

---
 libopenage/pathfinding/pathfinder.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 75b2591436..e3a1bd72ec 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -83,7 +83,8 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	// Check which portals are reachable from the start field
 	coord::tile_delta start = request.start - start_sector->get_position().to_tile(sector_size);
 	auto start_integration_field = this->integrator->integrate(start_sector->get_cost_field(),
-	                                                           start);
+	                                                           start,
+	                                                           false);
 
 	std::unordered_set<portal_id_t> start_portal_ids;
 	for (auto &portal : start_sector->get_portals()) {

From d328738d6e6fda47c8f104fabfd0d00a15fc8d77 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 05:47:54 +0200
Subject: [PATCH 38/68] path: Exit waypoinnt search if any LOS cell is found.

---
 libopenage/pathfinding/pathfinder.cpp | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index e3a1bd72ec..d2fef7b2b9 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -307,6 +307,8 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 	coord::tile_t target_x = request.target.ne % sector_size;
 	coord::tile_t target_y = request.target.se % sector_size;
 
+	bool reached_target = false;
+
 	coord::tile_t current_x = start_x;
 	coord::tile_t current_y = start_y;
 	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(current_x, current_y);
@@ -323,20 +325,21 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			if (cell & FLOW_LOS_MASK) {
 				// check if we reached an LOS cell
 				auto sector_pos = sector->get_position();
-				auto cell_pos = coord::tile(sector_pos.ne * sector_size,
-				                            sector_pos.se * sector_size)
+				auto cell_pos = sector_pos.to_tile(sector_size)
 				                + coord::tile_delta(current_x, current_y);
 				waypoints.push_back(cell_pos);
+				reached_target = true;
 				break;
 			}
 
+			// ASDF: break if target cell is reached
+
 			// check if we need to change direction
 			auto cell_direction = flow_field->get_dir(coord::tile_delta(current_x, current_y));
 			if (cell_direction != current_direction) {
 				// add the current cell as a waypoint
 				auto sector_pos = sector->get_position();
-				auto cell_pos = coord::tile(sector_pos.ne * sector_size,
-				                            sector_pos.se * sector_size)
+				auto cell_pos = sector_pos.to_tile(sector_size)
 				                + coord::tile_delta(current_x, current_y);
 				waypoints.push_back(cell_pos);
 				current_direction = cell_direction;
@@ -377,6 +380,10 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			}
 		}
 
+		if (reached_target) {
+			break;
+		}
+
 		// reset the current position for the next flow field
 		switch (current_direction) {
 		case flow_dir_t::NORTH:
@@ -414,7 +421,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 
 	// add the target position as the last waypoint
 	auto sector_pos = grid->get_sector(flow_fields.back().first)->get_position();
-	auto target_pos = coord::tile(sector_pos.ne * sector_size, sector_pos.se * sector_size)
+	auto target_pos = sector_pos.to_tile(sector_size)
 	                  + coord::tile_delta{target_x, target_y};
 	waypoints.push_back(target_pos);
 

From 0da61fa2d66fb05a1b365d482938bf6497d2164f Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 06:20:00 +0200
Subject: [PATCH 39/68] path: Calculate flow field directions for LOS cells to
 allow caching of field.

---
 libopenage/pathfinding/flow_field.cpp | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 2641b343fb..6c51306d4f 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -76,11 +76,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			if (integrate_cells[idx].flags & INTEGRATE_LOS_MASK) {
 				// Cell is in line of sight
 				flow_cells[idx] |= FLOW_LOS_MASK;
-
-				// we can skip calculating the flow direction as we can
-				// move straight to the target from this cell
-				flow_cells[idx] |= FLOW_PATHABLE_MASK;
-				continue;
 			}
 
 			if (integrate_cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {

From d651de443a163f18972c54babb636ffd5b7b81e6 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 06:29:25 +0200
Subject: [PATCH 40/68] path: Transfer flags for LOS/wavefront blocked from an
 integration field.

---
 libopenage/pathfinding/flow_field.cpp | 19 +++++++++++++++++++
 libopenage/pathfinding/flow_field.h   | 19 +++++++++++++++++--
 2 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 6c51306d4f..3b2dd3e1da 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -266,4 +266,23 @@ void FlowField::reset_dynamic_flags() {
 	log::log(DBG << "Flow field dynamic flags have been reset");
 }
 
+void FlowField::transfer_dynamic_flags(const std::shared_ptr<IntegrationField> &integration_field) {
+	auto &integrate_cells = integration_field->get_cells();
+	auto &flow_cells = this->cells;
+
+	for (size_t idx = 0; idx < integrate_cells.size(); ++idx) {
+		if (integrate_cells[idx].flags & INTEGRATE_LOS_MASK) {
+			// Cell is in line of sight
+			flow_cells[idx] |= FLOW_LOS_MASK;
+		}
+
+		if (integrate_cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
+			// Cell is blocked by a line-of-sight corner
+			flow_cells[idx] |= FLOW_WAVEFRONT_BLOCKED_MASK;
+		}
+	}
+
+	log::log(DBG << "Flow field dynamic flags have been transferred");
+}
+
 } // namespace openage::path
diff --git a/libopenage/pathfinding/flow_field.h b/libopenage/pathfinding/flow_field.h
index 6d9aeaeb63..5dc91fed96 100644
--- a/libopenage/pathfinding/flow_field.h
+++ b/libopenage/pathfinding/flow_field.h
@@ -132,8 +132,9 @@ class FlowField {
 	void reset();
 
 	/**
-	 * Reset all flags that are dependent on the path target location. These
-	 * flags should be removed when the field is cached and reused for
+	 * Reset all flags that are dependent on the path target location.
+	 *
+	 * These flags should be removed when the field is cached and reused for
 	 * other targets.
 	 *
 	 * Relevant flags are:
@@ -142,6 +143,20 @@ class FlowField {
 	 */
 	void reset_dynamic_flags();
 
+	/**
+	 * Transfer dynamic flags from an integration field.
+	 *
+	 * These flags should be transferred when the field is copied from cache.
+	 * Flow field directions are not altered.
+	 *
+	 * Relevant flags are:
+	 * - FLOW_LOS_MASK
+	 * - FLOW_WAVEFRONT_BLOCKED_MASK
+	 *
+	 * @param integration_field Integration field.
+	 */
+	void transfer_dynamic_flags(const std::shared_ptr<IntegrationField> &integration_field);
+
 private:
 	/**
 	 * Side length of the field.

From da34efce76cce05c8c5cdba8acf8050181a50bbe Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 06:43:25 +0200
Subject: [PATCH 41/68] path: Apply LOS flags when getting fields from cache.

---
 libopenage/pathfinding/integration_field.cpp |  7 +-
 libopenage/pathfinding/integration_field.h   |  3 +
 libopenage/pathfinding/integrator.cpp        | 70 ++++++++++++++++----
 libopenage/pathfinding/integrator.h          | 38 ++++++-----
 libopenage/pathfinding/pathfinder.cpp        | 12 ++--
 libopenage/pathfinding/tests.cpp             |  2 +-
 6 files changed, 92 insertions(+), 40 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index ab1dbb3c0b..fb62372d67 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -99,6 +99,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 }
 
 std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostField> &cost_field,
+                                                    const std::shared_ptr<IntegrationField> &other,
                                                     sector_id_t other_sector_id,
                                                     const std::shared_ptr<Portal> &portal,
                                                     const coord::tile_delta &target) {
@@ -119,6 +120,8 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	auto x_diff = exit_start.ne - entry_start.ne;
 	auto y_diff = exit_start.se - entry_start.se;
 
+	auto &other_cells = other->get_cells();
+
 	// transfer masks for flags from the other side of the portal
 	// only LOS and wavefront blocked flags are relevant
 	integrated_flags_t transfer_mask = INTEGRATE_LOS_MASK | INTEGRATE_WAVEFRONT_BLOCKED_MASK;
@@ -134,7 +137,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 
 			// Set the cost of all target cells to the start value
 			this->cells[target_idx].cost = INTEGRATED_COST_START;
-			this->cells[target_idx].flags = this->cells[entry_idx].flags & transfer_mask;
+			this->cells[target_idx].flags = other_cells[entry_idx].flags & transfer_mask;
 
 			this->cells[target_idx].flags |= INTEGRATE_TARGET_MASK;
 
@@ -429,7 +432,7 @@ void IntegrationField::reset() {
 }
 
 void IntegrationField::reset_dynamic_flags() {
-	integrated_flags_t mask = 0xFF & ~(INTEGRATE_LOS_MASK | INTEGRATE_WAVEFRONT_BLOCKED_MASK);
+	integrated_flags_t mask = 0xFF & ~(INTEGRATE_LOS_MASK | INTEGRATE_WAVEFRONT_BLOCKED_MASK | INTEGRATE_FOUND_MASK);
 	for (integrated_t &cell : this->cells) {
 		cell.flags = cell.flags & mask;
 	}
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index fa9e910613..a8564eccd8 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -88,6 +88,7 @@ class IntegrationField {
 	 * can be used as a starting point for the cost integration.
 	 *
 	 * @param cost_field Cost field to integrate.
+	 * @param other Integration field of the other sector.
 	 * @param other_sector_id Sector ID of the other integration field.
 	 * @param portal Portal connecting the two fields.
 	 * @param target Coordinates of the target cell (relative to field origin).
@@ -95,6 +96,7 @@ class IntegrationField {
 	 * @return Cells flagged as "wavefront blocked".
 	 */
 	std::vector<size_t> integrate_los(const std::shared_ptr<CostField> &cost_field,
+	                                  const std::shared_ptr<IntegrationField> &other,
 	                                  sector_id_t other_sector_id,
 	                                  const std::shared_ptr<Portal> &portal,
 	                                  const coord::tile_delta &target);
@@ -168,6 +170,7 @@ class IntegrationField {
 	 * Relevant flags are:
 	 * - INTEGRATE_LOS_MASK
 	 * - INTEGRATE_WAVEFRONT_BLOCKED_MASK
+	 * - INTEGRATE_FOUND_MASK
 	 */
 	void reset_dynamic_flags();
 
diff --git a/libopenage/pathfinding/integrator.cpp b/libopenage/pathfinding/integrator.cpp
index ac551957ce..990dab37dd 100644
--- a/libopenage/pathfinding/integrator.cpp
+++ b/libopenage/pathfinding/integrator.cpp
@@ -27,6 +27,7 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
 }
 
 std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<CostField> &cost_field,
+                                                        const std::shared_ptr<IntegrationField> &other,
                                                         sector_id_t other_sector_id,
                                                         const std::shared_ptr<Portal> &portal,
                                                         const coord::tile_delta &target,
@@ -34,22 +35,36 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
-		// TODO: LOS pass?
+		if (with_los) {
+			// Make a copy of the cached field to avoid modifying the cached field
+			auto integration_field = std::make_shared<IntegrationField>(*cached->second.first);
 
+			// Only integrate LOS; leave the rest of the field as is
+			integration_field->integrate_los(cost_field, other, other_sector_id, portal, target);
+
+			return integration_field;
+		}
 		return cached->second.first;
 	}
 
+	// Create a new integration field
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
 
+	// LOS pass
 	std::vector<size_t> wavefront_blocked;
 	if (with_los) {
-		wavefront_blocked = integration_field->integrate_los(cost_field, other_sector_id, portal, target);
+		wavefront_blocked = integration_field->integrate_los(cost_field, other, other_sector_id, portal, target);
 	}
 
+	// Cost integration
 	if (wavefront_blocked.empty()) {
+		// No LOS pass or no blocked cells
+		// use the portal as the target
 		integration_field->integrate_cost(cost_field, other_sector_id, portal);
 	}
 	else {
+		// LOS pass was performed and some cells were blocked
+		// use the blocked cells as the start wave
 		integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
 	}
 
@@ -66,10 +81,21 @@ std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationFi
 std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationField> &integration_field,
                                              const std::shared_ptr<IntegrationField> &other,
                                              sector_id_t other_sector_id,
-                                             const std::shared_ptr<Portal> &portal) {
+                                             const std::shared_ptr<Portal> &portal,
+                                             bool with_los) {
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
+		if (with_los) {
+			// Make a copy of the cached flow field
+			auto flow_field = std::make_shared<FlowField>(*cached->second.second);
+
+			// Transfer the LOS flags to the flow field
+			flow_field->transfer_dynamic_flags(integration_field);
+
+			return flow_field;
+		}
+
 		return cached->second.second;
 	}
 
@@ -79,36 +105,52 @@ std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationFi
 	return flow_field;
 }
 
-Integrator::build_return_t Integrator::build(const std::shared_ptr<CostField> &cost_field,
-                                             const coord::tile_delta &target) {
+Integrator::get_return_t Integrator::get(const std::shared_ptr<CostField> &cost_field,
+                                         const coord::tile_delta &target) {
 	auto integration_field = this->integrate(cost_field, target);
 	auto flow_field = this->build(integration_field);
 
 	return std::make_pair(integration_field, flow_field);
 }
 
-Integrator::build_return_t Integrator::build(const std::shared_ptr<CostField> &cost_field,
-                                             const std::shared_ptr<IntegrationField> &other_integration_field,
-                                             sector_id_t other_sector_id,
-                                             const std::shared_ptr<Portal> &portal,
-                                             const coord::tile_delta &target,
-                                             bool with_los) {
+Integrator::get_return_t Integrator::get(const std::shared_ptr<CostField> &cost_field,
+                                         const std::shared_ptr<IntegrationField> &other,
+                                         sector_id_t other_sector_id,
+                                         const std::shared_ptr<Portal> &portal,
+                                         const coord::tile_delta &target,
+                                         bool with_los) {
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
-		// TODO: LOS pass?
+		if (with_los) {
+			// Make a copy of the cached integration field
+			auto integration_field = std::make_shared<IntegrationField>(*cached->second.first);
+
+			// Only integrate LOS; leave the rest of the field as is
+			integration_field->integrate_los(cost_field, other, other_sector_id, portal, target);
+
+			// Make a copy of the cached flow field
+			auto flow_field = std::make_shared<FlowField>(*cached->second.second);
+
+			// Transfer the LOS flags to the flow field
+			flow_field->transfer_dynamic_flags(integration_field);
+
+			return std::make_pair(integration_field, flow_field);
+		}
 
 		return cached->second;
 	}
 
-	auto integration_field = this->integrate(cost_field, other_sector_id, portal, target, with_los);
-	auto flow_field = this->build(integration_field, other_integration_field, other_sector_id, portal);
+	auto integration_field = this->integrate(cost_field, other, other_sector_id, portal, target, with_los);
+	auto flow_field = this->build(integration_field, other, other_sector_id, portal);
 
 	// Copy the fields to the cache.
 	std::shared_ptr<IntegrationField> cached_integration_field = std::make_shared<IntegrationField>(*integration_field);
 	cached_integration_field->reset_dynamic_flags();
+
 	std::shared_ptr<FlowField> cached_flow_field = std::make_shared<FlowField>(*flow_field);
 	cached_flow_field->reset_dynamic_flags();
+
 	this->field_cache[cache_key] = std::make_pair(cached_integration_field, cached_flow_field);
 
 	return std::make_pair(integration_field, flow_field);
diff --git a/libopenage/pathfinding/integrator.h b/libopenage/pathfinding/integrator.h
index 995c451aba..c27d3c1eb1 100644
--- a/libopenage/pathfinding/integrator.h
+++ b/libopenage/pathfinding/integrator.h
@@ -37,7 +37,7 @@ class Integrator {
 	 *
 	 * @param cost_field Cost field.
 	 * @param target Coordinates of the target cell.
-	 * @param with_los true if an LOS pass should be performed, else false.
+	 * @param with_los If true an LOS pass is performed before cost integration.
 	 *
 	 * @return Integration field.
 	 */
@@ -52,14 +52,16 @@ class Integrator {
 	 * The target coordinates must be relative to the origin of the sector the cost field belongs to.
 	 *
 	 * @param cost_field Cost field.
+	 * @param other Integration field of the other side of the portal.
 	 * @param other_sector_id Sector ID of the other side of the portal.
 	 * @param portal Portal.
 	 * @param target Coordinates of the target cell, relative to the integration field origin.
-	 * @param with_los true if an LOS pass should be performed, else false.
+	 * @param with_los If true an LOS pass is performed before cost integration.
 	 *
 	 * @return Integration field.
 	 */
 	std::shared_ptr<IntegrationField> integrate(const std::shared_ptr<CostField> &cost_field,
+	                                            const std::shared_ptr<IntegrationField> &other,
 	                                            sector_id_t other_sector_id,
 	                                            const std::shared_ptr<Portal> &portal,
 	                                            const coord::tile_delta &target,
@@ -81,45 +83,47 @@ class Integrator {
 	 * @param other Integration field of the other side of the portal.
 	 * @param other_sector_id Sector ID of the other side of the portal.
 	 * @param portal Portal.
+	 * @param with_los If true LOS flags are calculated if the flow field is in cache.
 	 *
 	 * @return Flow field.
 	 */
 	std::shared_ptr<FlowField> build(const std::shared_ptr<IntegrationField> &integration_field,
 	                                 const std::shared_ptr<IntegrationField> &other,
 	                                 sector_id_t other_sector_id,
-	                                 const std::shared_ptr<Portal> &portal);
+	                                 const std::shared_ptr<Portal> &portal,
+	                                 bool with_los = true);
 
-	using build_return_t = std::pair<std::shared_ptr<IntegrationField>, std::shared_ptr<FlowField>>;
+	using get_return_t = std::pair<std::shared_ptr<IntegrationField>, std::shared_ptr<FlowField>>;
 
 	/**
-	 * Build the integration field and flow field for a target.
+	 * Get the integration field and flow field for a target.
 	 *
 	 * @param cost_field Cost field.
 	 * @param target Coordinates of the target cell.
 	 *
 	 * @return Integration field and flow field.
 	 */
-	build_return_t build(const std::shared_ptr<CostField> &cost_field,
-	                     const coord::tile_delta &target);
+	get_return_t get(const std::shared_ptr<CostField> &cost_field,
+	                 const coord::tile_delta &target);
 
 	/**
-	 * Build the integration field and flow field from a portal.
+	 * Get the integration field and flow field from a portal.
 	 *
 	 * @param cost_field Cost field.
-	 * @param other_integration_field Integration field of the other side of the portal.
+	 * @param other Integration field of the other side of the portal.
 	 * @param other_sector_id Sector ID of the other side of the portal.
 	 * @param portal Portal.
 	 * @param target Coordinates of the target cell, relative to the integration field origin.
-	 * @param with_los true if an LOS pass should be performed, else false.
+	 * @param with_los If true an LOS pass is performed before cost integration.
 	 *
 	 * @return Integration field and flow field.
 	 */
-	build_return_t build(const std::shared_ptr<CostField> &cost_field,
-	                     const std::shared_ptr<IntegrationField> &other_integration_field,
-	                     sector_id_t other_sector_id,
-	                     const std::shared_ptr<Portal> &portal,
-	                     const coord::tile_delta &target,
-	                     bool with_los = false);
+	get_return_t get(const std::shared_ptr<CostField> &cost_field,
+	                 const std::shared_ptr<IntegrationField> &other,
+	                 sector_id_t other_sector_id,
+	                 const std::shared_ptr<Portal> &portal,
+	                 const coord::tile_delta &target,
+	                 bool with_los = true);
 
 private:
 	/**
@@ -140,7 +144,7 @@ class Integrator {
 	 * when the field is reused.
 	 */
 	std::unordered_map<std::pair<portal_id_t, sector_id_t>,
-	                   build_return_t,
+	                   get_return_t,
 	                   pair_hash>
 		field_cache;
 };
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index d2fef7b2b9..92304c5ffe 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -116,7 +116,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	auto prev_flow_field = this->integrator->build(prev_integration_field);
 	auto prev_sector_id = target_sector->get_id();
 
-	Integrator::build_return_t sector_fields{prev_integration_field, prev_flow_field};
+	Integrator::get_return_t sector_fields{prev_integration_field, prev_flow_field};
 
 	std::vector<std::pair<sector_id_t, std::shared_ptr<FlowField>>> flow_fields;
 	flow_fields.reserve(portal_path.size() + 1);
@@ -129,11 +129,11 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 
 		target_delta = request.target - next_sector->get_position().to_tile(sector_size);
 
-		sector_fields = this->integrator->build(next_sector->get_cost_field(),
-		                                        prev_integration_field,
-		                                        prev_sector_id,
-		                                        portal,
-		                                        target_delta);
+		sector_fields = this->integrator->get(next_sector->get_cost_field(),
+		                                      prev_integration_field,
+		                                      prev_sector_id,
+		                                      portal,
+		                                      target_delta);
 		flow_fields.push_back(std::make_pair(next_sector_id, sector_fields.second));
 
 		prev_integration_field = sector_fields.first;
diff --git a/libopenage/pathfinding/tests.cpp b/libopenage/pathfinding/tests.cpp
index 12c96cc30e..2d54dd728d 100644
--- a/libopenage/pathfinding/tests.cpp
+++ b/libopenage/pathfinding/tests.cpp
@@ -85,7 +85,7 @@ void flow_field() {
 		auto integrator = std::make_shared<Integrator>();
 
 		// Build the flow field
-		auto flow_field = integrator->build(cost_field, coord::tile_delta{2, 2}).second;
+		auto flow_field = integrator->get(cost_field, coord::tile_delta{2, 2}).second;
 		auto ff_cells = flow_field->get_cells();
 
 		// The flow field for targeting (2, 2) hould look like this:

From e67deef83f9020eb3ed6290fffc6a64691cfd412 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 06:52:31 +0200
Subject: [PATCH 42/68] path: Limit sectors where LOS is transferred between
 portals.

This avoid edge cases where LOS flags would be set when LOS is actually blocked by an obstacle, e.g. a cell in a sector that is not visited.
---
 libopenage/pathfinding/pathfinder.cpp | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 92304c5ffe..5d6a84c5a9 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -122,22 +122,27 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	flow_fields.reserve(portal_path.size() + 1);
 	flow_fields.push_back(std::make_pair(target_sector->get_id(), sector_fields.second));
 
+	int los_depth = 1;
+
 	for (auto &portal : portal_path) {
 		auto prev_sector = grid->get_sector(prev_sector_id);
 		auto next_sector_id = portal->get_exit_sector(prev_sector_id);
 		auto next_sector = grid->get_sector(next_sector_id);
 
 		target_delta = request.target - next_sector->get_position().to_tile(sector_size);
+		bool with_los = los_depth > 0;
 
 		sector_fields = this->integrator->get(next_sector->get_cost_field(),
 		                                      prev_integration_field,
 		                                      prev_sector_id,
 		                                      portal,
-		                                      target_delta);
+		                                      target_delta,
+		                                      with_los);
 		flow_fields.push_back(std::make_pair(next_sector_id, sector_fields.second));
 
 		prev_integration_field = sector_fields.first;
 		prev_sector_id = next_sector_id;
+		los_depth -= 1;
 	}
 
 	// reverse the flow fields so they are ordered from start to target

From 0eba33c874dbf4129987271adfa1ebd413ff92c6 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 1 Jun 2024 06:59:55 +0200
Subject: [PATCH 43/68] path: Fix time unit in demo 1.

---
 libopenage/pathfinding/demo/demo_1.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libopenage/pathfinding/demo/demo_1.cpp b/libopenage/pathfinding/demo/demo_1.cpp
index 3d00d31b0c..f9d7cbc92f 100644
--- a/libopenage/pathfinding/demo/demo_1.cpp
+++ b/libopenage/pathfinding/demo/demo_1.cpp
@@ -96,7 +96,7 @@ void path_demo_1(const util::Path &path) {
 	Path path_result = pathfinder->get_path(path_request);
 	timer.stop();
 
-	log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " ps");
+	log::log(INFO << "Pathfinding took " << timer.getval() / 1000 << " us");
 
 	// Create a renderer to display the grid and path
 	auto qtapp = std::make_shared<renderer::gui::GuiApplicationWithLogger>();

From 7a48ef0474cbeace1b363376166d5ba053b4e34f Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 00:05:29 +0200
Subject: [PATCH 44/68] path: Align bit positions for shared flags of
 flow/integration cell values.

---
 etc/gdb_pretty/printers.py           |  6 ++++--
 libopenage/pathfinding/definitions.h |  8 ++++----
 libopenage/pathfinding/types.h       | 14 ++++++++++----
 3 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/etc/gdb_pretty/printers.py b/etc/gdb_pretty/printers.py
index 1a7803619f..de3b3cc1ce 100644
--- a/etc/gdb_pretty/printers.py
+++ b/etc/gdb_pretty/printers.py
@@ -333,8 +333,10 @@ def children(self):
 
 # Integrated flags
 INTEGRATED_FLAGS: dict = {
-    0x01: 'LOS',
-    0x02: 'WAVEFRONT_BLOCKED',
+    0x01: 'TARGET',
+    0x02: 'FOUND',
+    0x20: 'LOS',
+    0x40: 'WAVEFRONT_BLOCKED',
 }
 
 
diff --git a/libopenage/pathfinding/definitions.h b/libopenage/pathfinding/definitions.h
index a54dff576a..7391d9523e 100644
--- a/libopenage/pathfinding/definitions.h
+++ b/libopenage/pathfinding/definitions.h
@@ -45,22 +45,22 @@ constexpr integrated_cost_t INTEGRATED_COST_UNREACHABLE = std::numeric_limits<in
 /**
  * Line of sight flag in an integrated_flags_t value.
  */
-constexpr integrated_flags_t INTEGRATE_LOS_MASK = 0x01;
+constexpr integrated_flags_t INTEGRATE_LOS_MASK = 0x20;
 
 /**
  * Wavefront blocked flag in an integrated_flags_t value.
  */
-constexpr integrated_flags_t INTEGRATE_WAVEFRONT_BLOCKED_MASK = 0x02;
+constexpr integrated_flags_t INTEGRATE_WAVEFRONT_BLOCKED_MASK = 0x40;
 
 /**
  * Target flag in an integrated_flags_t value.
  */
-constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x04;
+constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x01;
 
 /**
  * Found flag in an integrated_flags_t value.
  */
-constexpr integrated_flags_t INTEGRATE_FOUND_MASK = 0x80;
+constexpr integrated_flags_t INTEGRATE_FOUND_MASK = 0x02;
 
 /**
  * Initial value for a cell in the integration grid.
diff --git a/libopenage/pathfinding/types.h b/libopenage/pathfinding/types.h
index 3285d9d170..9a5c3806d6 100644
--- a/libopenage/pathfinding/types.h
+++ b/libopenage/pathfinding/types.h
@@ -53,10 +53,16 @@ struct integrated_t {
 	/**
 	 * Flags.
 	 *
-	 * Bit 0: Found flag.
-	 * Bit 5: Target flag.
-	 * Bit 6: Wave front blocked flag.
-	 * Bit 7: Line of sight flag.
+	 * Bit 0-3: Shared flags with the flow field.
+	 *  - 0: Unused.
+	 *  - 1: Wave front blocked flag.
+	 *  - 2: Line of sight flag.
+	 *  - 3: Unused.
+	 * Bit 4-7: Integration field specific flags.
+	 *  - 4: Unused.
+	 *  - 5: Unused.
+	 *  - 6: LOS found flag.
+	 *  - 7: Target flag.
 	 */
 	integrated_flags_t flags;
 };

From 9f4355c6af39562dd2b0ec5ddc118d259b868021 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 00:09:47 +0200
Subject: [PATCH 45/68] path: Use integration flags in flow field shader.

---
 .../pathfinding/demo_0_flow_field.frag.glsl   | 19 ++++--
 .../pathfinding/demo_0_flow_field.vert.glsl   |  9 ++-
 libopenage/pathfinding/demo/demo_0.cpp        | 63 ++++++++++++-------
 libopenage/pathfinding/demo/demo_0.h          | 12 ++--
 libopenage/pathfinding/pathfinder.cpp         |  1 +
 5 files changed, 70 insertions(+), 34 deletions(-)

diff --git a/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl b/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl
index b5ff4042a3..8dd4a2dd85 100644
--- a/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl
+++ b/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl
@@ -1,24 +1,33 @@
 #version 330
 
-in float v_cost;
+/// Flow field value
+in float flow_val;
+
+/// Integration field flags
+in float int_val;
 
 out vec4 outcol;
 
+int WAVEFRONT_BLOCKED = 0x40;
+int LINE_OF_SIGHT = 0x20;
+int PATHABLE = 0x10;
+
 void main() {
-    int cost = int(v_cost);
-    if (bool(cost & 0x40)) {
+    int flow_flags = int(flow_val) & 0xF0;
+    int int_flags = int(int_val);
+    if (bool(int_flags & WAVEFRONT_BLOCKED)) {
         // wavefront blocked
         outcol = vec4(0.9, 0.9, 0.9, 1.0);
         return;
     }
 
-    if (bool(cost & 0x20)) {
+    if (bool(flow_flags & LINE_OF_SIGHT)) {
         // line of sight
         outcol = vec4(1.0, 1.0, 1.0, 1.0);
         return;
     }
 
-    if (bool(cost & 0x10)) {
+    if (bool(flow_flags & PATHABLE)) {
         // pathable
         outcol = vec4(0.7, 0.7, 0.7, 1.0);
         return;
diff --git a/assets/test/shaders/pathfinding/demo_0_flow_field.vert.glsl b/assets/test/shaders/pathfinding/demo_0_flow_field.vert.glsl
index 2c2190e57c..03900a8daf 100644
--- a/assets/test/shaders/pathfinding/demo_0_flow_field.vert.glsl
+++ b/assets/test/shaders/pathfinding/demo_0_flow_field.vert.glsl
@@ -1,15 +1,18 @@
 #version 330
 
 layout(location=0) in vec3 position;
-layout(location=1) in float cost;
+layout(location=1) in float flow_cell;
+layout(location=2) in float int_cell;
 
 uniform mat4 model;
 uniform mat4 view;
 uniform mat4 proj;
 
-out float v_cost;
+out float flow_val;
+out float int_val;
 
 void main() {
 	gl_Position = proj * view * model * vec4(position, 1.0);
-    v_cost = cost;
+    flow_val = flow_cell;
+    int_val = int_cell;
 }
diff --git a/libopenage/pathfinding/demo/demo_0.cpp b/libopenage/pathfinding/demo/demo_0.cpp
index 8e844d942d..c063445192 100644
--- a/libopenage/pathfinding/demo/demo_0.cpp
+++ b/libopenage/pathfinding/demo/demo_0.cpp
@@ -111,7 +111,7 @@ void path_demo_0(const util::Path &path) {
 						render_manager->show_integration_field(integration_field);
 						break;
 					case RenderManager0::field_t::FLOW:
-						render_manager->show_flow_field(flow_field);
+						render_manager->show_flow_field(flow_field, integration_field);
 						break;
 					}
 
@@ -137,7 +137,7 @@ void path_demo_0(const util::Path &path) {
 				log::log(INFO << "Showing integration field");
 			}
 			else if (ev.key() == Qt::Key_F3) { // Show flow field
-				render_manager->show_flow_field(flow_field);
+				render_manager->show_flow_field(flow_field, integration_field);
 				current_field = RenderManager0::field_t::FLOW;
 				log::log(INFO << "Showing flow field");
 			}
@@ -241,7 +241,8 @@ void RenderManager0::show_integration_field(const std::shared_ptr<path::Integrat
 	this->field_pass->set_renderables({renderable});
 }
 
-void RenderManager0::show_flow_field(const std::shared_ptr<path::FlowField> &field) {
+void RenderManager0::show_flow_field(const std::shared_ptr<path::FlowField> &flow_field,
+                                     const std::shared_ptr<path::IntegrationField> &int_field) {
 	Eigen::Matrix4f model = Eigen::Matrix4f::Identity();
 	auto unifs = this->flow_shader->new_uniform_input(
 		"model",
@@ -250,7 +251,7 @@ void RenderManager0::show_flow_field(const std::shared_ptr<path::FlowField> &fie
 		this->camera->get_view_matrix(),
 		"proj",
 		this->camera->get_projection_matrix());
-	auto mesh = get_flow_field_mesh(field, 4);
+	auto mesh = get_flow_field_mesh(flow_field, int_field, 4);
 	auto geometry = this->renderer->add_mesh_geometry(mesh);
 	renderer::Renderable renderable{
 		unifs,
@@ -720,13 +721,14 @@ renderer::resources::MeshData RenderManager0::get_integration_field_mesh(const s
 	return {std::move(vert_data), std::move(idx_data), info};
 }
 
-renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::shared_ptr<FlowField> &field,
+renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::shared_ptr<FlowField> &flow_field,
+                                                                  const std::shared_ptr<path::IntegrationField> &int_field,
                                                                   size_t resolution) {
 	// increase by 1 in every dimension because to get the vertex length
 	// of each dimension
 	util::Vector2s size{
-		field->get_size() * resolution + 1,
-		field->get_size() * resolution + 1,
+		flow_field->get_size() * resolution + 1,
+		flow_field->get_size() * resolution + 1,
 	};
 	auto vert_distance = 1.0f / resolution;
 
@@ -737,25 +739,39 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 	for (int i = 0; i < static_cast<int>(size[0]); ++i) {
 		for (int j = 0; j < static_cast<int>(size[1]); ++j) {
 			// for each vertex, compare the surrounding tiles
-			std::vector<float> surround{};
+			std::vector<float> ff_surround{};
+			std::vector<float> int_surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, (j - 1) / resolution));
-				surround.push_back(cost);
+				auto ff_cost = flow_field->get_cell((i - 1) / resolution, (j - 1) / resolution);
+				ff_surround.push_back(ff_cost);
+
+				auto int_flags = int_field->get_cell((i - 1) / resolution, (j - 1) / resolution).flags;
+				int_surround.push_back(int_flags);
 			}
-			if (j < static_cast<int>(field->get_size()) and i - 1 >= 0) {
-				auto cost = field->get_cell(coord::tile_delta((i - 1) / resolution, j / resolution));
-				surround.push_back(cost);
+			if (j < static_cast<int>(flow_field->get_size()) and i - 1 >= 0) {
+				auto ff_cost = flow_field->get_cell((i - 1) / resolution, j / resolution);
+				ff_surround.push_back(ff_cost);
+
+				auto int_flags = int_field->get_cell((i - 1) / resolution, j / resolution).flags;
+				int_surround.push_back(int_flags);
 			}
-			if (j < static_cast<int>(field->get_size()) and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile_delta(i / resolution, j / resolution));
-				surround.push_back(cost);
+			if (j < static_cast<int>(flow_field->get_size()) and i < static_cast<int>(flow_field->get_size())) {
+				auto ff_cost = flow_field->get_cell(i / resolution, j / resolution);
+				ff_surround.push_back(ff_cost);
+
+				auto int_flags = int_field->get_cell(i / resolution, j / resolution).flags;
+				int_surround.push_back(int_flags);
 			}
-			if (j - 1 >= 0 and i < static_cast<int>(field->get_size())) {
-				auto cost = field->get_cell(coord::tile_delta(i / resolution, (j - 1) / resolution));
-				surround.push_back(cost);
+			if (j - 1 >= 0 and i < static_cast<int>(flow_field->get_size())) {
+				auto ff_cost = flow_field->get_cell(i / resolution, (j - 1) / resolution);
+				ff_surround.push_back(ff_cost);
+
+				auto int_flags = int_field->get_cell(i / resolution, (j - 1) / resolution).flags;
+				int_surround.push_back(int_flags);
 			}
 			// use the cost of the most expensive surrounding tile
-			auto max_cost = *std::max_element(surround.begin(), surround.end());
+			auto ff_max_cost = *std::max_element(ff_surround.begin(), ff_surround.end());
+			auto int_max_flags = *std::max_element(int_surround.begin(), int_surround.end());
 
 			coord::scene3 v{
 				static_cast<float>(i * vert_distance),
@@ -766,7 +782,8 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 			verts.push_back(world_v[0]);
 			verts.push_back(world_v[1]);
 			verts.push_back(world_v[2]);
-			verts.push_back(max_cost);
+			verts.push_back(ff_max_cost);
+			verts.push_back(int_max_flags);
 		}
 	}
 
@@ -790,7 +807,9 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 	}
 
 	renderer::resources::VertexInputInfo info{
-		{renderer::resources::vertex_input_t::V3F32, renderer::resources::vertex_input_t::F32},
+		{renderer::resources::vertex_input_t::V3F32,
+	     renderer::resources::vertex_input_t::F32,
+	     renderer::resources::vertex_input_t::F32},
 		renderer::resources::vertex_layout_t::AOS,
 		renderer::resources::vertex_primitive_t::TRIANGLES,
 		renderer::resources::index_t::U16};
diff --git a/libopenage/pathfinding/demo/demo_0.h b/libopenage/pathfinding/demo/demo_0.h
index 7a07ebfd7e..adf5651971 100644
--- a/libopenage/pathfinding/demo/demo_0.h
+++ b/libopenage/pathfinding/demo/demo_0.h
@@ -92,9 +92,11 @@ class RenderManager0 {
 	/**
 	 * Draw a flow field to the screen.
 	 *
-	 * @param field Flow field.
+	 * @param flow_field Flow field.
+	 * @param int_field Integration field.
 	 */
-	void show_flow_field(const std::shared_ptr<path::FlowField> &field);
+	void show_flow_field(const std::shared_ptr<path::FlowField> &flow_field,
+	                     const std::shared_ptr<path::IntegrationField> &int_field);
 
 	/**
 	 * Draw the steering vectors of a flow field to the screen.
@@ -160,9 +162,11 @@ class RenderManager0 {
 	/**
 	 * Create a mesh for the flow field.
 	 *
-	 * @param field Flow field to visualize.
+	 * @param flow_field Flow field to visualize.
+	 * @param int_field Integration field.
 	 */
-	static renderer::resources::MeshData get_flow_field_mesh(const std::shared_ptr<path::FlowField> &field,
+	static renderer::resources::MeshData get_flow_field_mesh(const std::shared_ptr<path::FlowField> &flow_field,
+	                                                         const std::shared_ptr<path::IntegrationField> &int_field,
 	                                                         size_t resolution = 2);
 
 	/**
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 5d6a84c5a9..559a761639 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -338,6 +338,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			}
 
 			// ASDF: break if target cell is reached
+			// idea: target flag for flow field cells
 
 			// check if we need to change direction
 			auto cell_direction = flow_field->get_dir(coord::tile_delta(current_x, current_y));

From 4f843d88bca4a3d20117767566e381d033993685 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 01:57:48 +0200
Subject: [PATCH 46/68] path: Remove FLOW_WAVEFRONT_BLOCKED flag.

---
 .../pathfinding/demo_0_flow_field.frag.glsl   |  4 ++--
 etc/gdb_pretty/printers.py                    |  4 ++--
 libopenage/pathfinding/definitions.h          | 17 +++++-----------
 libopenage/pathfinding/demo/demo_0.cpp        | 20 ++++++++++++-------
 libopenage/pathfinding/flow_field.cpp         | 12 +----------
 libopenage/pathfinding/integration_field.cpp  |  6 ++----
 libopenage/pathfinding/tests.cpp              |  4 ++--
 libopenage/pathfinding/types.h                |  6 +++---
 8 files changed, 30 insertions(+), 43 deletions(-)

diff --git a/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl b/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl
index 8dd4a2dd85..b003945619 100644
--- a/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl
+++ b/assets/test/shaders/pathfinding/demo_0_flow_field.frag.glsl
@@ -8,7 +8,7 @@ in float int_val;
 
 out vec4 outcol;
 
-int WAVEFRONT_BLOCKED = 0x40;
+int WAVEFRONT_BLOCKED = 0x04;
 int LINE_OF_SIGHT = 0x20;
 int PATHABLE = 0x10;
 
@@ -21,7 +21,7 @@ void main() {
         return;
     }
 
-    if (bool(flow_flags & LINE_OF_SIGHT)) {
+    if (bool(int_flags & LINE_OF_SIGHT)) {
         // line of sight
         outcol = vec4(1.0, 1.0, 1.0, 1.0);
         return;
diff --git a/etc/gdb_pretty/printers.py b/etc/gdb_pretty/printers.py
index de3b3cc1ce..fdab2f12bc 100644
--- a/etc/gdb_pretty/printers.py
+++ b/etc/gdb_pretty/printers.py
@@ -291,7 +291,7 @@ class PathFlowTypePrinter:
     FLOW_FLAGS: dict = {
         0x10: 'PATHABLE',
         0x20: 'LOS',
-        0x40: 'WAVEFRONT_BLOCKED',
+        0x40: 'UNUSED',
         0x80: 'UNUSED',
     }
 
@@ -335,8 +335,8 @@ def children(self):
 INTEGRATED_FLAGS: dict = {
     0x01: 'TARGET',
     0x02: 'FOUND',
+    0x04: 'WAVEFRONT_BLOCKED',
     0x20: 'LOS',
-    0x40: 'WAVEFRONT_BLOCKED',
 }
 
 
diff --git a/libopenage/pathfinding/definitions.h b/libopenage/pathfinding/definitions.h
index 7391d9523e..0dc9594935 100644
--- a/libopenage/pathfinding/definitions.h
+++ b/libopenage/pathfinding/definitions.h
@@ -47,11 +47,6 @@ constexpr integrated_cost_t INTEGRATED_COST_UNREACHABLE = std::numeric_limits<in
  */
 constexpr integrated_flags_t INTEGRATE_LOS_MASK = 0x20;
 
-/**
- * Wavefront blocked flag in an integrated_flags_t value.
- */
-constexpr integrated_flags_t INTEGRATE_WAVEFRONT_BLOCKED_MASK = 0x40;
-
 /**
  * Target flag in an integrated_flags_t value.
  */
@@ -62,6 +57,11 @@ constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x01;
  */
 constexpr integrated_flags_t INTEGRATE_FOUND_MASK = 0x02;
 
+/**
+ * Wavefront blocked flag in an integrated_flags_t value.
+ */
+constexpr integrated_flags_t INTEGRATE_WAVEFRONT_BLOCKED_MASK = 0x04;
+
 /**
  * Initial value for a cell in the integration grid.
  */
@@ -88,11 +88,4 @@ constexpr flow_t FLOW_PATHABLE_MASK = 0x10;
  */
 constexpr flow_t FLOW_LOS_MASK = 0x20;
 
-/**
- * Wavefront blocked flag in a flow_t value.
- *
- * TODO: This flag is only used in demo 0 and can be removed.
- */
-constexpr flow_t FLOW_WAVEFRONT_BLOCKED_MASK = 0x40;
-
 } // namespace openage::path
diff --git a/libopenage/pathfinding/demo/demo_0.cpp b/libopenage/pathfinding/demo/demo_0.cpp
index c063445192..483261ebaf 100644
--- a/libopenage/pathfinding/demo/demo_0.cpp
+++ b/libopenage/pathfinding/demo/demo_0.cpp
@@ -735,12 +735,12 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 	// add vertices for the cells of the grid
 	std::vector<float> verts{};
 	auto vert_count = size[0] * size[1];
-	verts.reserve(vert_count * 4);
+	verts.reserve(vert_count * 5);
 	for (int i = 0; i < static_cast<int>(size[0]); ++i) {
 		for (int j = 0; j < static_cast<int>(size[1]); ++j) {
 			// for each vertex, compare the surrounding tiles
-			std::vector<float> ff_surround{};
-			std::vector<float> int_surround{};
+			std::vector<flow_t> ff_surround{};
+			std::vector<integrated_flags_t> int_surround{};
 			if (j - 1 >= 0 and i - 1 >= 0) {
 				auto ff_cost = flow_field->get_cell((i - 1) / resolution, (j - 1) / resolution);
 				ff_surround.push_back(ff_cost);
@@ -769,9 +769,15 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 				auto int_flags = int_field->get_cell(i / resolution, (j - 1) / resolution).flags;
 				int_surround.push_back(int_flags);
 			}
-			// use the cost of the most expensive surrounding tile
-			auto ff_max_cost = *std::max_element(ff_surround.begin(), ff_surround.end());
-			auto int_max_flags = *std::max_element(int_surround.begin(), int_surround.end());
+			// combine the flags of the sorrounding tiles
+			auto ff_max_flags = 0;
+			for (auto &val : ff_surround) {
+				ff_max_flags |= val & 0xF0;
+			}
+			auto int_max_flags = 0;
+			for (auto &val : int_surround) {
+				int_max_flags |= val;
+			}
 
 			coord::scene3 v{
 				static_cast<float>(i * vert_distance),
@@ -782,7 +788,7 @@ renderer::resources::MeshData RenderManager0::get_flow_field_mesh(const std::sha
 			verts.push_back(world_v[0]);
 			verts.push_back(world_v[1]);
 			verts.push_back(world_v[2]);
-			verts.push_back(ff_max_cost);
+			verts.push_back(ff_max_flags);
 			verts.push_back(int_max_flags);
 		}
 	}
diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 3b2dd3e1da..04649bcbe1 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -78,11 +78,6 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				flow_cells[idx] |= FLOW_LOS_MASK;
 			}
 
-			if (integrate_cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
-				// Cell is blocked by a line-of-sight corner
-				flow_cells[idx] |= FLOW_WAVEFRONT_BLOCKED_MASK;
-			}
-
 			if (integrate_cells[idx].flags & INTEGRATE_TARGET_MASK) {
 				// target cells are pathable
 				flow_cells[idx] |= FLOW_PATHABLE_MASK;
@@ -258,7 +253,7 @@ void FlowField::reset() {
 }
 
 void FlowField::reset_dynamic_flags() {
-	flow_t mask = 0xFF & ~(FLOW_LOS_MASK | FLOW_WAVEFRONT_BLOCKED_MASK);
+	flow_t mask = 0xFF & ~(FLOW_LOS_MASK);
 	for (flow_t &cell : this->cells) {
 		cell = cell & mask;
 	}
@@ -275,11 +270,6 @@ void FlowField::transfer_dynamic_flags(const std::shared_ptr<IntegrationField> &
 			// Cell is in line of sight
 			flow_cells[idx] |= FLOW_LOS_MASK;
 		}
-
-		if (integrate_cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
-			// Cell is blocked by a line-of-sight corner
-			flow_cells[idx] |= FLOW_WAVEFRONT_BLOCKED_MASK;
-		}
 	}
 
 	log::log(DBG << "Flow field dynamic flags have been transferred");
diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index fb62372d67..346b8a1a4e 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -70,8 +70,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 		// in line-of-sight.
 
 		this->cells[target_idx].flags |= INTEGRATE_FOUND_MASK;
-		// ASDF: Fix display in demo 0
-		// this->cells[target_idx].flags |= INTEGRATE_LOS_MASK;
+		this->cells[target_idx].flags |= INTEGRATE_LOS_MASK;
 
 		// Add neighbors to current wave
 		if (target.se > 0) {
@@ -267,8 +266,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 					// Add the current cell to the blocked wavefront if it's not a wall
 					wavefront_blocked.push_back(idx);
 					this->cells[idx].cost = wave_cost - 1 + cost_field->get_cost(idx);
-					// ASDF: Fix display in demo 0
-					// this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+					this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
 				}
 
 				// check each neighbor for a corner
diff --git a/libopenage/pathfinding/tests.cpp b/libopenage/pathfinding/tests.cpp
index 2d54dd728d..c68ef007f3 100644
--- a/libopenage/pathfinding/tests.cpp
+++ b/libopenage/pathfinding/tests.cpp
@@ -94,9 +94,9 @@ void flow_field() {
 		// | E  | E  | N |
 		auto ff_expected = std::vector<flow_t>{
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::EAST),
-			FLOW_WAVEFRONT_BLOCKED_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH_EAST),
+			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH_EAST),
 			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
-			FLOW_WAVEFRONT_BLOCKED_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH_EAST),
+			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH_EAST),
 			0,
 			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
 			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
diff --git a/libopenage/pathfinding/types.h b/libopenage/pathfinding/types.h
index 9a5c3806d6..629f201035 100644
--- a/libopenage/pathfinding/types.h
+++ b/libopenage/pathfinding/types.h
@@ -55,12 +55,12 @@ struct integrated_t {
 	 *
 	 * Bit 0-3: Shared flags with the flow field.
 	 *  - 0: Unused.
-	 *  - 1: Wave front blocked flag.
+	 *  - 1: Unused.
 	 *  - 2: Line of sight flag.
 	 *  - 3: Unused.
 	 * Bit 4-7: Integration field specific flags.
 	 *  - 4: Unused.
-	 *  - 5: Unused.
+	 *  - 5: Wave front blocked flag.
 	 *  - 6: LOS found flag.
 	 *  - 7: Target flag.
 	 */
@@ -87,7 +87,7 @@ enum class flow_dir_t : uint8_t {
  * Flow field cell value.
  *
  * Bit 0: Unused.
- * Bit 1: Wave front blocked flag.
+ * Bit 1: Unused.
  * Bit 2: Line of sight flag.
  * Bit 3: Pathable flag.
  * Bits 4-7: flow direction.

From 7b7117906eb2f5de99c1c51069097885b666c0cf Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 02:22:23 +0200
Subject: [PATCH 47/68] path: Add FLOW_TARGET flag.

---
 etc/gdb_pretty/printers.py            |  4 ++--
 libopenage/pathfinding/definitions.h  | 12 +++++++++++-
 libopenage/pathfinding/flow_field.cpp |  8 +++-----
 libopenage/pathfinding/types.h        |  6 +++---
 4 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/etc/gdb_pretty/printers.py b/etc/gdb_pretty/printers.py
index fdab2f12bc..fffce7e63d 100644
--- a/etc/gdb_pretty/printers.py
+++ b/etc/gdb_pretty/printers.py
@@ -291,7 +291,7 @@ class PathFlowTypePrinter:
     FLOW_FLAGS: dict = {
         0x10: 'PATHABLE',
         0x20: 'LOS',
-        0x40: 'UNUSED',
+        0x40: 'TARGET',
         0x80: 'UNUSED',
     }
 
@@ -333,10 +333,10 @@ def children(self):
 
 # Integrated flags
 INTEGRATED_FLAGS: dict = {
-    0x01: 'TARGET',
     0x02: 'FOUND',
     0x04: 'WAVEFRONT_BLOCKED',
     0x20: 'LOS',
+    0x40: 'TARGET',
 }
 
 
diff --git a/libopenage/pathfinding/definitions.h b/libopenage/pathfinding/definitions.h
index 0dc9594935..0fc8268291 100644
--- a/libopenage/pathfinding/definitions.h
+++ b/libopenage/pathfinding/definitions.h
@@ -50,7 +50,7 @@ constexpr integrated_flags_t INTEGRATE_LOS_MASK = 0x20;
 /**
  * Target flag in an integrated_flags_t value.
  */
-constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x01;
+constexpr integrated_flags_t INTEGRATE_TARGET_MASK = 0x40;
 
 /**
  * Found flag in an integrated_flags_t value.
@@ -78,6 +78,11 @@ constexpr flow_t FLOW_INIT = 0;
  */
 constexpr flow_t FLOW_DIR_MASK = 0x0F;
 
+/**
+ * Mask for the flow flag bits in a flow_t value.
+ */
+constexpr flow_t FLOW_FLAGS_MASK = 0xF0;
+
 /**
  * Pathable flag in a flow_t value.
  */
@@ -88,4 +93,9 @@ constexpr flow_t FLOW_PATHABLE_MASK = 0x10;
  */
 constexpr flow_t FLOW_LOS_MASK = 0x20;
 
+/**
+ * Target flag in a flow_t value.
+ */
+constexpr flow_t FLOW_TARGET_MASK = 0x40;
+
 } // namespace openage::path
diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 04649bcbe1..26b7592da8 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -73,12 +73,10 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				continue;
 			}
 
-			if (integrate_cells[idx].flags & INTEGRATE_LOS_MASK) {
-				// Cell is in line of sight
-				flow_cells[idx] |= FLOW_LOS_MASK;
-			}
+			flow_t transfer_flags = integrate_cells[idx].flags & FLOW_FLAGS_MASK;
+			flow_cells[idx] |= transfer_flags;
 
-			if (integrate_cells[idx].flags & INTEGRATE_TARGET_MASK) {
+			if (flow_cells[idx] & FLOW_TARGET_MASK) {
 				// target cells are pathable
 				flow_cells[idx] |= FLOW_PATHABLE_MASK;
 
diff --git a/libopenage/pathfinding/types.h b/libopenage/pathfinding/types.h
index 629f201035..1b48a49654 100644
--- a/libopenage/pathfinding/types.h
+++ b/libopenage/pathfinding/types.h
@@ -55,14 +55,14 @@ struct integrated_t {
 	 *
 	 * Bit 0-3: Shared flags with the flow field.
 	 *  - 0: Unused.
-	 *  - 1: Unused.
+	 *  - 1: Target flag.
 	 *  - 2: Line of sight flag.
 	 *  - 3: Unused.
 	 * Bit 4-7: Integration field specific flags.
 	 *  - 4: Unused.
 	 *  - 5: Wave front blocked flag.
 	 *  - 6: LOS found flag.
-	 *  - 7: Target flag.
+	 *  - 7: Unused.
 	 */
 	integrated_flags_t flags;
 };
@@ -87,7 +87,7 @@ enum class flow_dir_t : uint8_t {
  * Flow field cell value.
  *
  * Bit 0: Unused.
- * Bit 1: Unused.
+ * Bit 1: Target flag.
  * Bit 2: Line of sight flag.
  * Bit 3: Pathable flag.
  * Bits 4-7: flow direction.

From 82ce34ee0ba7ce76726290b47515e0747741e244 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 02:31:22 +0200
Subject: [PATCH 48/68] path: Check ifr target cell has been reached using flow
 target flag.

---
 libopenage/pathfinding/pathfinder.cpp | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 559a761639..8b4eb45f39 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -312,7 +312,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 	coord::tile_t target_x = request.target.ne % sector_size;
 	coord::tile_t target_y = request.target.se % sector_size;
 
-	bool reached_target = false;
+	bool los_reached = false;
 
 	coord::tile_t current_x = start_x;
 	coord::tile_t current_y = start_y;
@@ -321,25 +321,19 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 		auto sector = grid->get_sector(flow_fields.at(i).first);
 		auto flow_field = flow_fields.at(i).second;
 
+		auto cell = flow_field->get_cell(current_x, current_y);
 		// navigate the flow field vectors until we reach its edge (or the target)
-		while (current_x < static_cast<coord::tile_t>(sector_size)
-		       and current_y < static_cast<coord::tile_t>(sector_size)
-		       and current_x >= 0
-		       and current_y >= 0) {
-			auto cell = flow_field->get_cell(current_x, current_y);
+		while (not(cell & FLOW_TARGET_MASK)) {
 			if (cell & FLOW_LOS_MASK) {
 				// check if we reached an LOS cell
 				auto sector_pos = sector->get_position();
 				auto cell_pos = sector_pos.to_tile(sector_size)
 				                + coord::tile_delta(current_x, current_y);
 				waypoints.push_back(cell_pos);
-				reached_target = true;
+				los_reached = true;
 				break;
 			}
 
-			// ASDF: break if target cell is reached
-			// idea: target flag for flow field cells
-
 			// check if we need to change direction
 			auto cell_direction = flow_field->get_dir(coord::tile_delta(current_x, current_y));
 			if (cell_direction != current_direction) {
@@ -384,9 +378,14 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			default:
 				throw Error{ERR << "Invalid flow direction: " << static_cast<int>(current_direction)};
 			}
+
+			// get the next cell
+			cell = flow_field->get_cell(current_x, current_y);
 		}
 
-		if (reached_target) {
+		if (los_reached or i == flow_fields.size() - 1) {
+			// exit the loop if we found an LOS cell or reached
+			// the target cell in the last flow field
 			break;
 		}
 

From c1d5637ddb4e04b89601c05d03ba3da3395809de Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 02:40:08 +0200
Subject: [PATCH 49/68] etc: Add unused placeholders for integration flags.

---
 etc/gdb_pretty/printers.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/etc/gdb_pretty/printers.py b/etc/gdb_pretty/printers.py
index fffce7e63d..28bfb5ca22 100644
--- a/etc/gdb_pretty/printers.py
+++ b/etc/gdb_pretty/printers.py
@@ -333,10 +333,14 @@ def children(self):
 
 # Integrated flags
 INTEGRATED_FLAGS: dict = {
+    0x01: 'UNUSED',
     0x02: 'FOUND',
     0x04: 'WAVEFRONT_BLOCKED',
+    0x08: 'UNUSED',
+    0x10: 'UNUSED',
     0x20: 'LOS',
     0x40: 'TARGET',
+    0x80: 'UNUSED',
 }
 
 

From 9206916dfc6ac4b23b8833948c7ad11b63182baf Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 03:46:22 +0200
Subject: [PATCH 50/68] path: Optimize performance-critical paths in the code.

---
 libopenage/pathfinding/integration_field.cpp | 26 ++++++++++++--------
 libopenage/pathfinding/pathfinder.cpp        | 22 ++++++-----------
 2 files changed, 23 insertions(+), 25 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 346b8a1a4e..4b71f3c586 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -119,6 +119,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	auto x_diff = exit_start.ne - entry_start.ne;
 	auto y_diff = exit_start.se - entry_start.se;
 
+	auto &cost_cells = cost_field->get_costs();
 	auto &other_cells = other->get_cells();
 
 	// transfer masks for flags from the other side of the portal
@@ -147,7 +148,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 			}
 
 			// Get the cost of the current cell
-			auto cell_cost = cost_field->get_cost(target_idx);
+			auto cell_cost = cost_cells[target_idx];
 
 			if (cell_cost > COST_MIN or this->cells[target_idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
 				// cell blocks line of sight
@@ -166,8 +167,8 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 					// draw a line from the corner to the edge of the field
 					// to get the cells blocked by the corner
 					auto blocked_cells = this->bresenhams_line(target, corner.first, corner.second);
-					for (auto &blocked_idx : blocked_cells) {
-						if (cost_field->get_cost(blocked_idx) > COST_MIN) {
+					for (auto blocked_idx : blocked_cells) {
+						if (cost_cells[blocked_idx] > COST_MIN) {
 							// stop if blocked_idx is not min cost
 							// because this idx may create a new corner
 							break;
@@ -229,6 +230,9 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	// Cost of the current wave
 	integrated_cost_t wave_cost = start_cost;
 
+	// Get the cost field values
+	auto &cost_cells = cost_field->get_costs();
+
 	// Add the start wave to the current wave
 	current_wave.insert(current_wave.end(), start_wave.begin(), start_wave.end());
 	do {
@@ -244,7 +248,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 			}
 			else if (this->cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
 				// Stop at cells that are blocked by a LOS corner
-				this->cells[idx].cost = wave_cost - 1 + cost_field->get_cost(idx);
+				this->cells[idx].cost = wave_cost - 1 + cost_cells[idx];
 				this->cells[idx].flags |= INTEGRATE_FOUND_MASK;
 				continue;
 			}
@@ -257,7 +261,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 			auto y = idx / this->size;
 
 			// Get the cost of the current cell
-			auto cell_cost = cost_field->get_cost(idx);
+			auto cell_cost = cost_cells[idx];
 
 			if (cell_cost > COST_MIN) {
 				// cell blocks line of sight
@@ -265,7 +269,7 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 				if (cell_cost != COST_IMPASSABLE) {
 					// Add the current cell to the blocked wavefront if it's not a wall
 					wavefront_blocked.push_back(idx);
-					this->cells[idx].cost = wave_cost - 1 + cost_field->get_cost(idx);
+					this->cells[idx].cost = wave_cost - 1 + cell_cost;
 					this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
 				}
 
@@ -275,8 +279,8 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 					// draw a line from the corner to the edge of the field
 					// to get the cells blocked by the corner
 					auto blocked_cells = this->bresenhams_line(target, corner.first, corner.second);
-					for (auto &blocked_idx : blocked_cells) {
-						if (cost_field->get_cost(blocked_idx) > COST_MIN) {
+					for (auto blocked_idx : blocked_cells) {
+						if (cost_cells[blocked_idx] > COST_MIN) {
 							// stop if blocked_idx is impassable
 							break;
 						}
@@ -380,6 +384,8 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 	std::vector<size_t> neighbors;
 	neighbors.reserve(4);
 
+	auto &cost_cells = cost_field->get_costs();
+
 	// Move outwards from the wavefront, updating the integration field
 	open_list.insert(open_list.end(), start_cells.begin(), start_cells.end());
 	while (!open_list.empty()) {
@@ -407,9 +413,9 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 		}
 
 		// Update the integration field of the neighboring cells
-		for (auto &neighbor_idx : neighbors) {
+		for (auto neighbor_idx : neighbors) {
 			this->update_neighbor(neighbor_idx,
-			                      cost_field->get_cost(neighbor_idx),
+			                      cost_cells[neighbor_idx],
 			                      integrated_current,
 			                      open_list);
 		}
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 8b4eb45f39..ae8a911716 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -309,8 +309,6 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 	auto sector_size = grid->get_sector_size();
 	coord::tile_t start_x = request.start.ne % sector_size;
 	coord::tile_t start_y = request.start.se % sector_size;
-	coord::tile_t target_x = request.target.ne % sector_size;
-	coord::tile_t target_y = request.target.se % sector_size;
 
 	bool los_reached = false;
 
@@ -318,29 +316,26 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 	coord::tile_t current_y = start_y;
 	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(current_x, current_y);
 	for (size_t i = 0; i < flow_fields.size(); ++i) {
-		auto sector = grid->get_sector(flow_fields.at(i).first);
-		auto flow_field = flow_fields.at(i).second;
+		auto sector = grid->get_sector(flow_fields[i].first);
+		auto sector_pos = sector->get_position().to_tile(sector_size);
+		auto flow_field = flow_fields[i].second;
 
 		auto cell = flow_field->get_cell(current_x, current_y);
 		// navigate the flow field vectors until we reach its edge (or the target)
 		while (not(cell & FLOW_TARGET_MASK)) {
 			if (cell & FLOW_LOS_MASK) {
 				// check if we reached an LOS cell
-				auto sector_pos = sector->get_position();
-				auto cell_pos = sector_pos.to_tile(sector_size)
-				                + coord::tile_delta(current_x, current_y);
+				auto cell_pos = sector_pos + coord::tile_delta(current_x, current_y);
 				waypoints.push_back(cell_pos);
 				los_reached = true;
 				break;
 			}
 
 			// check if we need to change direction
-			auto cell_direction = flow_field->get_dir(coord::tile_delta(current_x, current_y));
+			auto cell_direction = flow_field->get_dir(current_x, current_y);
 			if (cell_direction != current_direction) {
 				// add the current cell as a waypoint
-				auto sector_pos = sector->get_position();
-				auto cell_pos = sector_pos.to_tile(sector_size)
-				                + coord::tile_delta(current_x, current_y);
+				auto cell_pos = sector_pos + coord::tile_delta(current_x, current_y);
 				waypoints.push_back(cell_pos);
 				current_direction = cell_direction;
 			}
@@ -425,10 +420,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 	}
 
 	// add the target position as the last waypoint
-	auto sector_pos = grid->get_sector(flow_fields.back().first)->get_position();
-	auto target_pos = sector_pos.to_tile(sector_size)
-	                  + coord::tile_delta{target_x, target_y};
-	waypoints.push_back(target_pos);
+	waypoints.push_back(request.target);
 
 	return waypoints;
 }

From 2ac96380b7d4e727553143b029358e71b627c46b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 03:50:49 +0200
Subject: [PATCH 51/68] path: Remopve outdated TODOs.

---
 libopenage/pathfinding/demo/demo_1.cpp | 1 -
 libopenage/pathfinding/pathfinder.cpp  | 3 +--
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/libopenage/pathfinding/demo/demo_1.cpp b/libopenage/pathfinding/demo/demo_1.cpp
index f9d7cbc92f..cd67e7b79f 100644
--- a/libopenage/pathfinding/demo/demo_1.cpp
+++ b/libopenage/pathfinding/demo/demo_1.cpp
@@ -167,7 +167,6 @@ void path_demo_1(const util::Path &path) {
 	render_manager->create_waypoint_tiles(path_result);
 
 	// Run the renderer pss to draw the grid and path into a window
-	// TODO: Make this a while (not window.should_close()) loop
 	render_manager->run();
 }
 
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index ae8a911716..bc1621f217 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -191,8 +191,7 @@ const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &req
 	// list of known portals and corresponding node.
 	nodemap_t visited_portals;
 
-	// Cost to travel from one portal to another
-	// TODO: Determine this cost for each portal
+	// TODO: Compute cost to travel from one portal to another when creating portals
 	// const int distance_cost = 1;
 
 	// create start nodes

From a7415abfa81efed004998422967fbec9c6bfe5e1 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 04:02:53 +0200
Subject: [PATCH 52/68] path: Fix existing unit tests.

---
 libopenage/pathfinding/tests.cpp | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/libopenage/pathfinding/tests.cpp b/libopenage/pathfinding/tests.cpp
index c68ef007f3..5f92496ff8 100644
--- a/libopenage/pathfinding/tests.cpp
+++ b/libopenage/pathfinding/tests.cpp
@@ -29,7 +29,7 @@ void flow_field() {
 	{
 		auto integration_field = std::make_shared<IntegrationField>(3);
 		integration_field->integrate_cost(cost_field, coord::tile_delta{2, 2});
-		auto int_cells = integration_field->get_cells();
+		auto &int_cells = integration_field->get_cells();
 
 		// The integration field should look like:
 		// | 4 | 3 | 2 |
@@ -60,7 +60,7 @@ void flow_field() {
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH),
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::EAST),
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::EAST),
-			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::NORTH),
+			FLOW_TARGET_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::NORTH),
 		};
 
 		// Compare the integration field cells with the expected values
@@ -86,7 +86,7 @@ void flow_field() {
 
 		// Build the flow field
 		auto flow_field = integrator->get(cost_field, coord::tile_delta{2, 2}).second;
-		auto ff_cells = flow_field->get_cells();
+		auto &ff_cells = flow_field->get_cells();
 
 		// The flow field for targeting (2, 2) hould look like this:
 		// | E  | SE | S |
@@ -95,13 +95,13 @@ void flow_field() {
 		auto ff_expected = std::vector<flow_t>{
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::EAST),
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH_EAST),
-			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
+			FLOW_LOS_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH),
 			FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH_EAST),
 			0,
-			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
-			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
-			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
-			FLOW_LOS_MASK | FLOW_PATHABLE_MASK,
+			FLOW_LOS_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::SOUTH),
+			FLOW_LOS_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::EAST),
+			FLOW_LOS_MASK | FLOW_PATHABLE_MASK | static_cast<uint8_t>(flow_dir_t::EAST),
+			FLOW_LOS_MASK | FLOW_PATHABLE_MASK | FLOW_TARGET_MASK,
 		};
 
 		// Compare the flow field cells with the expected values

From 2abbb3db7565e64a1ec0509ad002e451fc9d5a30 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 04:27:26 +0200
Subject: [PATCH 53/68] path: More helpful log messages.

---
 libopenage/pathfinding/integrator.cpp | 31 +++++++++++++++++++++++++++
 libopenage/pathfinding/pathfinder.cpp | 14 ++++++------
 2 files changed, 38 insertions(+), 7 deletions(-)

diff --git a/libopenage/pathfinding/integrator.cpp b/libopenage/pathfinding/integrator.cpp
index 990dab37dd..265c5285cc 100644
--- a/libopenage/pathfinding/integrator.cpp
+++ b/libopenage/pathfinding/integrator.cpp
@@ -2,6 +2,8 @@
 
 #include "integrator.h"
 
+#include "log/log.h"
+
 #include "pathfinding/cost_field.h"
 #include "pathfinding/flow_field.h"
 #include "pathfinding/integration_field.h"
@@ -15,11 +17,14 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
                                                         bool with_los) {
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
 
+	log::log(DBG << "Integrating cost field for target coord " << target);
 	if (with_los) {
+		log::log(SPAM << "Performing LOS pass");
 		auto wavefront_blocked = integration_field->integrate_los(cost_field, target);
 		integration_field->integrate_cost(cost_field, std::move(wavefront_blocked));
 	}
 	else {
+		log::log(SPAM << "Skipping LOS pass");
 		integration_field->integrate_cost(cost_field, target);
 	}
 
@@ -35,7 +40,11 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
+		log::log(DBG << "Using cached integration field for portal " << portal->get_id()
+		             << " from sector " << other_sector_id);
 		if (with_los) {
+			log::log(SPAM << "Performing LOS pass on cached field");
+
 			// Make a copy of the cached field to avoid modifying the cached field
 			auto integration_field = std::make_shared<IntegrationField>(*cached->second.first);
 
@@ -47,12 +56,16 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
 		return cached->second.first;
 	}
 
+	log::log(DBG << "Integrating cost field for portal " << portal->get_id()
+	             << " from sector " << other_sector_id);
+
 	// Create a new integration field
 	auto integration_field = std::make_shared<IntegrationField>(cost_field->get_size());
 
 	// LOS pass
 	std::vector<size_t> wavefront_blocked;
 	if (with_los) {
+		log::log(SPAM << "Performing LOS pass");
 		wavefront_blocked = integration_field->integrate_los(cost_field, other, other_sector_id, portal, target);
 	}
 
@@ -73,6 +86,8 @@ std::shared_ptr<IntegrationField> Integrator::integrate(const std::shared_ptr<Co
 
 std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationField> &integration_field) {
 	auto flow_field = std::make_shared<FlowField>(integration_field->get_size());
+
+	log::log(DBG << "Building flow field from integration field");
 	flow_field->build(integration_field);
 
 	return flow_field;
@@ -86,7 +101,11 @@ std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationFi
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
+		log::log(DBG << "Using cached flow field for portal " << portal->get_id()
+		             << " from sector " << other_sector_id);
 		if (with_los) {
+			log::log(SPAM << "Transferring LOS flags to cached flow field");
+
 			// Make a copy of the cached flow field
 			auto flow_field = std::make_shared<FlowField>(*cached->second.second);
 
@@ -99,6 +118,9 @@ std::shared_ptr<FlowField> Integrator::build(const std::shared_ptr<IntegrationFi
 		return cached->second.second;
 	}
 
+	log::log(DBG << "Building flow field for portal " << portal->get_id()
+	             << " from sector " << other_sector_id);
+
 	auto flow_field = std::make_shared<FlowField>(integration_field->get_size());
 	flow_field->build(integration_field, other, other_sector_id, portal);
 
@@ -122,13 +144,19 @@ Integrator::get_return_t Integrator::get(const std::shared_ptr<CostField> &cost_
 	auto cache_key = std::make_pair(portal->get_id(), other_sector_id);
 	auto cached = this->field_cache.find(cache_key);
 	if (cached != this->field_cache.end()) {
+		log::log(DBG << "Using cached integration and flow fields for portal " << portal->get_id()
+		             << " from sector " << other_sector_id);
 		if (with_los) {
+			log::log(SPAM << "Performing LOS pass on cached field");
+
 			// Make a copy of the cached integration field
 			auto integration_field = std::make_shared<IntegrationField>(*cached->second.first);
 
 			// Only integrate LOS; leave the rest of the field as is
 			integration_field->integrate_los(cost_field, other, other_sector_id, portal, target);
 
+			log::log(SPAM << "Transferring LOS flags to cached flow field");
+
 			// Make a copy of the cached flow field
 			auto flow_field = std::make_shared<FlowField>(*cached->second.second);
 
@@ -144,6 +172,9 @@ Integrator::get_return_t Integrator::get(const std::shared_ptr<CostField> &cost_
 	auto integration_field = this->integrate(cost_field, other, other_sector_id, portal, target, with_los);
 	auto flow_field = this->build(integration_field, other, other_sector_id, portal);
 
+	log::log(DBG << "Caching integration and flow fields for portal ID: " << portal->get_id()
+	             << ", sector ID: " << other_sector_id);
+
 	// Copy the fields to the cache.
 	std::shared_ptr<IntegrationField> cached_integration_field = std::make_shared<IntegrationField>(*integration_field);
 	cached_integration_field->reset_dynamic_flags();
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index bc1621f217..7c063821cb 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -31,7 +31,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	    or request.target.se < 0
 	    or request.target.ne >= grid_width
 	    or request.target.se >= grid_height) {
-		log::log(INFO << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
 		log::log(DBG << "Target is out of bounds.");
 		return Path{request.grid_id, PathResult::OUT_OF_BOUNDS, {}};
 	}
@@ -64,7 +64,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 			}
 			waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
-			log::log(INFO << "Path found (start = " << request.start << "; target = " << request.target << ")");
+			log::log(DBG << "Path found (start = " << request.start << "; target = " << request.target << ")");
 			log::log(DBG << "Path is within the same sector.");
 			return Path{request.grid_id, PathResult::FOUND, waypoints};
 		}
@@ -97,7 +97,7 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 
 	if (target_portal_ids.empty() or start_portal_ids.empty()) {
 		// Exit early if no portals are reachable from the start or target
-		log::log(INFO << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
 		log::log(DBG << "No portals are reachable from the start or target.");
 		return Path{request.grid_id, PathResult::NOT_FOUND, {}};
 	}
@@ -157,10 +157,10 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
 	if (portal_status == PathResult::NOT_FOUND) {
-		log::log(INFO << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
 	}
 	else {
-		log::log(INFO << "Path found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Path found (start = " << request.start << "; target = " << request.target << ")");
 	}
 	return Path{request.grid_id, portal_status, waypoints};
 }
@@ -234,7 +234,7 @@ const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &req
 			for (auto &node : backtrace) {
 				result.push_back(node->portal);
 			}
-			log::log(INFO << "Portal path found with " << result.size() << " portal traversals.");
+			log::log(DBG << "Portal path found with " << result.size() << " portal traversals.");
 			return std::make_pair(PathResult::FOUND, result);
 		}
 
@@ -293,7 +293,7 @@ const Pathfinder::portal_star_t Pathfinder::portal_a_star(const PathRequest &req
 		result.push_back(node->portal);
 	}
 
-	log::log(INFO << "Portal path not found.");
+	log::log(DBG << "Portal path not found.");
 	log::log(DBG << "Closest portal: " << closest_node->portal->get_id());
 	return std::make_pair(PathResult::NOT_FOUND, result);
 }

From 09e22df6ebe27c21288588fa3f2e853a8f04c150 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 04:49:10 +0200
Subject: [PATCH 54/68] path: Fix waypoint finder exiting one cell too early.

---
 libopenage/pathfinding/pathfinder.cpp | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 7c063821cb..37e049c3e9 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -319,9 +319,11 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 		auto sector_pos = sector->get_position().to_tile(sector_size);
 		auto flow_field = flow_fields[i].second;
 
-		auto cell = flow_field->get_cell(current_x, current_y);
 		// navigate the flow field vectors until we reach its edge (or the target)
-		while (not(cell & FLOW_TARGET_MASK)) {
+		flow_t cell;
+		do {
+			cell = flow_field->get_cell(current_x, current_y);
+
 			if (cell & FLOW_LOS_MASK) {
 				// check if we reached an LOS cell
 				auto cell_pos = sector_pos + coord::tile_delta(current_x, current_y);
@@ -372,10 +374,8 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			default:
 				throw Error{ERR << "Invalid flow direction: " << static_cast<int>(current_direction)};
 			}
-
-			// get the next cell
-			cell = flow_field->get_cell(current_x, current_y);
 		}
+		while (not(cell & FLOW_TARGET_MASK));
 
 		if (los_reached or i == flow_fields.size() - 1) {
 			// exit the loop if we found an LOS cell or reached

From b651e3697f6bc5bff1f646570508463954c1c45b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 05:10:49 +0200
Subject: [PATCH 55/68] Fix compiler warnings.

---
 libopenage/gamestate/terrain.cpp      | 6 +++---
 libopenage/pathfinding/pathfinder.cpp | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/libopenage/gamestate/terrain.cpp b/libopenage/gamestate/terrain.cpp
index 8625c0b727..e7d078f2c5 100644
--- a/libopenage/gamestate/terrain.cpp
+++ b/libopenage/gamestate/terrain.cpp
@@ -45,7 +45,7 @@ Terrain::Terrain(const util::Vector2s &size,
 		current_offset.ne += chunk_size[0];
 
 		// Wrap around to the next row
-		if (current_offset.ne == size[0]) {
+		if (current_offset.ne == static_cast<coord::tile_t>(size[0])) {
 			current_offset.ne = 0;
 			current_offset.se += chunk_size[1];
 		}
@@ -61,12 +61,12 @@ Terrain::Terrain(const util::Vector2s &size,
 		}
 
 		// Check terrain boundaries
-		if (current_offset.ne > size[0]) {
+		if (current_offset.ne > static_cast<coord::tile_t>(size[0])) {
 			throw error::Error{ERR << "Width of chunk " << chunk->get_offset()
 			                       << " exceeds terrain width: " << chunk_size[0]
 			                       << " (max width: " << size[0] << ")"};
 		}
-		else if (current_offset.se > size[1]) {
+		else if (current_offset.se > static_cast<coord::tile_t>(size[1])) {
 			throw error::Error{ERR << "Height of chunk " << chunk->get_offset()
 			                       << " exceeds terrain height: " << chunk_size[1]
 			                       << " (max height: " << size[1] << ")"};
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 37e049c3e9..b734f4a304 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -29,8 +29,8 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	auto grid_height = grid_size[1] * sector_size;
 	if (request.target.ne < 0
 	    or request.target.se < 0
-	    or request.target.ne >= grid_width
-	    or request.target.se >= grid_height) {
+	    or request.target.ne >= static_cast<coord::tile_t>(grid_width)
+	    or request.target.se >= static_cast<coord::tile_t>(grid_height)) {
 		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
 		log::log(DBG << "Target is out of bounds.");
 		return Path{request.grid_id, PathResult::OUT_OF_BOUNDS, {}};

From 3790ffb5f289d5fc9b7df90a8a11a477b38d66b2 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 15:55:46 +0200
Subject: [PATCH 56/68] path: Vectorize and unroll loops to maximize
 performance.

---
 libopenage/pathfinding/integration_field.cpp | 107 +++++++++++--------
 libopenage/pathfinding/integration_field.h   |   4 +-
 2 files changed, 63 insertions(+), 48 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 4b71f3c586..6e76542cde 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -222,10 +222,16 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	std::vector<size_t> wavefront_blocked;
 
 	// Cells that still have to be visited by the current wave
-	std::deque<size_t> current_wave;
+	std::vector<size_t> current_wave = std::move(start_wave);
 
 	// Cells that have to be visited in the next wave
-	std::deque<size_t> next_wave;
+	std::vector<size_t> next_wave;
+
+	// Preallocate ~30% of the field size for the wavefront
+	// This reduces the number of reallocations on push_back operations
+	// TODO: Find "optimal" value for reserve
+	current_wave.reserve(this->size * 3);
+	next_wave.reserve(this->size * 3);
 
 	// Cost of the current wave
 	integrated_cost_t wave_cost = start_cost;
@@ -233,14 +239,10 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 	// Get the cost field values
 	auto &cost_cells = cost_field->get_costs();
 
-	// Add the start wave to the current wave
-	current_wave.insert(current_wave.end(), start_wave.begin(), start_wave.end());
 	do {
-		while (not current_wave.empty()) {
+		for (size_t i = 0; i < current_wave.size(); ++i) {
 			// inner loop: handle a wave
-
-			auto idx = current_wave.front();
-			current_wave.pop_front();
+			auto idx = current_wave[i];
 
 			if (this->cells[idx].flags & INTEGRATE_FOUND_MASK) {
 				// Skip cells that are already in the line of sight
@@ -376,52 +378,65 @@ void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_fie
 
 void IntegrationField::integrate_cost(const std::shared_ptr<CostField> &cost_field,
                                       std::vector<size_t> &&start_cells) {
-	// Cells that still have to be visited
-	// they may be visited multiple times
-	std::deque<size_t> open_list;
+	// Cells that still have to be visited by the current wave
+	std::vector<size_t> current_wave = std::move(start_cells);
 
-	// Stores neighbors of the current cell
-	std::vector<size_t> neighbors;
-	neighbors.reserve(4);
+	// Cells that have to be visited in the next wave
+	std::vector<size_t> next_wave;
+
+	// Preallocate ~30% of the field size for the wavefront
+	// This reduces the number of reallocations on push_back operations
+	// TODO: Find "optimal" value for reserve
+	current_wave.reserve(this->size * 3);
+	next_wave.reserve(this->size * 3);
 
+	// Get the cost field values
 	auto &cost_cells = cost_field->get_costs();
 
 	// Move outwards from the wavefront, updating the integration field
-	open_list.insert(open_list.end(), start_cells.begin(), start_cells.end());
-	while (!open_list.empty()) {
-		auto idx = open_list.front();
-		open_list.pop_front();
+	while (not current_wave.empty()) {
+		for (size_t i = 0; i < current_wave.size(); ++i) {
+			auto idx = current_wave[i];
 
-		// Get the x and y coordinates of the current cell
-		auto x = idx % this->size;
-		auto y = idx / this->size;
-
-		auto integrated_current = this->cells.at(idx).cost;
+			// Get the x and y coordinates of the current cell
+			auto x = idx % this->size;
+			auto y = idx / this->size;
 
-		// Get the neighbors of the current cell
-		if (y > 0) {
-			neighbors.push_back(idx - this->size);
-		}
-		if (x > 0) {
-			neighbors.push_back(idx - 1);
-		}
-		if (y < this->size - 1) {
-			neighbors.push_back(idx + this->size);
-		}
-		if (x < this->size - 1) {
-			neighbors.push_back(idx + 1);
-		}
+			auto integrated_current = this->cells[idx].cost;
 
-		// Update the integration field of the neighboring cells
-		for (auto neighbor_idx : neighbors) {
-			this->update_neighbor(neighbor_idx,
-			                      cost_cells[neighbor_idx],
-			                      integrated_current,
-			                      open_list);
+			// Get the neighbors of the current cell
+			if (y > 0) {
+				auto neighbor_idx = idx - this->size;
+				this->update_neighbor(neighbor_idx,
+				                      cost_cells[neighbor_idx],
+				                      integrated_current,
+				                      next_wave);
+			}
+			if (x > 0) {
+				auto neighbor_idx = idx - 1;
+				this->update_neighbor(neighbor_idx,
+				                      cost_cells[neighbor_idx],
+				                      integrated_current,
+				                      next_wave);
+			}
+			if (y < this->size - 1) {
+				auto neighbor_idx = idx + this->size;
+				this->update_neighbor(neighbor_idx,
+				                      cost_cells[neighbor_idx],
+				                      integrated_current,
+				                      next_wave);
+			}
+			if (x < this->size - 1) {
+				auto neighbor_idx = idx + 1;
+				this->update_neighbor(neighbor_idx,
+				                      cost_cells[neighbor_idx],
+				                      integrated_current,
+				                      next_wave);
+			}
 		}
 
-		// Clear the neighbors vector
-		neighbors.clear();
+		current_wave.swap(next_wave);
+		next_wave.clear();
 	}
 }
 
@@ -447,7 +462,7 @@ void IntegrationField::reset_dynamic_flags() {
 void IntegrationField::update_neighbor(size_t idx,
                                        cost_t cell_cost,
                                        integrated_cost_t integrated_cost,
-                                       std::deque<size_t> &open_list) {
+                                       std::vector<size_t> &wave) {
 	ENSURE(cell_cost > COST_INIT, "cost field cell value must be non-zero");
 
 	// Check if the cell is impassable
@@ -462,7 +477,7 @@ void IntegrationField::update_neighbor(size_t idx,
 		// update the cell and add it to the open list
 		this->cells[idx].cost = cost;
 
-		open_list.push_back(idx);
+		wave.push_back(idx);
 	}
 }
 
diff --git a/libopenage/pathfinding/integration_field.h b/libopenage/pathfinding/integration_field.h
index a8564eccd8..c9149cc82f 100644
--- a/libopenage/pathfinding/integration_field.h
+++ b/libopenage/pathfinding/integration_field.h
@@ -181,14 +181,14 @@ class IntegrationField {
 	 * @param idx Index of the neighbor cell that is updated.
 	 * @param cell_cost Cost of the neighbor cell from the cost field.
 	 * @param integrated_cost Current integrated cost of the updating cell in the integration field.
-	 * @param open_list List of cells to be updated.
+	 * @param wave List of cells that are part of the next wavefront.
 	 *
 	 * @return New integration value of the cell.
 	 */
 	void update_neighbor(size_t idx,
 	                     cost_t cell_cost,
 	                     integrated_cost_t integrated_cost,
-	                     std::deque<size_t> &open_list);
+	                     std::vector<size_t> &wave);
 
 	/**
 	 * Get the LOS corners around a cell.

From 91e84a9da004da51f2864bdd4e7b4b56167c2e82 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 17:40:18 +0200
Subject: [PATCH 57/68] path: Speed up flow field access.

---
 libopenage/pathfinding/flow_field.cpp | 38 +++++++++++++++------------
 libopenage/pathfinding/pathfinder.cpp |  6 ++---
 2 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index 26b7592da8..a3ce56f331 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -68,32 +68,36 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 		for (size_t x = 0; x < this->size; ++x) {
 			size_t idx = y * this->size + x;
 
-			if (integrate_cells[idx].cost == INTEGRATED_COST_UNREACHABLE) {
+			const auto &integrate_cell = integrate_cells[idx];
+			auto &flow_cell = flow_cells[idx];
+
+			if (integrate_cell.cost == INTEGRATED_COST_UNREACHABLE) {
 				// Cell cannot be used as path
 				continue;
 			}
 
-			flow_t transfer_flags = integrate_cells[idx].flags & FLOW_FLAGS_MASK;
-			flow_cells[idx] |= transfer_flags;
+			flow_t transfer_flags = integrate_cell.flags & FLOW_FLAGS_MASK;
+			flow_cell |= transfer_flags;
 
-			if (flow_cells[idx] & FLOW_TARGET_MASK) {
+			if (flow_cell & FLOW_TARGET_MASK) {
 				// target cells are pathable
-				flow_cells[idx] |= FLOW_PATHABLE_MASK;
+				flow_cell |= FLOW_PATHABLE_MASK;
 
 				// they also have a preset flow direction so we can skip here
 				continue;
 			}
 
 			// Store which of the non-diagonal directions are unreachable.
-			std::bitset<4> directions_unreachable;
+			// north == 0x01, east == 0x02, south == 0x04, west == 0x08
+			uint8_t directions_unreachable = 0x00;
 
 			// Find the neighbor with the smallest cost.
-			flow_dir_t direction = static_cast<flow_dir_t>(flow_cells[idx] & FLOW_DIR_MASK);
+			flow_dir_t direction = static_cast<flow_dir_t>(flow_cell & FLOW_DIR_MASK);
 			auto smallest_cost = INTEGRATED_COST_UNREACHABLE;
 			if (y > 0) {
 				auto cost = integrate_cells[idx - this->size].cost;
 				if (cost == INTEGRATED_COST_UNREACHABLE) {
-					directions_unreachable[0] = true;
+					directions_unreachable |= 0x01;
 				}
 				else if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -103,7 +107,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			if (x < this->size - 1) {
 				auto cost = integrate_cells[idx + 1].cost;
 				if (cost == INTEGRATED_COST_UNREACHABLE) {
-					directions_unreachable[1] = true;
+					directions_unreachable |= 0x02;
 				}
 				else if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -113,7 +117,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			if (y < this->size - 1) {
 				auto cost = integrate_cells[idx + this->size].cost;
 				if (cost == INTEGRATED_COST_UNREACHABLE) {
-					directions_unreachable[2] = true;
+					directions_unreachable |= 0x04;
 				}
 				else if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -123,7 +127,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			if (x > 0) {
 				auto cost = integrate_cells[idx - 1].cost;
 				if (cost == INTEGRATED_COST_UNREACHABLE) {
-					directions_unreachable[3] = true;
+					directions_unreachable |= 0x08;
 				}
 				else if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -132,7 +136,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			}
 
 			if (x < this->size - 1 and y > 0
-			    and not(directions_unreachable[0] and directions_unreachable[1])) {
+			    and not(directions_unreachable & 0x01 and directions_unreachable & 0x02)) {
 				auto cost = integrate_cells[idx - this->size + 1].cost;
 				if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -140,7 +144,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				}
 			}
 			if (x < this->size - 1 and y < this->size - 1
-			    and not(directions_unreachable[1] and directions_unreachable[2])) {
+			    and not(directions_unreachable & 0x02 and directions_unreachable & 0x04)) {
 				auto cost = integrate_cells[idx + this->size + 1].cost;
 				if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -148,7 +152,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				}
 			}
 			if (x > 0 and y < this->size - 1
-			    and not(directions_unreachable[2] and directions_unreachable[3])) {
+			    and not(directions_unreachable & 0x04 and directions_unreachable & 0x08)) {
 				auto cost = integrate_cells[idx + this->size - 1].cost;
 				if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -156,7 +160,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				}
 			}
 			if (x > 0 and y > 0
-			    and not(directions_unreachable[3] and directions_unreachable[0])) {
+			    and not(directions_unreachable & 0x01 and directions_unreachable & 0x08)) {
 				auto cost = integrate_cells[idx - this->size - 1].cost;
 				if (cost < smallest_cost) {
 					smallest_cost = cost;
@@ -165,10 +169,10 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			}
 
 			// Set the flow field cell to pathable.
-			flow_cells[idx] |= FLOW_PATHABLE_MASK;
+			flow_cell |= FLOW_PATHABLE_MASK;
 
 			// Set the flow field cell to the direction of the smallest cost.
-			flow_cells[idx] |= static_cast<uint8_t>(direction);
+			flow_cell |= static_cast<uint8_t>(direction);
 		}
 	}
 }
diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index b734f4a304..6f67d254be 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -315,9 +315,9 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 	coord::tile_t current_y = start_y;
 	flow_dir_t current_direction = flow_fields.at(0).second->get_dir(current_x, current_y);
 	for (size_t i = 0; i < flow_fields.size(); ++i) {
-		auto sector = grid->get_sector(flow_fields[i].first);
+		auto &sector = grid->get_sector(flow_fields[i].first);
 		auto sector_pos = sector->get_position().to_tile(sector_size);
-		auto flow_field = flow_fields[i].second;
+		auto &flow_field = flow_fields[i].second;
 
 		// navigate the flow field vectors until we reach its edge (or the target)
 		flow_t cell;
@@ -333,7 +333,7 @@ const std::vector<coord::tile> Pathfinder::get_waypoints(const std::vector<std::
 			}
 
 			// check if we need to change direction
-			auto cell_direction = flow_field->get_dir(current_x, current_y);
+			auto cell_direction = static_cast<flow_dir_t>(cell & FLOW_DIR_MASK);
 			if (cell_direction != current_direction) {
 				// add the current cell as a waypoint
 				auto cell_pos = sector_pos + coord::tile_delta(current_x, current_y);

From 156165a4f1f368ce6321423fb54a9893490453c0 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 18:13:36 +0200
Subject: [PATCH 58/68] path: Optimize portal exit node search for speed.

---
 libopenage/pathfinding/pathfinder.cpp | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index 6f67d254be..a316a06acd 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -491,22 +491,25 @@ std::vector<node_t> PortalNode::generate_backtrace() {
 
 std::vector<node_t> PortalNode::get_exits(const nodemap_t &nodes,
                                           sector_id_t entry_sector) {
-	std::vector<node_t> exits;
+	auto &exits = this->portal->get_exits(entry_sector);
+	std::vector<node_t> exit_nodes;
+	exit_nodes.reserve(exits.size());
 
 	auto exit_sector = this->portal->get_exit_sector(entry_sector);
-	for (auto &exit : this->portal->get_exits(entry_sector)) {
+	for (auto &exit : exits) {
 		auto exit_id = exit->get_id();
 
-		if (nodes.contains(exit_id)) {
-			exits.push_back(nodes.at(exit_id));
+		auto exit_node = nodes.find(exit_id);
+		if (exit_node != nodes.end()) {
+			exit_nodes.push_back(exit_node->second);
 		}
 		else {
-			exits.push_back(std::make_shared<PortalNode>(exit,
-			                                             exit_sector,
-			                                             this->shared_from_this()));
+			exit_nodes.push_back(std::make_shared<PortalNode>(exit,
+			                                                  exit_sector,
+			                                                  this->shared_from_this()));
 		}
 	}
-	return exits;
+	return exit_nodes;
 }
 
 

From 7eaebae6109ce0d01d71384839427900c676f4d5 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 2 Jun 2024 18:43:23 +0200
Subject: [PATCH 59/68] path: Optimize access to integration cell in LOS pass.

---
 libopenage/pathfinding/integration_field.cpp | 36 ++++++++++++--------
 1 file changed, 21 insertions(+), 15 deletions(-)

diff --git a/libopenage/pathfinding/integration_field.cpp b/libopenage/pathfinding/integration_field.cpp
index 6e76542cde..26134506b8 100644
--- a/libopenage/pathfinding/integration_field.cpp
+++ b/libopenage/pathfinding/integration_field.cpp
@@ -238,25 +238,27 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 
 	// Get the cost field values
 	auto &cost_cells = cost_field->get_costs();
+	auto &integrate_cells = this->cells;
 
 	do {
 		for (size_t i = 0; i < current_wave.size(); ++i) {
 			// inner loop: handle a wave
 			auto idx = current_wave[i];
+			auto &cell = integrate_cells[idx];
 
-			if (this->cells[idx].flags & INTEGRATE_FOUND_MASK) {
+			if (cell.flags & INTEGRATE_FOUND_MASK) {
 				// Skip cells that are already in the line of sight
 				continue;
 			}
-			else if (this->cells[idx].flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
+			else if (cell.flags & INTEGRATE_WAVEFRONT_BLOCKED_MASK) {
 				// Stop at cells that are blocked by a LOS corner
-				this->cells[idx].cost = wave_cost - 1 + cost_cells[idx];
-				this->cells[idx].flags |= INTEGRATE_FOUND_MASK;
+				cell.cost = wave_cost - 1 + cost_cells[idx];
+				cell.flags |= INTEGRATE_FOUND_MASK;
 				continue;
 			}
 
 			// Add the current cell to the found cells
-			this->cells[idx].flags |= INTEGRATE_FOUND_MASK;
+			cell.flags |= INTEGRATE_FOUND_MASK;
 
 			// Get the x and y coordinates of the current cell
 			auto x = idx % this->size;
@@ -271,8 +273,8 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 				if (cell_cost != COST_IMPASSABLE) {
 					// Add the current cell to the blocked wavefront if it's not a wall
 					wavefront_blocked.push_back(idx);
-					this->cells[idx].cost = wave_cost - 1 + cell_cost;
-					this->cells[idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+					cell.cost = wave_cost - 1 + cell_cost;
+					cell.flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
 				}
 
 				// check each neighbor for a corner
@@ -287,10 +289,10 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 							break;
 						}
 						// set the blocked flag for the cell
-						this->cells[blocked_idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
+						integrate_cells[blocked_idx].flags |= INTEGRATE_WAVEFRONT_BLOCKED_MASK;
 
 						// clear los flag if it was set
-						this->cells[blocked_idx].flags &= ~INTEGRATE_LOS_MASK;
+						integrate_cells[blocked_idx].flags &= ~INTEGRATE_LOS_MASK;
 
 						wavefront_blocked.push_back(blocked_idx);
 					}
@@ -300,21 +302,25 @@ std::vector<size_t> IntegrationField::integrate_los(const std::shared_ptr<CostFi
 
 			// The cell is in the line of sight at min cost
 			// Set the LOS flag and cost
-			this->cells[idx].cost = wave_cost;
-			this->cells[idx].flags |= INTEGRATE_LOS_MASK;
+			cell.cost = wave_cost;
+			cell.flags |= INTEGRATE_LOS_MASK;
 
 			// Search the neighbors of the current cell
 			if (y > 0) {
-				next_wave.push_back(idx - this->size);
+				auto neighbor_idx = idx - this->size;
+				next_wave.push_back(neighbor_idx);
 			}
 			if (x > 0) {
-				next_wave.push_back(idx - 1);
+				auto neighbor_idx = idx - 1;
+				next_wave.push_back(neighbor_idx);
 			}
 			if (y < this->size - 1) {
-				next_wave.push_back(idx + this->size);
+				auto neighbor_idx = idx + this->size;
+				next_wave.push_back(neighbor_idx);
 			}
 			if (x < this->size - 1) {
-				next_wave.push_back(idx + 1);
+				auto neighbor_idx = idx + 1;
+				next_wave.push_back(neighbor_idx);
 			}
 		}
 

From 3a63dc69463d4321966da8f46d2bbf80edd4a50d Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Thu, 11 Jul 2024 02:03:48 +0200
Subject: [PATCH 60/68] path: Make distinction between cardinal/diagonal checks
 more clear.

---
 libopenage/pathfinding/flow_field.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/libopenage/pathfinding/flow_field.cpp b/libopenage/pathfinding/flow_field.cpp
index a3ce56f331..e582345b48 100644
--- a/libopenage/pathfinding/flow_field.cpp
+++ b/libopenage/pathfinding/flow_field.cpp
@@ -94,6 +94,8 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 			// Find the neighbor with the smallest cost.
 			flow_dir_t direction = static_cast<flow_dir_t>(flow_cell & FLOW_DIR_MASK);
 			auto smallest_cost = INTEGRATED_COST_UNREACHABLE;
+
+			// Cardinal directions
 			if (y > 0) {
 				auto cost = integrate_cells[idx - this->size].cost;
 				if (cost == INTEGRATED_COST_UNREACHABLE) {
@@ -135,6 +137,7 @@ void FlowField::build(const std::shared_ptr<IntegrationField> &integration_field
 				}
 			}
 
+			// Diagonal directions
 			if (x < this->size - 1 and y > 0
 			    and not(directions_unreachable & 0x01 and directions_unreachable & 0x02)) {
 				auto cost = integrate_cells[idx - this->size + 1].cost;

From 498beb32cabaed2e459ffcd868f36b2322529ea2 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 13 Jul 2024 11:57:13 +0200
Subject: [PATCH 61/68] etc: Remove pathfinding TODO from pretty printer.

---
 etc/gdb_pretty/printers.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/etc/gdb_pretty/printers.py b/etc/gdb_pretty/printers.py
index 28bfb5ca22..fe6d43e397 100644
--- a/etc/gdb_pretty/printers.py
+++ b/etc/gdb_pretty/printers.py
@@ -416,6 +416,5 @@ def children(self):
 
 
 # TODO: curve types
-# TODO: pathfinding types
 # TODO: input event codes
 # TODO: eigen types https://github.com/dmillard/eigengdb

From 966218697f089ba5f5c91b2d8a62248ea492b915 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 27 Jul 2024 22:28:16 +0200
Subject: [PATCH 62/68] path: Check if target cell is impassable.

---
 libopenage/pathfinding/pathfinder.cpp | 38 +++++++++++++++++++++------
 1 file changed, 30 insertions(+), 8 deletions(-)

diff --git a/libopenage/pathfinding/pathfinder.cpp b/libopenage/pathfinding/pathfinder.cpp
index a316a06acd..288f7875df 100644
--- a/libopenage/pathfinding/pathfinder.cpp
+++ b/libopenage/pathfinding/pathfinder.cpp
@@ -4,6 +4,7 @@
 
 #include "coord/chunk.h"
 #include "coord/phys.h"
+#include "pathfinding/cost_field.h"
 #include "pathfinding/flow_field.h"
 #include "pathfinding/grid.h"
 #include "pathfinding/integration_field.h"
@@ -31,8 +32,10 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	    or request.target.se < 0
 	    or request.target.ne >= static_cast<coord::tile_t>(grid_width)
 	    or request.target.se >= static_cast<coord::tile_t>(grid_height)) {
-		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
-		log::log(DBG << "Target is out of bounds.");
+		log::log(DBG << "Path not found (start = "
+		             << request.start << "; target = "
+		             << request.target << "): "
+		             << "Target is out of bounds.");
 		return Path{request.grid_id, PathResult::OUT_OF_BOUNDS, {}};
 	}
 
@@ -44,6 +47,16 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	auto target_sector_y = request.target.se / sector_size;
 	auto target_sector = grid->get_sector(target_sector_x, target_sector_y);
 
+	auto target = request.target - target_sector->get_position().to_tile(sector_size);
+	if (target_sector->get_cost_field()->get_cost(target) == COST_IMPASSABLE) {
+		// TODO: This may be okay if the target is a building or unit
+		log::log(DBG << "Path not found (start = "
+		             << request.start << "; target = "
+		             << request.target << "): "
+		             << "Target is impassable.");
+		return Path{request.grid_id, PathResult::NOT_FOUND, {}};
+	}
+
 	// Integrate the target field
 	coord::tile_delta target_delta = request.target - target_sector->get_position().to_tile(sector_size);
 	auto target_integration_field = this->integrator->integrate(target_sector->get_cost_field(),
@@ -64,8 +77,10 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 			}
 			waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
-			log::log(DBG << "Path found (start = " << request.start << "; target = " << request.target << ")");
-			log::log(DBG << "Path is within the same sector.");
+			log::log(DBG << "Path found (start = "
+			             << request.start << "; target = "
+			             << request.target << "): "
+			             << "Path is within the same sector.");
 			return Path{request.grid_id, PathResult::FOUND, waypoints};
 		}
 	}
@@ -97,8 +112,10 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 
 	if (target_portal_ids.empty() or start_portal_ids.empty()) {
 		// Exit early if no portals are reachable from the start or target
-		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
-		log::log(DBG << "No portals are reachable from the start or target.");
+		log::log(DBG << "Path not found (start = "
+		             << request.start << "; target = "
+		             << request.target << "): "
+		             << "No portals are reachable from the start or target.");
 		return Path{request.grid_id, PathResult::NOT_FOUND, {}};
 	}
 
@@ -157,11 +174,16 @@ const Path Pathfinder::get_path(const PathRequest &request) {
 	waypoints.insert(waypoints.end(), flow_field_waypoints.begin(), flow_field_waypoints.end());
 
 	if (portal_status == PathResult::NOT_FOUND) {
-		log::log(DBG << "Path not found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Path not found (start = "
+		             << request.start << "; target = "
+		             << request.target << ")");
 	}
 	else {
-		log::log(DBG << "Path found (start = " << request.start << "; target = " << request.target << ")");
+		log::log(DBG << "Path found (start = "
+		             << request.start << "; target = "
+		             << request.target << ")");
 	}
+
 	return Path{request.grid_id, portal_status, waypoints};
 }
 

From 38d05e6d3ef9b7f283c068c5d3db50e570618327 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 27 Jul 2024 23:00:41 +0200
Subject: [PATCH 63/68] renderer: Update animation frame based on keyframe
 insertion time.

---
 libopenage/renderer/stages/world/object.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libopenage/renderer/stages/world/object.cpp b/libopenage/renderer/stages/world/object.cpp
index d4629f866b..0a707807ca 100644
--- a/libopenage/renderer/stages/world/object.cpp
+++ b/libopenage/renderer/stages/world/object.cpp
@@ -98,7 +98,7 @@ void WorldObject::update_uniforms(const time::time_t &time) {
 	auto angle_degrees = this->angle.get(time).to_float();
 
 	// Animation information
-	auto animation_info = this->animation_info.get(time);
+	auto [last_update, animation_info] = this->animation_info.frame(time);
 
 	for (size_t layer_idx = 0; layer_idx < this->layer_uniforms.size(); ++layer_idx) {
 		auto &layer_unifs = this->layer_uniforms.at(layer_idx);
@@ -123,7 +123,7 @@ void WorldObject::update_uniforms(const time::time_t &time) {
 		case renderer::resources::display_mode::LOOP: {
 			// ONCE and LOOP are animated based on time
 			auto &timing = layer.get_frame_timing();
-			frame_idx = timing->get_frame(time, this->render_entity->get_update_time());
+			frame_idx = timing->get_frame(time, last_update);
 		} break;
 		case renderer::resources::display_mode::OFF:
 		default:

From 703250569b3d644ad8370b018e18e00afaa2a703 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sat, 27 Jul 2024 23:11:45 +0200
Subject: [PATCH 64/68] gamestate: Do not spawn entities outside of map area.

---
 libopenage/gamestate/event/spawn_entity.cpp | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/libopenage/gamestate/event/spawn_entity.cpp b/libopenage/gamestate/event/spawn_entity.cpp
index 9a728a71ef..66f6df9be7 100644
--- a/libopenage/gamestate/event/spawn_entity.cpp
+++ b/libopenage/gamestate/event/spawn_entity.cpp
@@ -1,4 +1,4 @@
-// Copyright 2023-2023 the openage authors. See copying.md for legal info.
+// Copyright 2023-2024 the openage authors. See copying.md for legal info.
 
 #include "spawn_entity.h"
 
@@ -19,6 +19,7 @@
 #include "gamestate/game_entity.h"
 #include "gamestate/game_state.h"
 #include "gamestate/manager.h"
+#include "gamestate/map.h"
 #include "gamestate/types.h"
 
 // TODO: Testing
@@ -155,6 +156,21 @@ void SpawnEntityHandler::invoke(openage::event::EventLoop & /* loop */,
                                 const param_map &params) {
 	auto gstate = std::dynamic_pointer_cast<gamestate::GameState>(state);
 
+	// Check if spawn position is on the map
+	auto pos = params.get("position", gamestate::WORLD_ORIGIN);
+	auto map_size = gstate->get_map()->get_size();
+	if (not(pos.ne >= 0
+	        and pos.ne < map_size[0]
+	        and pos.se >= 0
+	        and pos.se < map_size[1])) {
+		// Do nothing if the spawn position is not on the map
+		log::log(DBG << "Entity spawn failed: "
+		             << "Spawn position " << pos
+		             << " is not inside the map area "
+		             << "(map size: " << map_size << ")");
+		return;
+	}
+
 	auto nyan_db = gstate->get_db_view();
 
 	auto game_entities = nyan_db->get_obj_children_all("engine.util.game_entity.GameEntity");
@@ -183,7 +199,6 @@ void SpawnEntityHandler::invoke(openage::event::EventLoop & /* loop */,
 	auto entity_pos = std::dynamic_pointer_cast<component::Position>(
 		entity->get_component(component::component_t::POSITION));
 
-	auto pos = params.get("position", gamestate::WORLD_ORIGIN);
 	entity_pos->set_position(time, pos);
 	entity_pos->set_angle(time, coord::phys_angle_t::from_int(315));
 

From e999fe4ae8c43695a6376f31b4df63f487be6e26 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 28 Jul 2024 02:17:11 +0200
Subject: [PATCH 65/68] doc: Document field types in flow field pathfinder.

---
 doc/code/pathfinding/README.md                |   5 +-
 doc/code/pathfinding/field_types.md           |  78 ++++++++++++++++++
 doc/code/pathfinding/images/cost_field.png    | Bin 0 -> 118593 bytes
 doc/code/pathfinding/images/flow_field.png    | Bin 0 -> 173423 bytes
 .../pathfinding/images/integration_field.png  | Bin 0 -> 219179 bytes
 libopenage/pathfinding/definitions.h          |   2 +-
 6 files changed, 81 insertions(+), 4 deletions(-)
 create mode 100644 doc/code/pathfinding/field_types.md
 create mode 100644 doc/code/pathfinding/images/cost_field.png
 create mode 100644 doc/code/pathfinding/images/flow_field.png
 create mode 100644 doc/code/pathfinding/images/integration_field.png

diff --git a/doc/code/pathfinding/README.md b/doc/code/pathfinding/README.md
index a7ec70d1bd..19d1dc8d19 100644
--- a/doc/code/pathfinding/README.md
+++ b/doc/code/pathfinding/README.md
@@ -109,13 +109,12 @@ a path request is made, the main influence on performance is the A\* algorithm.
 a limited number of portals, the A\* search should overall be very cheap.
 
 The resulting list of sectors and portals is subsequently used in the low-level flow
-field calculations. As a first step, the pathfinder uses its integrator to generate
+field calculations. More details can be found in the [field types](field_types.md) document.
+As a first step, the pathfinder uses its integrator to generate
 a flow field for each identified sector. Generation starts with the target sector
 and ends with the start sector. Flow field results are passed through at the cells
 of the identified portals to make the flow between sectors seamless.
 
-<!-- TODO: More descriptions of cost/integration/flow field calculations -->
-
 In a second step, the pathfinder follows the movement vectors in the flow fields from
 the start cell to the target cell. Waypoints are created for every direction change, so
 that game entities can travel in straight lines between them. The list of waypoints
diff --git a/doc/code/pathfinding/field_types.md b/doc/code/pathfinding/field_types.md
new file mode 100644
index 0000000000..d7251da686
--- /dev/null
+++ b/doc/code/pathfinding/field_types.md
@@ -0,0 +1,78 @@
+# Field Types
+
+This document describes the field types used in the flow field pathfinding system.
+
+Most of the descriptions are based on the [*Crowd Pathfinding and Steering Using Flow Field Tiles*](http://www.gameaipro.com/GameAIPro/GameAIPro_Chapter23_Crowd_Pathfinding_and_Steering_Using_Flow_Field_Tiles.pdf) article by Elijah Emerson.
+
+## Cost Field
+
+A cost field is a square grid of cells that record the cost of movement on the location
+of each cell. Higher cost values indicate that it is less desirable to move through that cell.
+The field is usually initialized at the start of the game and persists for the lifetime of
+the entire pathfinding grid. During gameplay, individual cell costs may be altered to reflect
+changes in the environment.
+
+Cost values are represented as `uint8_t` (0-255) values. The range of usable cost values
+is `1` to `254`. `255` is a special value that represents an impassable cell. `0` is reserved
+for initialization and should not be used for flow field calculations.
+
+![Cost Field](images/cost_field.png)
+
+- **green**: minimum cost
+- **red**: maximum cost
+- **black**: impassable cell
+
+## Integration Field
+
+The integration field is created from a cost field when a path is requested. For a specific
+target cell, the integration field stores the accumulated cost of reaching that cell from
+every other cell in the field.
+
+Integration values are calculated using a wavefront algorithm. The algorithm starts at the
+target cell(s) and propagates outward, updating the integration value of each cell it visits.
+The integration value is calculated by adding the cost value of the current cell to the lowest
+integration value of the 4 cardinal neighbors. The integration value of the target cell(s) is `0`.
+
+Integration values are represented as `uint16_t` (0-65535) values. The range of usable integration
+values is `1` to `65534`. `65535` is a special value that represents an unreachable cell. During
+initialization, all cells are set to `65535`.
+
+An additional refinement step in the form of line-of-sight testing may be performed before the
+integration values are calculated. This step flags every cell that is in line of sight of the
+target cell. This allows for smoother pathing, as game entities can move in a straight line to
+the target cell. The algorithm for this step is described in more detail in section 23.6.2
+of the [*Crowd Pathfinding and Steering Using Flow Field Tiles*](http://www.gameaipro.com/GameAIPro/GameAIPro_Chapter23_Crowd_Pathfinding_and_Steering_Using_Flow_Field_Tiles.pdf) article.
+
+In addition to the integration values, the integration field also stores flags for each cell:
+
+- `FOUND`: cell has been visited
+- `TARGET`: cell is a target cell
+- `LOS`: cell is in line of sight of target cell
+- `WAVEFRONT_BLOCKED`: cell is blocking line of sight to target cell
+
+![Integration Field](images/integration_field.png)
+
+- **green**: lower integration values
+- **purple**: higher integration values
+- **black**: unreachable cell
+
+## Flow Field
+
+Creating the flow field is the final step in the flow field calculation. The field
+is created from the integration field. Cells in the flow field store the direction to
+the neighbor cell with the lowest *integrated* cost. Thus, directions create a "flow"
+towards the target cell. Following the directions from anywhere on the field will lead
+to the shortest path to the target cell.
+
+Flow field values are represented as `uint8_t` values. The 4 least significant bits are used
+to store the direction to the neighbor cell with the lowest integrated cost. Therefore, 8
+directions can be represented. The 4 most significant bits are used for flags:
+- `PATHABLE`: cell is passable
+- `LOS`: cell is in line of sight of target cell
+- `TARGET`: cell is a target cell
+
+![Flow Field](images/flow_field.png)
+
+- **white**: line of sight
+- **bright/dark grey**: passable cells (not in line of sight)
+- **black**: impassable cell
diff --git a/doc/code/pathfinding/images/cost_field.png b/doc/code/pathfinding/images/cost_field.png
new file mode 100644
index 0000000000000000000000000000000000000000..8d820b93faa52071ed4e6b1a71b3bd8d553dae87
GIT binary patch
literal 118593
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

literal 0
HcmV?d00001

diff --git a/doc/code/pathfinding/images/flow_field.png b/doc/code/pathfinding/images/flow_field.png
new file mode 100644
index 0000000000000000000000000000000000000000..ec2985ece2b0b5f7c0bf06efa160475c310d8fac
GIT binary patch
literal 173423
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

literal 0
HcmV?d00001

diff --git a/doc/code/pathfinding/images/integration_field.png b/doc/code/pathfinding/images/integration_field.png
new file mode 100644
index 0000000000000000000000000000000000000000..56df3abf49df906cf0501fa55221ced9044f70ff
GIT binary patch
literal 219179
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
N;i}4&T<IHr{|D;PN~8b)

literal 0
HcmV?d00001

diff --git a/libopenage/pathfinding/definitions.h b/libopenage/pathfinding/definitions.h
index 0fc8268291..2ace3c79ab 100644
--- a/libopenage/pathfinding/definitions.h
+++ b/libopenage/pathfinding/definitions.h
@@ -35,7 +35,7 @@ constexpr cost_t COST_IMPASSABLE = 255;
 /**
  * Start value for goal cells.
  */
-const integrated_cost_t INTEGRATED_COST_START = 0;
+constexpr integrated_cost_t INTEGRATED_COST_START = 0;
 
 /**
  * Unreachable value for a cells in the integration grid.

From 3c79d9e8f405401cc72dde39ceb6f4d4f666aca9 Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 28 Jul 2024 03:34:49 +0200
Subject: [PATCH 66/68] gamestate: Use nyan terrain definition for modpacks
 without terrain graphics.

---
 libopenage/gamestate/map.cpp             | 32 ++++++--------
 libopenage/gamestate/terrain_factory.cpp | 56 +++++++++++++++++-------
 libopenage/gamestate/terrain_tile.h      |  4 +-
 3 files changed, 54 insertions(+), 38 deletions(-)

diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
index beb02b5e8a..3d9af584cb 100644
--- a/libopenage/gamestate/map.cpp
+++ b/libopenage/gamestate/map.cpp
@@ -27,17 +27,15 @@ Map::Map(const std::shared_ptr<Terrain> &terrain) :
 	util::Vector2s grid_size{this->terrain->get_row_size(), this->terrain->get_column_size()};
 	for (const auto &chunk : this->terrain->get_chunks()) {
 		for (const auto &tile : chunk->get_tiles()) {
-			if (tile.terrain != std::nullopt) {
-				auto path_costs = api::APITerrain::get_path_costs(*tile.terrain);
+			auto path_costs = api::APITerrain::get_path_costs(tile.terrain);
 
-				for (const auto &path_cost : path_costs) {
-					if (not this->grid_lookup.contains(path_cost.first)) {
-						auto grid = std::make_shared<path::Grid>(grid_idx, grid_size, side_length);
-						this->pathfinder->add_grid(grid);
+			for (const auto &path_cost : path_costs) {
+				if (not this->grid_lookup.contains(path_cost.first)) {
+					auto grid = std::make_shared<path::Grid>(grid_idx, grid_size, side_length);
+					this->pathfinder->add_grid(grid);
 
-						this->grid_lookup.emplace(path_cost.first, grid_idx);
-						grid_idx += 1;
-					}
+					this->grid_lookup.emplace(path_cost.first, grid_idx);
+					grid_idx += 1;
 				}
 			}
 		}
@@ -48,17 +46,15 @@ Map::Map(const std::shared_ptr<Terrain> &terrain) :
 		auto chunk_terrain = this->terrain->get_chunk(chunk_idx);
 		for (size_t tile_idx = 0; tile_idx < chunk_terrain->get_tiles().size(); ++tile_idx) {
 			auto tile = chunk_terrain->get_tile(tile_idx);
-			if (tile.terrain != std::nullopt) {
-				auto path_costs = api::APITerrain::get_path_costs(*tile.terrain);
+			auto path_costs = api::APITerrain::get_path_costs(tile.terrain);
 
-				for (const auto &path_cost : path_costs) {
-					auto grid_id = this->grid_lookup.at(path_cost.first);
-					auto grid = this->pathfinder->get_grid(grid_id);
+			for (const auto &path_cost : path_costs) {
+				auto grid_id = this->grid_lookup.at(path_cost.first);
+				auto grid = this->pathfinder->get_grid(grid_id);
 
-					auto sector = grid->get_sector(chunk_idx);
-					auto cost_field = sector->get_cost_field();
-					cost_field->set_cost(tile_idx, path_cost.second);
-				}
+				auto sector = grid->get_sector(chunk_idx);
+				auto cost_field = sector->get_cost_field();
+				cost_field->set_cost(tile_idx, path_cost.second);
 			}
 		}
 	}
diff --git a/libopenage/gamestate/terrain_factory.cpp b/libopenage/gamestate/terrain_factory.cpp
index 55c70b34cf..3f16a6acf1 100644
--- a/libopenage/gamestate/terrain_factory.cpp
+++ b/libopenage/gamestate/terrain_factory.cpp
@@ -26,15 +26,30 @@ static const std::vector<std::string> test_terrain_paths = {
 	"../test/textures/test_terrain2.terrain",
 };
 
-static const std::vector<nyan::fqon_t> aoe1_test_terrain = {};
-static const std::vector<nyan::fqon_t> de1_test_terrain = {};
+static const std::vector<nyan::fqon_t> aoe1_test_terrain = {
+	"aoe1_base.data.terrain.forest.forest.Forest",
+	"aoe1_base.data.terrain.grass.grass.Grass",
+	"aoe1_base.data.terrain.dirt.dirt.Dirt",
+	"aoe1_base.data.terrain.water.water.Water",
+};
+static const std::vector<nyan::fqon_t> de1_test_terrain = {
+	"aoe1_base.data.terrain.desert.desert.Desert",
+	"aoe1_base.data.terrain.grass.grass.Grass",
+	"aoe1_base.data.terrain.dirt.dirt.Dirt",
+	"aoe1_base.data.terrain.water.water.Water",
+};
 static const std::vector<nyan::fqon_t> aoe2_test_terrain = {
 	"aoe2_base.data.terrain.foundation.foundation.Foundation",
 	"aoe2_base.data.terrain.grass.grass.Grass",
 	"aoe2_base.data.terrain.dirt.dirt.Dirt",
 	"aoe2_base.data.terrain.water.water.Water",
 };
-static const std::vector<nyan::fqon_t> de2_test_terrain = {};
+static const std::vector<nyan::fqon_t> de2_test_terrain = {
+	"de2_base.data.terrain.foundation.foundation.Foundation",
+	"de2_base.data.terrain.grass.grass.Grass",
+	"de2_base.data.terrain.dirt.dirt.Dirt",
+	"de2_base.data.terrain.water.water.Water",
+};
 static const std::vector<nyan::fqon_t> hd_test_terrain = {
 	"hd_base.data.terrain.foundation.foundation.Foundation",
 	"hd_base.data.terrain.grass.grass.Grass",
@@ -47,10 +62,16 @@ static const std::vector<nyan::fqon_t> swgb_test_terrain = {
 	"swgb_base.data.terrain.desert0.desert0.Desert0",
 	"swgb_base.data.terrain.water1.water1.Water1",
 };
-static const std::vector<nyan::fqon_t> trial_test_terrain = {};
+static const std::vector<nyan::fqon_t> trial_test_terrain = {
+	"trial_base.data.terrain.foundation.foundation.Foundation",
+	"trial_base.data.terrain.grass.grass.Grass",
+	"trial_base.data.terrain.dirt.dirt.Dirt",
+	"trial_base.data.terrain.water.water.Water",
+};
 
 // TODO: Remove hardcoded test texture references
 static std::vector<nyan::fqon_t> test_terrains; // declare static so we only have to do this once
+static bool has_graphics = false;
 
 void build_test_terrains(const std::shared_ptr<GameState> &gstate) {
 	auto modpack_ids = gstate->get_mod_manager()->get_load_order();
@@ -59,36 +80,43 @@ void build_test_terrains(const std::shared_ptr<GameState> &gstate) {
 			test_terrains.insert(test_terrains.end(),
 			                     aoe1_test_terrain.begin(),
 			                     aoe1_test_terrain.end());
+			has_graphics = false;
 		}
 		else if (modpack_id == "de1_base") {
 			test_terrains.insert(test_terrains.end(),
 			                     de1_test_terrain.begin(),
 			                     de1_test_terrain.end());
+			has_graphics = false;
 		}
 		else if (modpack_id == "aoe2_base") {
 			test_terrains.insert(test_terrains.end(),
 			                     aoe2_test_terrain.begin(),
 			                     aoe2_test_terrain.end());
+			has_graphics = true;
 		}
 		else if (modpack_id == "de2_base") {
 			test_terrains.insert(test_terrains.end(),
 			                     de2_test_terrain.begin(),
 			                     de2_test_terrain.end());
+			has_graphics = false;
 		}
 		else if (modpack_id == "hd_base") {
 			test_terrains.insert(test_terrains.end(),
 			                     hd_test_terrain.begin(),
 			                     hd_test_terrain.end());
+			has_graphics = true;
 		}
 		else if (modpack_id == "swgb_base") {
 			test_terrains.insert(test_terrains.end(),
 			                     swgb_test_terrain.begin(),
 			                     swgb_test_terrain.end());
+			has_graphics = true;
 		}
 		else if (modpack_id == "trial_base") {
 			test_terrains.insert(test_terrains.end(),
 			                     trial_test_terrain.begin(),
 			                     trial_test_terrain.end());
+			has_graphics = true;
 		}
 	}
 }
@@ -185,7 +213,7 @@ std::shared_ptr<TerrainChunk> TerrainFactory::add_chunk(const std::shared_ptr<Ga
 
 	// TODO: Remove test texture references
 	// ==========
-	std::optional<nyan::Object> terrain_obj;
+	nyan::Object terrain_obj;
 	if (test_terrains.empty()) {
 		build_test_terrains(gstate);
 	}
@@ -204,20 +232,14 @@ std::shared_ptr<TerrainChunk> TerrainFactory::add_chunk(const std::shared_ptr<Ga
 		for (size_t i = 0; i < size[0] * size[1]; ++i) {
 			size_t terrain_index = layout_chunks.at(test_chunk_index).at(i);
 			terrain_obj = gstate->get_db_view()->get_object(test_terrains.at(terrain_index));
-			terrain_info_path = api::APITerrain::get_terrain_path(terrain_obj.value());
-			tiles.push_back({terrain_obj, terrain_info_path, terrain_elevation_t::zero()});
-		}
 
-		test_chunk_index += 1;
-	}
-	else {
-		// use a test texture
-		if (test_chunk_index >= test_terrain_paths.size()) {
-			test_chunk_index = 0;
-		}
-		terrain_info_path = test_terrain_paths.at(test_chunk_index);
+			if (has_graphics) {
+				terrain_info_path = api::APITerrain::get_terrain_path(terrain_obj);
+			}
+			else {
+				terrain_info_path = test_terrain_paths.at(test_chunk_index % test_terrain_paths.size());
+			}
 
-		for (size_t i = 0; i < size[0] * size[1]; ++i) {
 			tiles.push_back({terrain_obj, terrain_info_path, terrain_elevation_t::zero()});
 		}
 
diff --git a/libopenage/gamestate/terrain_tile.h b/libopenage/gamestate/terrain_tile.h
index 36ae11ddf3..6d6dd99b55 100644
--- a/libopenage/gamestate/terrain_tile.h
+++ b/libopenage/gamestate/terrain_tile.h
@@ -20,10 +20,8 @@ using terrain_elevation_t = util::FixedPoint<uint64_t, 16>;
 struct TerrainTile {
 	/**
 	 * Terrain definition used by this tile.
-	 *
-	 * TODO: Make this non-optional once all modpacks support terrain graphics.
 	 */
-	std::optional<nyan::Object> terrain;
+	nyan::Object terrain;
 
 	/**
 	 * Path to the terrain asset used by this tile.

From 347d586e41107d2f22e55c5f0501b4a7d0cafe4a Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 28 Jul 2024 14:46:53 +0200
Subject: [PATCH 67/68] presenter: Let camera look at map center on startup.

---
 libopenage/presenter/presenter.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/libopenage/presenter/presenter.cpp b/libopenage/presenter/presenter.cpp
index 62435074d4..33c798bcef 100644
--- a/libopenage/presenter/presenter.cpp
+++ b/libopenage/presenter/presenter.cpp
@@ -116,6 +116,7 @@ void Presenter::init_graphics(bool debug) {
 
 	// Camera
 	this->camera = std::make_shared<renderer::camera::Camera>(this->renderer, this->window->get_size());
+	this->camera->look_at_coord(coord::scene3{10.0, 10.0, 0}); // Center camera on the map
 	this->window->add_resize_callback([this](size_t w, size_t h, double /*scale*/) {
 		this->camera->resize(w, h);
 	});

From eb62b8ce432c3209cabdb4b52c8e2d24bd184c5b Mon Sep 17 00:00:00 2001
From: heinezen <heinezen@hotmail.de>
Date: Sun, 8 Sep 2024 22:32:05 +0200
Subject: [PATCH 68/68] gamestate: Create grids for all existing path types.

---
 libopenage/gamestate/game.cpp    |  2 +-
 libopenage/gamestate/map.cpp     | 35 ++++++++++++++------------------
 libopenage/gamestate/map.h       |  5 ++++-
 libopenage/gamestate/terrain.cpp |  9 ++------
 libopenage/gamestate/terrain.h   | 13 +++---------
 libopenage/pathfinding/grid.h    |  4 ++--
 6 files changed, 27 insertions(+), 41 deletions(-)

diff --git a/libopenage/gamestate/game.cpp b/libopenage/gamestate/game.cpp
index db50f8cc72..e63499d769 100644
--- a/libopenage/gamestate/game.cpp
+++ b/libopenage/gamestate/game.cpp
@@ -143,7 +143,7 @@ void Game::generate_terrain(const std::shared_ptr<TerrainFactory> &terrain_facto
 
 	auto terrain = terrain_factory->add_terrain({20, 20}, {chunk0, chunk1, chunk2, chunk3});
 
-	auto map = std::make_shared<Map>(terrain);
+	auto map = std::make_shared<Map>(this->state, terrain);
 	this->state->set_map(map);
 }
 
diff --git a/libopenage/gamestate/map.cpp b/libopenage/gamestate/map.cpp
index 3d9af584cb..1de5b0fe27 100644
--- a/libopenage/gamestate/map.cpp
+++ b/libopenage/gamestate/map.cpp
@@ -5,6 +5,7 @@
 #include <nyan/nyan.h>
 
 #include "gamestate/api/terrain.h"
+#include "gamestate/game_state.h"
 #include "gamestate/terrain.h"
 #include "gamestate/terrain_chunk.h"
 #include "pathfinding/cost_field.h"
@@ -14,31 +15,25 @@
 
 
 namespace openage::gamestate {
-Map::Map(const std::shared_ptr<Terrain> &terrain) :
+Map::Map(const std::shared_ptr<GameState> &state,
+         const std::shared_ptr<Terrain> &terrain) :
 	terrain{terrain},
 	pathfinder{std::make_shared<path::Pathfinder>()},
 	grid_lookup{} {
-	// Get grid types
-	// TODO: This should probably not be dependent on the existing tiles, but
-	//       on all defined nyan PathType objects
+	// Create a grid for each path type
+	// TODO: This is non-deterministic because of the unordered set. Is this a problem?
+	auto nyan_db = state->get_db_view();
+	std::unordered_set<nyan::fqon_t> path_types = nyan_db->get_obj_children_all("engine.util.path_type.PathType");
 	size_t grid_idx = 0;
 	auto chunk_size = this->terrain->get_chunk(0)->get_size();
-	auto side_length = std::max(chunk_size[0], chunk_size[0]);
-	util::Vector2s grid_size{this->terrain->get_row_size(), this->terrain->get_column_size()};
-	for (const auto &chunk : this->terrain->get_chunks()) {
-		for (const auto &tile : chunk->get_tiles()) {
-			auto path_costs = api::APITerrain::get_path_costs(tile.terrain);
-
-			for (const auto &path_cost : path_costs) {
-				if (not this->grid_lookup.contains(path_cost.first)) {
-					auto grid = std::make_shared<path::Grid>(grid_idx, grid_size, side_length);
-					this->pathfinder->add_grid(grid);
-
-					this->grid_lookup.emplace(path_cost.first, grid_idx);
-					grid_idx += 1;
-				}
-			}
-		}
+	auto side_length = std::max(chunk_size[0], chunk_size[1]);
+	auto grid_size = this->terrain->get_chunks_size();
+	for (const auto &path_type : path_types) {
+		auto grid = std::make_shared<path::Grid>(grid_idx, grid_size, side_length);
+		this->pathfinder->add_grid(grid);
+
+		this->grid_lookup.emplace(path_type, grid_idx);
+		grid_idx += 1;
 	}
 
 	// Set path costs
diff --git a/libopenage/gamestate/map.h b/libopenage/gamestate/map.h
index 4033373023..2817f74457 100644
--- a/libopenage/gamestate/map.h
+++ b/libopenage/gamestate/map.h
@@ -17,6 +17,7 @@ class Pathfinder;
 } // namespace path
 
 namespace gamestate {
+class GameState;
 class Terrain;
 
 class Map {
@@ -26,9 +27,11 @@ class Map {
 	 *
 	 * Initializes the pathfinder with the terrain path costs.
 	 *
+	 * @param state Game state.
 	 * @param terrain Terrain object.
 	 */
-	Map(const std::shared_ptr<Terrain> &terrain);
+	Map(const std::shared_ptr<GameState> &state,
+	    const std::shared_ptr<Terrain> &terrain);
 
 	~Map() = default;
 
diff --git a/libopenage/gamestate/terrain.cpp b/libopenage/gamestate/terrain.cpp
index e7d078f2c5..97c5ef5b51 100644
--- a/libopenage/gamestate/terrain.cpp
+++ b/libopenage/gamestate/terrain.cpp
@@ -78,14 +78,9 @@ const util::Vector2s &Terrain::get_size() const {
 	return this->size;
 }
 
-size_t Terrain::get_row_size() const {
+const util::Vector2s Terrain::get_chunks_size() const {
 	auto chunk_size = this->chunks[0]->get_size();
-	return this->size[0] / chunk_size[0];
-}
-
-size_t Terrain::get_column_size() const {
-	auto chunk_size = this->chunks[0]->get_size();
-	return this->size[1] / chunk_size[1];
+	return {this->size[0] / chunk_size[0], this->size[1] / chunk_size[1]};
 }
 
 void Terrain::add_chunk(const std::shared_ptr<TerrainChunk> &chunk) {
diff --git a/libopenage/gamestate/terrain.h b/libopenage/gamestate/terrain.h
index 1a5db1bf95..d77eaf939c 100644
--- a/libopenage/gamestate/terrain.h
+++ b/libopenage/gamestate/terrain.h
@@ -52,18 +52,11 @@ class Terrain {
 	const util::Vector2s &get_size() const;
 
 	/**
-	 * Get the size of a row in the terrain.
+	 * Get the size of the terrain (in chunks).
 	 *
-	 * @return Row size (width).
+	 * @return Terrain chunk size (width x height).
 	 */
-	size_t get_row_size() const;
-
-	/**
-	 * Get the size of a column in the terrain.
-	 *
-	 * @return Column size (height).
-	 */
-	size_t get_column_size() const;
+	const util::Vector2s get_chunks_size() const;
 
 	/**
 	 * Add a chunk to the terrain.
diff --git a/libopenage/pathfinding/grid.h b/libopenage/pathfinding/grid.h
index 8f34a7643c..8f24743433 100644
--- a/libopenage/pathfinding/grid.h
+++ b/libopenage/pathfinding/grid.h
@@ -23,7 +23,7 @@ class Grid {
 	 * Create a new empty grid of width x height sectors with a specified size.
 	 *
 	 * @param id ID of the grid.
-	 * @param size Size of the grid (width x height).
+	 * @param size Size of the grid in sectors (width x height).
 	 * @param sector_size Side length of each sector.
 	 */
 	Grid(grid_id_t id,
@@ -34,7 +34,7 @@ class Grid {
 	 * Create a grid of width x height sectors from a list of existing sectors.
 	 *
 	 * @param id ID of the grid.
-	 * @param size Size of the grid (width x height).
+	 * @param size Size of the grid in sectors (width x height).
 	 * @param sectors Existing sectors.
 	 */
 	Grid(grid_id_t id,