I strongly recommend playing through the IntroExtension that comes pre-installed with Extensions! It'll get you started, and explain everything here in a more interactive way. This guide is designed to be used as a reference while you build an extension. The IntroExtention mod itself is the introduction and tutorial.

You might also want to join the Hacknet Extensions Discord to talk with other modders, find testers, and get help with problems. You can find it here:
https://discord.gg/7cHhVT9

For easy access, the main reference files you'll find explained below are:

Computer
https://pastebin.com/NwtgTdPW

Mission
https://pastebin.com/WtFLbQvH

Faction/Actions
https://pastebin.com/n3i1faEe

First things first, navigate to the Extensions folder of your Hacknet install.
An easy way to find it is to right click on Hacknet in steam, go Properties, Local Files tab, and click the button "Browse Local Files..."

Once inside the Extensions folder, copy and paste the entire BlankExtension folder to duplicate it. Rename this new folder to be whatever you like.

Open that folder, and rename
to be just

This will let your extension show up inside Hacknet. Open this file and start changing things - the name is a good place to start. View the chapter on ExtensionInfo.xml in this guide to see what everything does.

Once you've done this, open Hacknet, go to extensions and navigate to your new extension's page.
Click "Run verification tests" to automatically test everything. You should get used to pressing this button every time you make changes to your extension, as it'll automatically point out errors and problems that can cause it to break.

Now you have the foundation of your own extension to start adding missions and computers to! This guide will teach you how to add everything you can.

All extensions require their own folder, which contains a file named ExtensionInfo.xml.
This file details the Extension's metadata. A complete example can be found here:

https://pastebin.com/6fc1fpJn

You'll want to duplicate that and change out the fields to fit your own needs for your own extension.

Computers in Hacknet are each defined in a single XML file. Adding and removing tags to this, and changing value changes what features the computer has, what it's security is, and every other aspect of it.

A full example computer with all features described fully can be found here:

https://pastebin.com/NwtgTdPW

The starting tag that defines the fundamentals looks like this:




For the type flag: 1= corporate, 2 = Home, 3 = server 4 = empty
You can also use the word "empty" to make sure it launches without generating junk files and IRC.

Icon: not including this uses the default set by security level:
laptop
chip
kellis
tablet
ePhone
ePhone2

LABYRINTHS ONLY:
Psylance
PacificAir
Alchemist
DLCLaptop
DLCPC1
DLCPC2
DLCServer

Security is a number from 0 to 5 that represents how hard it is to hack
From 1-4 it will need that many ports to open, 4 and above will automatically
add other security to scale it up easily, you can overwrite specifics below (recommended)

AllowsDefaultBootModule is default to true and means that when you connect to a node
it will automatically launch it's program (the last daemon defined in this file) and
put it up on the display module.

These tags can be added to a computer file to describe the security features of a computer.

Sets the admin password for this computer.

Adds an account to this computer.
Type represents it's privileges :
ADMIN = 0;
ALL = 1; (Can Delete files)
MAIL = 2; (for mail accounts)
MISSIONLIST = 3; (for mission listing server accounts)

You can use the number or the name of the type.

Make accounts for the mail server like this

Valid Ports:
21, 22, 25, 80, 1433, 104, 6881, 443, 192

Proxy server. Set value to -1 to make it disappear.
Time is a multiplier on the base time (30 seconds). Time of 1 is "normal" and time of 2 is "long" - use the multiplier here to change the feel of it.

Number of ports to be open to allow porthack to run.
If this is set to be over 100, the computer will display the "INVIOLABILITY ERROR" message.

Adds a firewall - set level to -1 to remove it. Solution is the solution the player will need to find to break it, the level should ideally be equal to the solution length, but can be longer (Not shorter though!) - additional time is the nonstandard extra evaluation time per step that the Hacknet solver will need.

Adds a trace timer of this many seconds. Set to -1 to remove

Auto-administrator adder - this resets the ports and stuff when the player disconnects. Available types are "basic", "progress" and "fast" - basic only resets after 15 seconds or so.
Progress admins reset ports, firewall and proxy progress, but only if the player isn't the admin. Super admins reset passwords instantly on fast mode.

For servers that insta-reset whenever you disconnect use:

For general computers, it's best practice to use a progress admin unless you want port changes to persist between disconnects.

For computers that have the "security" number in the header set to more than 4, remove the auto-added admin with this:

Remaps the port from the defined default value to whatever you want. The left hand side is the default/original value or it's nickname.
Supported names: ssh, ftp, web, torrent, medical, smtp, sql
It also supports any actual port number.

The tracker is the 'passive trace' - if this tag is here, after a player disconnects from this machine if they have left logs downloading or deleting a file, they will be attacked by an auto-generated AI hacker that will try and reset them, or make them do the ETAS if the player has the flag:
"CSEC_Member"

This links this computer to another (one way) - if you scan from it, it reveals the links. You can add lots of these tags to add multiple links.

This positions this computer near the target on the network map.
Position is it's position radially around it, and total is the number of radially surrounding nodes it has - this way you can create cool looking networks.

ExtraDistance should be between -0.6 and 0.3 - anything bigger will seem really far away, and can cause problems. 0.1 is a good distance.

The "force" tag ensures that this node is positioned exactly where it's defined here, regardless of overlaps with other nodes etc. It basically prevents the checks that ensure stability, but guarantees that it'll be placed close.

Normal files can be made like this:






There are a few 'wildcards' that get auto-replaced at load-time with specific content.
This is usually things like the exact data for an .exe file, or the contents of a standard theme.
Here are the wildcards you can use:


Special programs for extensions only!
RTSPCrack breaks port 554
ESequencer is a customizable sequencer program, controlled by fields in ExtensionInfo.xml
OpShell has options -s and -o which save your current shell setup and re-opens them later very quickly!

Themes

Wildcards are always #ALLCAPS_WITH_HASHES_AROUND_THEM#

Custom themes will be discussed in more detail later, but for completion's sake, here is how you define them on a computer:


Encrypted files can be traced with DECHead.exe, and decoded with Decypher.exe. Here's how you define them:

Daemons are the "programs" running on nodes that do things.

The image to the left here shows all of the below daemons listed on a single computer in the IntroExtension. Below, you can see all the available daemons with their options. It's generally best practice to only use a single daemon per node, but it does support as many as you like.

Death row database loads a pre-set collection of records.

This draws from the People.All source. More details on the People system later!

An ISP system, like the one used in the ETAS (Emergency Trace Aversion Sequence).





This draws from the People.All source.

This is a special sort of server that allows you to upload files to it without admin permissions.

Web servers are added like this - you can add your own web pages to the web presets folder and have them show up in-game too! it renders proper html and everything (though it doesn't accept input yet). Mode details on websites later in the guide.

/el style message board. Check out the intro extension files at the path you see here to see the format of those threads! You can do fancy stuff with this too, like add threads dynamically in response to player actions using the Action system.


Patient is the person ID - their firstname initial underscore, then their last name.
If they are killed, it will add the flag
PatientID:DEAD
Where PatientID is, in the case here, "J_Stalvern"

SPECIAL NOTE: probably don't use this in your mods to actually kill anyone. That moment was special for Hacknet alone. For that reason, I wont show how to generate valid pacemaker files in here. This can be used for narrative reasons though.

This draws from the People.All source.


Lists news articles and missions like on Entropy or SlashBot.

Creates a CSEC-Style mission board

Credits server. This will load the credits stored in the format defined in the credits file above! Read that!

An optimized Action host daemon - this daemon does nothing except host delayable actions - but it is much more efficient at doing that than other servers.
If you have lots of actions looping or in delay at once (more than 50, say) it might be worth moving them to be delay hosted on one of these if you encounter performance issues.
If you're going to use this, make sure this tag is the first one under the <Computer> tag!

Adding this section will create a second computer on load, attached to this which is an eos device, all set up, with these files on it. It'll also automatically generate some apps and save files and things for flavor.

You can have more than one eOS device per computer!

Note: The above code must be added Inside of the <Computer> tags! It's described as a part of a computer, and gets split out into it's own thing when this file is loaded in.

For example, a very simple computer with an eOS device might look like this:

The following Computer features require Labyrinths to work.
http://steamproxy.net/steamstore/app/521840/Hacknet__Labyrinths/

This is the memory that will be turned into a memory dump using MemDumpGenerator.exe

Memory dump file - this can be downloaded and analyzed with MemForensics.exe

Creates a bibliotheque (DLC IRC server) style message board. Can be used to inject missions and messages into via the faction system.

Changes the default connect display to look like the one the "ricer" had in Labyrinths

Displays a big logo on the front of the server with optional messages underneath. If you do not provide a logo image path, it'll display a fancy loading spinner instead.

Custom connect display with a nameplate logo and title image like PacificAir had in Labyrinths.
Button alignment can be "left" "middle" or "right"

Creates an IRC daemon (without missions etc - just the chat). This can be dynamically added to later with Actions!



Whitelist servers are kind of tricky. This same tag can mean that this server checks against a remote whitelist to see who to let on, or that it itself is that whitelist server. This can be a bit confusing, so i'm just going to outline a few of the cases here:

This is your basic whitelist server "host" type - it wont check incoming connection to itself against it's list. It only serves a protective function against *other* servers.

This one connects to a remote host and checks against that host's whitelist.

This one protects itself against all connections not on the list. Generally "unbreakable" without scripts.


Database daemons display a list of records of any datatype in Hacknet. Providing no datatype will give the "API Access" screen like Pacific air had.


Current Datatypes:
*all basic C# datatypes from .NET*
Everything in the Hacknet codebase

Easy templated ones below:

Git Commit entry, as seen sbove

"TextRecord"
<TextRecord>
<Title>Record Title</Title>
<Data>Body Data</Data>
</TextRecord>

"OnlineAccount"
<OnlineAccount>
<ID>1234</ID>
<Username>asdf</Username>
<BanStatus>very yes</BanStatus>
<Notes>notes here</Notes>
</OnlineAccount>


"CAROData"
UserID
Headshots
Kills
Rank
Crowbars
InventoryID
BanStatus

"Account"
string ID;
string Cash;
string Bank;
string Apartments;
string Vehicles;
string PegasusVehicles;
string Rank;
string RP;
string Kills;

Labyrinths Programs

Hacknet missions, unlike computers, need to be defined with items in the correct order. Their parser is a bit more delicate, so be very careful when making new ones! Not changing this was part of my "No re-writes" policy for Hacknet, so some of the elements are very strict about their ordering and case sensitivity. Be careful, and test!

A complete mission file with everything discussed here in correct order can be found here:
https://pastebin.com/WtFLbQvH

• id : the mission ID - this isn't used in-code but is sometimes useful in debugging and testing.
  
  
• activeCheck : if this is set to true, when this mission is active, Hacknet will test for this mission being complete every frame, instead of only when the player responds to an email. This is very useful for creating delays, and for situations where the player is contacted from outside an existing chain.
  
  
• shouldIgnoreSenderVerification : This prevents the check to ensure that the player responded to the right sender when checking for mission completion.

A mission can be defined with one or more goals in it. All goals added to a mission have to be complete before the mission will complete.

Task to delete the file on node target, at path/file
This entry asks for deletion of home/asdf.txt on machine with ID "missionTestNode"

Task to delete ALL files on node target, in the folder at path

Task to download the file at the path
This entry asks for the player to download (SCP) home/asdf.txt on machine with ID "missionTestNode"

Task to add the text specified by keyword to the specified file. This is usually achieved by the "replace" command. It's possible to make the keyword a larger block and task the player to replace one file with another.
This entry asks for the player to add the test "extension" top the file home/asdf.txt on machine with ID "missionTestNode"

Task to remove the text specified by keyword to the specified file. This is usually achieved by the "replace" command. The extra attribute "removal" tasks the player with removing a block of text from a file. Combining this with another filechange task can require a "replacement" of text (removing some, adding a different block).
This entry asks for the player to add the test "extension" top the file home/asdf.txt on machine with ID "missionTestNode"

Task to get admin on the target system.
NOTE: This will only be 'passed' if the player responds *while they are the admin of the system*
Servers that have an "admin" field that resets the password automatically will make this mission not complete if it's reset in the time that the player takes to disconnect from the system and respond.

Task to require a string passed in via the "Additional Info" field in the reply email screen.
This task requires the player to reply with the string "password" added.

This task will not complete until [time] seconds after the first attempt to complete it has been made. This is mostly only useful for use with the "activeCheck" flag on the mission set to true.
A mission with a delay goal, that is silenced and that's set to auto-check essentially acts as a delay timer buffer between responses for missions
This can add a human-feeling response time to missions.

This will only accept if the target flag has been set.
Mission end functions can use the function addFlags:[flagname],[flagname2],[etc] to set flags, then you can have a mission only complete if a flag is set.
Some daemons add flags when events happen. For example, a pacemaker server adds the flag "PATIENT_NAME:DEAD" when the patient dies.

Task to upload the file on server bitMission00 at bin/target_filename.txt to server with ID "destComp" to folder bin.
The folder name Dest/Uploads is the folder that files are uploaded to when using an Upload server daemon, so it's the most useful location normally.

For upload tasks, adding the flag decrypt=true requires the player the decypher the file before uploading it. If that file is password protected, you must include the password
in the goal with decryptPass="password"
For uploading encrypted files - put the encrypted name here (ending with .dec usually). It doesn't matter what the filename of the decrypted one becomes
The code will check for the right content.

Task to add the degree matching the degree name and uni and GPA details for the listed owner. This task *requires* an academic server to exist.
An owner is defined by name - to add a person to the simulation, define them in the People folder and refer to them by name here
The academic server must have the following properties:
1: ID must be "academic"
2: It must contain an Academic Database Daemon

Task to remove all degrees from the academic server for a specified owner. Note that for this one, you *MUST* have the ID of your database be "academic" or it wont find it.

Task to have an email sent to a specified address with a defined subject. This one requires an email be sent to mailuser123@jmail.com with the subject "Email Subject!". More specifically, it requires that file to exist in their inbox folder on the server ID "jmail" that contains a mail server.
This is mostly useful for detecting sent medical records from a medical database.
Medical records have the subject line: "MedicalRecord - Lastname_Firstname"

Requires the player to respond with the current admin password for the linked server. This is useful for servers that change passwords - like ones with password resetting admins, and databases that allow for admin password reset.

Mission functions can be run from Actions, or from a mission starting or ending. To trigger a mission function within a mission:

This will activate as soon as the mission is accepted from a hub server, or it's started in an email chain. val lets you pass integer data (whole numbers with no decimal points) to the function. This is optional, and is only useful with a few of these (like changeSong and addRank, which need a number passed into them)..

Same as mission start (this is also optional), but this happens when the mission is completed.
Note that this will never trigger if the mission is abandoned or otherwise lost.

Used like setFaction:entropy, sets the player's current faction to the faction with the given idName

This adds val in rank to the player's current active faction.
Important note: This will fail if the player hasn't been given a faction yet! Be very careful to make sure the player has a faction assigned before calling this!

Same as addRank, but it won't send a faction status update email.

this adds the val to the specified faction. I.E: "addRankFaction:CSEC"

Adds the defined (1 or more) flags to the current session. Flags can unlock missions and do other tasks.

Removes the listed flags if they exist.


Changes to the song defined in val:
case 1: Revolve
case 2: The_Quickening
case 3: TheAlgorithm
case 4: Ryan3
case 5: Bit(Ending)
case 6: Rico_Puestel-Roja_Drifts_By
case 7: out_run_the_wolves
case 8: Irritations
case 9: Broken_Boy
case 10: Ryan10
case 11: tetrameth





Loads in a conditional action set. These will be covered later in the guide.

Sets the server with the given ID to be the new hub server visually on the netmap.
this adds the little spinny things around it, like CSEC has in the base game.

Sets the server with the given ID to be the new asset server visually on the netmap.
this adds the little star inside it


Fades the music into the song file specified. Needs the whole path like: Music/Song.ogg
Songs must be in Ogg Vorbis (.ogg) format
Custom songs will not play on the XNA branch!

Plays the specified song above without the fade in - instantly snaps to it.

Values:
case 1: Remi2
case 2: snidelyWhiplash
case 3: Slow_Motion
case 4: World_Chase
case 5: HOME_Resonance
case 6: Remi_Finale
case 7: RemiDrone
case 8: DreamHead
case 9: Userspacelike
case 10: CrashTrack

To define what happens when this mission is completed, there's the nextMission tag:

This defines the path to the next mission file. The mission file at this path will be loaded, and email sent when the current mission is completed.
The IsSilent flag is... admittedly in a terrible place here. It silenced THIS mission, not the next one. This means that if you set IsSilent to be true here, this mission will not send and email when it is loaded.

Important detail about mission completion: For a reply to work, the mission the player is currently on my have the same email sender field as the email they reply to in their inbox. This means that if you have a silent connector mission, make sure it has the same sender filled in in the email field.

If you want there to be no mission following this one (For example, the email mission that introduces you to a hub server, set nextMission to "NONE".

Branch missions are loaded during the load step of this mission, and are held in parallel.
Every frame (if ActiveCheck) or every time an email is responded to, the mission system will check the goals of the current mission (this file), and if it doesn't pass them, it will check (in order) the goals of all the branch missions defined here. If successful, the branch mission's "nextMission" will be loaded.


This allows you to put in branching story paths, variable responses, and allow different responses for various goals. It's a bit finicky to use, so I recommend testing all branch structures you put in very carefully.
Note that the branch mission's email will not be sent - they are all loaded in silent mode.

The "Posting" of a mission is what gets read and put up on a mission listing board like CSEC or Entropy in base Hacknet.

• title is the Mission title line that's displayed in the list.
  
• reqs is a comma separated list of required flags before this mission can be accepted from a Hub server. Before the reqs and required rank are met, the mission will appear locked (like Junebug).
  
• requiredRank is the faction rank the player needs to have before this mission is unlocked (player rank must be >= this number)

This is the data of the email the player will be sent when this mission is accepted or continued to.

Actions in Hacknet can be triggered in a few ways:

• MissionStart or MissionEnd functions
  
• Faction rank progressing
  
• ConditionalActionSets having a condition met

You'll see how to make use of these soon, but for now it's best to understand what actions can do. Here are the basic actions you can use:

Runs a 'mission function' - for a list of these and how to use them, see the example mission file.

Immediately loads a mission, replacing whatever's currently there and sending the email.

Creates a file with the listed content on the computer with ID targetComp, in the folder path specified.
The folder specified must exist before this runs!
The file contents field here doesn't support newlines or super long content - this is recommended for just creating items with wildcard data (like programs)
For a complete list of wildcards, see the example computer file.

This copies a file from one computer to another.
DestFilePath + DestComp are the DESTINATION computer - where the file will end up
SourceFileName, SourceFilePath and SourceComp are the SOURCE computer - where the file exists and is taken from This will do nothing if the file does not exist to be copied.

This is very useful for adding complex files to a server after the session is created - create a new hidden server that's impossible to find, define all the files you want on there, then copy them over to where you want later.

This adds a new mission to a hub server. This works for both missionHubServer servers (CSEC Style), missionListingServers (Entropy style) and also DHSDaemon servers (Bibliotheque style).

CSEC Style:
Bibliotheque Style: Assignment tag is who the mission starts assigned to of the server's user list. If this tag exists, the player cant claim the mission!
Note that adding a mission to an entropy style server, you can set the AssignmentTag to be "top" to add to the top of the list. Otherwise it'll be added to the bottom.

This removes the mission from the hub server, if it exists. Works for all three specified above.

Adds a thread to a /el message board - thread file should be a UFT-8 plaintext document.

Adds a message to a DHSDaemon or IRCDaemon IRC. Delay is seconds until the post appears.

You can made notes, links and attachments in IRC Messages like this!

Crashes computer with the ID TargetComp. If this is "playerComp" it will crash the player's own computer (bluscreening it) instantly.
If it's another computer, this will remove it from the netmap for 15 seconds or so, and disconnect the player if they were connected to it.
The CrashSource is the ID of a computer that the crash log will point to.

NOTE: Players are very likely to rm * entire log folders, so don't make this part of any critical path - it's almost impossible to find. Secrets only!

DelayHost is the ID of a computer that can host delayable actions. Valid computers need to have one of these daemons on them:
IRCDaemon or DLCHubServer

Deletes a file from the target computer. Does nothing if that file does not exist.

Loads in a new set of conditional actions from a file. Check out the file listed here for an explanation on what you can do with that.

Saves the game! The player should be saved frequently, just incase their power dies or something. If you have extremely long missions without email replies or any other save triggers, use this to keep the player saved and up to date.

These can be used just like the basic actions, but there were too many to fit in the word limit for steam guide's single chapter limit, so here are the more advanced ones:


Loads in the Hacker script defined below to execute 5.5 seconds from now, coming from source advExamplePC and targeting playerComp (The player node ID).
These can target whatever you like, and be ally scripts! RequireLogsOnSource means that this will only execute if the source comp has logs on it from the player deleting, moving, or copying a file. You can use the ID or the IP for the source and target - either works.
RequireSourceIntact means that if the target is missing it's networking file from /sys, the hack wont happen. This means a crippled computer cant hack you back.

Switches to the listed theme. You can specify any of the core Hacknet themes by name directly :
TerminalOnlyBlack, HacknetBlue, HacknetTeal, HacknetYellow, HacknetWhite, HacknetPurple, HacknetMint, HackerGreen
Or you can specify a path to a custom theme file

Starts a 'screen bleed' effect! This is where the red line moves down from the top of the screen dramatically.
The title and the first 3 lines of the content of this tag are what's shown in the bottom left alert window. The CompleteAction conditional action set is run *only if* the red hits the bottom of the screen and the player runs out of time.TotalDurationSeconds is the total time it takes for the screen bleed to go from top to bottom.

I recommend syncing this up with various other conditions that allow you to cancel the effect if the player completes some task.

Cancels a screen bleed effect started with the tag above.

Appends the content of the tag onto the file specified. Useful for adding extra data into things, making the world feel more dynamic, adding people to whitelists etc.

Kills all exes that contain the string mentioned, or * for all.
This is case insensitive. So the following would kill "SSHCrackExe",
but changing it to "s" would kill all exes with an s in their name.

This is useful for doing things like killing ESequencer.exe once it's running,
or having a rival hacker close all of the player's shells.

Hides the target computer node from the netmap if it's visible

Reveals this user account to the player so it's details show up in the autocomplete options when the player goes to log in.

Changes the IP Address of the computer with ID in targetComp to the new IP address provided.
Set NewIP to be blank, or #RANDOM_IP# for a random one!

Un-reveals all visible nodes from the netmap

Reveals a node on the netmap.

Sets a UI module to be locked/unlocked and hidden/visible. Module names are:
terminal, ram, netmap, display

The final Action lets you change the mail Icon.

Changes the alert icon (top right) to point to a new server!
Target is the ID of the server it should connect to.
Type can be one of 4 options:
mail, irc, irchub, board

mail is a mail server, like Jmail. If you use this, the mail server that it points to MUST HAVE A MAIL ACCOUNT FOR THE PLAYER.
If it doesn't, it will crash when the player clicks on the icon and tries to go to their non-existent account.

board is a /el style message board. Whenever a message or thread is added that contains any other the above IRC mention strings, the player will be notified.

irchub is a DLCHubServer like Labyrinths uses. Labyrinths players only.

irc is a standard IRC server. Whenever an IRC log with @#PLAYERNAME# or @Channel in it is added, the player will get a notification.

IMPORTANT NOTE: Changing the type to anything other than mail is only supported with the Hacknet Labyrinths DLC installed.

A conditional action set is a set of conditions that each contain a list of Actions to run if that condition is met.
You can load a conditional action set in via the Action:

And mission function:

A complete conditional action set example file is here:
https://hastebin.com/rodiyumepa.xml


This one is checked when the player connects to the PC with ID in the target field. needsMissionComplete and reqiuredFlags are optional additional checks that you can apply.

Triggers once the player has *all* of the flags in a comma separated list in requiredFlags

Triggered once the player gets admin access to the target machine.

This triggers immediately, as soon as this is finished loading! Actions will happen in the order they appear in this file.


Triggers if the player has none of the flags in the list.

Triggers when the player disconnects from something, or connects to their own computer.
You can remove the target tag (or set it to "NONE") to have this trigger when the player disconnects from anything.

A faction is essentially just a few things:
A name, a number representing the player's position in the faction, and a set of actions that can trigger to make changes to the game state in response to actions.

They are useful for sequencing events, launching Action sets and guiding the player to new things.

A complete example faction file can be found here:
https://pastebin.com/n3i1faEe

For a faction to be loaded it, it must be added to the IntroExtension.xml
With one of these tags:

Your faction file should start with this:
You can change the starting player value with the playerVal field above.

From there it can contain multiple Action sets that are triggered by a faction-specific condition. Available conditions are:

The value required conditional action is the most basic one. This triggers once the player's value moves from below this number to equal to or more than it.


This action trigger as soon as the player is given the "decypher" flag

And this one only triggers once both the player has the flag, and the score is greater than or equal to the required value

First, check out the example theme file that generates the theme in the screenshot above:

https://pastebin.com/ch66vkUb

You'll notice it has a bunch of tags with the name of the color, and 3 or 4 numbers which represent the color itself, like this:

These numbers define a color using the premultiplied-alpha method, so:

R, G, B, A
Where A is opacity and additivity. These are bytes, so they range from 0 to 255 without decimal places. This is a little complex, so I'll break it down with some examples.

Pure black is 0, 0, 0, 255

Pure White is 255, 255, 255, 255

If the number on the far right (alpha) is 0, the color values provided will ADD to the pixel underneath it. This lets you do highlights that brighten things behind them, and look "sort of" transparent.
This is a cool effect, and Hacknet uses it a lot, but remember to be tasteful with it - backgrounds like this make text hard to read, for example.

There are a few quirks to what the colors do, as the theme setup was added super early in development, and some things pull colors from strange places. For example, the Proxy/Firewall bars on the probe screen draw their colors from the shell and top bar colors.

You can change the layout of the windows in your theme with the tag:
Valid layouts:
blue, green, white, mint, greencompact, riptide, colamaeleon and riptide2

you can use the command "reloadtheme" if you have debug commands enabled to instantly reload the theme you currently have active and see any changes you've made.

You can include your own images in the extension and reference them to be used as the background in custom themes. Note that if you want to distribute your mod through steam workshop, you'll need the rights to the images you use! Make sure you get permission.

Backgrounds should be 1920x1080px and wither .png or .jpg format.

If no background is specified, Hacknet will automatically generate one out of hex cells.

You can add your themes to computers ingame using the tag:


Or you can auto-switch the player to it with the Action:

Custom songs can be played with the mission function "playCustomSong:[SONG_PATH]"
You can also use playCustomSongImmediatley:[SONG_PATH] to skip the fade between songs and start it immediately.

Songs must be in Ogg Vorbis (.ogg) format!

Also note that for now, songs will not work on the XNA branch - this is because the .ogg format handling code is done within FNA, so the XNA version doesn't have the code to support those files.
I'll address this when I can, but due to how few people use that branch, it's a lower priority for now. Sorry!
A strategy for this is to specify a base game song to play first, the instantly override it with your desired custom song - this way XNA players will still get a music change.

You can also do this from conditional action sets, using the "runFunction" tag.

Several daemons use the people system to populate their datasets.

The people system defines (and generates) a set of data representing a single individual that has accounts and records across multiple servers. This helps create a sense of consistency and identity within the game, and allows players to track down all of the data points about a person on various servers.
To define a person that will get loaded in and added to relevant servers, add a person descriptor file into the /People/ folder.
You can see an example person file here:

https://hastebin.com/eqayupuxiv.xml

You can add as many people files as you want. Hacknet will automatically generate random people so that the list is filled up to be at least 100 people on new session load, to make the other servers feel full.

Daemons that use data form the people system:
Databases
Academic Daemons
Medical Daemons
PointClicker
JMail junk accounts

Websites. The porting nightmare. The buggy mess. The endless hacks.
These have been nothing but nightmares from day 1, and due to apparently all web rendering services that work cross platform being buggy as anything, many players use the -disableweb launch argument, preventing websites from rendering.
This means you need to make 100% sure that your missions are completable from these people reading the source of the website.

Websites in Hacknet are restricted to being in only one folder for security reasons, so *everything* you reference within your websites needs to be relative to Web/Cache within your extension folder.
Before you look into the files, first visit the website itself, linked below.

Your websites themselves (the HTML files) can be stored wherever you like within your extension folder, but all images and .css files you reference must be within the /Web/Cache folder (or a subfolder therein).

Note that websites have a few rendering issues (like stretching for some resolutions and themes). I'll work these kinks out as much as possible before launch, but they may remain, so try to design around them.


Create your website HTML file wherever you like.
Add all images and CSS files that you want to use in it to the folder Web/Cache or a subfolder inside of it.
Reference those assets using relative paths only within the website.
Add a web server daemon to your node with the URL pointing to your html file.

Jmail can be replaced by setting the id of any computer to be "jmail". If you aren;t changing your mail icon to something else, it will default point to this server. Note that if you want to use your newly crated server as the default mail icon destination, it MUST contain a MailServer daemon, and a mail account for the player, like so:


Note that you can still add in extra accounts etc here as normal.

The player computer can be overwritten by setting the ID of any computer to be "playerComp". Note that this is *always* the ID of the player computer, for referencing it elsewhere by ID.

There aren't any special requirements for this one, so go nuts. Note that the computer will probably not be in the normal spot on the netmap if you do this!

Make a computer with the id "ispComp" and make sure it has an ISP server on it, and this should work!

Following is an example hacker script with all available options listed in it:

To Autostart your mod while in development, start Hacknet with the argument
-extstart [YOUR_MOD_FOLDERNAME]

To start Hacknet on your second monitor, if you have one, use the argument
-altmonitor

You probably also want to develop with force complete on:
-enablefc

Debug commands too:
-enabledebug

Once you have Debug commands enabled:

fh
Instantly breaks into any computer

dscan [ID]
reveals a computer by ID name

ra
reveals everything on the netmap at once

reloadext
reloads all the nodes in the current extension from source files,
and updates them in the current save.

printflags
ouputs all the flags the player has to the terminal

runhackscript Script/Path/Name.txt
Replace the path with the filepath of your own hacker script to test it out - this also prints errors to the terminal.

To make the workshop publishing tools visible within Hacknet, add the launch argument:


From your extension page, you'll now be able to create the workshop item and upload your content to it. Make sure to read the Workshop information at the bottom of ExtensionInfo.xml in the example extension to know what to include!

I suggest you create it as private first, then go to your own workshop page on steam to look over it and polish it up before making it public.

Once uploaded, there's a few things you'll need to check. First, check to see if your extension requires the Labyrinths DLC or not. You can keep track of this yourself during development, but the best way to know for sure is to disable your copy of Labyrinths if you have it (uncheck it's box in the DLC section of your Hacknet library page), then run the tests on your extension and play through it.

If it does require Labyrinths, make sure you add that as a requirement on your workshop page!

Once you've published to the Steam workshop, you should upload your extension to The Nexus so that others with DRM Free copies of Hacknet can play it. Upload them here:

https://www.nexusmods.com/hacknet