HPL3/Amnesia: Rebirth/Tutorials/Custom Menu - Revision history

Darkfire: /* Rotating the camera in a 3D menu */ useful link

2020-11-09T21:32:22Z

Rotating the camera in a 3D menu: useful link

Darkfire: Added a missing section WIP

2020-11-09T01:30:40Z

Added a missing section WIP

Darkfire: Fixed, finished text

2020-11-09T01:28:59Z

Fixed, finished text

Darkfire: Created, wip

2020-11-09T01:23:48Z

Created, wip

New page

This tutorial will show you how to make a custom menu for your mod. It assumes you set up your mod and were able to run a basic map.

## Preparing the map

Make your map as you want. The map only needs a player spawn called <code>PlayerStartArea_1</code> (it can be named differently, but you will need to correct that in script later).

If you don't want a 3D menu, the map should be empty (asides from the player spawn).

If you ''are'' planning to make the map 3D, you can make the map at this point. It will be easier if we complete other steps first, however.

Finally, make sure to copy the original script: <code>/maps/main_menu/main_menu.hps</code> to your map's folder and rename the script with the same name as your map.

## Setting up a custom module

The menu is handled by a script module the filepath to which is <code>/script/custom/modules/MenuHandler.hps</code>. Copy it and place it in a similar place in your mod, i.e. <code>/mods/YourMod/script/custom/modules/MenuHandler.hps</code>.

{{tip| Engine modules are placed in <code>/script/modules/</code>. Game-specific modules are placed in <code>/script/custom/modules/</code>.}}

From now on, you should be able to change that module and see the changes in your mod.

{{tip| If you're using CodeLite (which you should), you will need to re-add the game folders again to see new files (read [[HPL3/Scripting/Scripting_Guide/Setting_up_CodeLite|the set-up guide]] to see how).}}

## Making a custom 2D menu

If you wish to have a custom 2D menu like the original one, it will be fully done in the Menu script module.

{{ConstructionNotice| Altering the 2D menu needs testing and experience - this part of the tutorial is to come.|align=center|width=30%}}

## Setting up for a 3D menu

If you want a 3D menu, you will need to at least remove the menu background art.

To do that, open your MenuHandler module and Ctrl+F search this: <code>menu_bg_uw_background.png</code>.
That will take you to the start of the section you need to comment out; make sure to comment everything from "Background" to "Animated texture graphics". You can also comment out the vignette effect if you wish.

{{tip|Use this syntax to comment out big chunks of code at the same time: <code>/* (commented code here) */</code>}}

This is also the section where you can edit the logo which appears in the menu. Just swap the PNG filename to a custom one.

{{ConstructionNotice| Moving the menu piece around - coming soon |align=center|width=30%}}

## Rotating the camera in a 3D menu

If you tried placing something in the map and loading it, you might notice the camera always looks into a certain direction, no matter how the player spawn is roated. If you're making a map from scratch, this should not be a problem, since you can just make the map where the camera points.

However, that is very limiting and can become frustrating, so instead we can use a camera animation to set the view as we want.

First, place a

After these edits, you will be able to reload the map menu and see your changes

<code></code>

@@ Line 47: / Line 47: @@
 However, that is very limiting and can become frustrating, so instead we can use a camera animation to set the view as we want.
-First, place a CameraAnimation area where you want your camera to point. Make sure to call it "CameraAnimation_1" - or use a different name, but match it with the script.
+First, place [[HPL3/Areas/Camera Animation Area|a CameraAnimation area]] where you want your camera to point. Make sure to call it "CameraAnimation_1" - or use a different name, but match it with the script.
 Then, go to the map script and add this line to OnEnter: <code>CameraAnimation_Begin("CameraAnimation", "", false);</code>

← Older revision		Revision as of 01:30, 9 November 2020
Line 54:		Line 54:

	After these edits, you will be able to reload the map menu and see your changes in the 3D map.		After these edits, you will be able to reload the map menu and see your changes in the 3D map.
		+
		+	== Setting the map as the menu in the mod release ==
		+
		+	{{ConstructionNotice\| Coming soon \|align=center\|width=30%}}

@@ Line 2: / Line 2: @@
 This tutorial will show you how to make a custom menu for your mod. It assumes you set up your mod and were able to run a basic map.
-## Preparing the map
+== Preparing the map ==
 Make your map as you want. The map only needs a player spawn called <code>PlayerStartArea_1</code> (it can be named differently, but you will need to correct that in script later).
@@ Line 12: / Line 12: @@
 Finally, make sure to copy the original script: <code>/maps/main_menu/main_menu.hps</code> to your map's folder and rename the script with the same name as your map.
-## Setting up a custom module
+== Setting up a custom module ==
 The menu is handled by a script module the filepath to which is <code>/script/custom/modules/MenuHandler.hps</code>. Copy it and place it in a similar place in your mod, i.e. <code>/mods/YourMod/script/custom/modules/MenuHandler.hps</code>.
@@ Line 22: / Line 22: @@
 {{tip| If you're using CodeLite (which you should), you will need to re-add the game folders again to see new files (read [[HPL3/Scripting/Scripting_Guide/Setting_up_CodeLite|the set-up guide]] to see how).}}
-## Making a custom 2D menu
+== Making a custom 2D menu ==
 If you wish to have a custom 2D menu like the original one, it will be fully done in the Menu script module.
@@ Line 28: / Line 28: @@
 {{ConstructionNotice| Altering the 2D menu needs testing and experience - this part of the tutorial is to come.|align=center|width=30%}}
-## Setting up for a 3D menu
+== Setting up for a 3D menu ==
 If you want a 3D menu, you will need to at least remove the menu background art.
@@ Line 41: / Line 41: @@
 {{ConstructionNotice| Moving the menu piece around - coming soon |align=center|width=30%}}
-## Rotating the camera in a 3D menu
+== Rotating the camera in a 3D menu ==
 If you tried placing something in the map and loading it, you might notice the camera always looks into a certain direction, no matter how the player spawn is roated. If you're making a map from scratch, this should not be a problem, since you can just make the map where the camera points.
@@ Line 47: / Line 47: @@
 However, that is very limiting and can become frustrating, so instead we can use a camera animation to set the view as we want.
-First, place a
+First, place a CameraAnimation area where you want your camera to point. Make sure to call it "CameraAnimation_1" - or use a different name, but match it with the script.
-After these edits, you will be able to reload the map menu and see your changes
+Then, go to the map script and add this line to OnEnter: <code>CameraAnimation_Begin("CameraAnimation", "", false);</code>
-<code></code>
+This will start a camera animation which will iterate through all CameraAnimation areas that start with "CameraAnimation" in their name. Since we only have one and it's move time is set to zero, the animation will just teleport the camera to our area and leave it there. You can of course make actual camera animations in the menu if you wish, but that goes beyond the scope of this tutorial.