MumbleLink (Memory Shared File)

[HezkoreParticipant]

Mumble is a VOIP application with positional sound.
Games that support Mumble creates something called a MumbleLink, which is a shared memory file.
That file includes lots of information, such as avatar/camera position, rotation, name, map etc.
Mumble then uses that file to track your location in the game world.
The following code lets you too read that shared file, and get all the juicy information from it!
You could use it to create things like external map viewers for your favorite game, or “event schedules” for MMO’s etc.

For example, Guild Wars 2 uses this to share a lot of player information, like team, profession and all that:
https://wiki.guildwars2.com/wiki/API:MumbleLink#Usage_in_Guild_Wars_2

You’ll need this mumble.h file:

C++

#include <windows.h> struct LinkedMem { UINT32 uiVersion; DWORD uiTick; float fAvatarPosition[3]; float fAvatarFront[3]; float fAvatarTop[3]; wchar_t name[256]; float fCameraPosition[3]; float fCameraFront[3]; float fCameraTop[3]; wchar_t identity[256]; UINT32 context_len; unsigned char context[256]; wchar_t description[2048]; }; static LinkedMem *lm = NULL; static void initMumble() { // HANDLE hMapObject = OpenFileMappingW(FILE_MAP_ALL_ACCESS, FALSE, L"MumbleLink"); HANDLE hMapObject = CreateFileMappingW(INVALID_HANDLE_VALUE, NULL, PAGE_READWRITE, 0, sizeof(LinkedMem), L"MumbleLink"); if (hMapObject == NULL) return; lm = (LinkedMem *) MapViewOfFile(hMapObject, FILE_MAP_ALL_ACCESS, 0, 0, sizeof(LinkedMem)); if (lm == NULL) { CloseHandle(hMapObject); hMapObject = NULL; return; } }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

#include <windows.h> struct LinkedMem { UINT32 uiVersion; DWORD uiTick; float fAvatarPosition[3]; float fAvatarFront[3]; float fAvatarTop[3]; wchar_t name[256]; float fCameraPosition[3]; float fCameraFront[3]; float fCameraTop[3]; wchar_t identity[256]; UINT32 context_len; unsigned char context[256]; wchar_t description[2048]; }; static LinkedMem *lm = NULL; static void initMumble() { // HANDLE hMapObject = OpenFileMappingW(FILE_MAP_ALL_ACCESS, FALSE, L"MumbleLink"); HANDLE hMapObject = CreateFileMappingW(INVALID_HANDLE_VALUE, NULL, PAGE_READWRITE, 0, sizeof(LinkedMem), L"MumbleLink"); if (hMapObject == NULL) return; lm = (LinkedMem *) MapViewOfFile(hMapObject, FILE_MAP_ALL_ACCESS, 0, 0, sizeof(LinkedMem)); if (lm == NULL) { CloseHandle(hMapObject); hMapObject = NULL; return; } }

And here’s the Monkey 2 wrapper for it, which I call “mumble.monkey2”:

Monkey

Namespace mumble #Import "mumble.h" Extern Struct LinkedMem Field uiVersion:UInt Field fAvatarPosition:Float[] Field fAvatarFront:Float[] Field fAvatarTop:Float[] Field fCameraPosition:Float[] Field fCameraFront:Float[] Field fCameraTop:Float[] Field name:String Field identity:String Field context_len:Int Field context:UByte[] Field description:String End Function initMumble_C:Void()="initMumble" Function updateMumble_C:Void()="updateMumble" Global lm:LinkedMem Ptr Public Global link:LinkedMem Function InitMumble:Int() initMumble_C() If lm Then link=lm[0] Return 1 Else Return 0 Endif End Function UpdateMumble() If lm Then link=lm[0] End

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42

Namespace mumble   #Import "mumble.h"   Extern Struct LinkedMem Field uiVersion:UInt Field fAvatarPosition:Float[] Field fAvatarFront:Float[] Field fAvatarTop:Float[] Field fCameraPosition:Float[] Field fCameraFront:Float[] Field fCameraTop:Float[] Field name:String Field identity:String Field context_len:Int Field context:UByte[] Field description:String End Function initMumble_C:Void()="initMumble" Function updateMumble_C:Void()="updateMumble" Global lm:LinkedMem Ptr Public   Global link:LinkedMem   Function InitMumble:Int() initMumble_C() If lm Then link=lm[0] Return 1 Else Return 0 Endif End   Function UpdateMumble() If lm Then link=lm[0] End

You use it by first calling InitMumble()
Then call UpdateMumble() as you want new information. (every frame)
You then use the Global link variable to check avatar/cameras position, rotation, name, map etc.

Super basic example of usage:

Monkey

#Import "<std>" #Import "<mojo>" #Import "<mojox>" Using std.. Using mojo.. Using mojox.. #Import "mumble" Using mumble.. Class MyWindow Extends Window Method New() Super.New( "Simple Mojo Gui App",640,480,WindowFlags.Resizable ) InitMumble() End Method OnRender( canvas:Canvas ) Override App.RequestRender() UpdateMumble() Print link.fAvatarPosition[0]+", "+link.fAvatarPosition[1]+", "+link.fAvatarPosition[2] End End Function Main() New AppInstance New MyWindow App.Run() End

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

#Import "<std>" #Import "<mojo>" #Import "<mojox>"   Using std.. Using mojo.. Using mojox..   #Import "mumble" Using mumble..   Class MyWindow Extends Window Method New() Super.New( "Simple Mojo Gui App",640,480,WindowFlags.Resizable ) InitMumble() End Method OnRender( canvas:Canvas ) Override App.RequestRender() UpdateMumble() Print link.fAvatarPosition[0]+", "+link.fAvatarPosition[1]+", "+link.fAvatarPosition[2] End End   Function Main() New AppInstance New MyWindow App.Run() End

[Author]

Posts