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
157 lines
4.4 KiB
C++
157 lines
4.4 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>.
|
|
|
|
#define MUMBLE_ALLOW_DEPRECATED_LEGACY_PLUGIN_API
|
|
#include "../mumble_legacy_plugin.h"
|
|
|
|
#include "../mumble_positional_audio_main.h"
|
|
|
|
using namespace std;
|
|
|
|
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 state;
|
|
char ccontext[128];
|
|
|
|
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;
|
|
|
|
/*
|
|
This plugin uses the following Variables:
|
|
|
|
Address Type Description
|
|
===================================
|
|
0x0072AFD0 float Z-Coordinate
|
|
0x0072AFE0 float X-Coordinate
|
|
0x0072AFF0 float Y-Coordinate
|
|
0x0072AF3C float Horizontal view (degrees)
|
|
0x0072AF38 float Vertical view (degrees)
|
|
|
|
0x0074E380 byte Magical state value
|
|
*/
|
|
ok = peekProc(0x0074E380, &state, 1); // Magical state value
|
|
if (!ok)
|
|
return false;
|
|
/*
|
|
state value is:
|
|
0 while not in game
|
|
4 while playing
|
|
8 while spectating
|
|
|
|
This value is used for disabling pa for spectators
|
|
or people not on a server.
|
|
*/
|
|
if (state != 4)
|
|
return true; // This results in all vectors beeing zero which tells mumble to ignore them.
|
|
|
|
ok = peekProc(0x0072AFD0, avatar_pos + 2, 4) && // Z
|
|
peekProc(0x0072AFE0, avatar_pos, 4) && // X
|
|
peekProc(0x0072AFF0, avatar_pos + 1, 4) && // Y
|
|
peekProc(0x0072AF3C, &viewHor, 4) && // Hor
|
|
peekProc(0x0072AF38, &viewVer, 4) && // Ver
|
|
peekProc(0x00956D88, ccontext, 128);
|
|
|
|
if (!ok)
|
|
return false;
|
|
|
|
/*
|
|
Get context string; in this plugin this will be an
|
|
ip:port (char 256 bytes) string
|
|
*/
|
|
|
|
ccontext[127] = 0;
|
|
context = std::string(ccontext);
|
|
|
|
if (context.find(':') == string::npos)
|
|
context.append(":28960");
|
|
|
|
// Scale Coordinates
|
|
/*
|
|
Z-Value is increasing when heading north
|
|
decreasing when heading south
|
|
X-Value is increasing when heading west
|
|
decreasing when heading east
|
|
Y-Value is increasing when going up
|
|
decreasing when going down
|
|
40 units = 1 meter (not confirmed)
|
|
*/
|
|
for (int i = 0; i < 3; i++)
|
|
avatar_pos[i] /= 40.0f; // Scale to meters
|
|
avatar_pos[0] *= (-1.0f); // Convert right to left handed
|
|
|
|
avatar_top[2] = -1; // Head movement is in front vector
|
|
|
|
// Calculate view unit vector
|
|
/*
|
|
Vertical view 0° when centered
|
|
85° when looking down
|
|
275° when looking up
|
|
Decreasing when looking up.
|
|
|
|
Horizontal is 0° when facing North
|
|
90° when facing West
|
|
180° when facing South
|
|
270° when facing East
|
|
Increasing when turning left.
|
|
*/
|
|
viewVer *= static_cast< float >(M_PI / 180.0f);
|
|
viewHor *= static_cast< float >(M_PI / 180.0f);
|
|
|
|
avatar_front[0] = -sin(viewHor) * cos(viewVer);
|
|
avatar_front[1] = -sin(viewVer);
|
|
avatar_front[2] = cos(viewHor) * cos(viewVer);
|
|
|
|
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];
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
static int trylock(const std::multimap< std::wstring, unsigned long long int > &pids) {
|
|
if (!initialize(pids, L"iw3mp.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 Call of Duty 4 v1.7.568 only. No identity support yet.");
|
|
}
|
|
|
|
static std::wstring description(L"Call of Duty 4 v1.7.568");
|
|
static std::wstring shortname(L"Call of Duty 4");
|
|
|
|
static int trylock1() {
|
|
return trylock(std::multimap< std::wstring, unsigned long long int >());
|
|
}
|
|
|
|
static MumblePlugin cod4plug = { MUMBLE_PLUGIN_MAGIC, description, shortname, nullptr, nullptr, trylock1,
|
|
generic_unlock, longdesc, fetch };
|
|
|
|
static MumblePlugin2 cod4plug2 = { MUMBLE_PLUGIN_MAGIC_2, MUMBLE_PLUGIN_VERSION, trylock };
|
|
|
|
extern "C" MUMBLE_PLUGIN_EXPORT MumblePlugin *getMumblePlugin() {
|
|
return &cod4plug;
|
|
}
|
|
|
|
extern "C" MUMBLE_PLUGIN_EXPORT MumblePlugin2 *getMumblePlugin2() {
|
|
return &cod4plug2;
|
|
}
|