FlightControl-Master/MOOSE
1
0
Fork 0
mirror of https://github.com/FlightControl-Master/MOOSE.git synced 2025-10-29 16:58:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Documentation update

Browse Source
This commit is contained in:
FlightControl
2017-03-30 18:11:37 +02:00
parent 614581222d
commit 51b28f990c
3 changed files with 26 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/Communities.md
View File

@@ -1,8 +1,8 @@
# 3) MOOSE framework support channels # 1) MOOSE framework support channels
MOOSE is broadcasted, documented and supported through various social media channels. MOOSE is broadcasted, documented and supported through various social media channels.
## 3.1) MOOSE broadcast channels on YouTube ## 1.1) MOOSE broadcast channels on YouTube
MOOSE has a [broadcast channel](https://www.youtube.com/channel/UCjrA9j5LQoWsG4SpS8i79Qg/playlists) on youtube. MOOSE has a [broadcast channel](https://www.youtube.com/channel/UCjrA9j5LQoWsG4SpS8i79Qg/playlists) on youtube.
These videos are grouped into playlists, which explain specific MOOSE capabilities, These videos are grouped into playlists, which explain specific MOOSE capabilities,
@@ -18,19 +18,19 @@ Some mandatory videos to watch are:
* [MOOSE Tasking](https://www.youtube.com/playlist?list=PL7ZUrU4zZUl3CgxN2iAViiGLTPpQ-Ajdg) * [MOOSE Tasking](https://www.youtube.com/playlist?list=PL7ZUrU4zZUl3CgxN2iAViiGLTPpQ-Ajdg)
* [MOOSE Task Dispatching](https://www.youtube.com/playlist?list=PL7ZUrU4zZUl3I6ieFM-cjey-rncF1ktNI) * [MOOSE Task Dispatching](https://www.youtube.com/playlist?list=PL7ZUrU4zZUl3I6ieFM-cjey-rncF1ktNI)
## 3.2) MOOSE on Eagle Dynamics forums ## 1.2) MOOSE on Eagle Dynamics forums
This is a default thread at the Eagle Dynamics forums where the MOOSE framework can be discussed and supported. This is a default thread at the Eagle Dynamics forums where the MOOSE framework can be discussed and supported.
The thread is called [MOOSE - Mission Object Oriented Scripting Framework](https://forums.eagle.ru/showthread.php?t=138043). The thread is called [MOOSE - Mission Object Oriented Scripting Framework](https://forums.eagle.ru/showthread.php?t=138043).
## 3.3) MOOSE on GITHUB. ## 1.3) MOOSE on GITHUB.
I encourage that you create also a user at GITHUB. I encourage that you create also a user at GITHUB.
On the MOOSE framework GITHUB site, you can register issues, feedback and comments in the issues section of the site. On the MOOSE framework GITHUB site, you can register issues, feedback and comments in the issues section of the site.
This allows to track this feedback and issues, in order to provide a structured support and create a milestone plan. This allows to track this feedback and issues, in order to provide a structured support and create a milestone plan.
In other words, treat this development as a project. In other words, treat this development as a project.
## 3.4) MOOSE on slack.com ## 1.4) MOOSE on slack.com
Slack is a team community site. It is a great environment to discuss online the framework. Slack is a team community site. It is a great environment to discuss online the framework.
Various channels are allocated in the environment to discuss specific topics. Various channels are allocated in the environment to discuss specific topics.

5
docs/README.md
View File

@@ -6,7 +6,7 @@ MOOSE works with DCS world 1.5. and 2.0.
![MOOSE Banner](Presentations\MOOSE\Dia1.JPG) ![MOOSE Banner](Presentations\MOOSE\Dia1.JPG)
## 1.1) MOOSE framework goal ## MOOSE framework goal
The goal of MOOSE is to allow mission designers to enhance their scripting with mission orchestration objects, which can be instantiated from defined classes within the framework. This will allow to write mission scripts with minimal code embedded. Of course, the richness of the framework will determine the richness of the misson scenarios. The goal of MOOSE is to allow mission designers to enhance their scripting with mission orchestration objects, which can be instantiated from defined classes within the framework. This will allow to write mission scripts with minimal code embedded. Of course, the richness of the framework will determine the richness of the misson scenarios.
The MOOSE is a service that is produced while being consumed ... , it will evolve further as more classes are developed for the framework, and as more users are using it. The MOOSE is a service that is produced while being consumed ... , it will evolve further as more classes are developed for the framework, and as more users are using it.
@@ -175,6 +175,7 @@ These AI Controlling Classes are based on FSM (Finite State Machine) Classes, an
* [AI_CARGO](Documentation/AI_Cargo.html): Make AI behave as cargo. Various CARGO types exist. * [AI_CARGO](Documentation/AI_Cargo.html): Make AI behave as cargo. Various CARGO types exist.
## 3.6) MOOSE Human Tasking Classes ## 3.6) MOOSE Human Tasking Classes
MOOSE Tasking Classes provide a comprehensive Mission Orchestration System. MOOSE Tasking Classes provide a comprehensive Mission Orchestration System.
@@ -194,6 +195,7 @@ Each TASK has a TASK ACTION flow, which is the flow that a player (hosted by a U
* [TASK_CAS](Documentation/Task_A2G.html): Models a CAS Task, where a Player is routed towards an attack zone with enemies nearby, and various ground targets need to be eliminated. * [TASK_CAS](Documentation/Task_A2G.html): Models a CAS Task, where a Player is routed towards an attack zone with enemies nearby, and various ground targets need to be eliminated.
## 3.7) MOOSE Action Classes ## 3.7) MOOSE Action Classes
MOOSE Action Classes are task action sub-flows, that can be used and combined, to quickly define a comprehensive end-to-end task action flow. MOOSE Action Classes are task action sub-flows, that can be used and combined, to quickly define a comprehensive end-to-end task action flow.
@@ -208,6 +210,7 @@ For example, for the SEAD Task, the task action flow combines the actions ASSIGN
* [ACT_ASSIST](Documentation/Assist.html): Mechanisms to assist players executing a task. For example, acquire targets through smoking them. * [ACT_ASSIST](Documentation/Assist.html): Mechanisms to assist players executing a task. For example, acquire targets through smoking them.
# 4) Credits # 4) Credits
Note that most of the framework is based on code i've written myself, Note that most of the framework is based on code i've written myself,

34
docs/Usage_Guide.md
View File

@@ -1,9 +1,9 @@
# 2.1) MOOSE Usage Guide # 1) MOOSE Usage Guide
Using the MOOSE framework is very easy, and this document provides you with a detailed explanation how to install Using the MOOSE framework is very easy, and this document provides you with a detailed explanation how to install
and use MOOSE within your missions. and use MOOSE within your missions.
## 2.1.1) MOOSE framework at GitHub ## 1.1) MOOSE framework at GitHub
You can find the source of [MOOSE framework on GITHUB](https://github.com/FlightControl-Master/MOOSE/). You can find the source of [MOOSE framework on GITHUB](https://github.com/FlightControl-Master/MOOSE/).
It is free for download and usage, but it is under license of the GNU 3.0 open source license policy. It is free for download and usage, but it is under license of the GNU 3.0 open source license policy.
@@ -12,7 +12,7 @@ GITHUB enforces a structured approval process, release and change management, an
The MOOSE framework development is considered an open source project, where contributors are welcome to contribute on the development. The MOOSE framework development is considered an open source project, where contributors are welcome to contribute on the development.
Some key users have already started with this process. Contact me if you're interested to contribute. Some key users have already started with this process. Contact me if you're interested to contribute.
## 2.1.2) Eclipse LDT ## 1.2) Eclipse LDT
MOOSE utilizes the Eclipse Lua Development Tools. As a result, the MOOSE framework is documented using the luadocumentor standard. MOOSE utilizes the Eclipse Lua Development Tools. As a result, the MOOSE framework is documented using the luadocumentor standard.
Every class, method and variable is documented within the source, and mission designers can write mission script lua code that is **intellisense**(-ed) ... Every class, method and variable is documented within the source, and mission designers can write mission script lua code that is **intellisense**(-ed) ...
@@ -20,7 +20,7 @@ What that means is that while you are coding your mission, your object and varia
![Intellisense](Usage/Intellisense.JPG) ![Intellisense](Usage/Intellisense.JPG)
## 2.1.3) LUA training ## 1.3) LUA training
In order to efficiently use the MOOSE framework, it is highly recommended that you learn a couple of basic principles of lua. In order to efficiently use the MOOSE framework, it is highly recommended that you learn a couple of basic principles of lua.
I recommend you learn the basic lua principles following this [lua tutorial](https://www.tutorialspoint.com/lua). I recommend you learn the basic lua principles following this [lua tutorial](https://www.tutorialspoint.com/lua).
@@ -30,9 +30,9 @@ knowledge to "understand" the code, and also, to understand the syntax.
**Therefore, I suggest you walk through this [lua quick guide](https://www.tutorialspoint.com/lua/lua_quick_guide.htm)**. **Therefore, I suggest you walk through this [lua quick guide](https://www.tutorialspoint.com/lua/lua_quick_guide.htm)**.
Ignore the lua environment setup. DCS comes with a pre-defined lua environment. Ignore the lua environment setup. DCS comes with a pre-defined lua environment.
# 2.2) MOOSE Installation Guide # 2) MOOSE Installation Guide
## 2.2.1) Download the latest release of MOOSE ## 2.1) Download the latest release of MOOSE
The delivery of MOOSE follows a structured release process. Over time, new features are added that can be used in your mission. The delivery of MOOSE follows a structured release process. Over time, new features are added that can be used in your mission.
@@ -41,21 +41,21 @@ The delivery of MOOSE follows a structured release process. Over time, new featu
**Unzip the files into a directory of your choice, but keep the folder structure intact**. **Unzip the files into a directory of your choice, but keep the folder structure intact**.
## 2.2.2) Download and install the Eclipse Lua Development Tools (LDT), which is an advanced lua editor. ## 2.2) Download and install the Eclipse Lua Development Tools (LDT), which is an advanced lua editor.
1. If you don't have JAVA yet, you may have to install [java](https://www.java.com/en/download) first. 1. If you don't have JAVA yet, you may have to install [java](https://www.java.com/en/download) first.
2. Download and Install [Eclipse LDT](https://eclipse.org/ldt) on your Windows 64 bit system. 2. Download and Install [Eclipse LDT](https://eclipse.org/ldt) on your Windows 64 bit system.
Now you should have a working LDT on your system. Now you should have a working LDT on your system.
## 2.2.3) Configure your LDT for the usage of MOOSE. ## 2.3) Configure your LDT for the usage of MOOSE.
You need to configure your Eclipse LDT environment and link it with the MOOSE respository. You need to configure your Eclipse LDT environment and link it with the MOOSE respository.
This will enable you to **start developing mission scripts** in lua, which will be **fully intellisense enabled**!!! This will enable you to **start developing mission scripts** in lua, which will be **fully intellisense enabled**!!!
Please follow the steps outlined! Please follow the steps outlined!
### 2.2.3.1) Create a new **Workspace** in LDT. ### 2.3.1) Create a new **Workspace** in LDT.
The LDT editor has a concept of **Workspaces**, which contains all your settings of your editing environment, The LDT editor has a concept of **Workspaces**, which contains all your settings of your editing environment,
like views, menu options etc, and your code... Nothing to pay attention to really, but you need to set it up! like views, menu options etc, and your code... Nothing to pay attention to really, but you need to set it up!
@@ -64,7 +64,7 @@ When you open EclipseLDT for the first time, it will ask you where to put your *
1. Open Eclipse LDT. 1. Open Eclipse LDT.
2. Select the default workspace that LDT suggests. 2. Select the default workspace that LDT suggests.
### 2.2.3.2) Create a new **Project** in LDT. ### 2.3.2) Create a new **Project** in LDT.
Here we will create a **New Project** called **Moose_Framework** in your LDT environment. Here we will create a **New Project** called **Moose_Framework** in your LDT environment.
The project details are already defined within the MOOSE framework repository, The project details are already defined within the MOOSE framework repository,
@@ -99,9 +99,9 @@ As a result, when you browse to the Script Explorer, you'll see the following:
**Congratulations! You have now setup your Moose_Framework project LDT environment!** **Congratulations! You have now setup your Moose_Framework project LDT environment!**
# 2.3) Your first mission # 2.4) Your first mission
## 2.3.1) Setup your **Mission Project** in LDT ## 2.4.1) Setup your **Mission Project** in LDT
In order to design your own missions, it is recommended you create a separate directory on your PC In order to design your own missions, it is recommended you create a separate directory on your PC
which contains your mission files. Your mission will be designed consisting possibly which contains your mission files. Your mission will be designed consisting possibly
@@ -131,7 +131,7 @@ The LDT has been customized and provides a tool to **automatically** maintain yo
3. Type the Project Name: **My Missions**. 3. Type the Project Name: **My Missions**.
## 2.3.2) Create your first Mission file ## 2.4.2) Create your first Mission file
In the MOOSE package, a file named **Moose.lua** can be found. In the MOOSE package, a file named **Moose.lua** can be found.
In order to create or design a mission using the MOOSE framework, In order to create or design a mission using the MOOSE framework,
@@ -146,18 +146,18 @@ you'll have to include this **Moose.lua** file into your missions:
Voila, MOOSE is now included in your mission. During the execution of this mission, all MOOSE classes will be loaded, and all MOOSE initializations will be exectuted before any other mission action is executed. Voila, MOOSE is now included in your mission. During the execution of this mission, all MOOSE classes will be loaded, and all MOOSE initializations will be exectuted before any other mission action is executed.
## 2.3.3) Maintain your .miz files ## 2.4.3) Maintain your .miz files
IMPORTANT NOTE: When a new version of MOOSE is released, you'll have to UPDATE the Moose.lua file in EACH OF YOUR MISSION. IMPORTANT NOTE: When a new version of MOOSE is released, you'll have to UPDATE the Moose.lua file in EACH OF YOUR MISSION.
This can be a tedious task, and for this purpose, a tool has been developed that will update the Moose.lua files automatically within your missions. This can be a tedious task, and for this purpose, a tool has been developed that will update the Moose.lua files automatically within your missions.
# 2.4) Support Channels # 3) Support Channels
MOOSE is broadcasted, documented and supported through various social media channels. MOOSE is broadcasted, documented and supported through various social media channels.
[Click here for the communities guide of the MOOSE framework](Communities.html). [Click here for the communities guide of the MOOSE framework](Communities.html).
# 2.5) Demonstration Missions # 4) Demonstration Missions
The framework comes with [demonstration missions](https://github.com/FlightControl-Master/MOOSE_MISSIONS), The framework comes with [demonstration missions](https://github.com/FlightControl-Master/MOOSE_MISSIONS),
that you can try out and helps you to code. that you can try out and helps you to code.
@@ -167,5 +167,5 @@ You can copy/paste code the code snippets from this .lua file into your missions
You will learn, see, and understand how the different MOOSE classes need to be applied, and how you can create You will learn, see, and understand how the different MOOSE classes need to be applied, and how you can create
more complex mission scenarios by combining these MOOSE classes into a complex but powerful mission engine. more complex mission scenarios by combining these MOOSE classes into a complex but powerful mission engine.
These exact test missions are also demonstrated at the demo videos in the YouTube channel. These exact demonstration missions are also explained at the demo videos in the YouTube channel.