mt-mods / missions

Minetest missions mod

Minetest mission mod (missions)

Archived!

This mod is now in archive mode, for a full replacement with more features use the "epic" mod: https://github.com/damocles-minetest/epic (or ping me if you want to fork and maintain this)

Minetest mod for in-game mission creation (for players and admins) Adds a mission block to create missions and a mission-wand to mark positions and chests

• Github: https://github.com/thomasrudin-mt/missions
• Forum Topic: https://forum.minetest.net/viewtopic.php?f=9&t=20125

Obligatory screenshot

Features:

• In-game mission builder
• Craftable mission-block and wand
• Create epic quests or mazes
• Missions can span multiple days, even weeks
• Running missions persist across login/logout and server-restart

Supported mission-steps:

• Build (place any nodes)
• Build specific nodes (e.g: Stone)
• Dig nodes (any)
• Dig specific nodes (e.g: Meseblock)
• Put items in Chest at position (e.g: 99xStone)
• Waypoint (hidden and visible in hud)
• Teleport player to position (requires the missions_teleport priv)
• Reward player with items from a chest
• Reward player with items (mission-build must have the give priv)
• Message (show a message with a title)
• Grant priviliege (requires the priv privilege)

Extended mission-steps (dependent on other mods):

• Spawn a mob at position (requires the missions_mobs priv)
• Check xp (if xp mod enabled)
• Give xp (if xp mod enabled and privs available)

Install

• Unzip/Clone it to your worldmods folder

Crafting

Mission-Block:

Mission wand:

Note: Used (position and chest) wands can be mixed back to a plain wand again

Manual

Create missions (in-game)

Craft yourself a mission wand (missions:wand) and mark your waypoints and chests with it:

Give them a name so you find them later in the inventory. The wand converts either to a position wand or a chest wand, depending on what you are pointing it to.

• Position wand: Marks waypoints for a mission
• Chest wand: Marks chests for taking or putting inventory (default and morechests supported for now)

Properly named chest-wand:

When you are finished marking the places and chests you want in your mission you can craft a mission-block (missions:mission) and place it where you want the mission to start. The Mission block can only be dug from the owner or an admin with protector_bypass privilege.

Rightclick on the mission to open the editor dialog:

On the left you can add and order the mission steps. On the right you can edit its name, description and the time allowed to finish it.

Now click on add to create your first mission step:

Choose your first step in the mission:

• Could be a waypoint to which the player has to go
• Or a chest which has to be filled with a given amount and type of item
• Or a simple welcome message to brief the player

Example of a step in which the player has to place 99 stones in the chest

This is just an example, the player could take out the items as soon as the step or the mission is finished. In reality you would use a dropbox from the morechests mod or inject the items into some tubes with mesecons and pipeworks.

Example of a waypoint step:

The visibility of the waypoint can be toggled if you want the player to search for it (after you gave him some hints of course)

Example of a Message step:

The player has to click the message away in order to execute the next step

An example of a finished mission with waypoints and messages:

now you can click on Save and Validate to check if the mission is valid:

• Enough items to give the player as reward
• Enough room in chests for the player to put in

An example of an invalid mission:

The mission will be validated every time a player wants to start it.

Of course a reward upon finishing the mission would always be a good idea... For this, create a Reward from Chest step and place the marked wand to the chest in the target field. The chest has to contain the items in order to start the mission.

Play missions

To play a mission do a rightclick on a mission-block or as the owner of it click on User in the edit dialog:

After carefully reading the text (or not at all) you can click Start to accept the mission. Only one mission can be active at the same time.

After the start the configured wapyoints will guide you through the mission (or not if so configured)

For item collection a status-text on the upper right will tell you how much you have to collect:

An example message from the mission-creator to the player:

Create more mission-steps (specs)

See the existing steps in the steps folder for some guidelines.

Depends

• default
• xp_redo?
• more_chests?
• mobs_redo?
• mobs_monster?
• mobs_horse?
• mobs_animal?
• mobs_npc?
• mobs_xenomorph?
• mobs_fish?
• mobs_crocs?
• mobs_jellyfish?
• mobs_sharks?
• mobs_turtles?
• mesecon?

Pull requests / bugs

I'm happy for any bug reports or pull requests (code and textures)

missions's Issues

Cannot set reward options before saving the step

Experienced it on both missions I've created so far. Couldn't put reward and wand in step options without first closing it and reopening.

Update readme with screenshots

Add success/failed count in block meta

Pretty animation and sound on mission completion

testing on desktop and android

Auto bones mission

Suggestion: use this mod for automatically creating a mission on player death with a waypoint on bones.

ERROR

2023-01-24 21:43:00: ERROR[Main]: ModError: Failed to load and run script from F:\TW\minetest-5.6.1-win64\bin\..\mods\missions\init.lua:
2023-01-24 21:43:00: ERROR[Main]: Number of registerable nodes (32768) exceeded (missions:mission)
2023-01-24 21:43:00: ERROR[Main]: stack traceback:
2023-01-24 21:43:00: ERROR[Main]: 	[C]: in function 'register_item_raw'
2023-01-24 21:43:00: ERROR[Main]: 	F:\TW\minetest-5.6.1-win64\bin\..\builtin\game\register.lua:184: in function 'register_item'
2023-01-24 21:43:00: ERROR[Main]: 	F:\TW\minetest-5.6.1-win64\bin\..\builtin\game\register.lua:210: in function 'register_node'
2023-01-24 21:43:00: ERROR[Main]: 	F:\TW\minetest-5.6.1-win64\bin\..\mods\missions/block.lua:2: in main chunk
2023-01-24 21:43:00: ERROR[Main]: 	[C]: in function 'dofile'
2023-01-24 21:43:00: ERROR[Main]: 	F:\TW\minetest-5.6.1-win64\bin\..\mods\missions\init.lua:40: in main chunk

possible formspec injection

i think there is a lot of formspec_escape missing in that mod now that i think of it 😖

Save button should only be seen by the owner

The formspec Save button should only be seen by the owner.

Add afk in area step

• proposal

add not_in_creative_inventory group to wand with metadata

Hidden setting does not seem to do anything

Is this setting for other mods to use or should it hide the node to other players?

Add crafting recipes for certain missions

Only for transport mission now, the others are an admin-feature (crafting, building) for now

crash on high xp value

2021-02-21 19:02:45: ERROR[Main]: ServerError: AsyncErr: environment_Step: Runtime error from mod 'missions' in callback environment_Step(): /data/world//worldmods/missions/steps/checkxp.lua:43: attempt to compare nil with number
2021-02-21 19:02:45: ERROR[Main]: stack traceback:
2021-02-21 19:02:45: ERROR[Main]: 	/data/world//worldmods/missions/steps/checkxp.lua:43: in function 'on_step_enter'
2021-02-21 19:02:45: ERROR[Main]: 	/data/world//worldmods/missions/executor.lua:112: in function 'update_mission'
2021-02-21 19:02:45: ERROR[Main]: 	/data/world//worldmods/missions/executor.lua:192: in function 'func'
2021-02-21 19:02:45: ERROR[Main]: 	...ocal/share/minetest/builtin/profiler/instrumentation.lua:106: in function 'globalstep'
2021-02-21 19:02:45: ERROR[Main]: 	/data/world//worldmods/monitoring/builtin/globalstep.lua:32: in function </data/world//worldmods/monitoring/builtin/globalstep.lua:24>
2021-02-21 19:02:45: ERROR[Main]: 	/usr/local/share/minetest/builtin/game/register.lua:429: in function </usr/local/share/minetest/builtin/game/register.lua:413>
2021-02-21 19:02:45: ERROR[Main]: stack traceback:

Add Teleport step and priv

Preserve mission state across restarts

either with player:set_attribute() or files

Add mail notification if mission turns invalid

via optional mail mod

Mission chest empty when it should contain items

The mission chest is empty when the owner looks in it, even when another player has deposited items to it.

Add lethal mission option

Player gets killed if mission fails

Add Mesecons activate step

Waypoint with randomized positions

Add subsequent mission call step

Allow the user to chain missions together

Mission chest unlocked

Any one can look into and dig the mission chest. Perhaps it's intended to act as a regular chest and not a locked one, but it seems to me that only the owner should be able to see its contents.

Cleanup and document "executor.lua"

This grew into quite a mess...

Add next mission choice step

Allow the player to choose from available next missions
related to #13

Add give step

For admin missions

don't allow digging by non-owner

maybe add mission privilege

Raw proposal

Hi, Banzai!

I thought about the step editor for your Mission Mod. Here's what I came up with...

[STEP EDITOR]:

1. Trigger A Node To Teleport

Instead of just automatically teleport to an area, players should trigger a block THEN teleport them into an area. Examples of these blocks are:
~ Button
~ Switch
~ Pressure Plate
Not sure how the coding will work, tho. Maybe like how you programmed the mission wand to the chest.

2. Time Trigger

Players should wait for a given amount of seconds before proceeding to the next step.

3. "Mission Failed" Trigger

An if;then statement. If players do this action, (e.g. tap the wrong button), then mission is over.

4. Kill Specific Mob

Again, not sure how you'll code this (p.s. I got very minimal knowledge in coding). Player should kill a specific mob set up by the Mission Block in order to trigger next step.
Would be nice if this specific mob will be unique, like kill just this one specific Dirt Monster out of all these other 5 Dirt Monster. (I doubt this will work, since there isn't a unique variable registered per spawn mob, but I'll let you do the magic :D )

5. DONT Kill Specific Mob

The other way around for suggestion #4. This time, players should not kill this mob in a given amount of time OR until the end of the entire mission OR when countered by the Kill Specific Mob suggestion.

6. A Message Board

I haven't really observed this much. I think players tend to forget what they should be doing next in their mission run. For example, in my Mission I wanted the player to investigate around the tower instead of just guiding them to the dtragon thru waypoints. This way, it would immerse themselves more in the story. I hope you can add like a mission window somewhere in screen with the title of the next step plus description (dunno how mobile users would look like).

7. Review A Pop Up Window

There is the existing option in Step Editor that lets the mission box open a window for a message. But as soon as the player closes it, they can't open it anymore. Maybe add a button in the players mission button (in inventory) and add a Mission Log for received messages?

That's about it. I really hope most of these can be coded! It would really be more fun and flexible to configure this mod. I anticipate for your reply soon!

Keep up the good work, Banzai :D You've been the most responsive admin I have encountered.

Warden.

Add Plant/Harvest Step

Add Kill-Mobs in area step

Add mission certificate

useful as a prerequisite for a next mission (mission-trail)

show mission validation status

with another node (red-ish) and/or mail mod, if installed

Add mission cooldown timer

For building missions (build, finish mission, dig again ...)

Add checks for reward

Player death = mission failed

Allow use of foreign chests

Add a type of "wand" to mark the target chest and allow that wand to be placed in the mission-chest instead of the misused book-reference

HUD cleanup

Cleanup hud stuff, move to edge of screen