Gale world default config

Info

The YAML config below shows the structure and default config values of Gale's world defaults config (config/gale-world-defaults.yml)

The config bases on the latest 1.21.1 branch of Leaf

Click arrow button behind the config node to show description of it

gale-world-defaults.yml

# This is the world defaults configuration file for Gale.
# As you can see, there's a lot to configure. Some options may impact gameplay, so use
# with caution, and make sure you know what each option does before configuring.
# 
# If you need help with the configuration or have any questions related to Gale,
# join us in our Discord, or check the GitHub Wiki pages.
# 
# Configuration options here apply to all worlds, unless you specify overrides inside
# the world-specific config file inside each world folder.
# 
# Wiki: https://github.com/GaleMC/Gale/wiki
# Discord: https://discord.gg/gwezNT8c24

_version: 1
gameplay-mechanics:
  arrow-movement-resets-despawn-counter: false #(1)!
  entities-can-random-stroll-into-non-ticking-chunks: true #(2)!
  entity-wake-up-duration-ratio-standard-deviation: 0.2 #(3)!
  fixes:
    broadcast-crit-animations-as-the-entity-being-critted: false #(4)!
    keep-mooshroom-rotation-after-shearing: true #(5)!
    mc-110386: true #(6)!
    mc-121706: false #(7)!
    mc-238526: false #(8)!
    mc-31819: true #(9)!
  hide-flames-on-entities-with-fire-resistance: false #(10)!
  technical:
    load-portal-destination-chunk-before-entity-teleport: false #(11)!
  try-respawn-ender-dragon-after-end-crystal-place: true #(12)!
small-optimizations:
  load-chunks: #(13)!
    to-activate-climbing-entities: false #(14)!
    to-spawn-phantoms: false #(15)!
  max-projectile-chunk-loads: #(16)!
    per-projectile:
      max: 10 #(17)!
      remove-from-world-after-reach-limit: false #(18)!
      reset-movement-after-reach-limit: false #(19)!
    per-tick: 10 #(20)!
  reduced-intervals:
    acquire-poi-for-stuck-entity: 60 #(21)!
    check-nearby-item:
      hopper: #(22)!
        interval: 1 #(23)!
        minecart:
          interval: 1 #(24)!
          temporary-immunity: #(25)!
            check-for-minecart-near-item-interval: 20 #(26)!
            check-for-minecart-near-item-while-active: false #(27)!
            check-for-minecart-near-item-while-inactive: true #(28)!
            duration: 100 #(29)!
            max-item-horizontal-distance: 24.0 #(30)!
            max-item-vertical-distance: 4.0 #(31)!
            nearby-item-max-age: 1200 #(32)!
    check-stuck-in-wall: 10 #(33)!
    villager-item-repickup: 100 #(34)!
  save-fireworks: true #(35)!
  use-optimized-sheep-offspring-color: true #(36)!

1. Whether the despawn counter of arrows will restart when the arrow starts falling (e.g. when the block it is stuck in gets broken).

   	Default
   Recommended	Gale	Paper	Vanilla
   -	true	true	true

   Values for goals
   Optimization	false
   Vanilla behavior	true

2. Whether entities that are wandering around randomly can also pathfind into non-ticking chunks.

   	Default
   Recommended	Gale	Paper	Vanilla
   -	true	true	true

   Values for goals
   Optimization	-
   Vanilla behavior	true

3. If this value is set to any value > 0, waking up inactive entities happens spread over time, instead of many entities at once.
   This makes entities feel and behave more natural.
   
   This setting is the coefficient of variation, or σ / μ (the ratio of the standard deviation to the mean) of the inactivity duration.
   
   In other words, this setting is the value σ, so that the regular inactivity duration will be multiplied by a factor normal_distribution(μ = 1, σ).
   
   If a value ≤ 0 is given, variable entity wake-up is disabled.

   	Default
   Recommended	Gale	Paper	Vanilla
   0.2	0.2	0.0	-

   Values for goals
   Optimization	-
   Paper behavior	0.0

4. Whether to broadcast crit animations as the entity being critted.
   
   This does not affect where the crit animation is shown: it is always shown on the entity being critted.
   However, normally (if this setting is set to false), the crit animation is broadcast as the player doing the crit, meaning anyone who cannot see the player cannot see the crit.
   
   If this setting is set to true, the crit animation is broadcast as the entity being hit, meaning anyone that can see the entity can see the crit.

   	Default
   Recommended	Gale	Paper	Vanilla
   -	false	false	false

   Values for goals
   Optimization	-
   Vanilla behavior	false

5. Whether to make mooshrooms keep their rotation after being sheared (fixes part of MC-88967).

   	Default
   Recommended	Gale	Paper	Vanilla
   -	true	false	false

   Values for goals
   Optimization	-
   Vanilla behavior	false

6. Whether to fix MC-110386.

   	Default
   Recommended	Gale	Paper	Vanilla
   true	true	false	false

7. Whether to fix MC-121706.

   	Default
   Recommended	Gale	Paper	Vanilla
   true	false	false	false

8. Whether to fix MC-238526.

   	Default
   Recommended	Gale	Paper	Vanilla
   -	false	false	false

9. Whether to fix MC-31819.

   	Default
   Recommended	Gale	Paper	Vanilla
   true	true	false	false

10. Whether to hide visual flames for entities that are on fire, but also have the Fire Resistance potion effect.

    	Default
    Recommended	Gale	Paper	Vanilla
    -	false	false	false

    Values for goals
    Optimization	-
    Vanilla behavior	false

11. Whether to fully load chunks before teleporting an entity, when an entity enters a portal.
    This forces the entire server to wait for the chunk to be loaded.

    	Default
    Recommended	Gale	Paper	Vanilla
    false	false	false	false

    Values for goals
    Optimization	false
    Vanilla behavior	false

12. Whether able to attempt to respawn the ender dragon after an end crystal has been placed in one of the right positions on the fountain.

    	Default
    Recommended	Gale	Paper	Vanilla
    -	true	true	true

    Values for goals
    Optimization	-
    Vanilla behavior	true

13. Whether to load chunks at certain times.

14. Whether to load chunks to activate climbing entities.
    
    In Paper, entities, like zombies, that are "climbing" (e.g. going down a ladder) get priority to be activated.
    To check whether an entity is climbing, the block it is in must be checked.
    This can lead to the entire server having to wait for a chunk to load when an entity moves just over the edge.
    
    If this value is set to false, this is prevented: the server will not check the "climbing" priority for entities that are in unloaded chunks. This prevents unnecessary server hangs.

    	Default
    Recommended	Gale	Paper	Vanilla
    false	false	true	-

    Values for goals
    Optimization	false
    Paper behavior	true

15. Whether to load chunks to spawn phantoms.
    If this value is set to false, when the server attempts to spawn a phantom in an unloaded chunk, nothing happens.

    	Default
    Recommended	Gale	Paper	Vanilla
    false	false	true	true

    Values for goals
    Optimization	false
    Vanilla behavior	true

16. Settings for loading chunks for projectiles (e.g. when an arrow, trident or ender pearl enters an unloaded chunk).

17. The maximum number of chunks that can be synchronously loaded by a projectile throughout its lifetime.
    If a value < 0 is given, this setting is disabled: i.e. the number of chunks loaded by a projectile will be unlimited.

    	Default
    Recommended	Gale	Paper	Vanilla
    10	10	-1	-1

    Values for goals
    Optimization	10
    Vanilla behavior	-1

18. Whether to remove projectiles that cross the max threshold (described above) from the world entirely.
    
    Removing projectiles from the world is risky, because this will also affect projectiles such as tridents that are valuable to players, so it is not recommended to set this value to true unless you accept that risk.

    	Default
    Recommended	Gale	Paper	Vanilla
    false	false	false	false

    Values for goals
    Optimization	true in extreme circumstances, but this is risky
    Vanilla behavior	false

19. Whether to set the planar velocity of projectiles that cross the max threshold (described above) to 0, so that they stop attempting to cross chunk boundaries.
    
    This has no effect if remove-from-world-after-reach-limit (described above) is true.

    	Default
    Recommended	Gale	Paper	Vanilla
    -	false	false	false

    Values for goals
    Optimization	true
    Vanilla behavior	false

20. The maximum number of chunks that can be synchronously loaded by all projectiles in one world in a tick.
    
    If a value < 0 is given, this setting is disabled: i.e. the number of chunks loaded by projectiles per tick will be unlimited.

    	Default
    Recommended	Gale	Paper	Vanilla
    10	10	-1	-1

    Values for goals
    Optimization	2
    Vanilla behavior	-1

21. The extra interval (on top of the regular interval), given in ticks, for entities that are stuck (e.g. in a vehicle) to attempt to acquire a POI (such as a villager job block).
    If they become unstuck during this time, they will immediately be free to acquire a POI again.
    For example, if this value is set to 100, stuck entities will try to find a POI every 5 seconds.
    
    If a value < 0 is given, it will default to the same as Paper.

    	Default
    Recommended	Gale	Paper	Vanilla
    60	60	200	0

    Values for goals
    Optimization	200
    Vanilla behavior	0

22. Frequency with which hoppers check for items to pick up.
    This only affects picking up in-world (e.g. dropped) items, not pulling items from chests or other storage blocks.

23. Frequency, given in ticks, with which hopper blocks check for items to pick up.
    For example, if this value is set to 20, hoppers will check for items above them every second.
    
    If a value ≤ 0 is given, it will default to the same as Paper.

    	Default
    Recommended	Gale	Paper	Vanilla
    20	1	1	1

    Values for goals
    Optimization	50
    Vanilla behavior	1

24. The same as the interval setting above, but for hopper minecarts.

    	Default
    Recommended	Gale	Paper	Vanilla
    20	1	1	1

    Values for goals
    Optimization	20
    Vanilla behavior	1

25. Hopper minecarts can have temporary immunity from the interval setting above.
    While a minecart is immune, it can check for items every tick.

26. How often, given in ticks, to check for hopper minecarts near items, to give the minecarts temporary immunity from the interval setting.
    If a value ≤ 0 is given, it behaves like 1.

    	Default
    Recommended	Gale	Paper	Vanilla
    20	20	-	-

    Values for goals
    Optimization	20
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

27. Whether to check for hopper minecarts near items that are active, to give the minecarts temporary immunity from the interval setting.

    	Default
    Recommended	Gale	Paper	Vanilla
    true (setting this value to false is strongly not recommended)	false	-	-

    Values for goals
    Optimization	false
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

28. Whether to check for hopper minecarts near items that are inactive, to give the minecarts temporary immunity from the interval setting.

    	Default
    Recommended	Gale	Paper	Vanilla
    true (setting this value to false is strongly not recommended)	true	-	-

    Values for goals
    Optimization	true
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

29. The duration, given in ticks, of temporary immunity from the interval setting for hopper minecarts.
    If a value ≤ 0 is given, hopper minecarts will never have temporary immunity from the interval setting.

    	Default
    Recommended	Gale	Paper	Vanilla
    100	100	-	-

    Values for goals
    Optimization	75
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

30. The maximum horizontal distance a dropped item can be away from a hopper minecart be to give it temporary immunity from the interval setting.
    If a value < 0 is given, hopper minecarts will never have temporary immunity from the interval setting.

    	Default
    Recommended	Gale	Paper	Vanilla
    24.0	24.0	-	-

    Values for goals
    Optimization	24.0
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

31. Same as max-item-horizontal-distance, but this is the maximum distance vertically.

    	Default
    Recommended	Gale	Paper	Vanilla
    4.0	4.0	-	-

    Values for goals
    Optimization	4.0
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

32. Items with an age (given in ticks) higher than this value will not cause nearby hopper minecarts to become immune from the interval setting.
    If a value ≤ 0 is given, it means no minimum age: in other words, all items can give nearby hopper minecarts temporary immunity from the interval setting.

    	Default
    Recommended	Gale	Paper	Vanilla
    1200	1200	-	-

    Values for goals
    Optimization	600
    Vanilla behavior	- (for vanilla behavior, interval must be set to 1)

33. The interval, given in ticks, at which to check whether an entity is stuck in a wall, to deal suffocation damage.
    
    Since after dealing damage, there is an interval (this may change in the future, but approximately 1 second) at which entities cannot take repeated damage, delaying the suffocation check by less than 1 second is almost unnoticeable.
    
    For example:

    • If this value is set to 10, entities will check whether they are being suffocated every ½ second.
    • If a value ≤ 0 is given, it will default to the same as Paper.

    	Default
    Recommended	Gale	Paper	Vanilla
    10	10	1	1

    Values for goals
    Optimization	10
    Vanilla behavior	1

34. The minimum delay, given in ticks, for items dropped by villagers to be picked up by (other) entities.

    • Prevents villagers picking up farmed items before hoppers do in certain farm designs; that would otherwise be broken by the check-nearby-item.hopper setting described below.
    • Reduces lag from villagers continuously throwing many items at each other when their inventories are full.
      
      For example:
    • if this value is set to 100, entities can pick up items dropped by villagers after 5 seconds.
    • If a value < 0 is given, it will default to the same as vanilla, which is currently 10 ticks (½ second).

    	Default
    Recommended	Gale	Paper	Vanilla
    100	100	-1	-1

    Values for goals
    Optimization	100
    Vanilla behavior	-1

35. Whether fireworks are saved when saving a chunk.
    Fireworks can bug out and not detonate, and an automated launcher can very easily fill a chunk.
    If this value is set to true, chunk unloads will remove any fireworks, preventing this scenario.

    	Default
    Recommended	Gale	Paper	Vanilla
    - (See Optimization below)	true	true	true

    Values for goals
    Optimization	Normally: - (doesn't matter much) If you expect players to try to break your server: false
    Vanilla behavior	true

36. Whether to use a (much) faster way to choose a color when a new baby sheep is born.
    The color chosen is exactly the same as vanilla.
    
    However, in vanilla, it is possible to change the new color by changing the crafting recipe for combining dyes using a data pack.
    If this value is set to true, any such crafting recipe changes will be ignored.

    	Default
    Recommended	Gale	Paper	Vanilla
    true	true	false	false

    Values for goals
    Optimization	true
    Vanilla behavior	false