Feature - Mod Status API

[ItsNature]

Overview

Description:
Introduce the Mod Status API to the Mod Settings Module, allowing server developers to retrieve the current values of a player's Lunar Client mod settings.

Changes:

• Added ModSettingModule#getStatus(ApolloPlayer, Option)
• Added ApolloUpdateModOptionEvent event that is triggered when a player updates a mod option, providing the player, option, and new value.
• Added Option#get(UUID, Option) and Option#getDirect(UUID, Option).
• Bumped the apollo-protos version to 0.0.4.
• Updated the documentation for the Mod Setting module and Events to include the new features.

Code Example

// How to retrieve the current value of a mod option for a player
private final ModSettingModule modSettingModule = Apollo.getModuleManager().getModule(ModSettingModule.class);

private void printOptionStatusExample(Player player) {
    Optional<ApolloPlayer> apolloPlayerOpt = Apollo.getPlayerManager().getPlayer(player.getUniqueId());
    apolloPlayerOpt.ifPresent(apolloPlayer -> {
        boolean waypointsEnabled = this.modSettingModule.getStatus(apolloPlayer, ModWaypoints.ENABLED);
        float minimapScale = this.modSettingModule.getStatus(apolloPlayer, ModMinimap.SCALE);
        int fovDefaultFov = this.modSettingModule.getStatus(apolloPlayer, ModFov.DEFAULT_FOV);

        apolloPlayer.sendMessage(Component.text("Waypoints Enabled: ").append(Component.text(waypointsEnabled)));
        apolloPlayer.sendMessage(Component.text("Minimap Scale: ").append(Component.text(minimapScale)));
        apolloPlayer.sendMessage(Component.text("Fov Default Fov: ").append(Component.text(fovDefaultFov)));
    });
}

// How to listen for mod option updates
@Listen
private void onApolloUpdateModOption(ApolloUpdateModOptionEvent event) {
    event.getPlayer().sendMessage(Component.text(event.getOption().getKey())
        .append(Component.text(" was updated to "))
        .append(Component.text(Objects.toString(event.getValue()))));
}

---

Review Request Checklist

• Your code follows the style guidelines of this project.
• I have performed a self-review of my code.
• I have tested this change myself. (If applicable)
• I have made corresponding changes to the documentation. (If applicable)
• The branch name follows the projects naming conventions. (e.g. feature/add-module & bugfix/fix-issue)

---