New scripting functionality

[AEthelraedUnraed]

As the Devs recently said, IL2 now supports advanced programmable triggers that can be used to define custom behaviour in missions. There are two packed scripts available: luascripts\worldobjects\customtriggers\test.txt and luascripts\worldobjects\customtriggers\playvoice.txt.

Since there is no working unGTP-IL2.exe yet, there is no way however to read the contents of these files and use the added functionality. Is there any chance @LukeFF that you could provide these files so that we can have a look at them? It would certainly enable some very cool missions 🙂

[Jaegermeister]

@AEthelraedUnraed / @Juri_JS

The Playvoice scripted trigger allows you to play a voice message which will be be generated in game. Text you type into the Text ; Value field will be played in game with the localized voice you specify in the numerical Voice field. When you activate the Scripted trigger, it will play the message. Then you should deactivate it with OnAction00: Completed, targeting a Trigger:Deactivate object linked back to the scripted trigger. If you do not deactivate it, it will keep running and cause other commands to be ignored, similar to leaving the media player running and not ending it. 

If this is not clear enough, send me a PM

 

Edited July 6 by Jaegermeister

[Juri_JS]

4 hours ago, Jaegermeister said:

@AEthelraedUnraed / @Juri_JS

The Playvoice scripted trigger allows you to play a voice message which will be be generated in game. Text you type into the Text ; Value field will be played in game with the localized voice you specify in the numerical Voice field. When you activate the Scripted trigger, it will play the message. Then you should deactivate it with OnAction00: Completed, targeting a Trigger:Deactivate object linked back to the scripted trigger. If you do not deactivate it, it will keep running and cause other commands to be ignored, similar to leaving the media player running and not ending it. 

If this is not clear enough, send me a PM

 

Thank you I will test it. Would be nice to have Korean voice messages for my Guards Taejon campaign, but I wonder how well it will work for none European languages.

[AEthelraedUnraed]

7 hours ago, Jaegermeister said:

@AEthelraedUnraed / @Juri_JS

The Playvoice scripted trigger allows you to play a voice message which will be be generated in game. Text you type into the Text ; Value field will be played in game with the localized voice you specify in the numerical Voice field. When you activate the Scripted trigger, it will play the message. Then you should deactivate it with OnAction00: Completed, targeting a Trigger:Deactivate object linked back to the scripted trigger. If you do not deactivate it, it will keep running and cause other commands to be ignored, similar to leaving the media player running and not ending it. 

If this is not clear enough, send me a PM

 

Yes, I've tried it and it works. 🙂 Though the Deactivate command may be the reason I couldn't get the "test" script to work.

What I rather meant, is have a look at the contents of those files so that we can write our own.

[Jaegermeister]

10 hours ago, Juri_JS said:

Thank you I will test it. Would be nice to have Korean voice messages for my Guards Taejon campaign, but I wonder how well it will work for none European languages.

I think the English, Russian, Korean and Chinese voices are currently active.

[Juri_JS]

8 minutes ago, Jaegermeister said:

I think the English, Russian, Korean and Chinese voices are currently active.

I guess the bigger problem will be, that I first have to translate the English messages into Korean. No idea how well English to Korean works in Google Translate. I am sure some of the results will be extremely funny for our Korean community members.

[Jaegermeister]

53 minutes ago, Juri_JS said:

I guess the bigger problem will be, that I first have to translate the English messages into Korean. No idea how well English to Korean works in Google Translate. I am sure some of the results will be extremely funny for our Korean community members.

It should be localized automatically. English voices are numbers 31 through 38. Try selecting a voice number lower than 31, type your text in the language you IL2 program is localized for, and see what you get in game.

 

Edited July 7 by Jaegermeister

[Juri_JS]

2 hours ago, Jaegermeister said:

It should be localized automatically. English voices are numbers 31 through 38. Try selecting a voice number lower than 31, type your text in the language you IL2 program is localized for, and see what you get in game.

 

I've tested it, but only the English voices worked for me. Maybe other languages aren't ready yet?

[LuftManu]

Hey guys! How are you activating the TTS? I placed it on the map but I can't link a timer to fire it.

 

Thanks in advance!

Edit: Duh! I read with activate / deactivate!

Edit2: 

Am I missing something? 

Kinde regards guys!

Okay it works now after linking it to the plane as object 🙂

 

[Jaegermeister]

3 hours ago, Juri_JS said:

I've tested it, but only the English voices worked for me. Maybe other languages aren't ready yet?

1-8 = Russian

11-18 = Chinese

21-28 = Korean

31-38 = US English

Russian, Korean and US English are currently working, you have to input the text into the scripted trigger in Cyrillic and Korean for them to play in game. Simplified Chinese text displays but no voice, Korean text does not display but voice works as of now. PM sent

 

2 hours ago, LuftManu said:

Okay it works now after linking it to the plane as object 🙂

You should not have to link the scripted trigger to a plane.

I am not sure how long your timer is in the image above, but it might not play if it is not at least 3 seconds, It takes the game a couple of seconds to start, pause and then go to a stable state. If you play the message before that, it will get stopped before you hear it.

Timer or other trigger -> Activate -> Scripted Trigger -> Deactivate on OO action 

Edited July 7 by Jaegermeister

[Jaegermeister]

14 hours ago, AEthelraedUnraed said:

Yes, I've tried it and it works. 🙂 Though the Deactivate command may be the reason I couldn't get the "test" script to work.

What I rather meant, is have a look at the contents of those files so that we can write our own.

Right now I think it is only being used for the voices, but I will let you know if I hear anything different. I'm sure there will be more functionality added later by editing or writing .json files and saving them in a folder similar to the texture files we have saved with scripted campaigns.

 

Edited July 7 by Jaegermeister

[AEthelraedUnraed]

1 hour ago, Jaegermeister said:

1-8 = Russian

11-18 = Chinese

21-28 = Korean

31-38 = US English

Russian, Korean and US English are currently working, you have to input the text into the scripted trigger in Cyrillic and Korean for them to play in game. Simplified Chinese text displays but no voice, Korean text does not display but voice works as of now. PM sent

Thanks! I haven't been able to get the text to display visually however. How did you accomplish that?

28 minutes ago, Jaegermeister said:

Right now I think it is only being used for the voices, but I will let you know if I hear anything different. I'm sure there will be more functionality added later by editing or writing .json files and saving them in a folder similar to the texture files we have saved with scripted campaigns.

The test.txt one at least has some triggers in it, although I haven't been able to quite figure it out yet.

I don't think the scripts are in json (which is a data serialisation format rather than a scripting language). Who knows, perhaps we'll finally get some lua scripts in the luascripts directory.  Anyhow, theoretically it should be possible to put one's own scripts there. If only we get some documentation or the contents of the two examples, so we know what to put in them.

[LuftManu]

1 hour ago, Jaegermeister said:

1-8 = Russian

11-18 = Chinese

21-28 = Korean

31-38 = US English

Russian, Korean and US English are currently working, you have to input the text into the scripted trigger in Cyrillic and Korean for them to play in game. Simplified Chinese text displays but no voice, Korean text does not display but voice works as of now. PM sent

 

You should not have to link the scripted trigger to a plane.

Timer or other trigger -> Activate -> Scripted Trigger -> Deactivate on OO action 

Thanks!! It's working now 🙂

[Sketch]

Is this TTS unique to each side (for multiplayer missions) or is it only for single player? (aka: does it trigger the voice for all sides on multiplayer?) It would be nice to be able to do TTS for callouts from ground forces to the players flying on the server.

[Juri_JS]

For Korean it's still hit and miss for me, if voices work or not. No idea why, but some Korean texts just won't work. Maybe an issue with certain Korean letters or text length?

[Juri_JS]

In the last update we got "ingamemusic" and "exercise_001".

It is clear what "ingamemusic" does, but what does "exercise_001" do?

[Jade_Monkey]

On 7/25/2026 at 5:54 AM, Juri_JS said:

In the last update we got "ingamemusic" and "exercise_001".

It is clear what "ingamemusic" does, but what does "exercise_001" do?

Im guessing but I think exercise_001 is related to very scripted training missions where they walk you though takeoff and landing and they check that you are following all the steps correctly, sort of a very interactive tutorial. Im assuming we will see those come out later.

[Jade_Monkey]

Im going insane trying to get the TTS to work. What am I doing wrong?

 

 

 

 

 

 

Test TTS.zip

[Leifr]

Pretty sure I read on the Discord that the TTS doesn't work, and if it does, it's liable to crash the mission.

[eszyman]

This seems to only work when the mission is loaded in game.  Dserver does not like the TTS yet.

[Jade_Monkey]

1 hour ago, eszyman said:

This seems to only work when the mission is loaded in game.  Dserver does not like the TTS yet.

I'm trying it as a single player mission, I can't hear a thing. 

[Jaegermeister]

16 minutes ago, Jade_Monkey said:

I'm trying it as a single player mission, I can't hear a thing. 

Looks like your trigger is enabled, so it will play before the mission starts. Uncheck enabled and see if that works

2 hours ago, Leifr said:

Pretty sure I read on the Discord that the TTS doesn't work, and if it does, it's liable to crash the mission.

That is certainly not true in a single player mission. I have used it in all the missions I make with no issues

[Jade_Monkey]

3 hours ago, Jaegermeister said:

Looks like your trigger is enabled, so it will play before the mission starts. Uncheck enabled and see if that works

 

I've tried it both ways, nothing seems to work. I've also attempted (desperately) to link it to my plane as an object atc. 

NOTHING works.

Could someone share with me a sample mission file with a working sound (please quickly check it works right now on patch 1.003b)????

Edited August 9 by Jade_Monkey

[Jaegermeister]

 

1 hour ago, Jade_Monkey said:

 

I've tried it both ways, nothing seems to work. I've also attempted (desperately) to link it to my plane as an object atc. 

NOTHING works.

Could someone share with me a sample mission file with a working sound (please quickly check it works right now on patch 1.003b)????

Sure, give me a few minutes to run a test, I was eating dinner

[Jaegermeister]

@Jade_Monkey, here ya go... I'll take a look at your file and see if I can figure out why it didn't work.

 

Voice_Command_Test.zip