FEATURE: Custom Scripts Arguments Overhaul

[OcelotWalrus]

FEATURE

Summary

For starters, this PR is a part of a new wiki page guide, the Custom Scripting Guide which's an in-depth guide about custom scripting in Bane Of Wargs. This wiki page first introduces what a custom script and where they can be ran from the game data files, with an example of a custom script, then an explanation about arguments, and finally a detailed database about every functions of the game engine, for future content creators.

The PR first adds a set of new arguments you can choose from, whose goal is to be able to run any game engine function from a script; but it also adds a new feature, that allow data files to specify created arguments, with its custom value:

script name: my_script.py
arguments:
- player  # regular arguments
- zone
- custom_one: { first_key: ["hello", "hi"], second_key: true }  # a custom-made argument, that can be of any kind, as here it's a dictionary, that contains a boolean key and a list key

Usage examples

For example, let's say we wanna create a custom script that downloads the source/main.py file of this github repository. In the past, we'd make a specific script just to download that specific. So if later I'd want to download another file, another different script would be required. But now, you can just create a script, that passes an argument that can be "custom-made", so any file can be download:

[some event data]
actions:
  run scripts:
    - script 0:
      script name: download_fsspec.py
      arguments:
      - file_path: "source/main.py"
    - script 1:
      script name: download_fsspec.py
      arguments:
      - file_path: "source/battle.py"

The download_fsspec.py file:

from data_handling import temporary_git_file_download

def run(file_path):
    cout(  # print the file content to the console, but we could also save it to the player data so it could be used later if we want
        temporary_git_file_download(
            file_path, "https://github.com/Dungeons-of-Kathallion/Bane-Of-Wargs.git"
        )
    )

run(file_path)

Many other examples could be use to show the application of this new feature.

Testing Done

Everything tested.

Testing Method

You can try making your own custom script with the new wiki page guide.

Performance Impact

N/A

Check-List

• Review my own code
• Fix the workflow checks
• Finish wiki page
• Finish engine documentation

[OcelotWalrus]

Hey @lumbar527! Would you mind giving this PR a review, thanks! (it's mostly documentation)