Mods and Consoles/Body - Revision history

Xarkanoth at 19:37, 19 September 2025

2025-09-19T19:37:01Z

Xarkanoth at 19:35, 19 September 2025

2025-09-19T19:35:10Z

Xarkanoth: Created page with "== AGS Foreword == Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross-platform play. Players on both consoles cannot load mods..."

2025-09-19T19:34:05Z

Created page with "== AGS Foreword == Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross-platform play. Players on both consoles cannot load mods..."

New page

== AGS Foreword ==
Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross-platform play.

Players on both consoles cannot load mods. Unity on consoles uses IL2CPP (ahead-of-time, AOT), which prevents loading our Mono-based mods (just-in-time, JIT) at runtime. The Steam Workshop — which delivers mods on Steam — is also unavailable on consoles.

Beyond the technical blockers, we must comply with '''strict''' platform policies. There’s a reason mod support is rare on consoles. Designing a single system that ticks '''all the boxes''' on '''all platforms''' isn’t feasible — ''for now'' — as our modding was built for Steam.

I know that’s disappointing for modders who poured hours and heart into their work. As someone who started as a modder, I feel you — and you deserve the straight answer.

''Walki, Lead Developer''

== Server Platforms ==
This prepares community server admins for the console release. '''Warning: Misconfigured servers will eject console players mid-game.'''

Set your '''preferred''' server platform with the global config command:

<pre class="hf-code"><nowiki>
server_platform None # Default; cross-play ON
server_platform Steam
server_platform Xbox
server_platform PSN
</nowiki></pre>

If the server becomes cross-play incompatible, it will force-change <code>server_platform</code>, '''eject''' any console players, and hide itself from the console server browser. This can happen when loading or reloading (<code>rc fileReloader</code>) the config, and when loading mods (a mod’s type is only known after it’s loaded).

{| class="wikitable" style="text-align:center;"
|-
| '''Cross-play Compatible''' [[File:Crossplay Compatible Server.png|750px]] Any platform (Steam, Xbox, PlayStation) can connect if players have cross-play enabled in their game settings.
| '''Steam Only''' [[File:Steam Only Server.png|750px]] Visible only to Steam players. Happens when the server is or becomes cross-play incompatible (mods, etc.). This will '''EJECT''' and then reject console players.
|-
| '''Xbox Only''' [[File:Xbox Only Server.png|750px]] Visible only to Xbox players with cross-play disabled. Rejects other platforms.
| '''PlayStation Only''' [[File:PlayStation Only Server.png|750px]] Visible only to PlayStation players with cross-play disabled. Rejects other platforms.
|}

== Server Config Cross-Play Compatibility Table ==
Check your server config for the following commands and align them with your target <code>server_platform</code>:

{| class="wikitable" style="text-align:center;"
|-
! !! Steam & SteamDeck !! Xbox & PlayStation !! Cross-play Compatible
|-
| objects_override [any] || ✅ || ✅ || ✅
|-
| capture_point_override [any] || ✅ || ✅ || ✅
|-
| spawn_override [any] || ✅ || ✅ || ✅
|-
| starting_weapons_selection_override [any] || ✅ || ✅ || ✅
|-
| firearm_ammo_override [any] || ✅ || ✅ || ✅
|-
| ships_spawn_detail_override [any] || ✅ || ✅ || ✅
|-
| ships_health_detail_override [any] || ✅ || ✅ || ✅
|-
| mod_variable [any] || ✅ || ✅ || ✅
|-
| mod_variable_local [any] || ✅ || ✅ || ✅
|-
| mods_installed_server_only [any] || ✅ || ✅ || ✅
|-
| mods_installed [uniform] || ✅ || ✅* || ✅
|-
| mods_installed [flag] || ✅ || ✅* || ✅
|-
| mods_installed [script]** || ✅ || ❌ || ❌
|-
| mods_installed [map]** || ✅ || ❌ || ❌
|-
| map_name ModMap*** || ✅ || ❌ || ❌
|}


<nowiki>*</nowiki> Uniform and flag mods don’t flip the server platform, but they’re only visible to Steam players. Console players will see a generic uniform/flag instead. 
<nowiki>**</nowiki> Loading a script or map mod will change <code>server_platform</code> at load time (Steam-only). 
<nowiki>***</nowiki> Setting a ModMap in your rotation immediately forces <code>server_platform</code> = Steam.


== Notes & Caveats ==
* Cross-play visibility also depends on each player’s client setting (some console users disable cross-play).
* If you’re experimenting, do it on a test server — flipping into Steam-only mid-evening will hard-kick console players.
* After edits: prefer a clean restart over live <code>rc fileReloader</code> while you’re still validating cross-play, to avoid transient ejections.

← Older revision		Revision as of 19:37, 19 September 2025
Line 1:		Line 1:
−	==AGS Foreword== Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross platform play. Players on both consoles won't be able to load mods. Unity on consoles uses IL2CPP (Ahead-of-time (AOT) compilation), which makes it impossible to load our Mono-based mods (just-in-time (JIT) compilation) at runtime. The Steam workshop, which is responsible for delivering mods to players on Steam, is also unavailable. Apart from the technical challenges, we're also forced to follow '''strict''' rules outlined by each ecosystem. There's a reason why modding support is rare on consoles. Designing a system that ticks '''all the boxes''' on '''all the platforms''' is hard. Our modding system was created for Steam and trying to bend it to the rules proved unfeasible ''for now''. I know this comes as a disappointment to all the modders who poured their hours and their hearts into their creations. As someone who started his game dev career as a modder, I feel you and felt that I at least owed you an explanation.	+	==AGS Foreword==
		+	Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross platform play.
		+
		+	Players on both consoles won't be able to load mods. Unity on consoles uses IL2CPP (Ahead-of-time (AOT) compilation), which makes it impossible to load our Mono-based mods (just-in-time (JIT) compilation) at runtime. The Steam workshop, which is responsible for delivering mods to players on Steam, is also unavailable.
		+
		+	Apart from the technical challenges, we're also forced to follow '''strict''' rules outlined by each ecosystem. There's a reason why modding support is rare on consoles. Designing a system that ticks '''all the boxes''' on '''all the platforms''' is hard. Our modding system was created for Steam and trying to bend it to the rules proved unfeasible ''for now''.
		+
		+	I know this comes as a disappointment to all the modders who poured their hours and their hearts into their creations. As someone who started his game dev career as a modder, I feel you and felt that I at least owed you an explanation.

	''Walki, Lead Developer''		''Walki, Lead Developer''

← Older revision		Revision as of 19:35, 19 September 2025
Line 1:		Line 1:
−	== AGS Foreword ==	+	==AGS Foreword== Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross platform play. Players on both consoles won't be able to load mods. Unity on consoles uses IL2CPP (Ahead-of-time (AOT) compilation), which makes it impossible to load our Mono-based mods (just-in-time (JIT) compilation) at runtime. The Steam workshop, which is responsible for delivering mods to players on Steam, is also unavailable. Apart from the technical challenges, we're also forced to follow '''strict''' rules outlined by each ecosystem. There's a reason why modding support is rare on consoles. Designing a system that ticks '''all the boxes''' on '''all the platforms''' is hard. Our modding system was created for Steam and trying to bend it to the rules proved unfeasible ''for now''. I know this comes as a disappointment to all the modders who poured their hours and their hearts into their creations. As someone who started his game dev career as a modder, I feel you and felt that I at least owed you an explanation.
−	Starting with version v3.0, PS5 and Xbox Series players will join the Holdfast community via cross-platform play.
−
−	Players on both consoles ~~cannot~~ load mods. Unity on consoles uses IL2CPP (~~ahead~~-of-time, AOT), which ~~prevents loading~~ our Mono-based mods (just-in-time, JIT) at runtime. The Steam ~~Workshop —~~ which ~~delivers~~ mods on Steam — is also unavailable ~~on consoles~~.
−
−	~~Beyond~~ the technical ~~blockers~~, we ~~must comply with~~ '''strict''' ~~platform policies~~. ~~There’s~~ a reason ~~mod~~ support is rare on consoles. Designing a ~~single~~ system that ticks '''all the boxes''' on '''all platforms''' ~~isn’t feasible —~~ ''for now'' ~~— as our modding was built for Steam~~.
−
−	I know ~~that’s disappointing for~~ modders who poured hours and ~~heart~~ into their ~~work~~. As someone who started as a modder, I feel you — and you ~~deserve the straight answer~~.

	''Walki, Lead Developer''		''Walki, Lead Developer''