Installation / MxF Factions
MxF Factions is built as one Java 8 bytecode jar with a runtime compatibility layer for 1.8.8 through modern Spigot/Paper targets.
Docs version
v1.0.0
Product version
1.0.0-dev
Last updated
Jul 21, 2026
# Compatibility
MxF Factions is built as one Java 8 bytecode jar with a runtime compatibility layer for 1.8.8 through modern Spigot/Paper targets.
Use:
/f compatibility
/f compatThis shows the detected server version, compatibility family, Java version, supported capabilities, and integration adapter status.
The compatibility settings generate at:
plugins/Factions/mxf/compatibility.ymlThe file reloads through:
/f reloadFor menu and MxF feature configs, prefer dual material syntax:
material: "RED_STAINED_GLASS_PANE|STAINED_GLASS_PANE:14"The first value is the modern material. The second value is the legacy fallback. The optional number after : is legacy item data for 1.8-era servers.
Sounds can use modern and legacy fallbacks:
sound: "UI_BUTTON_CLICK|CLICK"Invalid sounds are ignored with a warn-once diagnostic when enabled.
The adapter layer covers high-risk MxF surfaces such as menus, sounds, titles/actionbars, FTop materials, spawners, world heights, outpost buffs, and YAML validation.
Actual support still depends on runtime testing and compatible third-party dependency jars for the target server version. See MXF_COMPATIBILITY_TEST_MATRIX.md and MXF_REMAINING_VERSION_RISKS.md in the project root.