Node | Description |
taien.th.hunt.world (or *) | Allows users to use /hunt or /th in world. |
taien.th.notify.world (or *) | Allows users to receive broadcasts from TreasureHunt while in the world named. |
taien.th.tool.world (or *) | Allows users to use the hunt tool in world. |
taien.th.claim.world (or *) | Allows users to claim chests they find in world (without this, they cannot win the hunt, only find the chest). |
taien.th.compass.world (or *) | Allows users to make offerings to compass blocks to have their compass set. |
taien.th.nodetect.world (or *) | Players with this permission will not count towards the closest player checks in the respective world. |
taien.th.noconsume.world (or *) | Players with this permission will be able to use their hunt tool infinitely. |
taien.th.stattool.world (or *) | Allows users to create stationary TreasureHunt chests without needing to give them the admin permission. |
taien.th.starthunt.world (or *) | Allows users to start hunts without needing to have the admin permission. |
taien.th.admin | Allows users to use all settings commands below. |
Command | Permission Node | Description |
/hunt | taien.th.hunt.world (or *) | Shows you the distance to the nearest chest. Can only be done once per SecondsBetweenChecks seconds. (See below.) |
/starthunt | taien.th.admin | Start a random hunt somewhere. |
/starthunt <value> | taien.th.admin | Start a random hunt somewhere with at least the value specified. |
/starthunt here <value> | taien.th.admin | Start a hunt at the block you are looking at with at least the value specified. |
/stattool off | taien.th.admin | Turn off the stationary chest tool (OBSIDIAN). |
/stattool <value> <minrespawntime> <maxrespawntime> <itemlist> | taien.th.admin | Set your stationary chest tool (OBSIDIAN) to place chests of the desired value, with a respawn time somewhere between <minrespawntime> and <maxrespawntime> (different every respawn), using items from <itemlist>. |
/hunt help | taien.th.admin | Shows all commands for setting the TH settings ingame. |
/hunt reload | taien.th.admin | Reloads configuration. |
/hunt list | taien.th.admin | Lists all active hunts. |
/hunt save | taien.th.admin | Save configuration. |
/hunt addworld | taien.th.admin | Add your current world as a chest generation world. |
/hunt removeworld | taien.th.admin | Removes your current world as a chest generation world. |
/hunt copyworld <name> | taien.th.admin | Import settings from the world you specify to your current world. |
/hunt cb | taien.th.admin | Toggle whether the block you're looking at is a compass block or not. |
/hunt addenchant <name> | taien.th.admin | Add the item you're holding as an enchanted item setup using the given name. |
/tophunters | none | Displays the top chest hunters. |
/tophunters clear | taien.th.admin | Clear the top hunters. |
Config Option | Ingame Command | Description |
Options.TopHuntersByValue | /tophunters | If true, the top hunters are displayed based upon how much value in chests they have found. If false, the top hunters are displayed based upon how many chests they've found. Default = false. |
Options.MaxAttemptsPerTick | | Number of times per server tick the plugin will search for a chest location (if it has determined that a chest should spawn). Default = 5. |
Options.SecondsBetweenChecks | | Amount of seconds players must wait before /hunting or using the hunt tool. Default = 5. |
Options.MaxSpawnAttempts | | Amount of attempts to find a suitable location when trying to spawn a chest. If your configuration is too tight, it will be easier to hit higher counts. Default = 1000. |
Options.MinPlayersOnline | | Amount of players which must be online for chests to spawn (does not include stationary chests). Default = 4. |
Options.UseCompass | /hunt usecb | Use the compass block feature of TH to help people find chests. Default = false. |
Options.3DDistances | | Use 3d distances instead of 2d for locating chests. With this off, players who get to 0 blocks must either go up or down. Default = false. |
Options.FoundChestFadeTime | | Time in minutes before a found chest will fade. Default = 5. |
Options.DirectionalText | | Turns on or off Directional Text, which displays what direction the chest is in textually when someone uses the hunt tool or does the hunt command. Default = false. |
Options.DetailLogs | | Display more log messages to console such as where and when chests spawn, who finds them, how much money they get, etc. Default = false. |
Options.Protection.Break | | Protects chests and marker blocks from being broken. Default = true. |
Options.Protection.Burn | | Protects chests and marker blocks from being burned. Default = true. |
Options.Protection.Explode | | Protects chests and marker blocks from being blown up. Default = true. |
Options.Protection.Piston | | Protects chests and marker blocks from being pistoned. Default = true. |
Options.ChestLevels.Uncommon | | Set the value at which chests become Uncommon. Default = 1500. |
Options.ChestLevels.Rare | | Set the value at which chests become Uncommon. Default = 2500. |
Options.ChestLevels.Legendary | | Set the value at which chests become Uncommon. Default = 3500. |
Options.ChestLevels.Epic | | Set the value at which chests become Uncommon. Default = 4500. |
Config Option | Ingame Command | Description |
WorldOptions.<world>.HuntTool | /hunt tool | Bukkit name of the Material to be used as the hunt tool. Default = ROTTEN_FLESH. |
WorldOptions.<world>.OfferingTool | /hunt offeringtool | Bukkit name of the Material to be used as the offering to compass blocks. Default = BONE. |
WorldOptions.<world>.MarkerBlock | /hunt marker | Bukkit name of the Material to be used as the marker block UNDER a chest. Default = GLOWSTONE. |
WorldOptions.<world>.ChestChance | /hunt chance <int> | Represents X in the chest chance of 1 in X. For example, entering 1 for this would cause a chest to spawn every check. Default = 100. |
WorldOptions.<world>.ChestInterval | /hunt interval <int> | Amount of time in seconds between chest checks for this world. Default = 60. |
WorldOptions.<world>.ChestDuration | /hunt duration <int> | Amount of time in minutes before an unfound chest fades. Default = 60. |
WorldOptions.<world>.MinDistance | /hunt mindist <int> | The minimum distance (cubical) that a chest must spawn from center in order to be allowed. Default = 0. |
WorldOptions.<world>.MaxDistance | /hunt maxdist <int> | The maximum distance (cubical) that a chest can spawn from center. Default = 3000. |
WorldOptions.<world>.MaxCompassDistance | /hunt maxcompassdist <int> | The maximum distance a chest can be from a compass block before it won't register to that block. Default = 1000. |
WorldOptions.<world>.CenterX | /hunt center | The X-coordinate of the center of chest generation. Default = 0. |
WorldOptions.<world>.CenterZ | /hunt center | The Z-coordinate of the center of chest generation. Default = 0. |
WorldOptions.<world>.DrawWeight | /hunt weight <int> | The amount of draws before a value is chosen (taking the lowest value). Default = 2. |
WorldOptions.<world>.GoodItemWeight | /hunt itemweight <int> | The amount of draws before an item is chosen (taking the one earliest in the list). Default = 2. |
WorldOptions.<world>.AmountWeight | /hunt amountweight <int> | The amount of draws before an amount of items is chosen (taking the lowest value). Default = 3. |
WorldOptions.<world>.MinLightLevel | | The minimum light required for a location to be valid for a chest to spawn. Default = 0. |
WorldOptions.<world>.MaxLightLevel | | The maximum light allowed for a location to be valid for a chest to spawn. Default = 4. |
WorldOptions.<world>.UseMarker | /hunt usemarker <true/false> | Use the Marker block underneath chests in this world. Default = true. |
WorldOptions.<world>.MinElevation | | The minimum elevation required for a location to be valid for a chest to spawn. Default = 4. |
WorldOptions.<world>.MaxElevation | | The maximum elevation allowed for a location to be valid for any chest to spawn. Default = 50. |
WorldOptions.<world>.MaxElevationRare | | The maximum elevation allowed for a location to be valid for a chest of rarity Rare or higher to spawn. Default = 25. |
WorldOptions.<world>.ConsumeChance | /hunt consumechance <int> | The percent chance (max 100) that the hunt tool will be consumed when used. Default = 50. |
WorldOptions.<world>.MinMoney | /hunt minmoney <int> | The minimum amount of money someone can get when they find a chest. Default = 100. |
WorldOptions.<world>.MoneyMultiplier | /hunt moneymultiplier <decimal> | The max money someone can get when they find a chest is the chest's value times this. Default = 1.0. |
WorldOptions.<world>.Enabled | /hunt enable <true/false> | Enable random chest generation for this world. Default = false. |
WorldOptions.<world>.StrictItems | /hunt strictitems <true/false> | Enable strict item selection for this world, which causes items from only the chest's rarity level to appear within it, instead of the default behavior of higher-level chests being able to contain amounts of lower-level items. Default = false. |
WorldOptions.<world>.MaxValue | /hunt maxvalue <int> | The maximum value any chest in this world can have. (Note that sometimes the value will go slightly over this - this is due to TH still accepting the last item randomly picked for a chest even if it goes over the goal value.) Default = 5000. |
WorldOptions.<world>.LastCheck | | You should probably not mess with this, but this represents the time (in milliseconds) when the world was last checked for chest generation. Default = 0. |
WorldOptions.<world>.OverrideMinPlayers | /hunt overrideminplayers <true/false> | Override the MinPlayersOnline setting to allow the plugin to always keep the MinChests amount of chests active even if not enough people are online to normally spawn chests. Default = false. |
WorldOptions.<world>.FadeFoundChests | /hunt fadefoundchests <true/false> | Fade chests that have been found shortly afterward. Default = true. |
WorldOptions.<world>.MinChests | /hunt minchests <int> | The amount of chests to keep active on this world at all times (except when there aren't enough players on to reach MinPlayers). Default = 0. |
WorldOptions.<world>.OfferAmount | /hunt offeramount <int> | The amount of OfferingTool you must offer to a compass block to get a reading. Default = 1. |
WorldOptions.<world>.CanSpawnOn | | The Bukkit material names of block types that TH chests can spawn on top of. Default = STONE, SMOOTH_BRICK, MOSSY_COBBLESTONE, OBSIDIAN. |
I'm Getting the message [TreasureHunt] Couldn't Fill the Chest! Worldlist 'Default' doesn't exist!
How do I fix that?