PluginConfigs/FastAsyncWorldEdit/config.yml
2020-10-22 16:09:03 +00:00

300 lines
12 KiB
YAML

# These first 6 aren't configurable
issues: "https://github.com/IntellectualSites/FastAsyncWorldEdit/issues"
wiki: "https://wiki.intellectualsites.com/FastAsyncWorldEdit/index"
date: "Sun Nov 15 00:00:00 UTC 2020"
build: "https://ci.athion.net/job/FastAsyncWorldEdit-1.16/422"
commit: "https://github.com/IntellectualSites/FastAsyncWorldEdit/commit/f2c9ff1c"
platform: "Bukkit"
# Set true to enable WorldEdit restrictions per region (e.g. PlotSquared or WorldGuard).
# To be allowed to WorldEdit in a region, users need the appropriate
# fawe.<plugin> permission. See the Permissions page for supported region plugins.
region-restrictions: true
# FAWE will cancel non admin edits when memory consumption exceeds this %
# - Bypass with `/wea` or `//fast` or `fawe.bypass`
# - Disable with 100 or -1.
max-memory-percent: 95
# Enable or disable core components
enabled-components:
commands: true
# Disable the FAWE-PlotSquared hook to take over most intense P2 queueing
# Specific aspects can be turned on and off further below
plotsquared-hook: true
clipboard:
# Store the clipboard on disk instead of memory
# - Will be slightly slower
# - Uses 2 bytes per block
use-disk: true
# Compress the clipboard to reduce the size:
# - TODO: Buffered random access with compression is not implemented on disk yet
# - 0 = No compression
# - 1 = Fast compression
# - 2-17 = Slower compression
compression-level: 1
# Number of days to keep history on disk before deleting it
delete-after-days: 1
lighting:
# If packet sending should be delayed until relight is finished
delay-packet-sending: true
async: true
# The relighting mode to use:
# - 0 = None (Do no relighting)
# - 1 = Optimal (Relight changed light sources and changed blocks)
# - 2 = All (Slowly relight every blocks)
mode: 1
# If existing lighting should be removed before relighting
remove-first: false
# Calculate and set heightmaps when relighting
do-heightmaps: true
# Generic tick limiter (not necessarily WorldEdit related, but useful to stop abuse)
tick-limiter:
# Enable the limiter
enabled: true
# The interval in ticks
interval: 20
# Max falling blocks per interval (per chunk)
falling: 64
# Max physics per interval (excluding redstone)
physics-ms: 10
# Max item spawns per interval (per chunk)
items: 256
# Whether fireworks can load chunks
# - Fireworks usually travel vertically so do not load any chunks
# - Horizontal fireworks can be hacked in to crash a server
fireworks-load-chunks: false
web:
# Should download urls be shortened?
# - Links are less secure as they could be brute forced
shorten-urls: false
# The web interface for clipboards
# - All schematics are anonymous and private
# - Downloads can be deleted by the user
# - Supports clipboard uploads, downloads and saves
url: "https://empcraft.com/fawe/"
plotsquared-integration:
clear: true
cuboids: true
copy-and-swap: true
set-biome: true
extent:
# Don't bug console when these plugins slow down WorldEdit operations
# - You'll see a message in console if you need to change this option
allowed-plugins: []
# Should debug messages be sent when third party extents are used?
debug: true
# Experimental options, use at your own risk
# - UNSAFE = Can cause permanent damage to the server
# - SAFE = Can be buggy but unlikely to cause any damage
experimental:
# [UNSAFE] Directly modify the region files. (OBSOLETE - USE ANVIL COMMANDS)
# - IMPROPER USE CAN CAUSE WORLD CORRUPTION!
anvil-queue-mode: false
# [SAFE] Dynamically increase the number of chunks rendered
# - Requires Paper
# - Set your server view distance to 1 (spigot.yml, server.properties)
# - Based on tps and player movement
# - Note: If entities become hidden, increase the server view distance to 3
dynamic-chunk-rendering: -1
# Allows brushes to be persistent (default: true)
persistent-brushes: true
# Disable using native libraries
disable-natives: false
# [SAFE] Keep entities that are positioned in non-air blocks when editing an area
# Might cause client-side FPS lagg in some situations
keep-entities-in-blocks: false
# [SAFE] Experimental freebuild region restrictions
# - PERM: fawe.freebuild
# - PERM: fawe.freebuild.<plugin>
freebuild: false
# Other experimental features
other: false
# Allow blocks placed by WorldEdit to tick. This could cause the big lags.
# This has no effect on existing blocks one way or the other.
allow-tick-placed: false
# Force re-ticking of existing blocks not edited by FAWE.
# This will increase time taken slightly.
allow-tick-existing: true
# Do not wait for a chunk's history to save before sending it
# - Undo/redo commands will wait until the history has been written to disk before executing
# - Requires combine_stages = true
send-before-history: false
# This relates to how FAWE places chunks
queue:
# This should equal the number of processors you have
parallel-threads: 4
progress:
# Display constant titles about the progress of a user's edit
# - false = disabled
# - title = Display progress titles
# - chat = Display progress in chat
display: "title"
# How often edit progress is displayed
interval: 1
# Delay sending progress in milliseconds (so quick edits don't spam)
delay: 5000
# When doing edits that effect more than this many chunks:
# - FAWE will start placing before all calculations are finished
# - A larger value will use slightly less CPU time
# - A smaller value will reduce memory usage
# - A value too small may break some operations (deform?)
target-size: 64
# Force FAWE to start placing chunks regardless of whether an edit is finished processing
# - A larger value will use slightly less CPU time
# - A smaller value will reduce memory usage
# - A value too small may break some operations (deform?)
max-wait-ms: 1000
# Increase or decrease queue intensity (ms) [-50,50]:
# 0 = balance of performance / stability
# -10 = Allocate 10ms less for chunk placement
# Too high can cause lag spikes (you might be okay with this)
# Too low will result in slow edits
extra-time-ms: 0
# Loading the right amount of chunks beforehand can speed up operations
# - Low values may result in FAWE waiting on requests to the main thread
# - Higher values use more memory and isn't noticeably faster
preload-chunks: 32
# If pooling is enabled (reduces GC, higher memory usage)
# - Enable to improve performance at the expense of memory
pool: true
# Discard edits which have been idle for a certain amount of time (ms)
# - E.g. A plugin creates an EditSession but never does anything with it
# - This only applies to plugins improperly using WorldEdit's legacy API
discard-after-ms: 60000
# When using fastmode also do not bother to fix existing ticking blocks
no-tick-fastmode: true
history:
# Should history be saved on disk:
# - Frees up a lot of memory
# - Persists restarts
# - Unlimited undo
# - Does not affect edit performance if `combine-stages`
use-disk: true
# Use a database to store disk storage summaries:
# - Enables inspection and rollback
# - Does not impact performance
use-database: true
# Record history with dispatching:
# - Much faster as it avoids duplicate block checks
# - Slightly worse compression since dispatch order is different
combine-stages: true
# Higher compression reduces the size of history at the expense of CPU
# 0 = Uncompressed byte array (fastest)
# 1 = 1 pass fast compressor (default)
# 2 = 2 x fast
# 3 = 3 x fast
# 4 = 1 x medium, 1 x fast
# 5 = 1 x medium, 2 x fast
# 6 = 1 x medium, 3 x fast
# 7 = 1 x high, 1 x medium, 1 x fast
# 8 = 1 x high, 1 x medium, 2 x fast
# 9 = 1 x high, 1 x medium, 3 x fast (best compression)
# NOTE: If using disk, do some compression (3+) as smaller files save faster
compression-level: 3
# The buffer size for compression:
# - Larger = better ratio but uses more upfront memory
# - Must be in the range [64, 33554432]
buffer-size: 531441
# The maximum time in milliseconds to wait for a chunk to load for an edit.
# (50ms = 1 server tick, 0 = Fastest).
# The default value of 100 should be safe for most cases.
#
# Actions which require loaded chunks (e.g. copy) which do not load in time
# will use the last chunk as filler, which may appear as bands of duplicated blocks.
# Actions usually wait about 25-50ms for the chunk to load, more if the server is lagging.
# A value of 100ms does not force it to wait 100ms if the chunk loads in 10ms.
#
# This value is a timeout in case a chunk is never going to load (for whatever odd reason).
# If the action times out, the operation continues by using the previous chunk as filler,
# and displaying an error message. In this case, either copy a smaller section,
# or increase chunk-wait-ms.
# A value of 0 is faster simply because it doesn't bother loading the chunks or waiting.
chunk-wait-ms: 1000
# Delete history on disk after a number of days
delete-after-days: 7
# Delete history in memory on logout (does not effect disk)
delete-on-logout: true
# If history should be enabled by default for plugins using WorldEdit:
# - It is faster to have disabled
# - Use of the FAWE API will not be effected
enable-for-console: true
# Should redo information be stored:
# - History is about 20% larger
# - Enables use of /redo
store-redo: true
# Assumes all edits are smaller than 4096x256x4096:
# - Reduces history size by ~10%
small-edits: false
# Paths for various directories
paths:
tokens: "tokens"
# Put any minecraft or mod jars for FAWE to be aware of block textures
textures: "textures"
heightmap: "heightmap"
history: "history"
# Multiple servers can use the same clipboards
# - Use a shared directory or NFS/Samba
clipboard: "clipboard"
# Each player has his or her own sub directory for schematics
per-player-schematics: true
commands: "commands"
# Region restriction settings
region-restrictions-options:
# What type of users are allowed to WorldEdit in a region
# - MEMBER = Players added to a region
# - OWNER = Players who own the region
mode: "MEMBER"
# The "default" limit group affects those without a specific limit permission.
# To grant someone different limits, copy the default limits group
# and give it a different name (e.g. newbie). Then give the user the limit
# permission node with that limit name (e.g. fawe.limit.newbie )
limits:
default:
# Max actions that can be run concurrently (i.e. commands)
max-actions: 1
# Max number of block changes (e.g. by `//set stone`).
max-changes: 50000000
# Max number of blocks checked (e.g. `//count stone` which doesn't change blocks)
max-checks: 50000000
# Number of times a change can fail (e.g. if the player can't access that region)
max-fails: 50000000
# Allowed brush iterations (e.g. `//brush smooth`)
max-iterations: 1000
# Max allowed entities (e.g. cows)
max-entities: 1337
# Blockstates include Banner, Beacon, BrewingStand, Chest, CommandBlock,
# CreatureSpawner, Dispenser, Dropper, EndGateway, Furnace, Hopper, Jukebox,
# NoteBlock, Sign, Skull, Structure
max-blockstates: 1337
# Maximum size of the player's history in Megabytes:
# - History on disk or memory will be deleted
max-history-mb: -1
# Maximum time in milliseconds //calc can execute
max-expression-ms: 50
# Cinematic block placement:
# - Adds a delay to block placement (nanoseconds/block)
# - Having an artificial delay will use more CPU/Memory
speed-reduction: 0
# Place chunks instead of individual blocks:
# - Disabling this will negatively impact performance
# - Only disable this for compatibility or cinematic placement
fast-placement: true
# Should WorldEdit use inventory?
# 0 = No inventory usage (creative)
# 1 = Inventory for removing and placing (freebuild)
# 2 = Inventory for placing (survival)
inventory-mode: 0
# Should large edits require confirmation (>16384 chunks)
confirm-large: true
# List of blocks to strip nbt from
strip-nbt: []