HardcoreLogOff

🌍 Server Side only mod 🌍

✔️ You can install/uninstall this mod whenever you like, it won't affect your world.

🤖 Mod created with AI 🤖

⚙️ For Players

• Disconnecting doesn’t make nearby mobs instantly disappear.
• When you log back in, creatures that were close to you may still be around.

⚔️ Combat Logout Protection

• Disconnecting is no longer an instant escape from danger.
• When an eligible player disconnects, HardcoreLogOff keeps their character temporarily present in the world.
• By default:
• LogoutBodyDurationSeconds = 10
• This means that disconnecting does not immediately protect the player from nearby enemies.
• During this period, the logout body remains physically present and vulnerable.

The logout body preserves

• Player appearance
• Player identity
• Position
• Orientation
• Movement / velocity
• Falling state
• Current health state

If a player disconnects while falling, the logout body continues with the player's existing movement instead of being frozen in the air.

🛠️ For Server Admins

• The mod currently operates entirely in memory (no disk persistence).

• Snapshots are automatically taken when a player disconnects and restored when someone re-enters the same area.

• Should be compatible with large servers — no noticeable lag spikes during capture or restore.

• Server logs display detailed zone and snapshot events for debugging or fine-tuning.

• Note: All snapshots are lost when the server restarts.

• Compatibel whether "PassTimeWhenEmpty" is enabled or disabled.

🚧 Development Notes

• This is an early version, tested so far only on a small 3-player server.
  Future updates will include:

• ✅ Scheduled hard-saves at defined times (e.g. before automatic restarts).

• ✅ Post-restart restoration of saved snapshots.

📜 Disclaimer

• This mod is experimental and designed for enthusiasts who want a more immersive, unforgiving world.
  Use it at your own risk — feedback and reports are welcome to help refine the next versions.
  
  

🔧Config file :

• Spoiler!
  📜 Default configuration (HardcoreLogOffConfig.json)

  You can add custom creatures too.

  {
    "ConfigVersion": "2.3.1",

    // ============================================================
    // MOB SNAPSHOT / RESTORATION
    // ============================================================

    "ZoneSizeBlocks": 128,
    // Size in blocks of the logical zones used to group mob snapshots.
    // Smaller values provide more precise zone separation.
    // Larger values reduce the number of zones that need to be tracked.
    // Allowed range: 32 - 1024.

    "CaptureRadiusBlocks": 48,
    // Radius in blocks around a disconnecting player in which eligible
    // creatures are captured into the snapshot.
    // Allowed range: 8 - 256.

    "SnapshotTtlMinMinutes": 120,
    // Minimum lifetime of a mob snapshot, in real minutes.
    // The actual expiration time is randomly selected between
    // SnapshotTtlMinMinutes and SnapshotTtlMaxMinutes.
    // Set Min and Max to the same value for a fixed lifetime.
    // Allowed range: 1 - 10080 minutes.

    "SnapshotTtlMaxMinutes": 360,
    // Maximum lifetime of a mob snapshot, in real minutes.
    // Must be equal to or greater than SnapshotTtlMinMinutes.
    // 10080 minutes = 7 days.

    "UseMaxMobs": true,
    // Enables the maximum number of creatures stored in one snapshot.
    // true  = MaxMobsSave is enforced.
    // false = the snapshot is not limited by MaxMobsSave.

    "MaxMobsSave": 60,
    // Maximum number of eligible creatures stored in one snapshot
    // when UseMaxMobs is enabled.
    // Allowed range: 1 - 1000.

    "RestoreDelayMsAfterJoin": 150,
    // Delay in milliseconds before attempting mob restoration after
    // a player has fully joined the world.
    // Gives the surrounding world/chunks a short time to become ready.
    // Allowed range: 0 - 10000 ms.

    "KeepPinnedAfterRestoreMs": 1500,
    // Amount of time, in milliseconds, that the relevant world area
    // remains temporarily pinned after a restoration operation.
    // Helps prevent restored entities from immediately losing their
    // required loaded area.
    // Allowed range: 0 - 30000 ms.

    "RestoreExactInstances": true,
    // Attempts to restore the exact creatures recorded in the snapshot
    // instead of merely spawning equivalent replacements.
    //
    // HardcoreLogOff preserves the information required to reproduce
    // the original entity as accurately as possible, including its
    // entity type and saved state.
    //
    // Recommended: true.

    "PreserveOriginalPosition": true,
    // Restores creatures at their recorded positions from the snapshot.
    //
    // true  = use the saved original position.
    // false = exact original positioning is not enforced.
    //
    // Recommended: true.

    "SavePrefixes": [
      "drifter",
      "shiver",
      "bowtorn",
      "locust",
      "bell"
    ],
    // Entity code prefixes that HardcoreLogOff is allowed to capture.
    //
    // Only matching creatures inside CaptureRadiusBlocks are considered.
    // Additional vanilla or modded creatures can be added here.
    //
    // Example:
    // "wolf",
    // "bear"

    "ExcludePrefixes": [
      "locust-hacked"
    ],
    // Entity code prefixes that must NEVER be captured/restored.
    //
    // Exclusions take priority over SavePrefixes.
    //
    // Example:
    // If "locust" is in SavePrefixes but "locust-hacked" is here,
    // hacked locusts remain excluded.

    "VerboseLogging": false,
    // Enables detailed server-side logging for the mob snapshot system.
    //
    // Useful for debugging captures/restorations and checking which
    // creatures are being processed.
    //
    // Recommended for normal servers: false.

  
    // ============================================================
    // COMBAT LOGOUT BODY
    // ============================================================

    "EnableCombatLogoutBody": true,
    // Enables the combat-logout body system.
    //
    // When an eligible player disconnects, HardcoreLogOff temporarily
    // keeps a representation of that player in the world instead of
    // allowing disconnection to instantly remove them from danger.
    //
    // The body remains vulnerable to the world during the configured
    // protection period.
    //
    // No duplicate player inventory is created by this system.

    "LogoutBodyDurationSeconds": 10,
    // Number of seconds the logout body remains active after the player
    // disconnects while it is still alive.
    //
    // Example:
    // 10 = the disconnected player remains vulnerable for 10 seconds.
    //
    // Setting this to 0 effectively disables the active-body duration.
    // Allowed range: 0 - 60 seconds.

    "IgnoreCreativePlayers": true,
    // true = players in Creative mode do not receive a logout body.
    // false = Creative players are also processed by the system.
    //
    // Recommended: true.

    "IgnoreSpectatorPlayers": true,
    // true = players in Spectator mode do not receive a logout body.
    // false = Spectator players are also processed.
    //
    // Recommended: true.

    "VerboseCombatLogoutLogging": false
    // Enables detailed server logs specifically for the combat-logout
    // system.
    //
    // Useful while testing body creation, removal, damage/death state
    // and reconnect reconciliation.
    //
    // Recommended for normal operation: false.
  }