Skip to content
BlockFrontBlockFront DocsOfficial Documentation for BlockFront

Your first mission

The quickest way to a working mission is to copy one that already works. You’ll start from Operation Pathfinder, make it your own, and see a change appear in game.

  1. Download Operation Pathfinder from Modrinth.
  2. Unzip it into your game’s resourcepacks folder, so that you have resourcepacks/my_campaign/pack.json. It must be a folder, not a zip, so the editing tools work.
  3. Open pack.json and change id to my_campaign, then change name, author and description. Clear modrinthProject.
  4. Rename assets/blockfront_pathfinder to assets/my_campaign.
  1. Start the game and enable your pack in the resource pack screen.
  2. Go to Find Game, then Campaign, and pick your campaign. Folder packs show an Editor tag on their card.
  3. Start the mission.

With the mission running, open missions/pathfinder/farm.lua in a text editor and change a line of dialogue. Save the file.

The game notices the change and reloads the mission straight away, restarting the current section. You don’t need to restart the game, and this is how you’ll work from now on: edit, save, watch.

If the script has an error, you’ll see it in game with the file and line number. See Debugging.

  • Read mission.lua, then follow a section through farm.lua.
  • Add a marker with /mission marker set and walk an actor to it. See Spatial data.
  • Add an objective with objective.add.

To build your own map, replace the mission’s world/ folder with your world, and replace the positions in spatial.json by capturing new ones in game.