Mods
Resource Packs
Data Packs
Modpacks
Shaders
Plugins
Mods Resource Packs Data Packs Plugins Shaders Modpacks
Get Modrinth App Upgrade to Modrinth+
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Sign in
Settings
Neruina - Ticking Entity Fixer

Neruina - Ticking Entity Fixer

A Mod that prevents ticking-related crashes from bricking worlds

2.59M
257
Utility

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.x
1.18.x

Platforms

Fabric
Forge
NeoForge

Supported environments

Server-side

90% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Report issues View source
Donate on Ko-fi

Creators

Bawnorton
Bawnorton Owner

Details

Licensed MIT
Published 2 years ago
Updated 3 days ago
DescriptionChangelogVersions

Show all versions

1
2
15

Neruina Fabric 3.0.0 for 1.21.8

by Bawnorton on Aug 11, 2025
Download

Neruina Neoforge 3.0.0 for 1.21.8

by Bawnorton on Aug 11, 2025
Download

Neruina Fabric 3.0.0 for 1.21.1

by Bawnorton on Aug 11, 2025
Download

Neruina Neoforge 3.0.0 for 1.21.1

by Bawnorton on Aug 11, 2025
Download

3.0.0

  • Update to 1.21.8
  • LTS 1.21.1, drop other versions
  • Re-add configurable
  • Migrate to mojmaps
  • Only send actions to players that can perform those actions
  • Add Chinese (Simplified) translations #130

2.3.1

  • Fix crash in 1.21.5 related to duplicate jackson modules

2.3.0

  • Added datadriven blackist to allow mods or modpacks to opt-out specific blocks, items, entities, etc from handling or entire namespaces
  • Migrated messaging system to use permission level instead of discrete options (default: 0)
  • Put all Neruina commands under a required permission level controlled by the config (default: 2)
  • Explicitly include transitive httpclient5 dep to ensure the correct version is used at runtime
  • Allow reports to fail gracefully if an error occurs during the report process

2.2.11

  • Cache entity UUID to prevent world interaction when re-serialising ticking entries

2.2.10

  • Fix crash when shuting down before world is created (#133)
  • Prevent cause getter from crashing during serialisation (#134)

2.2.8

  • Actually fix gson crash

2.2.7

  • Fix crash when handling errors with null messages
  • No longer represent config class as a record to avoid gson issues when <2.9 gson is present

2.2.6

  • Fix cache invalidation for configurable

2.2.5

  • Remove configurable until it can be reworked

2.2.4

  • Fix 1.21+ versions accidentally using pre-1.21 config

2.2.3

  • Update configurable dep for 1.21.1

2.2.2

  • Support 1.21.3
  • Fix crash on report
  • Added a test arg to the report command to test internal functionality

2.2.0

  • Drop forge

2.1.2

  • Add dimension support to teleport action

2.1.1

  • Fix version ranges

2.1.0

  • Add Minecraft 1.21 support
  • Migrate gradle to kotlin dsl
  • Update stonecutter to 0.4
  • Fix excessive memory usage for tracking errored blockstates

2.0.0-beta.10

  • Downgrade records in 1.19.2 and below to allow java 6 gson to serialize them
  • Fix missing translation for item stack error id not found

2.0.0-beta.9

  • Fix 1.19.2 on dedicated servers

2.0.0-beta.8

  • Recompile of .7 as published versions had corruption ... I have no idea how

2.0.0-beta.7

  • Add 1.19.1-1.19.2 jar
  • Fix 1.19.1/2 compat

2.0.0-beta.6

  • Fix minecraft version deps on published builds

2.0.0-beta.5

  • Migrate to custom_data component for persistence on item stacks

2.0.0-beta.4

  • Add Russion Translations (mpustovoi)
  • Actually fix the crash on dedicated servers

2.0.0-beta.3

  • Fix crash on dedicated servers

2.0.0-beta.2

  • Fix Command Permissions

2.0.0

Changes

  • Added NeoForge support
  • New ticking suspension system:
    • Entities, block entities, block states and item stacks will no longer be killed or removed but will instead be suspended until an operator takes action.
    • This should mitigate the undesired outcome where an important or useful entity is killed.
  • Added new actions to the ticking entity broadcast
    • What Is This?: Opens the Neruina wiki page on what Neruina is and what it does
    • Copy Crash: Copies the cause of the ticking exception to your clipboard
    • Teleport: Teleports you to the location of the ticking entity
    • Try Resume: Attempts to resume the ticking of the ticking entity
    • Kill: Immediately kills and removes the ticking entity
    • Report (1.19+): Opens a new issue on the NeruinaAutoReports GitHub repository and any mods that opt-in to the reporting system
  • Persitance:
    • Ticking entity tracking will now persist across server restarts
    • When the world is first started Neruina will broadcast all tracked ticking entities that need addressing
  • Ticking Threshold:
    • When a certain number of ticking excpetions occur within a certain time frame, Neruina will deliberately crash in order to prevent the server from becoming unusable.
    • A comprehensive report will be generated with every ticking exception that occurred with instructions on what to do next.
    • The default threshold is 10 exceptions within 5 minutes, this can be changed in the config.
  • Improved performance and memory usage by delegating the ticking state to the ticking entity
  • Migrated to Stonecutter to ease multi-loader multi-version development

Auto Reports

  • Added a new system for mods to opt-in to the auto reporting system
  • See the schema here

Commands

  • These are designed to be used internally by Neruina as it is a server-side mod and allows the client messages to interact with the mod, but they are available to operators as well.
  • /neruina resume <entity|pos|player>
    • entity: Resumes the ticking of the specified entity
    • block_entity: Resumes the ticking of the block entity at the specified position
    • block_state: Resumes the ticking of the block state at the specified position
    • item_stack: Resumes the ticking of the held item of the specified player
  • /neruina kill <entity>: Immediately kills and removes the specified entity
  • /neruina id <entity|pos>
    • entity: Returns the report UUID of the specified entity if it is being tracked
    • pos: Returns the report UUID of the block entity at the specified position if it is being tracked
  • /neruina info <uuid>: Sends the error message of the specified report UUID to the player
  • /neruina clear_tracked: Clears all tracked ticking entities
  • /neruina show_suspended: Displays all suspended ticking entities
  • /neruina report <uuid> (1.19+): Automatically generates a report for the specified ticking entity via it's tracked report UUID
  • /neruina cancel_login (1.19+): Cancels the current in-progress github authentication process

Config

  • New log_level option that replaces broadcast_errors
    • operators (default) - Only operators will receive the broadcast
    • everyone - Everyone will receive the broadcast
    • disabled - No one will receive the broadcast
  • New ticking_exception_threshold
    • The number of ticking exceptions that can occur within the specified time frame before Neruina will deliberately crash
    • Default is 10
    • -1 will disable the threshold
  • New auto_kill_ticking_entities
    • If true, ticking entities will be immediately killed and removed rather than suspended
    • Default is false

Fixes

  • Fixed a crash with newer versions of Forge
  • Fixed a crash with does potato tick 1.18.2

Neruina Fabric 2.3.1-beta.1 for 1.19.2

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.1-beta.1 for 1.19.4

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.1-beta.1 for 1.20.6

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.1-beta.1 for 1.20.1

by Bawnorton on May 2, 2025
Download

Neruina Neoforge 2.3.1-beta.1 for 1.20.6

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.1-beta.1 for 1.21

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.1-beta.1 for 1.21.3

by Bawnorton on May 2, 2025
Download

Neruina Neoforge 2.3.1-beta.1 for 1.21

by Bawnorton on May 2, 2025
Download

Neruina Neoforge 2.3.1-beta.1 for 1.21.3

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.1-beta.1 for 1.21.5

by Bawnorton on May 2, 2025
Download

Neruina Neoforge 2.3.1-beta.1 for 1.21.5

by Bawnorton on May 2, 2025
Download

Neruina Fabric 2.3.0-beta.4 for 1.19.2

by Bawnorton on Apr 22, 2025
Download

Neruina Fabric 2.3.0-beta.4 for 1.19.4

by Bawnorton on Apr 22, 2025
Download

Neruina Neoforge 2.3.0-beta.4 for 1.20.6

by Bawnorton on Apr 22, 2025
Download

Neruina Fabric 2.3.0-beta.4 for 1.20.6

by Bawnorton on Apr 22, 2025
Download

Neruina Fabric 2.3.0-beta.4 for 1.20.1

by Bawnorton on Apr 22, 2025
Download
1
2
15

Modrinth is open source.

main@81b0922

© Rinth, Inc.

Company

TermsPrivacyRulesCareers

Resources

SupportBlogDocsStatus

Interact

Discord X (Twitter) Mastodon Crowdin
Get Modrinth App Settings
NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.