feat(LuaEngine/GlobalMethods): add GetGossipMenuOptionLocale, GetMapEntrance

[iThorgrim]

This pull request introduces 2 new methods in mod-Eluna, enabling developers to retrieve specific localized gossip_menu option and box_text, get map entrance position.

New Methods

1. GetMapEntrance: Returns the entrance position (x, y, z, o) for a specified map ID.
2. GetGossipMenuOptionLocale: Retrieves the localized OptionText and BoxText for a specific gossip menu option. Falls back to the default text if the specified locale is unavailable.

Code Highlights

Example: Get Localized Gossip Text

local optionText, boxText = GetGossipMenuOptionLocale(1, 2, 3)
print(optionText, boxText)

Example: Retrieving Map Entrance position

local x, y, z, o = GetMapEntrance(571)
print(x, y, z, o)

Test performed :

local function OnPlayerLogin(event, player)
    local optionText, boxText = GetGossipMenuOptionLocale(10084, 0, 0)
    print("Option Menu Locale", optionText, boxText)

    optionText, boxText = GetGossipMenuOptionLocale(10084, 0, 2)
    print("Option Menu Locale", optionText, boxText)

    local x, y, z, o = GetMapEntrance(615)
    print("Map Entrance Position", x, y, z, o)

    player:Teleport(615, x, y, z, o)
end
RegisterPlayerEvent(3, OnPlayerLogin)

Results:

Desktop.2025-01-24.18-46-10.mp4