Minecraft Wiki
Advertisement

"whitelist" redirects here. For the command, see Commands/whitelist.
Server

The default server.properties file for Java Edition.

server.properties is the file stores all the settings for a multiplayer (Minecraft or Minecraft Classic) server.

When editing server.properties it is important that the same structure as the original is used, although the order of the lines is arbitrary. The text before the equal sign is the key, which should not be changed. The text after the equal sign is the property's value, which can be edited. Lines that begin with # are comments – altering or removing these lines has no effect on the game.

After changes are made to the server.properties file, the server must be restarted for them to take effect.

If the server.properties file does not list all properties (such as if a new version of the server adds new properties, or if the file does not exist), then on startup the server rewrites the server.properties file with the new properties listed and set them to their default values.

File location

Java Edition

This file is automatically generated upon first start of the server (if it doesn't exist).

OS File Location Notes
Windows Same directory as server.jar
Linux

Unix Unix/Mac

Path of Working Directory (pwd)

If you start it from your home directory (/home/yourname) the server files will be created in /home/yourname. Follow these guidelines for ensuring that the server files are generated where you would expect them.

  • Set aside an entire directory for all of the server files. (Things could get messy if you don't).
    • Place your server.jar here.
  • Use this script as a guideline for setting up a startup script for your Minecraft server.
    • Make sure it's in your executable $PATH
    • Be sure to add the execution permission to the startup script (chmod +x file_name, or use a folder manager)
      • minecraft_server.sh

Bedrock Edition

This file is downloaded with bedrock_server.exe.

OS File Location
Windows Same directory as bedrock_server.exe
Linux Same directory as bedrock_server

server.properties

These are the default settings for a newly installed Minecraft server:

Java Edition

#Minecraft server properties
#(File Modification Datestamp)
broadcast-rcon-to-ops=true
view-distance=10
max-build-height=256
server-ip=
level-seed=
rcon.port=25575
gamemode=survival
server-port=25565
allow-nether=true
enable-command-block=false
enable-rcon=false
enable-query=false
op-permission-level=4
prevent-proxy-connections=false
generator-settings=
resource-pack=
level-name=world
rcon.password=
player-idle-timeout=0
motd=A Minecraft Server
query.port=25565
force-gamemode=false
hardcore=false
white-list=false
broadcast-console-to-ops=true
pvp=true
spawn-npcs=true
generate-structures=true
spawn-animals=true
snooper-enabled=true
difficulty=easy
function-permission-level=2
network-compression-threshold=256
level-type=default
spawn-monsters=true
max-tick-time=60000
enforce-whitelist=false
use-native-transport=true
max-players=20
resource-pack-sha1=
spawn-protection=16
online-mode=true
allow-flight=false
max-world-size=29999984

Bedrock Edition

server-name=Dedicated Server
gamemode=survival
difficulty=easy
allow-cheats=false
max-players=10
online-mode=true
white-list=false
server-port=19132
server-portv6=19133
view-distance=32
tick-distance=4
player-idle-timeout=30
max-threads=8
level-name=Bedrock level
level-seed=
default-player-permission-level=member
texturepack-required=false

Minecraft server properties

Java Edition

Key Type Default Value Description
allow-flight boolean false Allows users to use flight on your server while in Survival mode, if they have a mod that provides flight installed.

With allow-flight enabled, griefers may become more common, because it makes their work easier. In Creative mode this has no effect.

false - Flight is not allowed (players in air for at least 5 seconds get kicked).
true - Flight is allowed, and used if the player has a fly mod installed.
allow-nether boolean true Allows players to travel to the Nether.
false - Nether portals will not work.
true - The server allows portals to send players to the Nether.
difficulty string easy Defines the difficulty (such as damage dealt by mobs and the way hunger and poison affects players) of the server.

If a legacy difficulty number is specified, it is silently converted to a difficulty name.

peaceful (0)
easy (1)
normal (2)
hard (3)
enable-command-block boolean false Enables command blocks
enable-query boolean false Enables GameSpy4 protocol server listener. Used to get information about server.
enable-rcon boolean false Enables remote access to the server console.
force-gamemode boolean false Force players to join in the default game mode.
false - Players will join in the gamemode they left in.
true - Players will always join in the default gamemode.
function-permission-level integer (1-4) 2 Sets the default permission level for functions.

See #op-permission-level for the details on the 4 levels.

gamemode string survival Defines the mode of gameplay.

If a legacy gamemode number is specified, it is silently converted to a gamemode name.

survival (0)
creative (1)
adventure (2)
spectator (3)
generate-structures boolean true Defines whether structures (such as villages) can be generated.
false - Structures will not be generated in new chunks.
true - Structures will be generated in new chunks.

Note: Dungeons still generate if this is set to false.

generator-settings string blank The settings used to customize world generation. See Superflat and Customized for possible settings and examples.
hardcore boolean false If set to true, server difficulty is ignored and set to hard and players will be set to spectator mode if they die.
level-name string world The "level-name" value is used as the world name and its folder name. You may also copy your saved game folder here, and change the name to the same as that folder's to load it instead.
Characters such as ' (apostrophe) may need to be escaped by adding a backslash before them.
level-seed string blank Add a seed for your world, as in Singleplayer.
Some examples are: minecraft, 404, 1a2b3c.
level-type string default Determines the type of map that is generated.
default - Standard world with hills, valleys, water, etc.
flat - A flat world with no features, can be modified with generator-settings.
largebiomes - Same as default but all biomes are larger.
amplified - Same as default but world-generation height limit is increased.
buffet - Same as default unless generator-settings is set to a preset.
max-build-height integer 256 The maximum height in which building is allowed. Terrain may still naturally generate above a low height limit.
max-players integer (0-2147483647) 20 The maximum number of players that can play on the server at the same time. Note that more players on the server consume more resources. Note also, op player connections are not supposed to count against the max players, but ops currently cannot join a full server. However, this can be changed by going to the file called ops.json in your server directory, opening it, finding the op you want the change, and changing the setting called bypassesPlayerLimit to true (the default is false). This means that that op does not have to wait for a player to leave in order to join. Extremely large values for this field result in the client-side user list being broken.
max-tick-time
integer (0–(2^63 - 1)) 60000 The maximum number of milliseconds a single tick may take before the server watchdog stops the server with the message, A single server tick took 60.00 seconds (should be max 0.05); Considering it to be crashed, server will forcibly shutdown. Once this criterion is met, it calls System.exit(1).
-1 - disable watchdog entirely (this disable option was added in 14w32a)
max-world-size
integer (1-29999984) 29999984 This sets the maximum possible size in blocks, expressed as a radius, that the world border can obtain. Setting the world border bigger causes the commands to complete successfully but the actual border does not move past this block limit. Setting the max-world-size higher than the default doesn't appear to do anything.

Examples:

  • Setting max-world-size to 1000 allows you to have a 2000×2000 world border.
  • Setting max-world-size to 4000 gives you an 8000×8000 world border.
motd string A Minecraft Server This is the message that is displayed in the server list of the client, below the name.
  • The MOTD supports color and formatting codes.
  • The MOTD supports special characters, such as "♥". However, such characters must be converted to escaped Unicode form. An online converter can be found here.
  • If the MOTD is over 59 characters, the server list will likely report a communication error.
network-compression-threshold
integer 256 By default it allows packets that are n-1 bytes big to go normally, but a packet of n bytes or more will be compressed down. So, a lower number means more compression but compressing small amounts of bytes might actually end up with a larger result than what went in.
-1 - disable compression entirely
0 - compress everything

Note: The Ethernet spec requires that packets less than 64 bytes become padded to 64 bytes. Thus, setting a value lower than 64 may not be beneficial. It is also not recommended to exceed the MTU, typically 1500 bytes.

online-mode boolean true Server checks connecting players against Minecraft account database. Only set this to false if your server is not connected to the Internet. Hackers with fake accounts can connect if this is set to false! If minecraft.net is down or inaccessible, no players can connect if this is set to true. Setting this variable to off purposely is called "cracking" a server, and servers that are presently with online mode off are called "cracked" servers, allowing players with unlicensed copies of Minecraft to join.
true - Enabled. The server will assume it has an Internet connection and checks every connecting player.
false - Disabled. The server will not attempt to check connecting players.
op-permission-level integer (1-4) 4 Sets the default permission level for ops when using /op. All levels inherit abilities and commands from levels before them.
1 - Ops can bypass spawn protection.
2 - Ops can use all singleplayer cheats commands (except /publish, as it is not on servers; along with /debug) and use command blocks. Command blocks, along with Realms owners/operators, have the same permissions as this level.
3 - Ops can use most multiplayer-exclusive commands, including /debug, and commands that manage players (/ban, /op, etc).
4 - Ops can use all commands including /stop, /save-all, /save-on, and /save-off.
player-idle-timeout integer 0 If non-zero, players are kicked from the server if they are idle for more than that many minutes.
Note: Idle time is reset when the server receives one of the following packets:
prevent-proxy-connections boolean false If the ISP/AS sent from the server is different from the one from Mojang's authentication server, the player is kicked
true - Enabled. Server prevents users from using vpns or proxies.
false - Disabled. The server doesn't prevent users from using vpns or proxies.
pvp boolean true Enable PvP on the server. Players shooting themselves with arrows receive damage only if PvP is enabled.
true - Players can kill each other.
false - Players cannot kill other players (also known as Player versus Environment (PvE)).

Note: Indirect damage sources spawned by players (such as lava, fire, TNT and to some extent water, sand and gravel) still deal damage to other players.

query.port integer (1-65534) 25565 Sets the port for the query server (see enable-query).
rcon.password string blank Sets the password for RCON: a remote console protocol that can allow other applications to connect and interact with a Minecraft server over the internet.
rcon.port integer (1-65534) 25575 Sets the RCON network port.
resource-pack string blank Optional URI to a resource pack. The player may choose to use it.

Note that the ":" and "=" characters need to be escaped with backslash (\), e.g. http\://somedomain.com/somepack.zip?someparam\=somevalue

The resource pack may not have a larger file size than 50 MiB (≈ 50.4 MB). Note that download success or failure is logged by the client, and not by the server.

resource-pack-sha1
string blank Optional SHA-1 digest of the resource pack, in lowercase hexadecimal. It's recommended to specify this. This is not yet used to verify the integrity of the resource pack, but improves the effectiveness and reliability of caching.
server-ip string blank Set this if you want the server to bind to a particular IP. It is strongly recommended that you leave server-ip blank!
Set to blank, or the IP you want your server to run (listen) on.
server-port integer (1-65534) 25565 Changes the port the server is hosting (listening) on. This port must be forwarded if the server is hosted in a network using NAT (If you have a home router/firewall).
snooper-enabled boolean true Sets whether the server sends snoop data regularly to http://snoop.minecraft.net.
false - disable snooping.
true - enable snooping.
spawn-animals boolean true Determines if animals can spawn.
true - Animals spawn as normal.
false - Animals immediately vanish.

Tip: if you have major lag, turn this off/set to false.

spawn-monsters boolean true Determines if monsters can spawn.
true - Enabled. Monsters will appear at night and in the dark.
false - Disabled. No monsters.

This setting has no effect if difficulty = 0 (peaceful). If difficulty is not = 0, a monster can still spawn from a Monster Spawner.

Tip: if you have major lag, turn this off/set to false.

spawn-npcs boolean true Determines whether villagers can spawn.
true - Enabled. Villagers will spawn.
false - Disabled. No villagers.
spawn-protection integer 16 Determines the radius of the spawn protection as 2x+1. Setting this to 0 does not disable spawn protection, but protects the single block at the spawn point. 1 protects a 3×3 area centered on the spawn point. 2 protects 5×5, 3 protects 7×7, etc. This option is not generated on the first server start and appears when the first player joins. If there are no ops set on the server, the spawn protection is disabled automatically.
use-native-transport boolean true Linux server performance improvements: optimized packet sending/receiving on Linux
true - Enabled. Enable Linux packet sending/receiving optimization
false - Disabled. Disable Linux packet sending/receiving optimization
view-distance integer (3-32) 10 Sets the amount of world data the server sends the client, measured in chunks in each direction of the player (radius, not diameter). It determines the server-side viewing distance.

10 is the default/recommended. If you have major lag, reduce this value.

Note: A value less than 9 has a big impact on mob spawning on the server, as noted in bug MC-2536.

white-list boolean false Enables a whitelist on the server.

With a whitelist enabled, users not on the whitelist cannot connect. Intended for private servers, such as those for real-life friends or strangers carefully selected via an application process, for example.

false - No white list is used.
true - The file whitelist.json is used to generate the white list.

Note: Ops are automatically white listed, and there is no need to add them to the whitelist.

enforce-whitelist boolean false Enforces the whitelist on the server.

When this option is enabled, users who are not present on the whitelist (if it's enabled) get kicked from the server after the server reloads the whitelist file.

false - No user will be kicked if not on the whitelist.
true - Online users not on the whitelist will be kicked.

In versions prior to Java Edition 1.12, the announce-player-achievements boolean property (default true) was used to toggle whether achievements were broadcasted to all players. This property no longer exists, but if it is set, the announceAdvancements gamerule is automatically updated to match, and the property is removed.

Bedrock Edition

Option name Possible values Default value When is it used Use Notes
gamemode survival (0), creative (1), adventure (2) survival Always or only for new players Sets the game mode for new players.
difficulty peaceful (0), easy (1), normal (2), hard (3) easy Always Sets the difficulty of the world.
level-type FLAT, LEGACY, DEFAULT DEFAULT World creation Determines the type of map that is generated.
server-name Any string Dedicated Server Always Used as the server name This is the server name shown in the in-game server list.
max-players Positive integer 10 Always The maximum number of players that can play on the server. The maximum numbers of players that should be able to play on the server. Higher values have performance impact.
server-port Any integer 19132 Always Which IPv4 port the server should listen to.
server-portv6 Any integer 19133 Always Which IPv6 port the server should listen to.
level-name Any string level Always The "level-name" value is used as the world name and its folder name. You may also copy your saved game folder here, and change the name to the same as that folder's to load it instead. The name of level to be used/generated. Each level has its own folder in /worlds.
level-seed Any string Defaults to empty (th34f1ju34facjn5f871df312h) World creation Use to randomize the world The seed to be used for randomizing the world. If left empty, a seed is chosen at random.
online-mode true, false true Always If true then all connected players must be authenticated to Xbox Live. If true then all connected players must be authenticated to Xbox Live.
white-list true, false false Always If true then all connected players must be listed in the separate whitelist.json file. If true then all connected players must be listed in the separate whitelist.json file.
allow-cheats true, false false Always If true then cheats like commands can be used.
view-distance Any integer 10 Always The maximum allowed view distance in number of chunks. The maximum allowed view distance. Higher values have performance impact.
player-idle-timeout Any integer 30 Always After a player has idled for this many minutes they will be kicked. After a player has idled for this many minutes they will be kicked.
max-threads Any integer 8 Always Maximum number of threads the server will try to use. If set to 0 or removed then it will use as many as possible. Maximum number of threads the server will try to use.
tick-distance An integer in the range [4, 12] 4 Always The world will be ticked this many chunks away from any player. The world will be ticked this many chunks away from any player. Higher values have performance impact.
default-player-permission-level visitor, member, operator member Always Permission level for new players joining for the first time. Which permission level new players will have when they join for the first time.
texturepack-required true, false false Always Force clients to use texture packs in the current world If the world uses any specific texture packs then this setting will force the client to use it.

Minecraft Classic server properties

Key Type Default Value Description
verify-names boolean true If enabled the server will make sure that the client is logged in with the same IP on Minecraft.net. This has caused problems for people trying to play on the same computer they are hosting the server on as the server will see the local IP (127.0.0.1) while Minecraft.net will see the external IP. It is recommended that this is enabled unless you want to play on your server from the same computer you are hosting it on
true - Enabled. The server will check all names with Minecraft.net
false - Disabled. The server will make sure the IP matches
admin-slot boolean false Allow ops to join even if the server is full.
public boolean Whether the server should be displayed in the server list, or not.
true - The server will be displayed in the server list - anyone can see it.
false - Only people with the URL which can be found in externalurl.txt and people who know the IP and port can join the server
server-name string The name of the server. This is displayed in the server list and when someone is joining the server
  • A single line of text. Characters such as ' (apostrophe) may need to be escaped by adding a backslash before them.
max-players integer (0-256) The max numbers of players that can play on the server at the same time. Note that if more players are on the server it will use more resources. Note also, admin connections are not counted against the max players.
max-connections integer (1-3) The max number of connections the server will accept from the same IP.

Note: If you try to set it higher than 3 it will be changed back to 3.

motd string MOTD is short for Message of the day, though you do not need to change it every day. The MOTD is displayed when people join the server.
grow-trees boolean Whether or not the server will allow planted saplings to grow into trees.
true - the server will allow saplings to grow into trees.
false - the server will not allow saplings to grow into trees.

History

Clock JE3
This section needs to be updated. 
Please update this section to reflect recent updates or newly available information.
Reason: History section nearly completely empty
Java Edition
1.14.4
{{Extension DPL}}<ul><li>[[Gunpowder|Gunpowder]]<br/>{{Item
| image = Gunpowder.png
| stackable = Yes (64)
| renewable = Yes
}}

'''Gunpowder''' is an item that is used for [[explosion]]-related recipes, and as an ingredient in potions.

== Obtaining ==

=== Mob loot ===

==== Creepers ====

[[Creeper]]s can drop 0-2 pieces of gunpowder upon death. [[Looting]] can increase this by one per level, with a maximum of 5 gunpowder.

==== Ghasts ====

[[Ghast]]s can drop 0-2 pieces of gunpowder upon death. Looting can increase this by one per level, with a maximum of 5 gunpowder.

==== Witches ====

[[Witch]]es can drop 0-6 pieces of gunpowder upon death. Looting can increase this by three per level, with a maximum of 15 gunpowder.
<!--
=== Crafting ===

{{Crafting
|showdescription=1
|description= {{only|bedrock|education}}
|Coal; Charcoal
|Sulfur
|Bone Meal
|Output= Gunpowder, 3
|type= Miscellaneous
}}
-->
=== Trading ===

<!--Wandering trader always offer one of the 5 item (one of them is gunpowder)-->

[[Wandering trader]]s have {{frac|1|6}} chance to sell gunpowder for an [[emerald]].

=== Chest loot ===

{{LootChestItem|gunpowder}}

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Brewing ingredient ===
{{brewing
  |name=[[Splash Potion]]
  |showname=1
  |Gunpowder
  |Splash Mundane Potion; Splash Potion of Healing; Splash Potion of Fire Resistance; Splash Potion of Harming; Splash Potion of Poison; Splash Potion of Regeneration; Splash Potion of Slowness; Splash Potion of Strength; Splash Potion of Swiftness; Splash Potion of Weakness; Splash Potion of Night Vision; Splash Potion of Invisibility; Splash Potion of Water Breathing; Splash Potion of Leaping
  |base=Any Potion
}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Gunpowder
|spritetype=item
|nameid=gunpowder
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gunpowder
|spritetype=item
|nameid=gunpowder
|id=328
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100130|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.
|Gunpowder is a [[crafting]] ingredient for [[TNT]]. 
|Gunpowder can be [[drops|dropped]] by any [[mob]].}}
{{History||20100219|Gunpowder now [[drops]] only from [[creeper]]s.}}
{{History|java infdev}}
{{History||20100625-2|Gunpowder can now be found in [[dungeon]] [[chest]]s.}}
{{History|java alpha}}
{{History||v1.2.0|snap=preview|Added [[ghast]]s, which [[drops|drop]] gunpowder upon [[death]].{{needs testing|was their gunpowder dropping present in the preview version, or added later on?|type=untestable}}}}
{{History|java beta}}
{{History||1.0|The item now has a display name: ''Sulphur''.}}
{{History||1.3|''Sulphur'' has been renamed to ''Gunpowder''.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 4|Gunpowder is now usable in [[brewing]] to create [[splash potion]]s.}}
{{History||1.2.1|snap=12w04a|[[Fire charge]]s are now [[crafting|crafted]] with gunpowder.}}
{{History||1.4.2|snap=12w38b|[[Witch]]es may now [[drops|drop]] gunpowder.}}
{{History||1.4.6|snap=12w49a|Gunpowder can now be used to craft a [[firework star]] and a [[firework rocket]].}}
{{History||1.9|snap=15w44a|Gunpowder now generates in [[desert temple]] [[chest]]s.
|The average yield of gunpowder in [[dungeon]] chests has now doubled.}}
{{History||1.11|snap=16w39a|Gunpowder can now be found in [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 289.}}
{{History|||snap=18w11a|Gunpowder can now generate in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}
{{History|||snap=19w05a|Added [[wandering trader]]s, which sell gunpowder.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|Gunpowder now drops when brushing [[suspicious sand]] in [[desert pyramid]]s.}}
{{History||1.20|snap=23w12a|The probability for the gunpowder to generate in [[suspicious sand]] in [[desert temple]]s has been changed from 1/7 to 1/8.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder. It is currently unobtainable and serves no purpose.}}
{{History||v0.3.3|Gunpowder now drops from [[creeper]]s. It is still unobtainable due to creepers not yet spawning naturally.}}
{{History||v0.4.0|Creepers now spawn naturally, making gunpowder obtainable in Survival mode.
|Gunpowder can now be used to craft [[TNT]].}}
{{History||v0.12.1|snap=build 1|Added gunpowder to the [[creative]] [[inventory]].
|Gunpowder is now usable in [[brewing]] to create [[splash potion]]s.}}
{{History||v0.13.0|snap=build 1|Gunpowder can now be found inside [[desert temple]] [[chest]]s.}}
{{History||v0.14.0|snap=build 1|Gunpowder can now be dropped by [[witch]]es.}}
{{History||v0.15.0|snap=build 1|Gunpowder can now be used to craft [[fire charge]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gunpowder now generates inside [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gunpowder can now be used to craft [[firework rocket]]s and [[firework star]]s.}}
{{History||1.4.0|snap=beta 1.2.14.2|Gunpowder now generates inside [[shipwreck]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Gunpowder now drops when brushing [[suspicious sand]] in [[desert pyramid]]s.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.}}
{{History|foot}}

== Issues ==
{{issue list}}

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--gunpowder Taking Inventory: Gunpowder] – Minecraft.net on June 21, 2019

{{Items}}

[[Category:Recipe using Charcoal]]

[[cs:Střelný prach]]
[[de:Schwarzpulver]]
[[es:Pólvora]]
[[fr:Poudre à canon]]
[[hu:Puskapor]]
[[it:Polvere da sparo]]
[[ja:火薬]]
[[ko:화약]]
[[nl:Buskruit]]
[[pl:Proch]]
[[pt:Pólvora]]
[[ru:Порох]]
[[th:ดินปืน]]
[[tr:Barut]]
[[uk:Порох]]
[[zh:火药]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li><li>[[String|String]]<br/>{{Block
| image = <gallery>
String JE2 BE2.png  | String
Tripwire (NESW).png | Tripwire
</gallery>
| extratext = View [[#Gallery|all renders]]
| transparent = Yes
| light = No
| tool = any
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = No
}}
'''String''' is an item used in [[crafting]] recipes such as [[bow]]s, [[fishing rod]]s and [[lead]]s. When placed as a [[block]], string becomes '''tripwire''', which can be combined with [[Tripwire Hook|tripwire hooks]] to form a tripwire circuit.

== Obtaining==
String can be obtained from [[drop]]s, breaking [[cobweb]]s, [[fishing]], [[bartering]], and as gifts from [[cat]]s. String can be looted from [[jungle temple]]s, [[desert pyramid]] chests, and [[dungeon]]s.

===Breaking ===
Tripwire can be {{control|mine|text=mined}} instantly with any [[tool]], dropping string. Tripwire is also removed and drops string as an [[item]] when:
*[[Water]] flows into its space
* A [[piston]] pushes it or moves a [[block]] into its space
Tripwire is destroyed without dropping string if [[lava]] flows into its space.

A [[cobweb]] drops string when it is broken in these ways (see also {{section link|Cobweb|Usage}}):
*Breaking a cobweb with a [[sword]]
*Pushing a cobweb with a [[piston]]
*[[Water]] breaking a cobweb by flowing over it (flowing [[lava]] destroys cobwebs without leaving string)

===Natural generation===
Five pieces of tripwire generate naturally in every [[jungle temple]]. 

===Mob loot ===
[[Spider]]s and [[cave spider]]s drop 0–2 string upon death. The maximum is increased by 1 per level of [[Looting]], for a maximum of 0–5 string with Looting III.

[[Strider]]s drop 2–5 string upon death. The maximum is increased by 1 per level of [[Looting]], for a maximum of 2–8 string with Looting III.{{only|Java|short=1}}

[[Cat]]s drop 0–2 string upon death, unaffected by Looting.<ref>{{bug|MC-200707||Looting does not increase drops for iron golems and cats}}</ref>

===Chest loot===
{{LootChestItem|string}}

===Fishing===
String has a 0.6% ({{frac|3|500}}) chance of being caught when [[fishing]] with an unenchanted fishing rod. The chance decreases to 0.5% ({{frac|1|200}}), 0.4% ({{frac|1|250}}), and 0.3% ({{frac|3|1000}}) if the fishing rod is enchanted with [[Luck of the Sea]] at enchantment levels I, II, and III, respectively.

===Cat gifts===
{{main|Cat#Gifts}}

Tamed [[cat]]s have a 70% chance of giving the [[player]] a gift when they wake up from a [[bed]], and the gift has a 16.13% chance to be a string.

===Bartering ===
[[Piglin]]s may [[barter]] 3-9 string when given a [[gold ingot]].

== Usage==
String can be used as a crafting ingredient and tripwire can be used as a [[redstone circuit]] component. It can also be used to keep [[player]]s from ender-pearling through that space.

=== Crafting ingredient===
{{crafting usage}}

===Redstone component===
{{redirect|Tripwire|tripwire hooks|Tripwire Hook}}
{{see also|Redstone circuits}}

String can be placed as tripwire, which can be used to detect [[entity|entities]] as part of a tripwire circuit. [[Observer]]s can also be used with a tripwire to generate redstone signals. 

;Placement

To place tripwire, {{control|use}} string while pointing at a surface facing the space the tripwire should occupy.

{{Schematic | caption =
'''Tripwire Circuit'''
|SB|th-$w|tw-$ew|th-$e|SB
}}
:In order to activate [[tripwire hook]]s, tripwire must be part of a "tripwire circuit": a straight line of [[block]]s consisting of a block with a tripwire hook attached to it, a "tripwire line" (1 to 40 blocks of tripwire), and a second tripwire hook attached to another block. 

;Activation
Tripwire activates if almost any [[entity]] ([[player]]s, [[mob]]s, [[minecart]]s, [[boat]]s, [[item]]s, [[arrow]]s, etc.) intersects its collision mask. The tripwire remains active until there are no entities intersecting its collision mask. Thrown [[potion]]s, some arrows, thrown [[ender pearl]]s, and thrown [[eyes of ender]] do not activate tripwire.

;Behavior
An active tripwire updates adjacent [[block]]s (for example, it can activate a [[Tutorials/Block update detector|BUD circuit]]). Additionally, active tripwires that are part of valid tripwire circuits cause the attached tripwire hooks to activate (producing [[redstone]] power). Active tripwires do ''not'' themselves produce redstone power.

When tripwire is broken (including by being washed away by spreading [[water]] {{in|java}}) after being part of a valid tripwire circuit, it activates the attached tripwire hooks for 5 redstone ticks (10 game [[tick]]s, or 0.5 seconds barring lag). It does not produce the signal if it is broken using [[shear]]s.

===Trading===
Novice-level fisherman [[villager]]s have a 50% chance to buy 20 string as part of their first-tier trade.

Journeyman-level fletcher villagers buy 14 string for 1 [[emerald]] as part of their trade.

==Sounds==
=== Generic===
{{Sound table/Block/Normal}}

===Unique===
{{edition|java}}:
{{Sound table
|rowspan=3
|sound=Click.ogg
|subtitle=Tripwire attaches
|source=block
|description=When a tripwire line is completed
|id=block.tripwire.attach
|translationkey=subtitles.block.tripwire.attach
|volume=0.4
|pitch=0.7
|distance=16}}
{{Sound table
|subtitle=Tripwire clicks
|source=block
|description=When a tripwire line deactivates
|id=block.tripwire.click_off
|translationkey=subtitles.block.tripwire.click
|volume=0.4
|pitch=0.5
|distance=16}}
{{Sound table
|subtitle=Tripwire clicks
|source=block
|description=When a tripwire line activates
|id=block.tripwire.click_on
|translationkey=subtitles.block.tripwire.click
|volume=0.4
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Arrow hit1.ogg
|sound2=Arrow hit2.ogg
|sound3=Arrow hit3.ogg
|sound4=Arrow hit4.ogg
|subtitle=Tripwire detaches
|source=block
|description=When a tripwire hook in a tripwire line is destroyed
|id=block.tripwire.detach
|translationkey=subtitles.block.tripwire.detach
|volume=0.4
|pitch={{frac|12|11}}-{{frac|4|3}}
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|rowspan=3
|sound=Click.ogg
|source=block
|description=When a tripwire line is completed
|id=block.click
|volume=0.2
|pitch=0.7}}
{{Sound table
|type=bedrock
|source=block
|description=When a tripwire line deactivates
|id=random.click
|volume=0.2
|pitch=0.5}}
{{Sound table
|source=block
|description=When a tripwire line activates
|id=random.click
|volume=0.2
|pitch=0.6}}
{{Sound table
|sound=Arrow hit1.ogg
|sound2=Arrow hit2.ogg
|sound3=Arrow hit3.ogg
|sound4=Arrow hit4.ogg
|source=block
|description=When a tripwire hook in a tripwire line is destroyed
|id=block.bowhit
|volume=0.4
|pitch=1.1-1.33
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Tripwire
|spritetype=block
|nameid=tripwire
|blocktags=wall_post_override
|form=block}}
{{ID table
|displayname=String
|spritetype=item
|nameid=string
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showaliasids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Tripwire
|spritetype=block
|nameid=trip_wire
|aliasid=tripWire
|id=132
|form=block
|itemform=trip_wire
|translationkey=tile.tripWire.name}}
{{ID table
|displayname=String
|spritetype=item
|nameid=string
|id=326
|form=item
|foot=1}}

===Block states===
{{see also|Block states}}

{{/BS}}

==Video==
<div style="text-align:center">
<span style="display:inline-block">{{yt|WUlhmu3JbcQ}}</span>
<span style="display:inline-block">{{yt|-7jEtrETxwc}}</span>
</div>

==History==
{{History|java indev}}
{{History||0.31|snap=20100129|[[File:String JE1 BE1.png|32px]] Added string.}}
{{History|||snap=20100130|[[Bow]]s can now be [[crafting|crafted]] using string.}}
{{History|||snap=20100201-2|[[Wool|Cloth]] can now be crafted using nine string.}}
{{History||20100219|[[Spider]]s now [[drops|drop]] string.}}
{{History|java infdev}}
{{History||20100625-2|String can now be found inside [[chest]]s in the new [[dungeon]]s.}}
{{History|java alpha}}
{{History||v1.1.1|String can now be used to craft [[fishing rod]]s.}}
{{History|java beta}}
{{History||1.5|Introduced [[cobweb]]s, which [[drops|drop]] string when [[breaking|broken]] with a [[sword]].}}
{{History||1.6.6|Wool is now crafted from four string rather than nine.}}
{{History||1.7|Cobwebs now drop string when broken using [[shears]].}}
{{History||1.8|snap=Pre-release|Cobwebs now generate naturally, making them a viable method to obtain string.}}
{{History|java}}
{{History||May 28, 2012|link=none|Tripwire was first revealed on [[Dinnerbone]]'s [[wikipedia:Twitter|Twitter]].<ref>{{tweet|Dinnerbone|207154562711289856|It's a tripwire, yeah.|May 28, 2012}}</ref><ref>{{tweet|Dinnerbone|207155073023868928|You place it yourself. String is now placeable|May 28, 2012}}</ref> Dinnerbone released a [{{ytl|mWuvXIzYcTc}} video] showing him experimenting with tripwire before its release.}}
{{History||1.3.1|snap=12w22a|String can now be placed on the ground as tripwire.}}
{{History|||snap=12w23a|Tripwire can now activated by most [[entity|entities]] (including [[arrow]]s).
|The max distance of tripwire has now been increased from 18 to 40 [[block]]s.
|Tripwire now has a translucent texture.}}
{{History||1.6.1|snap=13w18a|String can now be used to craft [[lead]]s.}}
{{History||1.8|snap=14w02a|String can now be [[trading|sold]] to fletcher and fisherman [[villager]]s, at 15–20 string for 1 [[emerald]].}}
{{History|||snap=release|Tripwire is now translucent.}}
{{History||1.9|snap=15w44a|String now generates in [[desert temple]] [[chest]]s.
|The average yield of string in [[dungeon]] chests has now more than doubled.}}
{{History|||snap=15w49a|The <code>suspended</code> block state has now been removed from tripwire.}}
{{History||1.11|snap=16w39a|String can now be found in [[woodland mansion]] [[chest]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 132 and the [[item]]'s was 287.
|Tripwire can now be disarmed.}}
{{History||1.14|snap=18w43a|String can now be used to craft [[crossbow]]s and a [[loom]].
|[[File:String JE2 BE2.png|32px]] The texture of string has now been changed.}}
{{History|||snap=18w44a|[[Cat]]s now drop 0-2 string upon death.
|Cats now offer string as [[Cat#Gifts|gift]]s.}}
{{History|||snap=18w45a|String can now be used to craft [[scaffolding]].}}
{{History|||snap=18w47a|String can now be found inside [[pillager outpost]] [[chest]]s.}}
{{History||1.16|snap=20w09a|String can now be obtained through [[bartering]] with [[piglin]]s.}}
{{History|||snap=20w13a|[[Strider]]s now [[drops|drop]] string upon [[death]].}}
{{History|||snap=20w16a|String now generates in [[bastion remnant]] chests.}}
{{History||1.17|snap=20w45a|String can now be used to craft [[bundle]]s and [[candle]]s.}}
{{History|||snap=21w13a|The model of the tripwire has been tweaked that the underside texture is mirrored.}}
{{History|||snap=21w19a|String can no longer be used to craft bundles and candles.}}
{{History|||snap=Pre-release 1|String can once again used to craft candles.}}
{{History||1.18|snap=Experimental Snapshot 1|String can now once again be used to craft bundles.}}
{{History|||snap=21w37a|String once again can no longer be used to craft bundles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|String can now once again be used to craft bundles.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|String can now be used to craft [[brush]]es.}}
{{History|||snap=1.19.4-pre1|String can no longer be used to craft [[brush]]es.}}
{{History||1.20|snap=23w12a|String can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|String no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; string now is in the common loot.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:String JE1 BE1.png|32px]] Added string. It is currently unobtainable and serves no purpose.}}
{{History||v0.3.3|Added spiders, which drop string when they die.
|String can now be used to [[crafting|craft]] [[bow]]s.}}
{{History||v0.4.0|String can now be crafted into [[wool]].}}
{{History||v0.11.0|snap=build 1|String can now be used to craft [[fishing rod]]s.
|String can now be caught as a junk [[item]] from [[fishing]].}}
{{History||v0.13.0|snap=build 1|String can now be placed on the ground as a tripwire.
|String can now be found in [[desert temple]] [[chest]]s.}}
{{History||v0.15.0|snap=build 1|String can now be used to craft [[lead]]s.
|Tripwire now generates in [[jungle temple]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|15-20 String can now be [[trading|sold]] to fletcher and fisherman [[villager]]s for an [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|String can now be found in [[woodland mansion]] [[chest]]s.
|[[Cobweb]]s can now be used to [[crafting|craft]] 9 string.}}
{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.8|Tamed [[cat]]s can now give the [[player]] string as gifts.
|String can now be used to craft [[scaffolding]].
|[[Cat]]s now [[drops|drop]] 0–2 string.}}
{{History|||snap=beta 1.8.0.10|String can now be used to craft [[crossbow]]s.}}
{{History||1.9.0|snap=beta 1.9.0.0|Tripwire string that is broken now activates, unless broken with [[shears]].}}
{{History||1.10.0|snap=beta 1.10.0.3|String can now be found in [[pillager outpost]] chests.
|String can now be used to craft a [[loom]].
|[[File:String JE2 BE2.png|32px]] The texture of string has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has now been changed, fisherman [[villager]]s now have a 50% chance to [[trading|buy]] 20 string as part of their first-tier trade.
|Fletcher villagers now buy 14 string for an [[emerald]] as their third-tier trade.}}
{{History||1.16.0|snap=beta 1.16.0.57|String can now be obtained through [[bartering]] with [[piglin]]s.
|Added [[strider]]s, which [[drops|drop]] string upon [[death]].
|String can now be found in [[bastion remnant]] chests.}}
{{History||1.17.10|snap=beta 1.17.10.22|String can now be used to craft [[candles]].}}
{{History||1.18.30|snap=beta 1.18.30.26|The ID of tripwire block is changed from <code>tripWire</code> to <code>trip_wire</code>}}
{{History||1.20.10|snap=beta 1.20.10.20|String can no longer be crafted from cobwebs.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:String JE1 BE1.png|32px]] Added string.}}
{{History||xbox=TU14|ps=1.04|String can now be placed on the ground as [[tripwire]].}}
{{History||xbox=none|xbone=none|ps=1.88|wiiu=none|switch=none|Tripwires are now activated when [[breaking|broken]], unless broken with [[shears]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:String JE2 BE2.png|32px]] The texture of string has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:String JE1 BE1.png|32px]] Added string.}}
{{History|foot}}

===Tripwire "item"===
{{:Technical blocks/Tripwire}}

== Issues ==
{{Issue list}}

== Gallery ==
<gallery>
Tripwire (NS).png|
Tripwire (N).png|
Tripwire (E).png|
Tripwire (S).png|
Tripwire (W).png|
Tripwire (EW).png|
Tripwire (NE).png|
Tripwire (ES).png|
Tripwire (SW).png|
Tripwire (NW).png|
Tripwire (ESW).png|
Tripwire (NSW).png|
Tripwire (NEW).png|
Tripwire (NES).png|
</gallery>

=== Screenshots ===
<gallery>
DinnerboneTripwireDev3.png|The first image of tripwires [[dinnerbonetweet:207154292593917952|released]] by Mojang.
DinnerboneTripwireDev4.png|An image [[dinnerbonetweet:207294114398605312|released]] by Mojang testing visibility of tripwires from a distance at night.
DinnerboneTripwireDev5.png|The same room viewed from the same angle, in daytime.
Dinnerbone String.png|Power lines made of suspended string blocks.
</gallery>

==References==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--string Taking Inventory: String] – Minecraft.net on May 14, 2020

{{Redstone}}
{{Items}}
{{Blocks|Utility}}

[[Category:Redstone mechanics]]
[[Category:Mechanics]]
[[Category:Mechanisms]]
[[Category:Generated structure blocks]]
[[Category:Non-solid blocks]]

[[cs:Vlákno]]
[[de:Faden]]
[[es:Hilo]]
[[fr:Ficelle]]
[[hu:Fonál]]
[[it:Cordicella]]
[[ja:糸]]
[[ko:실]]
[[nl:Draad]]
[[pl:Nić]]
[[pt:Linha]]
[[ru:Нить]]
[[th:เส้นใย]]
[[uk:Нитка]]
[[zh:线]]</li></ul>
Pre-Release 4Added function-permission-level option which controls what permission level functions have
Advertisement