Sepals

An extremely radical and experimental optimization for Minecraft server performances.

We recommended using Sepals with lithium and async to make the best performances.

Compatibility

Currently, sepals are compatible with almost all mods (if no new issue opened).

Here is the verified mod list with the latest Sepals version:

Target mod Required target version sodium all iris all ferritecore all krypton all lithium >=0.18.0 c2me-fabric >=0.3.4.0.0 moonrise-opt >=0.6.0-beta.1+45edfd7 async >=0.1.7+alpha.7-1.21.8

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 testing on different platforms has different results, please use configurations to disable Sepals features or Async features to test, find which is more worthwhile if you want to use both together.

Sepals feature related: enableSepalsEntitiesCramming.

Config

Config name Allowed value Default value forceEnableSepalsPoi bool value false enableSepalsVillager bool value true enableSepalsFrogLookAt bool value true enableSepalsFrogAttackableSensor bool value true enableSepalsLivingTargetCache bool value true nearestLivingEntitiesSensorUseQuickSort bool value true enableSepalsBiasedLongJumpTask bool value true enableSepalsEntitiesCramming bool value true enableSepalsItemMerge bool value true enableSepalsQuickCanBePushByEntityPredicate bool value true

Performance

A test was done in server of Mars provided by feimia, CPU: Intel i7-14700K; Game memory: 4G; OS: Ubuntu 24.04.1 LTS; Minecraft: 1.21.

Entities cramming

Use box cache to prevent too much 'getOtherEntities' calls -- Notice -- This feature was ignored scoreboard/team predicates for every sigle entity may cause unexpected behaviors This problem will not affects anything in vanilla(survival and creative) it only things to consider when game servers that using command blocks -- Status -- Default enabled

1390 villagers cramming in a 7x7 space:

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 %

Weighted random

Use binary search to replaced vanilla weight random -- Warning -- This feature may not provided good optimization because it was proved by spark that slower than vanilla when constructing range table even if the binary search almost close to 0ms -- Status -- Default disabled -- Warining -- Not tested.

Biased long jump task

Use sepals long jump task impletation to replaced vanilla impletation As mentioned above, the binary search is almost no costs sepals impletation will construct the range table at the same time as generating targets and used Catheter to replaced java stream The same time, rearrange should jump conditions in frog brain, make a good performance -- Notice -- This feature is unable to change in game runtime required restart the server to apply changes -- Status -- Default enabled

800 frogs cramming in a 7x7 space:

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

Quick sort supports by fastutil to replace java tim sort -- Status -- Default enabled

800 frogs cramming in a 7x7 space:

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

Rearrange the attackable conditions let less costs predicate running first reduce the probability of high-costs calculating -- The complaints -- Mojang's attackable predicate is: !entity.getBrain().hasMemoryModule(MemoryModuleType.HAS_HUNTING_COOLDOWN) && Sensor.testAttackableTargetPredicate(entity, target) && FrogEntity.isValidFrogFood(target) && !this.isTargetUnreachable(entity, target) && target.isInRange(entity, 10.0) in this case, 'Sensor#testAttackableTargetPredicate' has calls 'TargetPredicate#test' that cause a very lots raycast calculate when entities too much in the area but... minecraft's raycast is absolutely bad, very slow the 'TargetPredicate#test' in this case (800 frogs) has make 9.8ms costs in once game tick among them, 'BlockView.raycast' contributed 7.3ms then i make it be: FrogEntity.isValidFrogFood(target) && entity.getBrain().hasMemoryModule(MemoryModuleType.HAS_HUNTING_COOLDOWN) && target.isInRange(entity, 10.0) && Sensor.testAttackableTargetPredicate(entity, target) && isTargetUnreachable(entity, target); the 'isValidFrogFood' is simple conditions, check the entity's tag has in 'frog_food' and a extra check when entity is slime then skip it when it size not 1 the 'isInRange' and 'hasMemoryModule' also simple, it only a few math calculates -- Status -- Default enabled

800 frogs cramming in a 7x7 space:

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

Use 'SepalsLivingTargetCache' to improves target search performance Required enable the SepalsLivingTargetCache to apply this feature, otherwise not difference to vanilla -- Notice -- The raycast is in TargetPredicate test at the 'findFirst' in LivingTargetCache when input predicate is success but if subsequent conditions is failures, then to calculate this anymore is ueless because even if the findFirst has found (raycast success) but we don't used this result in subsequent contexts -- Status -- Default enabled

800 frogs cramming in a 7x7 space:

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 %

Villager miscellaneous optimizations

Listed what sepals to do here: 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 -- Notice -- Recommend use this feature with lithium and c2me to make best performance -- Warning -- Not long-term stability tested, only a month running shown it's ok currently this feature does not be proved 100% vanilla also it does not be proved has not vanilla in statistical significance -- Status -- Default enabled

800 villagers cramming in a 7x7 space 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 %

800 villagers cramming in a 7x7 space 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 %

Predicate optimization

1172 frogs cramming in a 3x3 space:

Environment time Percent(Avg.) Vanilla (java.util.function.Predicate.lambda\$and\$0()) 49.01 ms 100 % With Sepals (com.github.cao.awa.sepals.entity.predicate.SepalsEntityPredicates$$Lambda/0x000002d8f116e000.test()) 22.6 ms 46 %