No Description

Thomas Rudin 2421b31a1a Merge pull request #36 from WoosterUK/master 1 week ago
screenshots 346b023412 rename 1 year ago
sounds b479c30d17 mission complete animation (from awards) / license 1 year ago
steps afb4c3acc4 mesecons receptor step 3 weeks ago
textures efe27bbb53 followup stub 1 year ago
.luacheckrc afb4c3acc4 mesecons receptor step 3 weeks ago
LICENSE.txt b479c30d17 mission complete animation (from awards) / license 1 year ago
block.lua afb4c3acc4 mesecons receptor step 3 weeks ago
chat.lua 7dbd70f1b1 integrate with unified inv 1 year ago
cooldown.lua 0716adcf2e add cooldown timer in mission spec 1 year ago
depends.txt afb4c3acc4 mesecons receptor step 3 weeks ago
executor.hud.lua 02cfd18b4d luacheck 3 weeks ago
executor.lua 3c4c8bea55 add a few comments 3 weeks ago
form.missionblock_config.lua 94af61dd71 Merge branch 'master' of https://github.com/thomasrudin-mt/missions 3 weeks ago
form.missionblock_help.lua 11b004cee7 uniform mission bgcolor 11 months ago
form.missionblock_main.lua 02cfd18b4d luacheck 3 weeks ago
form.missionblock_stats.lua 11b004cee7 uniform mission bgcolor 11 months ago
form.missionblock_stepeditor.lua 02cfd18b4d luacheck 3 weeks ago
form.missionblock_user.lua 02cfd18b4d luacheck 3 weeks ago
form.newstep.lua 94af61dd71 Merge branch 'master' of https://github.com/thomasrudin-mt/missions 3 weeks ago
form.wand.lua 02cfd18b4d luacheck 3 weeks ago
functions.lua 02cfd18b4d luacheck 3 weeks ago
hud.lua 3c4c8bea55 add a few comments 3 weeks ago
init.lua afb4c3acc4 mesecons receptor step 3 weeks ago
migrate.lua 3c4c8bea55 add a few comments 3 weeks ago
privs.lua 8282bd6d3c give book step 11 months ago
readme.md 393c24b25e update readme 3 weeks ago
register_step.lua 94af61dd71 Merge branch 'master' of https://github.com/thomasrudin-mt/missions 3 weeks ago
ui.lua 02cfd18b4d luacheck 3 weeks ago
validate.lua 4c299ca180 check steps on validate 6 months ago
wand.lua 69606ed2f2 Re-factor wand registration to avoid oversights in deconversion recipes 1 week ago

readme.md

Minetest mission mod (missions)

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

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

Pull requests / bugs

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