AnyMAL MB.
What is it?
Menu Builder allows you to build menus without care about item indexes, formatting, page navigation, also allows to share menus, so other plugins can hold positions in your menu for their items.
How to obtain menu handle.
First, declare cell for MB's handle:
Code:
new MBH:mymenu_handle
And then register new handle during IPM-init:
Code:
mymenu_handle = anymal_mb_register(true)
How to build usual menu.
Notify AnyMAL MB that you want to show your menu:
Code:
anymal_mb_show(mymenu_handle, player)
Then watch for requestion forward, you must accept your menu and set some params during response:
Code:
public anymal_mb_requested(MBH:handle, player, page)
{
if(handle != mymenu_handle)
return
anymal_mb_accept("My menu", "choose something please :)", 2, false)
}
If you accepted your menu (otherwise it will be not shown), next forward will be broadcasted, where you update your menu items or whole pages:
Code:
public anymal_mb_item_shown(MBH:handle, player, item, menuitem, page)
{
if(handle != mymenu_handle)
return
if(menuitem == 1)
anymal_mb_update_item("Give me candy")
else
if(menuitem == 2)
anymal_mb_update_item("Explode me")
}
How to build injection-enabled menu.
If you plan to allow others to inject into your menu, you must at least give them your handle. For example, in
mymod.inc:
Code:
// my menu offers you slots for your items
native MBH:mymod_mymenu()
And then in
mymod.sma:
Code:
public MBH:_mymenu()
{
return mymenu_handle
}
At this point, your menu becomes injectable, or "public" menu. Next steps are identical to usual menus, excepting 2 things:
1. do
not hook anymal_mb_item_shown forward
2. call anymal_mb_injections to get number of items/pages, injected into your menu, and pass that value to anymal_mb_show:
Code:
anymal_mb_accept("My menu", "choose something please :)", anymal_mb_injections(mymenu_handle), false)
If you plan to place some your own items in your public menu, you need to inject them just like any 3rd-party plugin does it.
How to inject items in public menu.
First, you need to obtain and save menu handle:
Code:
othermenu_handle = othermod_menu()
Then get injection index(es):
Code:
option_1_injin = anymal_mb_inject(othermenu_handle)
option_2_injin = anymal_mb_inject(othermenu_handle)
option_3_injin = anymal_mb_inject(othermenu_handle)
Update them in corresponding forward:
Code:
public anymal_mb_item_shown(MBH:handle, player, item, menuitem, page)
{
if(handle != mymenu_handle)
return
if(item == option_1_injin)
anymal_mb_update_item("Skills")
else
if(item == option_2_injin)
anymal_mb_update_item("Shop")
else
if(item == option_3_injin)
anymal_mb_update_item("Help")
}
About navigation.
If you registered your menu handle with navigation, menu item #8 and #9 will be reserved for "Back" and "Next". Menu item #10 (assigned to zero button) always reserved for "Exit".
Related files.
anymal_mb*
Notes- Use IPM if you plan to use this API during initiallization time.
__________________
Linear Mode
