HariImmersiveTrain Changelog

Update hotfix (2025-12-28)

✨ New Features

• Stationary Train Portal Crossing: Players can now walk through portals while standing on a stationary train
• Velocity-based Teleport Logic: Smart detection of train movement state
  • Moving train → Create handles atomic teleport (player stays on train)
  • Stationary train → Immersive Portals handles seamless teleport (player can walk through)

🐛 Bug Fixes

• Fixed player stuck on stationary train: Previously, players couldn't walk through portals when standing on a stopped train at portal boundary
• Server-side velocity check: Added train velocity detection to server-side teleport blocking to match client-side logic

🔧 Technical Changes

• Modified MixinPortal.java: Added trainIsMoving check to canTeleportEntity mixin
• Modified MixinServerTeleportationManager.java: Added velocity check (speed > 0.01 threshold)
• Updated StandingCheckResult.java: Added trainIsMoving field

⚠️ Known Limitations

IMPORTANT: Shader Compatibility

When using Iris/Oculus shaders, Immersive Portals automatically disables cross-portal entity rendering. This means:

• Shader OFF: Train renders fully on both sides of portal (with purple tint)
• Shader ON: Only half of the train visible (the part in your current dimension)

This is a limitation of IP + Shader compatibility, not a bug in this mod. We attempted to force-enable cross-portal rendering but it caused teleportation issues, so this limitation cannot be bypassed.

• Purple tint on train: When train spans portal boundary, the part visible through portal may have purple tint
• Recommended: For best train portal experience, disable shaders temporarily

v1.0.0 (Initial Release)

Features

• Create + Immersive Portals integration for Forge 1.20.1
• Train teleportation across dimensions via IP portals
• Display Link unlimited range (no distance limitation)
• Track rendering for cross-portal views
• Player position fix-up system after teleportation
• Automatic portal track graph refresh on player join