Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
1.19.x
1.18.x
Platforms
Supported environments
Creators
Details
Licensed MIT
Published 3 years ago
Updated 3 weeks ago
Changelog
3.1.6
- Split 1.21.5-7 build into 1.21.5, 1.21.6-7 builds
3.1.5
- Update to 1.21.11
- Update configurable
3.1.4
- Use lenient UUID codec to fix occasional crashes
3.1.3
- Fix injection failure in 1.21.10 (#154)
3.1.2
- Fix configurable dep
3.1.1
- Update to 1.21.10
3.0.3
- Update deps
3.0.2
- Add 1.21.5-7 Jar as cannot use intermediary from 1.21.1 jar for 1.21.5+
3.0.1
- Fix 1.21.2+ support in 1.21.1 jar (#148)
- Update configurable to 3.2.2
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 doesCopy Crash: Copies the cause of the ticking exception to your clipboardTeleport: Teleports you to the location of the ticking entityTry Resume: Attempts to resume the ticking of the ticking entityKill: Immediately kills and removes the ticking entityReport(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 entityblock_entity: Resumes the ticking of the block entity at the specified positionblock_state: Resumes the ticking of the block state at the specified positionitem_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 trackedpos: 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_leveloption that replacesbroadcast_errorsoperators(default) - Only operators will receive the broadcasteveryone- Everyone will receive the broadcastdisabled- 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 -1will 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
Dependencies
Files
Metadata
Release channel
ReleaseVersion number
3.1.7Loaders
Game versions
1.21.1–1.21.4Environment
Client and server, best when installed on both
Downloads
1297Publication date
December 29, 2025 at 6:00 PMPublisher
Bawnorton
Owner



