Sepals is a experimental optimization mod for minecraft server, aims to minimize latency in game-ticking simultaneously keeping the vanilla features unchanged. ## Installation Sepals needs Fabric API on Fabric, needs Architectury API on NeoForge, and Sepals will always following the newest version of Minecraft, please ensure you are installed the requirement mods and the Minecraft that matched to Sepals required version. ## Issues Sepals is not very stable well, a lots of potential bugs is not not yet found. So please report all not vanilla behaviors to sepals's github issues that was happening, and could attach a spark profiler result, thanks! ## Compatibility Currently, sepals are compatible to almost all mods (~~If not new issues opened~~). Here is verified mod list: | Target mod | Target mod version | Recommend target version | Sepals version | Recommend sepals version | |------------------------------------------------------:|:--------------------:|:------------------------:|:--------------:|:------------------------:| | [sodium](https://modrinth.com/mod/sodium) | all | all | all | latest | | [iris](https://modrinth.com/mod/iris) | all | all | all | latest | | [ferritecore](https://modrinth.com/mod/ferrite-core) | all | all | all | latest | | [krypton](https://modrinth.com/mod/krypton) | all | all | all | latest | | [lithium](https://modrinth.com/mod/lithium) | >=0.14.1 | latest | \>=1.0.4 | latest | | [c2me-fabric](https://modrinth.com/mod/c2me-fabric) | \>=0.3.0+alpha.0.295 | latest | \>=1.0.5 | latest | | [moonrise-opt](https://modrinth.com/mod/moonrise-opt) | \>=0.1.0-beta8 | unknown | \>=1.0.6 | latest | | [async](https://modrinth.com/mod/async) | \>=0.1.5+alpha.8-1.21.4 | unknown | \>=1.0.11 | latest | If you don't know which version to choose, please use the latest version of all the optimization mods, Sepals will ensure compatibility with them. ### Specially When Sepals work with mod [Async](https://modrinth.com/mod/async) testing on different platforms has different results, please use configurations to disable Sepals features or Async features to test which is more worthwhile if you want use both together. Sepals feature related: ```enableSepalsEntitiesCramming```. ## Performance Sepals has been tested on Intel i7-14700K, 4G RAM for java, Minecraft 1.21, there are 800 frogs cramming in a 7x7 space:

Biased long jump task

| Environment | keepRunning | Percent(Avg.) | |:-----------------------------------------------:|:-----------:|:-------------:| | Vanilla
(LongJumpTask) | 43.1 ms | 100 % | | With Lithium
(LongJumpTask) | 7.5 ms | 17 % | | With Sepals
(SepalsLongJumpTask) | 0.2 ms | 0.4 % | | With Sepals+Lithium
(SepalsLongJumpTask) | 0.05 ms | 0.1 % | | Environment | getTarget | Percent(Avg.) | Percent(in ```keepRunning```) | |:-----------------------------------------------:|:---------:|:-------------:|:-----------------------------:| | Vanilla
(LongJumpTask) | 43.1 ms | 100 % | 100 % | | With Lithium
(LongJumpTask) | 3.6 ms | 9 % | 48 % | | With Sepals
(SepalsLongJumpTask) | N/A ms | 0 % | 0 % | | With Sepals+Lithium
(SepalsLongJumpTask) | N/A ms | 0 % | 0 % |

Quick sort in NearestLivingEntitiesSensor

| Environment | sort (NearestLivingEntitiesSensor#sense) | Percent(Avg.) | |--------------------:|:----------------------------------------:|:-------------:| | Vanilla | 3.8 ms | 100 % | | With Lithium | 3.6 ms | 94 % | | With Sepals | 2.2 ms | 57 % | | With Sepals+Lithium | 2.2 ms | 57 % |

Frog attackable target filter

| Environment | time | Percent(Avg.) | |-------------------------------------------------:|:------:|:-------------:| | Vanilla (FrogAttackablesSensor#matches) | 10 ms | 100 % | | With Lithium (FrogAttackablesSensor#matches) | 5.7 ms | 57 % | | With Sepals (SepalsFrogBrain#attackable) | 0.1 ms | 1 % | | With Sepals+Lithium (SepalsFrogBrain#attackable) | 0.1 ms | 1 % |

Frog look-at target filter

| Environment | findFirst | Percent | |-------------------------------------------------------------------------------------:|:---------:|:-------:| | Vanilla
(LookAtMobWithIntervalTask$$Lambda#findFirst) | 2.7 ms | 100 % | | With Lithium
(LookAtMobWithIntervalTask$$Lambda#findFirst) | 2.5 ms | 92 % | | With Sepals
(SepalsLookAtMobWithIntervalTask$$Lambda#findFirstPlayer) | 0.1 ms | 3 % | | With Sepals+Lithium
(SepalsLookAtMobWithIntervalTask$$Lambda#findFirstPlayer) | 0.1 ms | 3 % |

and 800 villagers cramming in a 7x7 space:

Villager miscellaneous optimizations

at noon: | Environment | Brain#tick (Total) | Percent | Brain#startTasks | Percent(startTasks) | Brain#tickSensors | Percent(tickSensors) | Brain#updateTasks | Percent(updateTasks) | Brain#tickMemories | Percent(tickMemories) | |:-----------------------:|:------------------:|:-------:|:----------------:|:-------------------:|:-----------------:|:--------------------:|:-----------------:|:--------------------:|:------------------:|:---------------------:| | Vanilla | 18 ms | 100 % | 9.3 ms | 100 % | 5.2 ms | 100 % | 3 ms | 100 % | 0.5 ms | 100 % | | With lithium | 12.4 ms | 68 % | 4.8 ms | 51 % | 5.9 ms | 113 % | 1.2 ms | 40 % | 0.5 ms | 100 % | | With Sepals | 9.7 ms | 53 % | 3.6 ms | 38 % | 3.7 ms | 71 % | 2 ms | 66 % | 0.4 ms | 80 % | | With Sepals and lithium | 10 ms | 55 % | 3.4 ms | 36 % | 3.7 ms | 71 % | 2.5 ms | 83 % | 0.4 ms | 80 % | at night: | Environment | Brain#tick (Total) | Percent | Brain#startTasks | Percent(startTasks) | Brain#tickSensors | Percent(tickSensors) | Brain#updateTasks | Percent(updateTasks) | Brain#tickMemories | Percent(tickMemories) | |:-----------------------:|:------------------:|:-------:|:----------------:|:-------------------:|:-----------------:|:--------------------:|:-----------------:|:--------------------:|:------------------:|:---------------------:| | Vanilla | 16.7 ms | 100 % | 8.2 ms | 100 % | 6 ms | 100 % | 2 ms | 100 % | 0.5 ms | 100 % | | With lithium | 10.2 ms | 61 % | 3.2 ms | 24 % | 6 ms | 113 % | 0.5 ms | 25 % | 0.5 ms | 100 % | | With Sepals | 9 ms | 53 % | 3.3 ms | 16 % | 4.7 ms | 78 % | 0.7 ms | 35 % | 0.3 ms | 60 % | | With Sepals and lithium | 8.7 ms | 52 % | 2.9 ms | 11 % | 4.6 ms | 76 % | 0.7 ms | 35 % | 0.5 ms | 100 % |

and 1390 villagers cramming in a 7x7 space:

Entities cramming

| Environment | tickCramming | Percent(Avg.) | |--------------------:|:------------:|:-------------:| | Vanilla | 53.6 ms | 100 % | | With Lithium | 54.4 ms | 101 % | | With Sepals | 10.2 ms | 19 % | | With Sepals+Lithium | 8.5 ms | 15 % |

## What was it doing 1. Used Catheter to replaced java stream, The newest version Catheter has more quite stunning performance and scalability than Stream 2. Cached tasks, activities, running tasks and memories to improves starting and updating task 3. Use sepals composite task to replaced vanilla composite task 4. Whenever possible, find opportunities to skips more raycast and useless predicates 5. Use 'SepalsLivingTargetCache' to replaced vanilla cache, At the cost in sensors tick make less cost in finding interaction target or look at mob task 6. Rearranged predicates and extra lower cost predicate, The purpose of this is do higher cost predicate later or best don't do that, Skip the remaining high cost predicates in advance 7. Copied and modified 'SerializingRegionBasedStorage' optimizations from lithium 8. With more targeted task, don't use the generics to reduce useless operations 9. Used binary search list to replaced hashset search 10. Use quick sort (fastutil) to replaced tim sort (java std) 11. Precalculate and cache any useful data, avoid unnecessary repetitive calculations 12. Do more cache, space for time ## Notes 1. Sepals just try to minimizing the game-ticking latency, it won't help with network latency! 2. Sepals are currently not extensive long-term testing, occur bugs it is possible 3. Only supported Fabric and NeoForge now, no Forge, no Quilt, and no other any modloader

Async

Links

Featured versions

Project members

Details