For the complete documentation index, see llms.txt. This page is also available as Markdown.

uhcconfiguration.yml

Overview

The uhcconfiguration.yml file is one of the main config files for FateUHC! This contains major plugin settings.

Last Updated: 5/17/2025

Default Config

UHC-SETTINGS:
  PREFIX: '&7[&eUHC&7] '
  BORDER-PREFIX: '&7[&eBorder&7] '
  TEAM-PREFIX: '&7[&eTeam&7] '
  RESTART-COMMAND: 'restart'
  LOBBY:
    ENABLED: true
    #Should we use PlayerBalancer? https://www.spigotmc.org/resources/55011/
    USE-PLAYER-BALANCER: false
    #If using PlayerBalancer make this your section name.
    FALL-BACK-SERVER: 'hub'
  JOIN-ITEMS: true
  AUTO-WHITELIST: false
  PRACTICE-RESPAWN-RADIUS: 7
  REBOOT-TIME: 30
  AUTO-PRACTICE: false
#World names, I recommend you leave this default.
WORLDS:
  LOBBY: 'uhc_lobby'
  UHC: 'uhc_world'
  NETHER: 'uhc_world_nether'
#Is the UHC world currently used and does it need to be regenerated?
UHC-WORLD-USED: true
LOCATIONS:
  LOBBY:
    WORLD: 'uhc_lobby'
    COORDS: '42.498135353877935;5.0;-192.54541245560267;-178.0989;-1.176207'
  PRACTICE:
    WORLD: 'uhc_practice'
    COORDS: '0.0;90.0;0.0;-90.0;0.0'
HIDE-LOBBY-PLAYERS:
  ENABLED: false
  PERMISSION-TO-SHOW: 'uhc.lobby.view'
  #If a player is invisible on join while HIDE-LOBBY-PLAYERS is disabled it will show them
  #to all online players, this excludes vanish or spectators. Do not enable unless told.
  FIX-VISUAL-BUG-INVISIBILITY: false
#If these are set to true the normal "Player joined the game" messages will not appear.
REMOVE-DEFAULT-MC-JOIN-MESSAGE: true
REMOVE-DEFAULT-MC-LEAVE-MESSAGE: true
JOIN-MESSAGE:
  - '&7&m-----------------------------'
  - '&eGame Type&7: &f{teams}'
  - '&eBorder&7: &f{border}'
  - '&eScenarios&7: &9{scenarios}'
  - '&7&m-----------------------------'
UHC-START-MESSAGE:
  - '&7&m-----------------------------'
  - '&eUHC has begun, good luck to all players.'
  - '&eBorder&7: &f{border}'
  - '&eScenarios&7: &a{scenarios}'
  - '&7&m-----------------------------'
TEAM-LIST-FORMAT:
  - '&7&m---------------------------------'
  - '&e{owner}''s Team &7[{size}/{max}&7]'
  - '&eState&7: &f{state}'
  - '&eMembers&7: &a{members}&7.'
  - '&7&m---------------------------------'
SEND-COORDS-FORMAT:
  - '&7&m---------------------------------'
  - '&e{player}''s coordinates'
  - '&7[&e{x}&7,&e{y}&7,&e{z}&7]'
  - '&bYou are {blocks} blocks away.'
  - '&7&m---------------------------------'
RELOGG-SUCCESS:
  - '&7&m---------------------------------'
  - '&eYou have successfully relogged.'
  - '&eTime left until disqualification&7: &c{timeLeft}'
  - '&7&m---------------------------------'
#PlaceholderAPI is supported in these chat formats along with any supported cores.
CHAT-FORMAT:
  ENABLED: true
  NORMAL: '&a{player}&7: &e{message}'
  TEAM: '&7[&aTeam Chat&7] &2{player} &7: &e{message}'
  SPECTATOR: '&7[Spectator Chat] &a{player} &7: &e{message}'
  MOLE: '&7[Mole Chat&7] &a{player} &7 &e{message}'
  HOST: '&7[&9Host&7]  &e{player} }&7: &6{message}'
  MOD: '&7[&bUHC Mod&7] &e{player} &7: &f{message}'
CHAT-PREFIXES:
  HOST: '&7[&9Host&7] &r'
  MOD: '&7[&bUHC Mod&7] &r'
  TEAM: '&7[{color}#{id}&7] &r'
#Requires BungeeAnnounce addon from https://depends.bghddevelopment.com
USING-BUNGEE-ANNOUNCE-CHANNELS-ADDON: false
VOTE-SYSTEM:
  ENABLED: false
  VOTE-FOR-SCENARIOS: false
  VOTE-FOR-CONFIGS: false
  MOST-VOTED-SCENARIOS-FORMAT: '&e<pos>. &6<name>&7: &f<amount>'
  MOST-VOTED-CONFIGS-FORMAT: '&e<pos>. &6<name>&7: &f<amount>'
  #How many scenarios should be enabled?
  ENABLED-SCENARIO-COUNT: 5
  #Scenario list: https://fateuhc.bghddevelopment.com/scenario-list
  VOTEABLE-SCENARIOS:
    - 'CUT_CLEAN'
    - 'SAFE_LOOT'
    - 'DOUBLE_ORES'
BORDER:
  START: 2000
  SHRINK-UNTIL: 25
  SHRINK-EVERY-MINUTES: 5
  COLOR-ID: 14
  SHRINK-STREAM: '3000;2500;2000;1500;1000;500;200;150;100;50;25'
  SHRINK-STARTED:
    - '&7&m--------------------------------------'
    - '&a&lBorder shrink has started'
    - '&eThe world border will shrink every &a{shrinkEvery} &eminutes,'
    - '&euntil &a{until}x{until} blocks&e.'
    - '&eNext border will shrink to &a{nextBorder} blocks&e.'
    - '&7&m--------------------------------------'
WORLD-GENERATOR: 'TerrainControl'
STARTER-INVENTORY: t@364:a@16;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;null;
SCENARIOS:
  FLOWER-POWER-NON-DROPPED-MATERIALS:
    - 'BEDROCK'
    - 'COMMAND_BLOCK'
  FLOWER-POWER-MATERIALS-TO-CHECK:
    - 'RED_ROSE'
    - 'YELLOW_FLOWER'
    - 'RED_TULIP'
UHC-WIN-MESSAGE:
  SOLO:
    - '&7&m-----------------------------------'
    - '&eCongrats to &b{winner} &efor wining this uhc'
    - '&eTotal kills&7: &b{kills}'
    - '&7&m-----------------------------------'
  TEAM:
    - '&7&m-----------------------------------'
    - '&eCongrats to &b{winners} &efor wining this uhc'
    - '&eTotal kills&7: &b{kills}'
    - '&7&m-----------------------------------'
WORLD-BORDER-FILLING-MESSAGE:
  - '&eUHC world is currently loading. &7(&6{chunks} chunks &ecompleted&7, &6~ {percentage} %&7)&e.'
RULES:
  ENABLED: true
  #PUT 'NONE' TO DISABLE SOUND EFFECT
  SEND-EVERY-SECONDS: 2
  SOUND: 'CLICK'
  FORMAT: '&7[&eRule &9#{count}&7] &7{rule}'
  RULES:
    - 'No hacked clients of any kind - this includes x-ray machines!'
    - 'Spamming chunk reloads is considered exploiting and is treated as x-ray.'
    - 'Using f3 to check entities is not allowed and is treated the same as cave finder.'
    - 'If you see a hacker or someone who you believe is cheating, please use /helpop.'
    - 'You may mine to sounds and players.'
    - 'Spoiling what others have, when you''re dead, will result in a 1 day ban. Dead shouldn''t interfere.'
    - 'No sky bases within 100x100. That means they can not be within the final shrink.'
    - 'The grace period is 20 minutes long. During the time, ipvp is NOT allowed.'
    - 'Anyone caught ipvping during the grace period will be banned for 3 day.'
    - 'If you stalk youtubers/streamers/famous during this time, we may TP you away.'
    - 'The world border will tp you, not kill you.'
    - 'Type /config to see what is enabled and what is not.'
    - 'You may relog during the game but you only have 10 minutes to get back in.'
POINTS-SYSTEM:
  PER-KILL: 3
  PER-WIN: 6
PRE-WHITELISTED-PLAYERS:
  - 'BGHDDev_YT'
  - 'BGHDDevelopment'
AUTO-START:
  ENABLED: false
  REQUIRED-PLAYERS: 100
  DELAY-TIME-IN-MINUTES: 10
  TIMER-IN-MINUTES: 1
  #Should whitelist be auto disabled?
  AUTO-WHITELIST: false
  #At what point? Default: 5min.
  AUTO-WHITELIST-TIME-IN-SECONDS: 300
ANNOUNCE-MESSAGE:
  WITHOUT-AUTO-START-ACTIVE: '&7[&a{serverName}&7] {displayName}&7: &a{gameType} &egame is starting soon. &7[&a{scenarios}.&7]'
  WITH-AUTO-START:
    MINUTES: '&7[&a{serverName}&7] {displayName}&7: &a{gameType} &egame is starting in &a{minutes} minutes. &7[&a{scenarios}.&7]'
    SECONDS: '&7[&a{serverName}&7] {displayName}&7: &a{gameType} &egame is starting in &a{seconds} seconds. &7[&a{scenarios}.&7]'
#Placeholders for MOTD
#{borderSize}
#{gameType}
MOTD:
  ENABLED: true
  LOBBY: '&eMOTD example line 1 {newLine}&dMOTD example line 2'
  GAME: '&eMOTD example line 1 {newLine}&dMOTD example line 2'
BUNGEE-AUTO-ANNOUNCE:
  ENABLED: false
  #SPLIT EACH TIME WITH ";"
  MINUTES: '30;20;10;5;4;3;2;1'
NICE-LOCATION-FORMAT: '&7[&2{x}&7,&2{y}&7,&2{z}&7] &7(&a{world}&7)'
#Use 'None' to disable sound
SOUNDS:
  FIRST-SHRINK: 'NOTE_PIANO'
  FIRST-SHRINK-ENABLED: true
  START: 'ENDERDRAGON_GROWL'
  START-ENABLED: true
  BORDER-SHRINK: 'LEVEL_UP'
  BORDER-SHRINK-ENABLED: true
  WIN: 'ENDERDRAGON_GROWL'
  WIN-ENABLED: true
  RULES-ENABLED: true
#This will automatically be doubled/tripled if double exp or triple exp is enabled.
ORE-EXPERIENCE:
  DIAMOND: 4
  GOLD: 3
  IRON: 2
  LAPIS: 2
  EMERALD: 3
  REDSTONE: 2
  COAL: 1
#Should mining blocks and getting XP send a sound?
XPSOUNDS: true
UHC-BORDER-INFO-FORMAT:
  SECONDS: '&7[&c<time>s&7]'
  MINUTES: '&7[&c<time>m&7]'
  LAST: '&7[&cLast&7]'
#If set to true the config will show in chat not a GUI.
#List: https://fateuhc.bghddevelopment.com/scenario-list#config-list
USE-CONFIG-INFO-IN-CHAT: false
CONFIGS-TO-SHOW-IN-CHAT:
  - 'Nether'
  - 'Final Heal Duration'
  - 'PvP Period Duration'
  - 'Border Size'
  - 'Border Shrink Interval'
  - 'Border Shrink Until'
  - 'First Shrink'
  - 'Enderpearl Damage'
  - 'Apple Rate'
  - 'Shears'
  - 'Shears Rate'
  - 'Enchanted Golden Apples'
  - 'Golden Heads'
  - 'Nether Bed Explosion'
  - 'Last Border Flat'
  - 'Glass Bedrock'
  - 'Team Damage'
  - 'To Inventory'
  - 'Exp Bottle'
  - 'Late Scatter Period'
#Should scenarios be shown in chat not in a GUI?
USE-SCENARIOS-INFO-IN-CHAT: false
CONFIGS-IN-CHAT-FORMAT:
  - '&8&m------------------------------------------'
  - '&f&l<type> &7- &a<scenarios>'
  - '{configs}'
  - ' &fPotions&7: &a<potions>'
  - '&8&m------------------------------------------'
USE-BUNGEE-ANNOUNCE-COMMAND:
  ENABLED: false
  COMMAND: 'broadcast <message>'
HELPOP:
  COOLDOWN: 60
THANK:
  COOLDOWN: 6000
REPORT:
  COOLDOWN: 60
PRACTICEBROADCAST:
  ENABLEDMESSAGE: true
  DISABLEDMESSAGE: true
#This will toggle the "You can't break blocks" message.
BLOCKMESSAGE:
  ENABLED: true
NAMETAGCOLOR:
  ENABLED: true
TABHEALTH:
  ENABLED: true
KICKMESSAGES:
  NORMAL: 'UHC has finished! The server is restarting!'
  ERROR: 'There was a problem loading your profile. Try again!'
  ERRORDEATH: 'You died while not in a game. Please join again.'
  DEATHKICK: '[&eDeathKick&7] &cThanks for playing this uhc!'
#Find list of colors here: https://wiki.bghddevelopment.com/books/fateuhc/page/death-message-chat-colors
DEATHMESSAGE:
  ENABLED: true
  KILLER: 'red'
  KILLED: 'red'
TIME:
  YEARS:
    NOTPLURAL: ' year '
    PLURAL: ' years '
  DAYS:
    NOTPLURAL: ' day '
    PLURAL: ' days '
  HOURS:
    NOTPLURAL: ' hour '
    PLURAL: ' hours '
  MINUTES:
    NOTPLURAL: ' minute '
    PLURAL: ' minutes '
  SECONDS:
    NOTPLURAL: ' second '
    PLURAL: ' seconds '
LIMITFLOWERPOWERPOTIONS:
  ENABLED: false
LIMITFLOWERPOWERORESANDBLOCKS:
  ENABLED: false
LIMITFLOWERPOWERAPPLES:
  ENABLED: false
BUILDUHCKIT:
  ARMOR: t@313;t@312;t@311;t@310;
  INVENTORY: t@276:e@16@1;t@346;t@327;t@4:a@64;t@326;t@322:dn@Golden Head;t@322:a@16;t@278;t@261;null;null;null;null;null;null;null;null;t@262:a@64;null;null;null;null;null;null;null;null;null;null;null;t@327;null;t@4:a@64;t@364:a@16;null;null;null;
TIMEBOMBHOLOS:
  DEFAULT: '&a{player}''s &fCorpse &7[&a31s&7]'
  NORMAL: '&a{player}''s &fCorpse &7[&a{time}s&7]'
  15SEC: '&a{player}''s &fCorpse &7[&e{time}s&7]'
  3SEC: '&a{player}''s &fCorpse &7[&6{time}s&7]'
  2SEC: '&a{player}''s &fCorpse &7[&c{time}s&7]'
  1SEC: '&a{player}''s &fCorpse &7[&4{time}s&7]'
SAFELOOTHOLOS:
  DEFAULT: '&eLocked for: &6{player}'
USEBUKKITSHUTDOWN:
  ENABLED: false
#This will pull the world from the backUp folder in /plugins/FateUHC/backUp
#It will disable generation.
USEWORLDBACKUPSYSTEM: false
#Should a head spawn on a fence when the player dies?
SPAWN-HEAD-ON-DEATH: true
#If enabled it will use the effects below rather than the default.
SUPERHEROS-USE-CUSTOM-EFFECTS: false
#Effects used randomly in Superheros scenario. These must be changed for your MC version.
SUPERHEROS-EFFECTS:
  - "INCREASE_DAMAGE"
  - "DAMAGE_RESISTANCE"
  - "SPEED"
  - "JUMP"
  - "INVISIBILITY"
  - "FIRE_RESISTANCE"
Fallback:
  Enabled: false
  #This should be the server name from your bungeecord config.
  Server: "Hub"
#100 Border Scenario Options *Must have 100 border in SHRINK-STREAM*
#Scenario List: https://fateuhc.bghddevelopment.com/scenario-list
ONE-HUNDRED-BORDER-SCENARIOS:
  - "NO_FALL_DAMAGE"
  - "TRIPLE_EXP"
#Players will be blocked from interacting with these blocks in sepectator mode. Please use the Material name not ID's.
#When using WorldBorder this may break, this is due to their event handling and cannot be fixed currently.
BLOCKED_INTERACTION_BLOCKS:
  - 'IRON_DOOR'
  - 'LEVER'
#How long should the combat logger remain spawned? 20 = 1sec. Default 1200 = 1min.
COMBATLOGTIME: 1200
#Should mobs spawn while the server is in pregen? Recommended: true.
MOBS-WHILE-PREGEN: true
#These commands will run on kill and on win. Placeholders: {player} - killer & winner, {killed} - killed player.
COMMANDS:
  ON-KILL:
    - ""
    - ""
    - ""
  ON-WIN:
    - ""
    - ""
    - ""
#Used in specific placeholders
SERVER-NAME: "Default FateUHC Minecraft Server"
# Should the server send messages informing players when an episode ends/when a new one starts?
EPISODE-TIMER:
  LENGTH-IN-MINS: 15
  AUTO-RESTART: true
  RESTART-WAIT-IN-MINS: 3
#Enable if told by a developer.
DEBUG: false

Last updated