<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-GB">
	<id>https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=Build_your_first_mod%2Fen-gb</id>
	<title>Build your first mod/en-gb - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=Build_your_first_mod%2Fen-gb"/>
	<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=Build_your_first_mod/en-gb&amp;action=history"/>
	<updated>2026-11-21T15:21:01Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.46.2</generator>
	<entry>
		<id>https://wiki.shroudforge.net/index.php?title=Build_your_first_mod/en-gb&amp;diff=3949&amp;oldid=prev</id>
		<title>FuzzyBot: Updating to match new version of source page</title>
		<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=Build_your_first_mod/en-gb&amp;diff=3949&amp;oldid=prev"/>
		<updated>2026-11-18T00:15:18Z</updated>

		<summary type="html">&lt;p&gt;Updating to match new version of source page&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;languages /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- ShroudForge Modloader Wiki Post&lt;br /&gt;
title: Build your first mod&lt;br /&gt;
description: Create a small Lua mod package, install it, and confirm that ShroudForge loads it.&lt;br /&gt;
language: en-GB&lt;br /&gt;
picture:Modding-First-Mod.png&lt;br /&gt;
creator: Bonsaibauer&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[File:Modding-First-Mod.png|thumb|right|The ShroudForge Modloader can show a mod&amp;#039;s settings and status.]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
This beginner guide takes about 10–15 minutes. You need a text editor. You do not need prior programming experience.&lt;br /&gt;
&lt;br /&gt;
A mod package has one required information file, a Lua file for the instruction in this example, and an optional settings file:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;mod.json&amp;lt;/code&amp;gt; describes the mod, its version, and the capabilities it requests.&lt;br /&gt;
* &amp;lt;code&amp;gt;src/mod.lua&amp;lt;/code&amp;gt; contains the Lua code.&lt;br /&gt;
* &amp;lt;code&amp;gt;extended.mod.json&amp;lt;/code&amp;gt; is optional. It can define player-facing settings.&lt;br /&gt;
&lt;br /&gt;
== 1. Make a folder for the mod ==&lt;br /&gt;
&lt;br /&gt;
Open your Enshrouded game folder, then open its &amp;lt;code&amp;gt;mods&amp;lt;/code&amp;gt; folder. Make a new folder called &amp;lt;code&amp;gt;yourname.first-mod&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
mods/yourname.first-mod/&lt;br /&gt;
├── mod.json&lt;br /&gt;
└── src/&lt;br /&gt;
    └── mod.lua&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== 2. Add mod.json ==&lt;br /&gt;
&lt;br /&gt;
Create &amp;lt;code&amp;gt;mod.json&amp;lt;/code&amp;gt; in the new folder. Change the ID, name, author, and description to match your mod.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;$schema&amp;quot;: &amp;quot;https://shroudforge.net/schemas/1.8.0/manifest.schema.json&amp;quot;,&lt;br /&gt;
  &amp;quot;id&amp;quot;: &amp;quot;yourname.first-mod&amp;quot;,&lt;br /&gt;
  &amp;quot;name&amp;quot;: &amp;quot;My First Mod&amp;quot;,&lt;br /&gt;
  &amp;quot;version&amp;quot;: &amp;quot;1.0.0&amp;quot;,&lt;br /&gt;
  &amp;quot;authors&amp;quot;: [&amp;quot;Your name&amp;quot;],&lt;br /&gt;
  &amp;quot;description&amp;quot;: &amp;quot;Writes a message.&amp;quot;,&lt;br /&gt;
  &amp;quot;license&amp;quot;: null,&lt;br /&gt;
  &amp;quot;icon&amp;quot;: null,&lt;br /&gt;
  &amp;quot;capabilities&amp;quot;: [],&lt;br /&gt;
  &amp;quot;dependencies&amp;quot;: []&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The &amp;lt;code&amp;gt;id&amp;lt;/code&amp;gt; should uniquely identify the package. The &amp;lt;code&amp;gt;name&amp;lt;/code&amp;gt; is the display name. Leave &amp;lt;code&amp;gt;version&amp;lt;/code&amp;gt; as &amp;lt;code&amp;gt;1.0.0&amp;lt;/code&amp;gt; for this example. The empty &amp;lt;code&amp;gt;capabilities&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;dependencies&amp;lt;/code&amp;gt; lists are enough for this example.&lt;br /&gt;
&lt;br /&gt;
See [[mod.json]] for the fields and the canonical schema.&lt;br /&gt;
&lt;br /&gt;
== 3. Add the Lua instruction ==&lt;br /&gt;
&lt;br /&gt;
Inside the &amp;lt;code&amp;gt;src&amp;lt;/code&amp;gt; folder, create &amp;lt;code&amp;gt;mod.lua&amp;lt;/code&amp;gt; and add this line:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
shroudforge.log.info(&amp;quot;My first mod loaded&amp;quot;)&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This sends a message to the ShroudForge log.&lt;br /&gt;
&lt;br /&gt;
== 4. Find the mod in the game ==&lt;br /&gt;
&lt;br /&gt;
Start Enshrouded. Press &amp;lt;kbd&amp;gt;F9&amp;lt;/kbd&amp;gt; to open the Mods window. Your mod should appear in the list. Press &amp;lt;kbd&amp;gt;F10&amp;lt;/kbd&amp;gt; to open the messages and look for &amp;lt;code&amp;gt;My first mod loaded&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
If ShroudForge cannot find the mod, check that its folder is inside the game&amp;#039;s &amp;lt;code&amp;gt;mods&amp;lt;/code&amp;gt; folder. Downloaded mods can use different folder layouts, so follow their creator&amp;#039;s instructions.&lt;br /&gt;
&lt;br /&gt;
== Next steps ==&lt;br /&gt;
&lt;br /&gt;
Add player-facing switches or sliders with [[extended.mod.json]]. For Lua modding concepts, continue with [[Modding with Lua]]. Use the [https://bonsaibauer.github.io/shroudforge/en/#api searchable Lua API reference] for exact function documentation.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Category:Modding:Shroudforge]]&lt;/div&gt;</summary>
		<author><name>FuzzyBot</name></author>
	</entry>
</feed>