Requirements
Requirements set a list of rules for a fish to appear and can be applied to any fish to limit fish to only appear when the rule(s) are met. If a fish has no requirements it will always be able to be caught (depending on the allowed-worlds/regions setting in config.yml) however if all fish have requirements and the user is in a situation where they meet none of the requirements for the rarity fish they've caught an error may be sent to console. When a user reels in their rod, the plugin chooses a rarity the player will receive, then it chooses a fish. It doesn't go back and re-roll the rarity if it can't find any fish to give the user, hence why there must be at least one fish in each rarity that a user will always meet requirements for.
A few settings from pre-1.6 have been moved into requirements, so it's advised to check through this before upgrading.
As of 1.6.10 it's possible to add in requirements to rarities. These are applied exactly the same as they are to fish in the fish.yml file and all requirements available to fish are available to rarities - if a user doesn't meet the criteria for a rarity they won't be able to catch any fish in that rarity at all.
This lets you define a list of biomes the fish will only appear in, allowing you to create fish from cool areas and fish from hot areas. This takes in a list value, allowing for multiple biomes allowed per fish.
ℹ️ Want to create groups and reuse them? Try biome sets.
biome-sets:
# oceans biome set. you can add more sets as you please.
oceans:
- COLD_OCEAN
- DEEP_COLD_OCEAN
- DEEP_LUKEWARM_OCEAN
- DEEP_OCEAN
- LUKEWARM_OCEAN
- OCEAN
- WARM_OCEANThis restricts your users to only catching fish during certain times of in-game day, this time will be inputted based on the current in-game tick, which happens 20 times every second. For example, 15 seconds past midnight would be 2015 and four minutes would be 460*20. Like minSize/maxSize, you need to specify a minTime & maxTime.
This restricts your users to only catching fish during certain times of the real-world day, this is inputted similar to times for times in the competitions.yml wiki where they are formatted by 00:00 in 24-hour format. Like ingame-time, you need to specify the minimum and maximum time.
This lets you restrict fish to certain moon phases, it is recommended to combine this with the ingame-time requirement as otherwise the fish may appear during daytime too, when the moon phase is irrelevant. Below is a list of all the moon phase types as referenced in EvenMoreFish and a screenshot from the Minecraft fandom wiki showing all the moon phases.
View the moon phases ( click to open )
FULL_MOONWANING_GIBBOUSLAST_QUARTERWANING_CRESCENTNEW_MOONWAXING_CRESCENTFIRST_QUARTERWAXING_GIBBOUS
Like biome and world requirements, this has moved from its own config setting. If you still have the old permission: setting for your fish not in any requirements, this will need to be converted to this new format.
This lets you limit fish to a specific region(s) to appear in however, this will override your global value for this set in config.yml, for example, if you whitelist "region" in your config.yml but don't include it in your region requirement, the fish won't be able to spawn in that region. [This requires WorldGuard or RedProtect]
This limits fish to only appear in certain weather. Initially when I started adding requirements I thought there was a lot more weather variation. There was not. As it turns out, your choice is limited to CLEAR or DOWNFALL. For non-English speakers I can imagine this quite easily getting lost in translation, so simply CLEAR is not raining/snowing, and DOWNFALL is raining/snowing (Minecraft sees rain and snow as the same thing)
And finally, this limits fish to certain worlds. By default there's only three worlds, overworld, nether and end, but with a plugin like Multiverse-Core, you can create worlds to allow fish to only be caught in. There probably isn't much point allowing nether since water can't be placed there and lava can't be fished in though.
