Difference between revisions of "HPL3/Scripting/Scripting Guide/The Basics - Introduction"

From Frictional Wiki
Jump to navigation Jump to search
Line 6: Line 6:
 
'''Welcome to the scripting guide for the HPL3 Engine.'''
 
'''Welcome to the scripting guide for the HPL3 Engine.'''
  
−
In this tutorial series, you will learn how to set up the tools necessary for scripting, the workflow of scripting in HPL3, how to script your maps, and we will also touch on more advanced topics such as modules and how you can create your own gameplay mechanics.
+
The guide is split into two sections: Basics and Advanced.
 +
* The basic section touches on how to set up the tools necessary for scripting, the workflow of scripting in HPL3, how to script your maps.
 +
* The advanced section touches on subjects beyond map scripting such as Modules and Ai.
  
−
Bear in mind that this tutorial mostly covers the most essential things you need to know in order to script your maps. The scripting in HPL3 is a bit more complex than the HPL2 Engine, which was used for Amnesia: The Dark Descent, and therefore requires lots of self experimentation and practice.
+
'''Bear in mind that this tutorial mostly covers the most essential things you need to know in order to script your maps.'''
  
 
==Prerequisites and Recommendations==
 
==Prerequisites and Recommendations==

Revision as of 22:48, 13 August 2020

Note icon.png Important: This guide only overviews the main features of HPL3's scripting capabilities on the concept level. It does not delve into the inner workings or into the full capabilities of the engine. You can read about a specific topic in more detail at the main scripting page of the game you are working with. Please see this guide as a springboard into HPL3 scripting.


  1. The Basics - Introduction
  2. What is scripting in HPL3?
  3. Setting up CodeLite - Scripting Tool
  4. Scripting Workflow and Structure
  5. Hello World
  6. Calling Functions and Function Callbacks
  7. Helper Files
  8. The OnAction method
  9. The Update method
  10. Timers
  11. Sequences
  12. Local and Global Variables
  13. Enums
  14. Conclusion

Welcome to the scripting guide for the HPL3 Engine.

The guide is split into two sections: Basics and Advanced.

  • The basic section touches on how to set up the tools necessary for scripting, the workflow of scripting in HPL3, how to script your maps.
  • The advanced section touches on subjects beyond map scripting such as Modules and Ai.

Bear in mind that this tutorial mostly covers the most essential things you need to know in order to script your maps.

Prerequisites and Recommendations

  1. The scripting language of HPL3 is called AngelScript, which is similar to some of the more popular programming languages, so you should get familiar with the basic concepts of programming and be able to write simple code in the style of languages such as Java or C#.
  2. You should know how to create or edit a basic mod. See the Creating a Mod article for more information.
Note icon.png If you have zero programming knowledge, you should start with the AngelScript Fundamentals guide, and read at least the first five lessons.
Retrieved from "https://wiki.frictionalgames.com/page?title=HPL3/Scripting/Scripting_Guide/The_Basics_-_Introduction&oldid=4290"