Mod:Nebula's Mission Board/Basic setup - Revision history

MistressNebula: /* Importing the files */ Added instruction talking about mission items

2026-02-19T08:22:51Z

Importing the files: Added instruction talking about mission items

← Older revision		Revision as of 08:22, 19 February 2026
Line 8:		Line 8:

	Note that the library files expect to be placed exactly inside <code>Data/Script/missiongen_lib</code>. If you place them anywhere else, you will need to adjust all of the files' <code>include</code> calls accordingly, as well as all of the <code>include</code> calls present in this guide.		Note that the library files expect to be placed exactly inside <code>Data/Script/missiongen_lib</code>. If you place them anywhere else, you will need to adjust all of the files' <code>include</code> calls accordingly, as well as all of the <code>include</code> calls present in this guide.
	Don't forget to also copy all of the strings inside the <code>strings.resx</code> and <code>stringsEx.resx</code> files over to your mod!		Don't forget to also copy all of the strings inside the <code>strings.resx</code> and <code>stringsEx.resx</code> files over to your mod, as well as the mission items inside the <code>Data/Item</code> folder!

	===== Initializing the library =====		===== Initializing the library =====

MistressNebula: Add namespace change instruction

2026-02-18T19:07:55Z

Add namespace change instruction

← Older revision		Revision as of 19:07, 18 February 2026
Line 20:		Line 20:

	===== Hooking up functions =====		===== Hooking up functions =====
	This is the lengthiest part of the guide. There are a lot of functions that need to be set up in order for the library to work correctly, as highlighted by the many files inside Nebula's Mission Board mod. Luckily, they're pretty easy to port: All you need to do is copy-paste all functions in their respective files in your mod. For example, all functions inside Nebula's Mission Board's <code>common.lua</code> will need to go inside ''your mod's'' <code>common.lua</code>.		This is the lengthiest part of the guide. There are a lot of functions that need to be set up in order for the library to work correctly, as highlighted by the many files inside Nebula's Mission Board mod. Luckily, they're pretty easy to port: All you need to do is copy-paste all functions in their respective files in your mod. For example, all functions inside Nebula's Mission Board's <code>common.lua</code> will need to go inside ''your mod's'' <code>common.lua</code>. Remember to also change any reference to the <code>nebula_mission_board</code> namespace into a reference to your mod's namespace.
	These are the files containing code that needs to be copied over:		These are the files containing code that needs to be copied over:
	* <code>common.lua</code>		* <code>common.lua</code>

MistressNebula: Redirect

2025-07-29T17:41:25Z

Redirect

← Older revision		Revision as of 17:41, 29 July 2025
Line 32:		Line 32:
	Now save your changes, and that's it! This function will be responsible for dynamically adding the necessary steps and events whenever a destination floor is reached.		Now save your changes, and that's it! This function will be responsible for dynamically adding the necessary steps and events whenever a destination floor is reached.

	Everything we did up until now takes care of everything when it comes to generating and handling jobs inside dungeons, but there is still nothing that allows players to take new jobs, or to hand in completed ones. Not to worry: all you need to do is to add a call to <code>MissionGen:BoardInteract(board_id)</code>, and your players will be able to access your job board of choice and take its contents. <code>board_id</code>s will be discussed in the page about [[~~User~~:~~MistressNebula~~/~~MissionGen:~~ Editing settings\|Settings]].		Everything we did up until now takes care of everything when it comes to generating and handling jobs inside dungeons, but there is still nothing that allows players to take new jobs, or to hand in completed ones. Not to worry: all you need to do is to add a call to <code>MissionGen:BoardInteract(board_id)</code>, and your players will be able to access your job board of choice and take its contents. <code>board_id</code>s will be discussed in the page about [[Mod:Nebula's Mission Board/ Editing settings\|Settings]].
	As for how handing in missions works, you will need to write a cutscene for it. Nebula's Mission Board mod already has one inside <code>Data/Script/nebula_mission_board/ground/base_camp_2</code> if you want to copy it, but here's a basic rundown of how the job completion cutscene is handled:		As for how handing in missions works, you will need to write a cutscene for it. Nebula's Mission Board mod already has one inside <code>Data/Script/nebula_mission_board/ground/base_camp_2</code> if you want to copy it, but here's a basic rundown of how the job completion cutscene is handled:

MistressNebula: MistressNebula moved page Mod:Nebula's Mission Board Mod/Basic setup to Mod:Nebula's Mission Board/Basic setup: Misspelled title

2025-07-29T17:33:13Z

MistressNebula moved page Mod:Nebula's Mission Board Mod/Basic setup to Mod:Nebula's Mission Board/Basic setup: Misspelled title

← Older revision	Revision as of 17:33, 29 July 2025
(No difference)

MistressNebula: MistressNebula moved page User:MistressNebula/MissionGen: Basic setup to Mod:Nebula's Mission Board Mod/Basic setup: Move to Mod namespace

2025-07-29T16:35:57Z

MistressNebula moved page User:MistressNebula/MissionGen: Basic setup to Mod:Nebula's Mission Board Mod/Basic setup: Move to Mod namespace

← Older revision	Revision as of 16:35, 29 July 2025
(No difference)

MistressNebula: Download link

2025-07-28T13:24:37Z

Download link

← Older revision		Revision as of 13:24, 28 July 2025
Line 3:		Line 3:
	===== Importing the files =====		===== Importing the files =====

	# Download [[Nebula's Mission Board]] from github and extract the zip's content wherever you like.		# Download [https://github.com/435THz/NebulaMissionBoard/releases Nebula's Mission Board] from github and extract the zip's content wherever you like.
	# Go to the mod's <code>Data/Script</code> folder and copy the <code>missiongen_lib</code> folder.		# Go to the mod's <code>Data/Script</code> folder and copy the <code>missiongen_lib</code> folder.
	# Paste the <code>missiongen_lib</code> folder inside your own mod's <code>Data/Script</code> folder.		# Paste the <code>missiongen_lib</code> folder inside your own mod's <code>Data/Script</code> folder.

MistressNebula: Mention strings

2025-07-19T10:13:30Z

Mention strings

← Older revision		Revision as of 10:13, 19 July 2025
Line 8:		Line 8:

	Note that the library files expect to be placed exactly inside <code>Data/Script/missiongen_lib</code>. If you place them anywhere else, you will need to adjust all of the files' <code>include</code> calls accordingly, as well as all of the <code>include</code> calls present in this guide.		Note that the library files expect to be placed exactly inside <code>Data/Script/missiongen_lib</code>. If you place them anywhere else, you will need to adjust all of the files' <code>include</code> calls accordingly, as well as all of the <code>include</code> calls present in this guide.
			Don't forget to also copy all of the strings inside the <code>strings.resx</code> and <code>stringsEx.resx</code> files over to your mod!

	===== Initializing the library =====		===== Initializing the library =====

MistressNebula: Create page

2025-07-18T18:14:16Z

Create page

New page

Despite it being created to be as easy to add inside mods as possible, it still takes a bit of work to get the Mission Generation Library up and running. This page will run through all the necessary steps, from file placement to function hooks and <code>require</code> calls.

===== Importing the files =====

# Download [[Nebula's Mission Board]] from github and extract the zip's content wherever you like.
# Go to the mod's <code>Data/Script</code> folder and copy the <code>missiongen_lib</code> folder.
# Paste the <code>missiongen_lib</code> folder inside your own mod's <code>Data/Script</code> folder.

Note that the library files expect to be placed exactly inside <code>Data/Script/missiongen_lib</code>. If you place them anywhere else, you will need to adjust all of the files' <code>include</code> calls accordingly, as well as all of the <code>include</code> calls present in this guide.

===== Initializing the library =====

With the files imported in your mod, it's time to load it:
* Add <code>MissionGen = require("missiongen_lib.missiongen_lib")</code> inside your mod's <code>common.lua</code> file. You can rename this variable however you want, but it must be a global variable.
* If your global variable is not named "MissionGen", open missiongen_service.lua and change the <code>library_name</code> string into your global variable's name. Doing this will ensure that the service will be able to find the library when it needs to interact with it.
* Add <code>require 'missiongen_lib.missiongen_service'</code> inside your mod's <code>main.lua</code> file.

These steps will take care of most of the initialization process all by themselves. All of the library files will be loaded, and the <code>SV</code> structure will be automatically have the library's save data added to it. This, however, does nothing in terms of gameplay, and more steps are needed for the library to actually function.

===== Hooking up functions =====
This is the lengthiest part of the guide. There are a lot of functions that need to be set up in order for the library to work correctly, as highlighted by the many files inside Nebula's Mission Board mod. Luckily, they're pretty easy to port: All you need to do is copy-paste all functions in their respective files in your mod. For example, all functions inside Nebula's Mission Board's <code>common.lua</code> will need to go inside ''your mod's'' <code>common.lua</code>.
These are the files containing code that needs to be copied over:
* <code>common.lua</code>
* <code>common_vars.lua</code>
* <code>event.lua</code> (the <code>require</code> statements)
* <code>event.battle.lua</code>
* <code>event_mapgen.lua</code>
* <code>event.single.lua</code>

You now need to hook up the dungeon generation code to the game. Open your mod in [[Dev Mode]], go to the Constants tab and open the Universal menu. Here, in Zone Steps, add a new Script Zone Step. Set its Script parameter to <code>GenerateJobInFloor</code>.
Now save your changes, and that's it! This function will be responsible for dynamically adding the necessary steps and events whenever a destination floor is reached.

Everything we did up until now takes care of everything when it comes to generating and handling jobs inside dungeons, but there is still nothing that allows players to take new jobs, or to hand in completed ones. Not to worry: all you need to do is to add a call to <code>MissionGen:BoardInteract(board_id)</code>, and your players will be able to access your job board of choice and take its contents. <code>board_id</code>s will be discussed in the page about [[User:MistressNebula/MissionGen: Editing settings|Settings]].
As for how handing in missions works, you will need to write a cutscene for it. Nebula's Mission Board mod already has one inside <code>Data/Script/nebula_mission_board/ground/base_camp_2</code> if you want to copy it, but here's a basic rundown of how the job completion cutscene is handled:

<ol>
<li>If any mission has been completed in the last dungeon run, the library will send the player to the location set inside the <code>end_dungeon_day_destination</code> setting. This location will need to call the <code>MissionGen:PlayJobsCompletedCutscene(callback)</code> function. If you have multiple maps with job boards, this function will also handle switching between maps as needed. You will have to provide the callback. (see step 3 for more details)</li>
<li><code>PlayJobsCompletedCutscene</code> will generate a list of characters, that will be passed to the callback along with the job struct itself.</li>
<li>the callback is ran. This is a modder-defined function with the following arguments:
<ul>
<li>a job table</li>
<li>a list of <code>GroundChar</code>s. The first one is always the client, while the second, if present, is always the target. Third and fourth are only generated for law enforcement jobs, and represent the background officers that would normally keep the outlaw restrained during the cutscene.</li>
</ul>
The callback is supposed to handle the cutscene itself, moving the characters where they need to be and displaying dialogue. It also needs to call <code>MissionGen:RewardPlayer(job, speaker, line1, line2)</code>, otherwise the player will not actually receive any rewards for the job they completed.
</li>
<li>Once the cutscene is finished, control goes back to <code>PlayJobsCompletedCutscene</code>, which will get rid of the current job and keep scanning for other completed ones until the end of the list, repeating steps 2 and 3 for each of them.</li>
<li>Finally, the function stored in the <>after_rewards_function<> settings is called, the boards are refreshed, and control is returned to the player.</li>
</ol>

That said, what you need to do is:
* call <code>MissionGen:PlayJobsCompletedCutscene(callback)</code> in any and all maps that have a board assigned to it.
* write the callback for the function above; it needs to use the current job's data and the given list of characters to actually implement the cutscene itself, and call <code>MissionGen:RewardPlayer(job, speaker, line1, line2)</code> so that players will receive their reward.
When that is done, the library will finally be fully set up and ready to use, though you will still need to edit its Settings to make sure that it generates jobs for your mod's dungeons.