@@ -412,7 +427,7 @@ fraction will decide a chance to spawn. 1 alien for 2 spawner's will have 50% on
generated by LDoc
diff --git a/doc/modules/utils.core.html b/doc/modules/utils.core.html
index a7c0e111..d4f15004 100644
--- a/doc/modules/utils.core.html
+++ b/doc/modules/utils.core.html
@@ -74,9 +74,6 @@
@@ -322,7 +337,7 @@
generated by LDoc
diff --git a/modules/addons/advanced-start.lua b/modules/addons/advanced-start.lua
index 7c30427a..fea02aea 100644
--- a/modules/addons/advanced-start.lua
+++ b/modules/addons/advanced-start.lua
@@ -1,4 +1,6 @@
--- Adds a better method of player starting items based on production levels.
+-- @addon Advanced-Start
+
local Event = require 'utils.event' --- @dep utils.event
local Game = require 'utils.game' --- @dep utils.game
local config = require 'config.advanced_start' --- @dep config.advanced_start
diff --git a/modules/addons/chat-popups.lua b/modules/addons/chat-popups.lua
index aea7631a..814478a5 100644
--- a/modules/addons/chat-popups.lua
+++ b/modules/addons/chat-popups.lua
@@ -1,5 +1,7 @@
---- Creates flying text entities when a player sends a message in chat
+--- Creates flying text entities when a player sends a message in chat;
-- also displays a ping above users who are named in the message
+-- @addon Chat-Popups
+
local Game = require 'utils.game' --- @dep utils.game
local Event = require 'utils.event' --- @dep utils.event
local config = require 'config.popup_messages' --- @dep config.popup_messages
diff --git a/modules/addons/chat-reply.lua b/modules/addons/chat-reply.lua
index 25f7cf57..4a17d70c 100644
--- a/modules/addons/chat-reply.lua
+++ b/modules/addons/chat-reply.lua
@@ -1,3 +1,6 @@
+--- Adds auto replies to chat messages; aswell as chat commands
+-- @addon Chat-Reply
+
local Event = require 'utils.event' --- @dep utils.event
local Game = require 'utils.game' --- @dep utils.game
local Roles = require 'expcore.roles' --- @dep expcore.roles
diff --git a/modules/addons/compilatron.lua b/modules/addons/compilatron.lua
index fafc4037..0fe347b9 100644
--- a/modules/addons/compilatron.lua
+++ b/modules/addons/compilatron.lua
@@ -1,3 +1,6 @@
+--- Adds a compilatron that walks around the spawn area; adapted from redmew code
+-- @addon Compilatron
+
local Event = require 'utils.event' --- @dep utils.event
local Global = require 'utils.global' --- @dep utils.global
local Game = require 'utils.game' --- @dep utils.game
@@ -62,7 +65,7 @@ end
Event.on_nth_tick(config.message_cycle, circle_messages)
--- This will add a compilatron to the global and start his message cycle
--- @tparam entity LuaEntity the compilatron entity that moves around
+-- @tparam LuaEntity entity the compilatron entity that moves around
-- @tparam string name the name of the location that the complitron is at
function Public.add_compilatron(entity, name)
if not entity and not entity.valid then
diff --git a/modules/addons/damage-popups.lua b/modules/addons/damage-popups.lua
index b0d5f7b7..17016977 100644
--- a/modules/addons/damage-popups.lua
+++ b/modules/addons/damage-popups.lua
@@ -1,5 +1,7 @@
---- Displays the amount of dmg that is done by players to entities
+--- Displays the amount of dmg that is done by players to entities;
-- also shows player health when a player is attacked
+-- @addon Damage-Popups
+
local Game = require 'utils.game' --- @dep utils.game
local Event = require 'utils.event' --- @dep utils.event
local config = require 'config.popup_messages' --- @dep config.popup_messages
diff --git a/modules/addons/death-logger.lua b/modules/addons/death-logger.lua
index e4f7c373..fb188f82 100644
--- a/modules/addons/death-logger.lua
+++ b/modules/addons/death-logger.lua
@@ -1,3 +1,6 @@
+--- Makes markers on the map where places have died and reclaims items if not recovered
+-- @addon Death-Logger
+
local Event = require 'utils.event' --- @dep utils.event
local Game = require 'utils.game' --- @dep utils.game
local Global = require 'utils.global' --- @dep utils.global
diff --git a/modules/addons/discord-alerts.lua b/modules/addons/discord-alerts.lua
index c9b7fedd..5aabc77e 100644
--- a/modules/addons/discord-alerts.lua
+++ b/modules/addons/discord-alerts.lua
@@ -1,3 +1,6 @@
+--- Sends alert messages to our discord server when certain events are triggered
+-- @addon Discord-Alerts
+
local Event = require 'utils.event' --- @dep utils.event
local Game = require 'utils.game' --- @dep utils.game
local Colors = require 'resources.color_presets' --- @dep resources.color_presets
diff --git a/modules/addons/pollution-grading.lua b/modules/addons/pollution-grading.lua
index e7590466..dd4b0914 100644
--- a/modules/addons/pollution-grading.lua
+++ b/modules/addons/pollution-grading.lua
@@ -1,3 +1,6 @@
+--- Makes polution look much nice of the map, ie not one big red mess
+-- @addon Pollution-Grading
+
local Event = require 'utils.event' --- @dep utils.event
local config = require 'config.pollution_grading' --- @dep config.pollution_grading
diff --git a/modules/addons/random-player-colours.lua b/modules/addons/random-player-colours.lua
index 74b3e984..0677faa1 100644
--- a/modules/addons/random-player-colours.lua
+++ b/modules/addons/random-player-colours.lua
@@ -1,3 +1,6 @@
+--- Gives players random colours when they join, also applies preset colours to those who have them
+-- @addon Player-Colours
+
local Colours = require 'resources.color_presets' --- @dep resources.color_presets
local Game = require 'utils.game' --- @dep utils.game
local Event = require 'utils.event' --- @dep utils.event
diff --git a/modules/addons/scorched-earth.lua b/modules/addons/scorched-earth.lua
index 13c1a444..82c361de 100644
--- a/modules/addons/scorched-earth.lua
+++ b/modules/addons/scorched-earth.lua
@@ -1,3 +1,6 @@
+--- When a player walks around the tiles under them will degrade over time, the same is true when entites are built
+-- @addon Scorched-Earth
+
local Event = require 'utils.event' --- @dep utils.event
local Game = require 'utils.game' --- @dep utils.game
local Global = require 'utils.global' --- @dep utils.global
diff --git a/modules/addons/spawn-area.lua b/modules/addons/spawn-area.lua
index fbad421a..dcdbb5f0 100644
--- a/modules/addons/spawn-area.lua
+++ b/modules/addons/spawn-area.lua
@@ -1,3 +1,6 @@
+--- Adds a custom spawn area with chests and afk turrets
+-- @addon Spawn-Area
+
local Global = require 'utils.global' --- @dep utils.global
local Event = require 'utils.event' --- @dep utils.event
local Game = require 'utils.game' --- @dep utils.game