Configuration Files
This page provides information on the configurability of TetrisFriends.
Below are the configuration files that TetrisFriends ships with. You can find game-configurations here.
Please make sure that ReturnLocation.PlayerJoinLocation is a valid location. Preferably make it match the location of your servers spawn point.
#########################################################################
# +-------------------------------------------------------------------+ #
# | _____ _ _ ___ _ _ | #
# | |_ _|___ | |_ _ _ (_) ___| __|_ _ (_) ___ _ _ __| | ___ | #
# | | | / -_)| _|| '_|| |(_-<| _|| '_|| |/ -_)| ' \ / _` |(_-< | #
# | |_| \___| \__||_| |_|/__/|_| |_| |_|\___||_||_|\__,_|/__/ | #
# | | #
# | By: Benz56 | #
# +-------------------------------------------------------------------+ #
#########################################################################
# Customize various parameters of the TetrisFriends game world.
World:
# Set to -1 to enable the daylight cycle.
Time: 6000
# Valid Environments: NORMAL, NETHER, THE_END.
# If changed you have to delete the 'TetrisFriends' world and generate a new one.
Environment: 'NORMAL'
# Select the schematic you wish to use for the TetrisFriends game cells.
#
# If you wish to create your own please follow these instructions:
# - Execute '/tfa schematic center' and '/tfa schematic helper'.
# - Build your schematic.
# - Once you're done execute '/tfa schematic save <name>'
#
# Please note that you do not have to use the built-in schematic creator, however,
# this is by far the easiest way to create your own schematics. It'll highlight
# areas to look out for, provide you with troubleshooting information as you
# create your schematic and validate it for you before creating it. It'll
# also make sure your schematic is perfectly centered when pasted.
Schematic: 'standard.schematic'
# Set the NoteBlock song that should play while playing Tetris.
# The songs are located in the 'songs' folder. You can add your own .nbs files.
# This requires the plugin NoteBlockAPI. https://www.spigotmc.org/resources/19287/
Music:
Song: 'theme.nbs'
# Determine where the player is teleported to once a game has finished.
ReturnLocation:
# false: Players are teleported back to the location they were teleported from when the game started.
# true: Players are teleported to the FixedLocation configured below when the game ends.
UseFixedLocation: false
# Set the fixed return-location in the following format:
# <world>, <x>, <y>, <z>, <yaw>, <pitch>
# Pitch and yaw are optional.
FixedLocation: 'world, 0, 60, 0, 0, 0'
# If a player for some reason joins in the TetrisFriends world where should they get teleported?
PlayerJoinLocation: 'world, 0, 60, 0, 0, 0'
# Set the number of seconds a challenge is valid.
Challenge:
# A public challenge is a challenge all players accept.
Public:
ExpiryTime: 1800
# A targeted challenge is a challenge created when a player challenges a specific player.
Targeted:
ExpiryTime: 120
# Select the type of Controls to use.
Controls:
# Event-based controls. Will cause a little bit of movement while playing.
Standard:
# Determine the milliseconds between each input action when playing.
# Lower input delay will allow moving the tetrominoes faster, however,
# may result in accidental movements. Recommended are 120 - 160.
InputDelay: 140
# Packet-based controls. Requires ProtocolLib.
# This option results in a far better gameplay experience.
# This is the recommended option for controls.
Enhanced:
enabled: false
# By default Tetris Friends saves its data in a local SQLite database file.
# By configuring a MySQL database you can make multiple servers share the same data.
MySQL:
Enabled: false
Host: localhost
Port: 3306
DatabaseName: database
Username: root
Password: password
MaximumPoolSize: 5
# Update Checker.
# Enable or disable the update checker.
UpdateCheckerEnabled: true
# false: All OPs are notified of a new update when they join.
# true: OPs are only notified if they have the tetrisfriends.update permission as well.
# N.B. any user with the tetrisfriends.update permission is notified; OP or not.
UpdateCheckerPermissionOnly: false
# This is the Message file for all TetrisFriends messages.
#
# All messages are fully customizable and support color codes, formatting and ASCII symbols.
# Set the Prefix and use %prefix% to add the corresponding prefix to a message.
# Prepend any message with <ActionBar> to send it as an ActionBar message.
# Leave a message blank ('') to disable it.
#
# You can also create messages with Hover and Click events. Syntax options: (Space between comma and quote is NOT allowed)
# - ["Message","/Command"]
# - ["Message","Hover"]
# - ["Message","/Command","Hover"]
# - ["Message","/Command","Suggest"]
# - ["Message","/Command","Hover","Suggest"]
# You can add as many events to a message as you want. Example:
# '%prefix% &cInvalid arguments! ["&c&n&oHelp","/tetrisfriends help","&aClick to get help!"]'
# The "Suggest" tag is used if the click event should suggest the command. Default is Run.
Prefix: '&7[&cT&6e&et&ar&bi&ds&cF&6r&ei&ae&bn&dd&cs&7]'
Messages:
General:
InvalidPermission: '%prefix% &cYou do not have permission to do this!'
NoCommands: 'Unknown command. Type "/help" for help.'
PlayerOnly: '%prefix% &cCommand can only be used as a Player!'
InvalidArguments: '%prefix% &cInvalid arguments! ["&c&n&oHelp","/tetrisfriends help","&aClick to get help!"]'
Tetris:
AlreadyPlaying: '%prefix% &cAlready playing!'
AlreadyHaveAPublicChallenge: '%prefix% &cYou already have a public challenge!'
PublicChallengeCreated: '%prefix% &aPublic challenge created!'
ChallengeSent: '%prefix% &aChallenge sent to &e%player%'
ChallengeReceived: '%prefix% &e%player% &ahas challenged you in Tetris! ["&b&nAccept","/tetrisfriends menu challenges","&aClick to open the challenges menu!"]'
AlreadyChallenged: '%prefix% &cYou''ve already challenged that player!'
ChallengeInvalid: '%prefix% &cThe challenge is no longer valid!'
CommandsDisabled: '%prefix% &cYou can''t execute commands while playing!'
Admin:
ConfigurationsReloaded: '%prefix% &aConfiguration files successfully reloaded!'
Please note that the material names in this file are for 1.12.2. The plugin will automatically generate the correct material names for the version you're running.
# This is the menu file for all TetrisFriends menus. Here you'll be able to customize all GUI menus used by TetrisFriends.
#
# Each menu has a 'Required' section:
# - You can customize the items in this section.
# - You can not add or remove sections.
# Each menu has an 'Optional' section:
# - You can add new items by creating a new section with a unique name e.g. instead of 'EdgeRed' you could add 'MyOwnItem'.
# - You can remove items by deleting a section.
#
# An item-section consists of:
# - [Required] Material: <Material> If you're using 1.12 you can use <Material>:[Data]. If you're not using 1.12 use the full material name.
# - [Required] Name: <String> You may use color codes in names.
# - [Required] Slot(s): <Integer> Select where the item should be placed with 'Slot: <Integer>' or 'Slots: <Integer,Integer,Integer>'
# - [Optional] Lore: <List> A lore is a list of strings. Please see an example below for the syntax.
# - [Optional] Glow: <Boolean> Give an item enchant 'glow'. true/false.
# - [Optional] Amount: <Integer> Set the amount in the itemstack. 1 to 64 both inclusive.
# - [Optional] ItemFlags: <List> Give an item various ItemFlags to e.g. hide attributes)
MainMenu:
Title: '&c&lT&6&le&e<&a&lr&b&li&d&ls&c&lF&6&lr&e&li&a&le&b&ln&d&ld&c&ls'
Required:
ChallengesButton:
Material: NETHER_STAR
Name: ' &eChallenges!'
Lore:
- ' &f&m-------------------&7 '
- ''
- ' &aClick here to view all'
- ' &aavailable challenges!'
- ''
- ' &7&m-------------------&7 '
Slot: 39
HighScoreSelectorButton:
Material: BOOK
Name: ' &eHigh Scores!'
Lore:
- ' &f&m--------------------&7 '
- ''
- ' &aClick here to view all'
- ' &acurrent high-scores!'
- ''
- ' &7&m--------------------&7 '
Slot: 41
Optional:
EdgeRed:
Material: STAINED_GLASS_PANE:14
Name: '&c&l█'
Slots: 0,6,18,44,48
EdgeOrange:
Material: STAINED_GLASS_PANE:1
Name: '&6&l█'
Slots: 1,7,9,46,53
EdgeYellow:
Material: STAINED_GLASS_PANE:4
Name: '&e&l█'
Slots: 2,8,47,52
EdgeGreen:
Material: STAINED_GLASS_PANE:5
Name: '&a&l█'
Slots: 3,17,45,51
EdgeBlue:
Material: STAINED_GLASS_PANE:3
Name: '&b&l█'
Slots: 4,26,36,50
EdgeMagenta:
Material: STAINED_GLASS_PANE:2
Name: '&d&l█'
Slots: 5,27,35,49
OpponentSelector:
Title: '&c&lT&6&le&e<&a&lr&b&li&d&ls&c&lF&6&lr&e&li&a&le&b&ln&d&ld&c&ls &7&l>
&c&lC&6&lh&e&la&a&ll&b&ll&d&le&c&ln&6&lg&e&le'
Required:
Opponent:
Head: '%player%'
Name: '&eChallenge &a%player%'
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
PublicChallenge:
Material: DIAMOND_SWORD
Name: ' &eCreate a Public Challenge'
Lore:
- ' &f&m---------------------------&7 '
- ''
- ' &aClick here to create a public'
- ' &achallenge in the selected game'
- ' &amode. The game starts once a'
- ' &aplayer accepts the challenge!'
- ''
- ' &f&m---------------------------&7 '
ItemFlags:
- HIDE_ATTRIBUTES
Slot: 38
NextPage:
Head: http://textures.minecraft.net/texture/e3fc52264d8ad9e654f415bef01a23947edbccccf649373289bea4d149541f70
Name: '&eNext Page'
Slot: 42
PrevPage:
Head: http://textures.minecraft.net/texture/5f133e91919db0acefdc272d67fd87b4be88dc44a958958824474e21e06d53e6
Name: '&ePrevious Page'
Slot: 40
Back:
Material: BARRIER
Name: '&eMain Menu'
Slot: 41
Optional:
EdgeRed:
Material: STAINED_GLASS_PANE:14
Name: '&c&l█'
Slots: 0,6,18,44,48
EdgeOrange:
Material: STAINED_GLASS_PANE:1
Name: '&6&l█'
Slots: 1,7,9,46,53
EdgeYellow:
Material: STAINED_GLASS_PANE:4
Name: '&e&l█'
Slots: 2,8,47,52
EdgeGreen:
Material: STAINED_GLASS_PANE:5
Name: '&a&l█'
Slots: 3,17,45,51
EdgeBlue:
Material: STAINED_GLASS_PANE:3
Name: '&b&l█'
Slots: 4,26,36,50
EdgeMagenta:
Material: STAINED_GLASS_PANE:2
Name: '&d&l█'
Slots: 5,27,35,49
ChallengesMenu:
Title: '&c&lT&6&le&e<&a&lr&b&li&d&ls&c&lF&6&lr&e&li&a&le&b&ln&d&ld&c&ls &7&l>
&c&lC&6&lh&e&la&a&ll&b&ll&d&le&c&ln&6&lg&e&le&a&ls'
Required:
Challenger:
Head: '%player%'
Name: ' &eCreated by &a%player%'
Lore:
- ' &f&m-------------------&7 '
- ''
- ' &eGameMode: &a%gameMode%'
- ' &ePublic: &a%public%'
- ''
- ' &7&m-------------------&7 '
- ' &eL-Click to accept.'
- ' &7&m-------------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
NextPage:
Head: http://textures.minecraft.net/texture/e3fc52264d8ad9e654f415bef01a23947edbccccf649373289bea4d149541f70
Name: '&eNext Page'
Slot: 41
PrevPage:
Head: http://textures.minecraft.net/texture/5f133e91919db0acefdc272d67fd87b4be88dc44a958958824474e21e06d53e6
Name: '&ePrevious Page'
Slot: 39
Back:
Material: BARRIER
Name: '&eMain Menu'
Slot: 40
Optional:
EdgeRed:
Material: STAINED_GLASS_PANE:14
Name: '&c&l█'
Slots: 0,6,18,44,48
EdgeOrange:
Material: STAINED_GLASS_PANE:1
Name: '&6&l█'
Slots: 1,7,9,46,53
EdgeYellow:
Material: STAINED_GLASS_PANE:4
Name: '&e&l█'
Slots: 2,8,47,52
EdgeGreen:
Material: STAINED_GLASS_PANE:5
Name: '&a&l█'
Slots: 3,17,45,51
EdgeBlue:
Material: STAINED_GLASS_PANE:3
Name: '&b&l█'
Slots: 4,26,36,50
EdgeMagenta:
Material: STAINED_GLASS_PANE:2
Name: '&d&l█'
Slots: 5,27,35,49
HighScoreSelector:
Title: '&c&lT&6&le&e<&a&lr&b&li&d&ls&c&lF&6&lr&e&li&a&le&b&ln&d&ld&c&ls &7&l>
&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le'
Required:
Back:
Material: BARRIER
Name: '&eMain Menu'
Slot: 40
MostGames:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: '&6&l&m--[-&f &e&lMost Games Played&f &6&l&m-]--'
Lore:
- ' &f&m----------------------------&7 '
- ''
- ' &aSee who plays the most:'
- ' &a - Overall'
- ' &a - Singleplayer'
- ' &a - Multiplayer'
- ''
- ' &aSorted by most games played.'
- ''
- ' &f&m----------------------------&7 '
Slot: 19
MostLosses:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: ' &6&l&m--[-&f &e&lMost Losses&f &6&l&m-]--'
Lore:
- ' &f&m-------------------------&7 '
- ''
- ' &aSee who losses the most!'
- ''
- ' &f&m-------------------------&7 '
Slot: 20
MostWins:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: ' &6&l&m--[-&f &e&lMost Wins&f &6&l&m-]--'
Lore:
- ' &f&m----------------------&7 '
- ''
- ' &aSee who wins the most!'
- ''
- ' &f&m----------------------&7 '
Slot: 21
HighestTotalScore:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: '&6&l&m--[-&f &e&lHighest Total Score&f &6&l&m-]--'
Lore:
- ' &f&m------------------------------&7 '
- ''
- ' &aSee who has the highest score:'
- ' &a - Overall'
- ' &a - Singleplayer'
- ' &a - Multiplayer'
- ''
- ' &aSorted by highest total score.'
- ''
- ' &f&m------------------------------&7 '
Slot: 22
MostLinesSent:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: ' &6&l&m--[-&f &e&lMost Lines Sent&f &6&l&m-]--'
Lore:
- ' &f&m----------------------------&7 '
- ''
- ' &aSee who sends the most lines:'
- ' &a - Overall'
- ' &a - Singleplayer'
- ' &a - Multiplayer'
- ''
- ' &aSorted by total lines sent.'
- ''
- ' &f&m----------------------------&7 '
Slot: 23
MostKOs:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: ' &6&l&m--[-&f &e&lMost KOs&f &6&l&m-]--'
Lore:
- ' &f&m----------------------&7 '
- ''
- ' &aSee who KOs the most!'
- ''
- ' &f&m----------------------&7 '
Slot: 24
MostPlaytime:
Head: http://textures.minecraft.net/texture/e34a592a79397a8df3997c43091694fc2fb76c883a76cce89f0227e5c9f1dfe
Name: ' &6&l&m--[-&f &e&lMost Playtime&f &6&l&m-]--'
Lore:
- ' &f&m--------------------------&7 '
- ''
- ' &aSee who plays the most:'
- ' &a - Overall'
- ' &a - Singleplayer'
- ' &a - Multiplayer'
- ''
- ' &aSorted by total playtime.'
- ''
- ' &f&m--------------------------&7 '
Slot: 25
Optional:
EdgeRed:
Material: STAINED_GLASS_PANE:14
Name: '&c&l█'
Slots: 0,6,18,44,48
EdgeOrange:
Material: STAINED_GLASS_PANE:1
Name: '&6&l█'
Slots: 1,7,9,46,53
EdgeYellow:
Material: STAINED_GLASS_PANE:4
Name: '&e&l█'
Slots: 2,8,47,52
EdgeGreen:
Material: STAINED_GLASS_PANE:5
Name: '&a&l█'
Slots: 3,17,45,51
EdgeBlue:
Material: STAINED_GLASS_PANE:3
Name: '&b&l█'
Slots: 4,26,36,50
EdgeMagenta:
Material: STAINED_GLASS_PANE:2
Name: '&d&l█'
Slots: 5,27,35,49
HighScore:
Titles:
MostGames: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lG&6&la&e&lm&a&le&b&ls'
MostLosses: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lL&6&lo&e&ls&a&ls&b&le&d&ls'
MostWins: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lW&6&li&e&ln&a&ls'
HighestTotalScore: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lS&6&lc&e&lo&a&lr&b&le'
MostLinesSent: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lL&6&li&e&ln&a&le&b&ls'
MostKOs: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lK&6&lO&e&ls'
MostPlaytime: '&c&lH&6&li&e&lg&a&lh&b&lS&d&lc&c&lo&6&lr&e&le &7&l> &c&lP&6&ll&e&la&a&ly&b<&d&li&c&lm&6&le'
Required:
MostGames:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m-------------------&7 '
- ''
- ' &eTotal Games: &a%totalGames%'
- ' &eSingleplayer: &a%singleplayerGames%'
- ' &eMultiplayer: &a%multiplayerGames%'
- ''
- ' &f&m-------------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
MostLosses:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m-----------------&7 '
- ''
- ' &eLosses: &a%losses%'
- ''
- ' &f&m-----------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
MostWins:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m-----------------&7 '
- ''
- ' &eWins: &a%wins%'
- ''
- ' &f&m-----------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
HighestTotalScore:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m-------------------------&7 '
- ''
- ' &eTotal Score: &a%totalScore%'
- ' &eSingleplayer: &a%singleplayerScore%'
- ' &eMultiplayer: &a%multiplayerScore%'
- ''
- ' &f&m-------------------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
MostLinesSent:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m--------------------&7 '
- ''
- ' &eTotal Lines: &a%totalLines%'
- ' &eSingleplayer: &a%singleplayerLines%'
- ' &eMultiplayer: &a%multiplayerLines%'
- ''
- ' &f&m--------------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
MostKOs:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m-----------------&7 '
- ''
- ' &eKO''s: &a%kos%'
- ''
- ' &f&m-----------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
MostPlaytime:
Head: '%player%'
Name: ' &e&l%position%. &a%player%'
Lore:
- ' &f&m------------------------&7 '
- ''
- ' &eTotal Playtime: &a%totalPlaytime%'
- ' &eSingleplayer: &a%singleplayerPlaytime%'
- ' &eMultiplayer: &a%multiplayerPlaytime%'
- ''
- ' &f&m------------------------&7 '
Slots: 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34
NextPage:
Head: http://textures.minecraft.net/texture/e3fc52264d8ad9e654f415bef01a23947edbccccf649373289bea4d149541f70
Name: '&eNext Page'
Slot: 41
PrevPage:
Head: http://textures.minecraft.net/texture/5f133e91919db0acefdc272d67fd87b4be88dc44a958958824474e21e06d53e6
Name: '&ePrevious Page'
Slot: 39
Back:
Material: BARRIER
Name: '&eMain Menu'
Slot: 40
Loading:
Material: WATCH
Name: '&e&lLoading...'
Slot: 22
Optional:
EdgeRed:
Material: STAINED_GLASS_PANE:14
Name: '&c&l█'
Slots: 0,6,18,44,48
EdgeOrange:
Material: STAINED_GLASS_PANE:1
Name: '&6&l█'
Slots: 1,7,9,46,53
EdgeYellow:
Material: STAINED_GLASS_PANE:4
Name: '&e&l█'
Slots: 2,8,47,52
EdgeGreen:
Material: STAINED_GLASS_PANE:5
Name: '&a&l█'
Slots: 3,17,45,51
EdgeBlue:
Material: STAINED_GLASS_PANE:3
Name: '&b&l█'
Slots: 4,26,36,50
EdgeMagenta:
Material: STAINED_GLASS_PANE:2
Name: '&d&l█'
Slots: 5,27,35,49
Please note that the material names in this file are for 1.12.2. The plugin will automatically generate the correct material names for the version you're running.
# Select the material for the tetrominoes as well as ghost blocks and garbage blocks.
#
# If you are using 1.12 you can use data values e.g. CONCRETE:3
# If you are using 1.13 or above please use full names e.g. LIGHT_BLUE_CONCRETE
Tetrominoes:
I: CONCRETE:3
J: CONCRETE:11
L: CONCRETE:1
O: CONCRETE:4
S: CONCRETE:5
T: CONCRETE:10
Z: CONCRETE:14
Ghost: STAINED_GLASS:8
Garbage: STONE:6
This folder by default contains standard.schematic. This is the structure in which the game takes place. You may create your own by using the /tfa schematic <action> command found here.
This folder by default contains theme.nbs. This is the standard music track played when players are playing Tetris. You can drop in your own .nbs tracks and configure the plugin to play that.
Please note that some configuration files might not be 100% up to date due to updates.
Last updated