Other Settings
This page covers additional Homestead configuration options from regions.yml, config.yml, and flags.yml that are not documented elsewhere.
Debug Mode
Show detailed console messages for troubleshooting.
Console Flood
Debug mode can flood the console on busy servers. Only enable it when actively debugging, then turn it off.
Metrics
Anonymous usage statistics via bStats and FastStats. No personal data is collected.
Player Input Display
Control how Homestead prompts players when it needs chat input (renaming a region, trusting a player, etc.).
Messages shown during input sessions are configured in the language file.
Clean Startup
Automatically remove corrupted or invalid data on startup (orphaned regions, broken coordinates, etc.).
Recommended
Keep this enabled unless startup time is a concern.
Adjacent Chunks
Force all claimed chunks to be connected (no scattered claims).
Disable for multi-location builds (separate bases and farms).
Chunk Price
Charge players a fee to claim each chunk.
Requires an economy plugin. See Economy Setup.
Auto-Select Target Region
Automatically assign a random target region to new players.
Sub-Areas Toggle
Globally enable or disable the sub-areas feature.
When false, players cannot create new sub-areas. Existing sub-areas are unaffected. See Sub-Areas.
Rewards Toggle
Globally enable or disable the rewards system (bonus chunks for members and playtime).
When false, no bonus chunks or sub-areas are awarded. See Rewards.
Welcome Signs Toggle
Enable or disable welcome signs globally.
See Welcome Signs.
Selection Tool
Configure the item used to select area corners, for sub-areas or claiming multiple chunks at once.
# In regions.yml
selection-tool:
item:
name: "&eSelection Tool"
lore:
- "&7Use this tool to create sub-areas or"
- "&7claim new chunks!"
type: GOLDEN_HOE # Any Bukkit material, or "NEXO-(id)" for NexoMC items
messages:
none: "&7Please select two corners/points inside or outside of the region."
firstCorner: "&7First corner: &a✔ &7| Second corner: &c✘"
secondCorner: "&7First corner: &c✘ &7| Second corner: &a✔"
selectionDone: "&aYou can create a new sub-area or claim new chunks!"
Disabled Worlds
Prevent claiming in specific worlds:
# In regions.yml
disabled-worlds-exact:
- "world_the_end"
- "factions"
- "pvp_arena"
disabled-worlds-pattern:
- "em_*" # Wildcard; matches em_world, em_dungeon, etc.
- "minigame_*_end"
- Exact — case-sensitive full world names
- Pattern —
*matches any characters
Use an empty array ([]) if no worlds should be disabled.
Enter/Exit Messages
Show messages when players enter or leave a region:
# In regions.yml
enter-exit-region-message:
enabled: true
type: 'title' # title, actionbar, or chat
messages:
enter:
title: [ "&2{region-displayname}", "&7{region-description}" ] # [ TITLE, SUBTITLE ]
actionbar: "&7You enter the territory of &2{region-displayname}&7: {region-description}"
chat: "&7You enter the territory of &2{region-displayname}&7: {region-description}"
exit:
title: [ "&3Wilderness", "&7Roam the wild!" ]
actionbar: "&7You left the territory of &2{region-displayname}&7."
chat: "&7You left the territory of &2{region-displayname}&7."
When type is title, the title field is an array of [main title, subtitle].
Welcome Message
Customize the join message for players (shown on rejoin, not first join):
# In regions.yml
welcome-message:
enabled: true
message: "&eWelcome back, {player}!\nThere are &6{unread-logs} &eunread mails, with &6{regions-invited} &eregions sent you an invite!"
Use \n for new lines.
Log Private Chat
Log region chat messages to console for moderation:
Region chat can also be forwarded to Discord via webhook. See Plugin Integrations.
Borders
Configure the region border visualization shown by /region borders.
# In regions.yml
borders:
enabled: true
# Display type:
# - particles: Dust particles following the player's Y position (recommended)
# - blocks: Fake blocks at the highest surface of the border
# - glow: Fake blocks with glowing effect following the player's Y position
type: particles
# Dust colors (type = 'particles'), RGB 0–255
dust-colors:
owner: [0, 255, 0] # Green
member: [255, 255, 0] # Yellow
visitor: [255, 0, 0] # Red
sub-area: [0, 179, 255] # Light blue
# Dust size (type = 'particles')
dust-size: 3.0
# Block type (type = 'blocks')
block-type: GRAY_GLAZED_TERRACOTTA
Full usage guide: Borders & Maps.
World Rules
Apply custom flags to wilderness (unclaimed) chunks per world:
# In flags.yml
world-rules:
enabled: false
worlds:
world_the_end:
player_flags: 68719474687
world_flags: 13631487
pvp_arena:
player_flags: 68719474687
world_flags: 13631487
Use the Homestead Flags Calculator to compute bitwise flag values.
Ignored Flags
These world rules flags are ignored: liquid-flow, wilderness-dispensers, wilderness-pistons, wilderness-minecarts
Allow All Flags for Trusted Players
When a player joins a region as a trusted member, automatically allow all player flags for them.
- true (default): Trusted members get all player flags allowed on join
- false: Trusted members start with the region's default flag states
Spawner Exclusion
Control whether mobs from spawners are ignored by spawn flags:
When true, spawner-spawned mobs are not blocked by the passive/hostile entity spawn flags.
Cooldown System
Configure cooldowns per action to prevent spam. Restarting the server resets all cooldowns.
# In regions.yml
cooldown:
flag-change-state:
ignore-operators: false
value: 3 # Seconds
region-spawn-change:
ignore-operators: true
value: 600 # 10 minutes
region-rename-change:
ignore-operators: true
value: 600 # 10 minutes
region-description-change:
ignore-operators: true
value: 300 # 5 minutes
region-transfer-ownership:
ignore-operators: true
value: 604800 # 7 days
region-dynamic-map-settings-change:
ignore-operators: true
value: 43200 # 12 hours
region-chunk-claim:
ignore-operators: true
value: 5 # 5 seconds
region-chunk-unclaim:
ignore-operators: true
value: 5 # 5 seconds
region-teleport:
ignore-operators: true
value: 15 # 15 seconds
selection-tool:
ignore-operators: false
value: 604800 # 7 days
war-flag-disabled:
ignore-operators: true
value: 129600 # 36 hours
| Cooldown Key | What It Limits | Default |
|---|---|---|
flag-change-state |
Changing any flag state | 3s |
region-spawn-change |
Updating the region spawn | 10 min |
region-rename-change |
Renaming the region | 10 min |
region-description-change |
Updating the description | 5 min |
region-transfer-ownership |
Transferring ownership (incl. sale signs) | 7 days |
region-dynamic-map-settings-change |
Map color / icon changes | 12 hours |
region-chunk-claim |
Claiming a chunk | 5s |
region-chunk-unclaim |
Unclaiming a chunk | 5s |
region-teleport |
Teleporting (/region home, /region visit) |
15s |
selection-tool |
Using the selection tool | 7 days |
war-flag-disabled |
Changing the wars flag after a war |
36 hours |
Delayed Teleport
Configure teleport delays and boss bar display:
# In regions.yml
delayed-teleport:
enabled: true
delay: 3 # Seconds
price: 0.0 # Cost (0.0 = free)
cancel-on-move: true # Cancel if player moves
ignore-operators: true # OPs bypass delay
boss-bar:
enabled: true
title: "&7Teleporting in &3{seconds}s&7..."
color: "PURPLE"
style: "SEGMENTED_10"
countdown-mode: "DEPLETE"
Full usage guide: Teleportation.
Force-Loaded Chunks
Keep chunks loaded even when no players are nearby.
There is no global on/off toggle. This feature is controlled per-chunk by the player. The maximum number of force-loaded chunks per region is set in Ranks & Limits via max-force-loaded-chunks.
Storage Feature
Allow trusted members to share a private chest:
See Region Storage.
Special Features
Miscellaneous behavior toggles grouped under special-feat in regions.yml.
TNT Below Sea Level
Allow TNT explosions only below Y=63 in unclaimed areas (protects the surface):
- false (default): TNT explodes normally everywhere
- true: TNT only explodes below Y=63
Trust Acceptance System
Control whether players must accept trust invitations:
- false (default): Trusted players must run
/region accept - true: Players are trusted immediately when
/region trustis run
Ignore Region Protection in Disabled Worlds
Disable region protection entirely in worlds listed under disabled-worlds-exact / disabled-worlds-pattern:
- true (default, recommended): Region protection does not apply in disabled worlds
- false: Regions in disabled worlds are still protected
End Portal Teleport
Teleport players to their region spawn instead of world spawn when exiting the End:
# In regions.yml
special-feat:
teleport-players-back-to-region-spawn-when-entering-end-exit-portal: true
- true (default): Players exiting the End return to their region spawn
- false: Players exit to the world spawn as normal
War Configuration
# In regions.yml
wars:
enabled: false
# Prize bounds
min-prize: 1000.0 # $1k
max-prize: 1000000000.0 # $1B
# Force keep inventory when a player dies during a war.
# Ignores the vanilla game rule for any world.
keep-inventory: false
# Give the winning region owner's head to the winner
give-head: true
# Broadcast "A war has been declared":
# - regions: Only sent to regions in the war
# - server: Sent to the entire server
# - silent: No message sent
broadcast-type: "regions"
# Flags forced to Allow during a war
override-flags:
- "pvp"
- "doors"
- "trap-doors"
- "fence-gates"
- "passthrough"
- "elytra"
- "teleport"
- "pickup-items"
- "take-fall-damage"
- "containers"
- "break-blocks"
- "place-blocks"
# Ownership wager wars: the loser's region transfers to the winner
ownership-wars:
enabled: true
default-kills-to-win: 10 # Kills needed to win (overridable per war)
default-timeout-minutes: 60 # Timeout in minutes (0 = no timeout)
Full usage guide: Wars.
Economy Systems
These are configured in regions.yml but have dedicated documentation pages:
| System | Config Key | Docs |
|---|---|---|
| Upkeep | upkeep |
Upkeep |
| Member Taxes | taxes |
Member Taxes |
| Renting | renting |
Rent |
| Selling | selling |
Sell |
Restart Required
Changes to upkeep, taxes, and renting require a full server restart to take effect.