SimpleMission (MSFS): Difference between revisions

From FSDeveloper Wiki
Jump to navigationJump to search
m (→‎Step 3: Open the project folder: Remove old explanation)
(Updated instructions for the new version of the sample project)
Line 25: Line 25:


== Step 1: Download the [https://flightsim.to/file/23934/mission-creation-resources SimpleMission project] ==
== Step 1: Download the [https://flightsim.to/file/23934/mission-creation-resources SimpleMission project] ==
Unpack the .zip. Rename the <code>SimpleMission</code> folder and main <code>.xml</code> to your mission name.
Unpack the .zip.
 
In <code>PackageSources/Missions</code>, rename the <code>SimpleMission</code> folder your mission name.


== Step 2: Open the project in MSFS DevMode ==
== Step 2: Open the project in MSFS DevMode ==
Change company name and package name. Click <code>Update package name</code>.
* Change company name and package name.
 
* Change Title and Creator.
Change Title and Creator.
* Edit SimpleMission asset group, change name to your mission name.
 
* Save the project, then close it.
Edit SimpleMission asset group:
* Change name to your mission name.
* Point AssetDir to the renamed folder: <code>PackageSources/Missions/YourMissionName</code>.
* For the OutputDir, change <code>YourName</code> to your company name and <code>SimpleMission</code> to your mission name.
 
Save the project.


== Step 3: Open the project folder ==
== Step 3: Open the project folder ==
In <code>PackageDefinitions</code> delete the <code>yourname-mission-simplemission</code> folder and <code>.xml</code> file.
In <code>PackageSources\Missions\PackageName\YourMissionName\</code>:
 
* Rename the files with ''SimpleMission'' to your mission name. The files should now have the same name as their parent folder.
In <code>PackageSources\Missions\YourMissionName</code>:
* Rename the files with ''SimpleMission'' in the name to your mission name (don't forget the images).
* Delete the <code>.PLN</code> and <code>.WPR</code> files and replace them with the ones you created for your mission.
* Edit the <code>.FLT</code> you created [[Flight_file_(MSFS)#Creating_your_flight_file|like this]]. You can use the SimpleMission .FLT as a reference.
* Edit the <code>.loc</code> with [[MSFSLocalizer]]. Change all the [[GUID|GUID's]] and editing data.
* Edit the <code>.xml</code> in Notepad++:
* Edit the <code>.xml</code> in Notepad++:
** In <code>SimMission.FlowStateAction</code>, for <code>TeleportActions</code>, you can choose an intro cinematic:
** In <code>SimMission.FlowStateAction</code>, for <code>TeleportActions</code>, you can choose an intro cinematic:
Line 60: Line 47:
|-
|-
!MissionFreeFlight
!MissionFreeFlight
|The mission type used for freeflight is the freest (e.g., allows increasing sim speed), but doesn't have a nice endscreen (just the logbook).
|The mission type used for freeflight gives the most freedom (e.g., allows increasing sim speed), but doesn't have a nice endscreen (just the logbook).
|-
|-
!Tutorial
!Tutorial
Line 73: Line 60:
!MissionDiscovery
!MissionDiscovery
|This mission type is used for discovery flights.
|This mission type is used for discovery flights.
|-
|MissionLowAltitude
|This mission type is used for the top-gun low altitude challenges.
|-
|-
!colspan="2"|Untested
!colspan="2"|Untested
|-
|MissionLowAltitude
|Has properties for a racecourse and racePoints. Maybe used for reno airraces?
|-
|-
|MissionRaceRedBull
|MissionRaceRedBull
Line 90: Line 77:


== Step 4: Building the mission ==
== Step 4: Building the mission ==
Now you are ready to [[Mission_Creation_for_MSFS|start building the missions]] in the script editor.
Now you are ready to [[Mission_Creation_for_MSFS|start building the missions]] with the script editor. First, create your flight file (.FLT), flightplan (.PLN), and weather file (.WPR), then start developing your mission with the script editor.


== Step 5: Images ==
== Step 5: Images ==

Revision as of 15:05, 16 May 2023


This guide will go over the process of creating a mission with the SimpleMission sample project. See MSFS Mission Script for general information about creating a mission script.

Step 1: Download the SimpleMission project

Unpack the .zip.

Step 2: Open the project in MSFS DevMode

  • Change company name and package name.
  • Change Title and Creator.
  • Edit SimpleMission asset group, change name to your mission name.
  • Save the project, then close it.

Step 3: Open the project folder

In PackageSources\Missions\PackageName\YourMissionName\:

  • Rename the files with SimpleMission to your mission name. The files should now have the same name as their parent folder.
  • Edit the .xml in Notepad++:
    • In SimMission.FlowStateAction, for TeleportActions, you can choose an intro cinematic:
      • id="RTC_Flying_Airport_Aircraft_Intro" InstanceId="{55ACAAD8-951B-4821-8D70-4CFC800D1AFD}"
      • id="RTC_Ground_Airport_Aircraft_Intro" InstanceId="{306B2AE4-06BA-48C3-93A0-BD5569E6EF5B}"
      • id="RTC_Ground_Airport_Aircraft_Intro_GATE" InstanceId="{EE18C69D-5C95-4C75-8194-425360D6798E}"
    • You can change SimMission.MissionFreeFlight to a different mission type (for example change SimMission.MissionFreeFlight to SimMission.Tutorial):
Mission type Comment
MissionFreeFlight The mission type used for freeflight gives the most freedom (e.g., allows increasing sim speed), but doesn't have a nice endscreen (just the logbook).
Tutorial This mission type has an endscreen to evaluate mission performance.
MissionBushTrip This mission type allows you to make a mission with multiple legs. If you use this mission type, the sim autosaves mission (currently a bit broken). This mission type also has flight legs and a variable that tracks if it was completed without assistance.
MissionLandingChallenge This mission type is used for landing challenges. It has an endscreen that displays the score. It also has a landingzone with a location, heading, width, and length.
MissionDiscovery This mission type is used for discovery flights.
MissionLowAltitude This mission type is used for the top-gun low altitude challenges.
Untested
MissionRaceRedBull
MissionRefueling
MissionSightingFlight

Step 4: Building the mission

Now you are ready to start building the missions with the script editor. First, create your flight file (.FLT), flightplan (.PLN), and weather file (.WPR), then start developing your mission with the script editor.

Step 5: Images

At some point, you want to take some beautiful screenshots of your mission for the widget thumbnail, briefing, loading, ending, and content manager thumbnail.


Pages relevant to mission creation for MSFS.

Mission structure

Flightplan
Weather definitions
Flight file
Mission script
Triggers
AirportLandingTrigger & AreaLandingTrigger · CounterTrigger · PropertyTrigger · ProximityTrigger · TimerTrigger
Actions
ObjectActivationAction · DialogAction · AdjustPayloadAction · ChangeAssistanceItemAction · FadeToColorAction · RandomAction · RequestTeleportAction · CountAction · ResetTimerAction · TimerAdjustAction · GoalResolutionAction & SubGoalResolutionAction · GrantRewardAction · PointOfInterestActivationAction · ActivateWaypointsAction · AITakeControlsAction · SendMessageToAIAction
Mission objects
Mission definition · Goal · LivingWorldExclusion · Camera
Calculator
Flow states
Events
Areas
Rectangle Area · Cylinder Area · Polygon Area · Corridor Area · InGameMarker
Library objects
Sim objects
RTC

Mission tools

MSFS Script Editor · BushTripInjector · BushMissionGen · MSFSLocalizer · SPB2XML · Little Navmap

Other

Example mission files
Porting FSX Missions to MSFS
Localisation
Click the links to access the topic pages (Default - Opens in same window).
Retrieved from ‘http://www.fsdeveloper.com/wiki/index.php?title=SimpleMission_(MSFS)&oldid=11384’