File information

Last updated

Original upload

Created by

BUTR Team

Uploaded by

Aragas

Virus scan

Safe to use

About this mod

Adds Discord Rich Presence support for the game!

Requirements
Permissions and credits
Mirrors
Changelogs
Sources available at GitHub!

Adds Discord Rich Presence support for the game! Inspired by one of the first mods on NexusMods, Discord RP for Bannerlord!

Full translation support as expected from BUTR mods!
Settings are available via MCM!

You can also enable mod sharing in Options that will add a fancy button on the bottom of your profile, opening it will give you an URL in format `https://modlist.butr.link/d29ee27c-5f08-4a53-b4ae-231a76d5e404` that will contain your game version and the list of enabled mods! The url will be available for 8 hour since the start of your game!
Some commentary about this feature. At the start of the game when the option is enabled or when saving with the enabled option, the module will send to `https://modlist.butr.link` the game version and the mod list and obtain a link that lives 8 hours that will show you the info. This is done this way because Discord has a limit on the URL length and we can't put the info inside the URL via the query params, so we have a quick lived backend server that stores this info.
Because the Module is open-sourced, even if our server dies after some years, we have the backend available for anyone to host and setup the module again with the feature!

The game supports basic states:
  • Main Menu
  • Loading
  • Custom Battles
  • Campaign:
  • Traveling near a settlement
  • Conversation with someone
  • At Settlement
  • In Settlement (Mission)
  • In Battle (simulation and not) with troop count. Attacking/Defending. Raid, Siege, Forcing* are all supported

For Modders
Other mods can use this module to set their own presence:
Note that you can use this code even if Bannerlord.DiscordRichPresence is not enabled by user, the actions will be skipped.
ButterLib's DynamicAPI
internal static class DiscordRichPresenceAPI
{
private static readonly Action<string, DateTime?, DateTime?, bool>? SetPresenceMethod =
DynamicAPIProvider.RequestAPIMethod<Action<string, DateTime?, DateTime?, bool>>("Bannerlord.DiscordRichPresence", "SetPresence");
private static readonly Action<bool>? SetPreviousPresenceMethod =
DynamicAPIProvider.RequestAPIMethod<Action<bool>>("Bannerlord.DiscordRichPresence", "SetPreviousPresence");

public static void SetPresence(string details, DateTime? start, DateTime? end)
{
if (SetPresenceMethod != null)
{
SetPresenceMethod(details, start, end, true);
}
}
public static void SetPreviousPresence()
{
if (SetPreviousPresenceMethod != null)
{
SetPreviousPresence(true);
}
}
}

Reflection and Harmony
internal static class DiscordRichPresenceAPI
{
private static readonly Action<string, DateTime?, DateTime?, bool>? SetPresenceMethod =
AccessTools.Method("Bannerlord.DiscordRichPresence.DynamicAPI:SetPresence") is { } method
? AccessTools.MethodDelegate<Action<string, DateTime?, DateTime?, bool>>(method)
: null;
private static readonly Action<bool>? SetPreviousPresenceMethod =
AccessTools.Method("Bannerlord.DiscordRichPresence.DynamicAPI:SetPreviousPresence") is { } method
? AccessTools.MethodDelegate<Action<bool>>(method)
: null;

public static void SetPresence(string details, DateTime? start, DateTime? end)
{
if (SetPresenceMethod != null)
{
SetPresenceMethod(details, start, end, true);
}
}
public static void SetPreviousPresence()
{
if (SetPreviousPresenceMethod != null)
{
SetPreviousPresence(true);
}
}
}