mirror of
https://github.com/mumble-voip/mumble.git
synced 2025-10-26 11:19:16 +00:00
This commit introduces a new plugin framework into the codebase of the Mumble client. Note that "plugin" here really refers to a (more or less) general purpose plugin and is therefore not to be confused with the previously available positional data plugins (only responsible for fetching positional data from a running game and passing that to Mumble). The plugin interface is written in C, removing the compiler-dependence the old "plugins" had. Instead plugins can now be written in an arbitrary language as long as that language is capable of being compiled into a shared library and also being capable of being C-compatible. As already indicated a plugin is essentially a shared library that provides certain functions that allow Mumble to interface with it. Inside Mumble the so-called PluginManager is responsible for managing the plugins and relaying events to the respective callbacks. Plugins themselves can also interact with Mumble on their own initiative by using the provided API functions. Fixes #2455 Fixes #2148 Fixes #1594 Fixes #2051 Fixes #3742 Fixes #4575 Fixes #4751
147 lines
4.8 KiB
C++
147 lines
4.8 KiB
C++
// Copyright 2008-2021 The Mumble Developers. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license
|
|
// that can be found in the LICENSE file at the root of the
|
|
// Mumble source tree or at <https://www.mumble.info/LICENSE>.
|
|
|
|
/*
|
|
This plugin scans the following address locations:
|
|
|
|
Address Type Description
|
|
===================================
|
|
0x013E8CF4 float X-Coordinate
|
|
0x013E8CF8 float Y-Coordinate
|
|
0x013E8CFC float Z-Coordinate
|
|
// The XYZ coordinates repeat at 0x013F79C8, 0x013F79CC, 0x013F79D0
|
|
// and seem to always hold the same values. It is not the camera vs
|
|
// character, as with third person they still hold the same values.
|
|
0x013F9E20 float Horizontal view in degree
|
|
0x013F9E1C float Vertical view in degree
|
|
0x013E8DFC byte Team; 0: not in-game (in menu etc), 1: allies, 2: axis, 3: spectator
|
|
0x009FFD30 char[40] last connected to host IP
|
|
0x010B4908 char[32] map shortname only
|
|
|
|
As reference, as help for future manual mem scanning:
|
|
0x010B48C8 char[32] map fullpath (relative to gamedir)
|
|
0x03A54C9C char[16] last download host IP (wwwdownload)
|
|
There seem to be a ton of memory addresses valid for the team value.
|
|
|
|
For position coordinates:
|
|
X-Value is increasing when heading east
|
|
decreasing when heading west
|
|
Y-Value is increasing when heading north
|
|
decreasing when heading south
|
|
Z-Value is increasing when going up
|
|
decreasing when going down
|
|
1 unit = 1 meter (not confirmed)
|
|
|
|
For the view angle values:
|
|
Vertical view 0 when centered
|
|
-90 when looking up
|
|
+90 when looking down
|
|
Increasing when looking down.
|
|
|
|
Horizontal is 90 when facing north
|
|
0 when facing east
|
|
-90 when facing south
|
|
+/-180 when facing west
|
|
Increasing when turning left.
|
|
*/
|
|
|
|
#define MUMBLE_ALLOW_DEPRECATED_LEGACY_PLUGIN_API
|
|
#include "../mumble_legacy_plugin.h"
|
|
|
|
#include "../mumble_positional_audio_main.h"
|
|
|
|
static int fetch(float *avatar_pos, float *avatar_front, float *avatar_top, float *camera_pos, float *camera_front,
|
|
float *camera_top, std::string &context, std::wstring &) {
|
|
float viewHor, viewVer;
|
|
char team;
|
|
|
|
for (int i = 0; i < 3; i++)
|
|
avatar_pos[i] = avatar_front[i] = avatar_top[i] = camera_pos[i] = camera_front[i] = camera_top[i] = 0.0f;
|
|
|
|
bool ok;
|
|
ok = peekProc(0x013E8DFC, &team, 1);
|
|
if (!ok)
|
|
return false;
|
|
|
|
// We dont use pos-audio in menus
|
|
if (team == 0 || team == 3)
|
|
return true;
|
|
|
|
ok = peekProc(0x013E8CF4, avatar_pos, 12) && // X, Y, Z
|
|
peekProc(0x013F9E20, &viewHor, 4) && // Hor-Angle
|
|
peekProc(0x013F9E1C, &viewVer, 4); // Ver-Angle
|
|
|
|
if (!ok)
|
|
return false;
|
|
|
|
avatar_top[2] = -1; // Head movement is in front vector
|
|
|
|
// Calculate view unit vector
|
|
viewVer *= static_cast< float >(M_PI / 180.0f);
|
|
viewHor *= static_cast< float >(M_PI / 180.0f);
|
|
|
|
avatar_front[0] = cos(viewVer) * cos(viewHor);
|
|
avatar_front[1] = -sin(viewVer);
|
|
avatar_front[2] = cos(viewVer) * sin(viewHor);
|
|
|
|
for (int i = 0; i < 3; i++) {
|
|
camera_pos[i] = avatar_pos[i];
|
|
camera_front[i] = avatar_front[i];
|
|
camera_top[i] = avatar_top[i];
|
|
}
|
|
|
|
// Context - concatenated server-ip, mapname and team value
|
|
char hostip[32];
|
|
char mapname[40];
|
|
ok = peekProc(0x009FFD30, hostip, sizeof(hostip)) && peekProc(0x010B4908, mapname, sizeof(hostip));
|
|
hostip[sizeof(hostip) - 1] = '\0';
|
|
mapname[sizeof(mapname) - 1] = '\0';
|
|
// Context in JSON format, {} with fields ipport (server hostname), map, and team (: int)
|
|
context = "{\"ipport\":\"" + std::string(hostip) + "\",\"map\":\"" + mapname + "\",\"team\":" + (char) (team + 0x30)
|
|
+ "}";
|
|
|
|
return true;
|
|
}
|
|
|
|
static int trylock(const std::multimap< std::wstring, unsigned long long int > &pids) {
|
|
if (!initialize(pids, L"ET.exe"))
|
|
return false;
|
|
|
|
float apos[3], afront[3], atop[3], cpos[3], cfront[3], ctop[3];
|
|
std::string context;
|
|
std::wstring identity;
|
|
|
|
if (fetch(apos, afront, atop, cpos, cfront, ctop, context, identity)) {
|
|
return true;
|
|
} else {
|
|
generic_unlock();
|
|
return false;
|
|
}
|
|
}
|
|
|
|
static const std::wstring longdesc() {
|
|
return std::wstring(L"Supports Wolfenstien: Enemy Territory v2.60b. No context or identity support yet.");
|
|
}
|
|
|
|
static std::wstring description(L"Wolfenstein: Enemy Territory v2.60b");
|
|
static std::wstring shortname(L"Wolfenstein: Enemy Territory");
|
|
|
|
static int trylock1() {
|
|
return trylock(std::multimap< std::wstring, unsigned long long int >());
|
|
}
|
|
|
|
static MumblePlugin wolfetplug = { MUMBLE_PLUGIN_MAGIC, description, shortname, nullptr, nullptr, trylock1,
|
|
generic_unlock, longdesc, fetch };
|
|
|
|
static MumblePlugin2 wolfetplug2 = { MUMBLE_PLUGIN_MAGIC_2, MUMBLE_PLUGIN_VERSION, trylock };
|
|
|
|
extern "C" MUMBLE_PLUGIN_EXPORT MumblePlugin *getMumblePlugin() {
|
|
return &wolfetplug;
|
|
}
|
|
|
|
extern "C" MUMBLE_PLUGIN_EXPORT MumblePlugin2 *getMumblePlugin2() {
|
|
return &wolfetplug2;
|
|
}
|