global.conf

Global Configuration

The global.conf file contains the global configuration settings for Sponge. This file is created in the config/sponge directory in your server folder. Many of these properties can be also overridden per-world or per-dimension type by using the config files in the subfolders of config/worlds. The following global.conf example was generated by a server running the beta build of SpongeForge (build 1000) and Forge 1.8 (build 1577).

# 1.0
#
# # If you need help with the configuration or have any questions related
# # to Sponge, join us at the IRC or drop by our forums and leave a post.
#
# # IRC: #sponge @ irc.esper.net ( http://webchat.esper.net/?channel=sponge )
# # Forums: https://forums.spongepowered.org/
#

sponge {
    block-tracking {
        # If enabled, adds player tracking support for block positions. Note: This should only be disabled if you do not care who caused a block to change.
        enabled=true
    }
    bungeecord {
        # If enabled, allows BungeeCord to forward IP address, UUID, and Game Profile to this server
        ip-forwarding=false
    }
    commands {}
    debug {
        # Dump chunks in the event of a deadlock
        dump-chunks-on-deadlock=false
        # Dump the heap in the event of a deadlock
        dump-heap-on-deadlock=false
        # Dump the server thread on deadlock warning
        dump-threads-on-warn=false
        # Enable Java's thread contention monitoring for thread dumps
        thread-contention-monitoring=false
    }
    entity {
        # Number of colliding entities in one spot before logging a warning. Set to 0 to disable
        collision-warn-size=200
        # Number of entities in one dimension before logging a warning. Set to 0 to disable
        count-warn-size=0
        # Number of ticks before a painting is respawned on clients when their art is changed
        entity-painting-respawn-delay=2
        # Number of ticks before the fake player entry of a human is removed from the tab list (range of 0 to 100 ticks).
        human-player-list-remove-delay=10
        # Controls the time in ticks for when an item despawns.
        item-despawn-rate=6000
        # Max size of an entity's bounding box before removing it. Set to 0 to disable
        max-bounding-box-size=1000
        # Square of the max speed of an entity before removing it. Set to 0 to disable
        max-speed=100
    }
    entity-activation-range {
        ambient-activation-range=32
        aquatic-activation-range=32
        creature-activation-range=32
        minecraft {
            ambient {
                bat=true
            }
            aquatic {
                squid=true
            }
            creature {
                chicken=true
                pig=true
                rabbit=true
                sheep=true
            }
            enabled=true
            misc {
                item=true
                villager=true
            }
            monster {
                creeper=true
                enderman=true
                skeleton=true
                spider=true
                witch=true
                zombie=true
            }
        }
        misc-activation-range=16
        monster-activation-range=32
    }
    general {
        # Forces Chunk Loading on provide requests (speedup for mods that don't check if a chunk is loaded)
        chunk-load-override=false
        # Disable warning messages to server admins
        disable-warnings=false
    }
    logging {
        # Log when blocks are broken
        block-break=false
        # Log when blocks are modified
        block-modify=false
        # Log when blocks are placed
        block-place=false
        # Log when blocks are populated in a chunk
        block-populate=false
        # Log when blocks are placed by players and tracked
        block-tracking=false
        # Log when chunks are loaded
        chunk-load=false
        # Log when chunks are unloaded
        chunk-unload=false
        # Whether to log entity collision/count checks
        entity-collision-checks=false
        # Log when living entities are destroyed
        entity-death=false
        # Log when living entities are despawned
        entity-despawn=false
        # Log when living entities are spawned
        entity-spawn=false
        # Whether to log entity removals due to speed
        entity-speed-removal=false
        # Log when server receives exploited packet with itemstack name exceeding string limit.
        exploit-itemstack-name-overflow=false
        # Log when player attempts to respawn invisible to surrounding players.
        exploit-respawn-invisibility=false
        # Log when server receives exploited packet to update a sign containing commands from player with no permission.
        exploit-sign-command-updates=false
        # Add stack traces to dev logging
        log-stacktraces=false
    }
    modules {
        bungeecord=false
        entity-activation-range=true
        timings=true
    }
    shutdown-on-eula {
        # If enabled, shut down the server if the EULA has not been accepted
        shutdown-server=true
    }
    # Configuration options related to the Sql service, including connection aliases etc
    sql {
        # Aliases for SQL connections, in the format jdbc:protocol://[username[:password]@]host/database
        aliases=null
    }
    timings {
        enabled=true
        hidden-config-entries=[
            "sponge.sql"
        ]
        history-interval=300
        history-length=3600
        server-name-privacy=false
        verbose=false
    }
    world {
        # Lava behaves like vanilla water when source block is removed
        flowing-lava-decay=false
        # Vanilla water source behavior - is infinite
        infinite-water-source=false
        # Enable if this world's spawn should remain loaded with no players.
        keep-spawn-loaded=true
        # Enable if this world should load on startup.
        load-on-startup=true
        # Enable if this world allows PVP combat.
        pvp-enabled=true
        # Enable if this world should be allowed to load.
        world-enabled=true
    }
}

Global Properties of Sponge

Property	Type	Default	Description
Block Tracking
enabled	boolean	true	Adds player tracking support for block positions.
Bungeecord
ip-forwarding	boolean	false	Allows bungeecord to forward ip address, UUID, and Game Profile to the server.
Debug Options
dump-chunks-on-deadlock	boolean	false	Dumps chunks in the event of a deadlock.
dump-heap-on-deadlock	boolean	false	Dump the heap in the event of a deadlock.
dump-threads-on-warn	boolean	false	Dump the server thread on deadlock warning.
thread-contention-monitoring	boolean	false	Enable Java’s thread contention monitoring for thread dumps.
Entity Options
collision-warn-size	integer	200	Number of colliding entities in one spot before logging a warning. Set to 0 to disable.
count-warn-size	integer	0	Number of entities allowed in one dimension before logging a warning. Set to 0 to disable.
entity-painting-respawn-delay	integer	2	Number of ticks before a painting is respawned on the client when their art is changed.
human-player-list-remove-delay	integer	10	Number of ticks before the fake player entry of a human is removed from the tab list. The allowed range is 0 - 100.
item-despawn-rate	integer	6000	The time in ticks before an item despawns.
max-bounding-box-size	integer	1000	Maximum size of an entity’s bounding box before it is removed. Set to 0 to disable.
max-speed	integer	100	Square of the maximum speed of an entity before it is removed. Set to 0 to disable
Entity Activation Range			Note that entities from Mods are automatically added to this list.
ambient-activation-range	integer	32	Range where ambient entities become active.
aquatic-activation-range	integer	32	Range where aquatic entities become active.
creature-activation-range	integer	32	Range where creatures become active.
Minecraft Creatures
Ambient (bat)	boolean	true	Use activation range on bats
Aquatic (squid)	boolean	true	Use activation range on squid.
Creature <creature>	boolean	true	Use activation range on <creature>. Permitted values: chicken, pig, rabbit, sheep.
enabled	boolean	true	Enable activation range on Minecraft entities.
Miscellaneous Entities
Misc <entity>	boolean	true	Use activation range on <entity>. Permitted values: item, villager.
Minecraft Monsters
Monster <monster>	boolean	true	Use activation range on <monster>. Permitted values: creeper, enderman, skeleton, spider witch, zombie.
misc-activation-range	integer	16	Range where misc entities become active.
monster-activation-range	integer	32	Range where monsters are activated.
General Settings
chunk-load-override	boolean	false	Forces chunk loading on provide requests. This is a speed-up for mods that don’t check if a chunk is loaded.
disable-warnings	boolean	false	Disable warning messages to server Admins.
Logging Options
block-break	boolean	false	Logs when a block is broken.
block-modify	boolean	false	Logs when blocks are modified.
block-place	boolean	false	Logs when blocks are placed.
block-populate	boolean	false	Logs when blocks are populated in a chunk.
block-tracking	boolean	false	Logs when blocks are placed by players and tracked.
chunk-load	boolean	false	Log when chunks are loaded.
chunk-unload	boolean	false	Log when chunks are unloaded.
entity-collision-checks	boolean	false	Whether to log entity collision/count checks.
entity-death	boolean	false	Log when living entities are destroyed.
entity-despawn	boolean	false	Log when living entities are despawned.
entity-spawn	boolean	false	Log when living entities are spawned.
entity-speed-removal	boolean	false	Whether to log entity removals due to speed.
exploit-itemstack-name-overflow	boolean	false	Logs when a server receives exploited packets with itemstack name exceeding string limit.
exploit-respawn-invisibility	boolean	false	Logs when a player attempts to respawn invisible to surrounding players.
exploit-sign-command-updates	boolean	false	Logs when a server receives an exploited packet containing commands from a player with no permission.
log-stacktraces	boolean	false	Add stack traces to dev logging.
Modules
bungeecord	boolean	false	Enables bungeecord support.
entity-activation-range	boolean	true	Enables the entity activation range settings.
timings	boolean	true	Enables timing settings.
Shutdown on EULA
shutdown-server	boolean	true	Enables if the server should be shut down if the EULA has not been accepted.
SQL
aliases	string	null	Aliases for SQL connections.
Timings
enabled	boolean	true	If timings are enabled.
hidden-config-entries	string	sponge.sql	The hidden config entries.
history-interval	integer	300	The timings history interval.
history-length	integer	3600	The timings history length.
server-name-privacy	boolean	false	Whether to include information such as the server name, motd, online-mode, and server icon in the report.
verbose	boolean	false	Whether or not to give a verbose report.
World Settings
flowing-lava-decay	boolean	false	Lava behaves like vanilla water when the source block is removed, when set to true.
infinite-water-source	boolean	false	False = Default vanilla water source behaviour.
keep-spawn-loaded	boolean	true	If the spawn should stay loaded with no players.
load-on-startup	boolean	true	If the world should load on startup.
pvp-enabled	boolean	true	If the would allows PVP combat.
world-enabled	boolean	true	Enable if this world should be allowed to load.