Modding pregame page in 0 A.D. 28

[Mentula]

Hi devs and modders,

In 0 A.D. 27 and before it was possible to mod the pregame page by adding scripts to the gui/pregame folder. Example of applications are: adding items to the main menu; running startup scripts.

Since commit 0fcc4f5fc5 the gui/pregame directory is not loaded anymore, in favour of loading the mainmenu.js file only. It is not clear how mod scripts can run in this page after this change.

✖ It is not an option to override mainmenu.js, mainmenu.xml, page_pregame.xml or other files. This will of course break the compatibility with other mods, as only the last loaded mod will execute the code.

Maybe @phosit, do you have an idea? I am pinging you as the author of the change.

Thanks.

[Stan`]

Hey @Mentula

Nice to see you're still active!

Can't you add a file like autociv like so ~mainmenu.js to extend it ?

Else maybe you can wrap the module into something else and use that elsewhere. sounds inconvenient though @phosit

[Mentula]

20 minutes ago, Stan` said:

Can't you add a file like autociv like so ~mainmenu.js to extend it ?

That's the point. If the directory gui/pregame was loaded by the xml - like it was before:

<script directory="gui/pregame/"/>

then one could create a file named mainmenu~MyMod.js and do all sort of scripting therein (for example making proxies of existing functions).

But this is not the case anymore for the pregame page. At first glance, this is the only page which changed behaviour. To make a comparison, session.xml is still loading the entire directory gui/session:

<script directory="gui/session/"/>

 

32 minutes ago, Stan` said:

Nice to see you're still active!

I wish I was!  New release, new work for porting mods. I played my last game in 2023, but 0 A.D. is always in my heart. 

[phosit]

There is an example in "binaries/data/mods/test.scriptinterface/module/modified/".

In your example you would write a file "mainmenu~local_rating.append.js".

In that file you can override the init-fuction or anything else.

init = function()
{
	// new init code.
}

 

[Mentula]

@phosit try creating a file gui/pregame/mainmenu~MyMod.append.js with any content; this file is not loaded. Or do you get a different outcome? 

[phosit]

With "any content" do you mean "no content"? Then that's expected. An empty file shouldn't change the behaviour. eg: appending nothing to the mainmenu.js doesn't change anything.

When adding a `warn` call at global scope of the "append" file, it works for me.

[Mentula]

@phosit right, I was too quick. So, what works and what does not:

✔ gui/pregame/mainmenu~MyMod.append.js

✖ gui/pregame/mainmenu~MyMod.js

The second approach has worked in all versions prior 28 - and this was "the" established practice, as far as I could see. It looks like the "append" keyword has a special meaning for evaluation of files (I tried with other keywords). Then I have two questions:

1. Should modders be advised to rename all files of the form "module~MyMod.js" with "module~MyMod.append.js"?
2. If so, could this be explicited somewhere? Probably not so relevant here https://gitea.wildfiregames.com/0ad/0ad/wiki/PortA27ToR28, but it would have helped.

[Grapjas]

I was dabbling into this too. In my case i simply needed an extra main menu button, doing 

let grapejuice =  {
        "caption": translate("Grapejuice Info"),
        "tooltip": translate("View the changes that this mod brings to the game."),
        "onPress": () => {
            Engine.OpenChildPage("page_grapejuice.xml");
        }
    };

mainMenuItems.unshift(grapejuice)

into `MainMenuItems~grapejuice.append` Seems to be clean and works well if i do the same in another mod. However if the variable name is the same in some other mod it will hardcrash on startup. Even if you let the variable out of it and just do 

mainMenuItems.unshift
(
    {
        "caption": translate("Grapejuice Info"),
        "tooltip": translate("View the changes that this mod brings to the game."),
        "onPress": () => {
            Engine.OpenChildPage("page_grapejuice.xml");
        }
    }
)

in 2 different mods it will hardcrash aswell. Not sure why and if this the recommended way of doing it anyway.

Edited 16 minutes ago by Grapjas